MGCLatticeFixedAssetService

Custom service for fixed asset operations: acquisition journal posting, the fixed asset transactions after acquisition (adjustments, depreciation, revaluation, write-ups and write-downs, extraordinary and bonus depreciation), asset transfer, asset split, depreciation proposals, disposal (sale/scrap) and the reversal of fixed asset transactions.

Methods

new

Initializes a new instance of the MGCLatticeFixedAssetService class.

• Visibility: public
• Returns: void

No parameters.

construct

Creates a new instance of the MGCLatticeFixedAssetService class.

• Visibility: public
• Returns: MGCLatticeFixedAssetService A new MGCLatticeFixedAssetService instance.

No parameters.

postAcquisition

Posts a fixed asset acquisition journal with asset/book/amount lines via LedgerJournalCheckPost.

• Visibility: public
• Returns: MGCLatticeOrderOperationResponseContract An MGCLatticeOrderOperationResponseContract indicating success or failure with details.

Name	Type	Optional	Description
_request	MGCLatticeFixedAssetAcquisitionRequestContract	No	The request containing JournalNameId, acquisition lines with AssetId/BookId/Amount, and standard header fields.

runDepreciationProposal

Runs the standard fixed asset depreciation proposal (AssetProposalDepreciation, the journal's Proposals > Depreciation proposal) into a new fixed asset journal: one line per asset book with depreciation due through the depreciation date, optionally only for one book. The journal is not posted.

• Visibility: public
• Returns: MGCLatticeOrderOperationResponseContract An MGCLatticeOrderOperationResponseContract: the DocumentId is the proposal journal and the message gives the number of proposed lines, or says that nothing was due.

Name	Type	Optional	Description
_request	MGCLatticeFixedAssetDepreciationRequestContract	No	The request containing JournalNameId (a fixed asset journal name), DepreciationDate, AssetBookId, and standard header fields.

postDisposal

Posts a fixed asset disposal journal for either sale or scrap, creating the journal and posting it.

• Visibility: public
• Returns: MGCLatticeOrderOperationResponseContract An MGCLatticeOrderOperationResponseContract indicating success or failure with details.

Name	Type	Optional	Description
_request	MGCLatticeFixedAssetDisposalRequestContract	No	The request containing AssetId, AssetBookId, JournalNameId, IsSale flag, SaleAmount, and standard header fields.

postAcquisitionBatch

Posts multiple fixed asset acquisitions in a single bulk operation.

• Visibility: public
• Returns: MGCLatticeBulkOperationResponseContract An MGCLatticeBulkOperationResponseContract containing per-item results.

Name	Type	Optional	Description
_requests	List	No	List of MGCLatticeFixedAssetAcquisitionRequestContract.

runDepreciationProposalBatch

Runs multiple depreciation proposals in a single bulk operation.

• Visibility: public
• Returns: MGCLatticeBulkOperationResponseContract An MGCLatticeBulkOperationResponseContract containing per-item results.

Name	Type	Optional	Description
_requests	List	No	List of MGCLatticeFixedAssetDepreciationRequestContract.

postDisposalBatch

Posts multiple fixed asset disposals in a single bulk operation.

• Visibility: public
• Returns: MGCLatticeBulkOperationResponseContract An MGCLatticeBulkOperationResponseContract containing per-item results.

Name	Type	Optional	Description
_requests	List	No	List of MGCLatticeFixedAssetDisposalRequestContract.

parseTransactionType

The fixed asset journal transaction type a postAssetTransaction line names, by the name of the AssetTransTypeJournal value (case does not matter). Only the transactions after acquisition that the fixed asset journal posts are returned: acquisition adjustment, depreciation, depreciation adjustment, revaluation, write-up and write-down adjustment, extraordinary and bonus depreciation.

• Visibility: public
• Returns: AssetTransTypeJournal The transaction type; None for any other name.

Name	Type	Optional	Description
_name	str	No	The transaction type name the request sent.

postAssetTransaction

Posts fixed asset transactions after acquisition in a new fixed asset journal, as the fixed asset journal page does: acquisition adjustments, depreciation, depreciation adjustments, revaluations, write-up and write-down adjustments, extraordinary and bonus depreciation. The lines are created with the standard AssetJournal (posting profile, offset account, default dimensions, text and voucher as the fixed asset proposals create them) and the journal is posted with LedgerJournalCheckPost.

• Visibility: public
• Returns: MGCLatticeOrderOperationResponseContract An MGCLatticeOrderOperationResponseContract: DocumentId is the posted journal, PostedDocumentId the voucher of its first line; the message lists every voucher.

Name	Type	Optional	Description
_request	MGCLatticeFixedAssetTransactionRequestContract	No	The request containing JournalNameId (a fixed asset journal name), Description, PostingDate, the lines (AssetId or AssetIdExternalKey, AssetBookId, TransactionType, DebitAmount or CreditAmount, TransactionDate, OffsetMainAccountId, Dimensions, ConsumptionQuantity, ReasonCode, ReasonComment, Description) and the standard header fields.

postAssetTransactionBatch

Posts several fixed asset transaction journals in a single bulk operation; each item runs as a single postAssetTransaction and gets its own result.

• Visibility: public
• Returns: MGCLatticeBulkOperationResponseContract An MGCLatticeBulkOperationResponseContract containing per-item results.

Name	Type	Optional	Description
_requests	List	No	List of MGCLatticeFixedAssetTransactionRequestContract.

transferAsset

Transfers a fixed asset to new financial dimensions with the standard asset transfer (AssetTransfer, the Transfer asset action of the fixed asset page) and posts what it creates, and moves the asset to a new location. The transfer moves each book's balance from its current default dimensions to the new ones (a general ledger voucher and an asset transfer transaction per book), records the transfer history and gives the book the new default dimensions; the location is the asset's location field.

• Visibility: public
• Returns: MGCLatticeOrderOperationResponseContract An MGCLatticeOrderOperationResponseContract: DocumentId is the fixed asset, PostedDocumentId the voucher of the first transferred book (empty for a location-only transfer); the message lists the books and vouchers.

Name	Type	Optional	Description
_request	MGCLatticeFixedAssetTransferRequestContract	No	The request containing AssetId (or AssetIdExternalKey), AssetBookId (optional), Dimensions, LocationId, TransferDate, Comment and the standard header fields.

transferAssetBatch

Transfers several fixed assets in a single bulk operation; each item runs as a single transferAsset and gets its own result.

• Visibility: public
• Returns: MGCLatticeBulkOperationResponseContract An MGCLatticeBulkOperationResponseContract containing per-item results.

Name	Type	Optional	Description
_requests	List	No	List of MGCLatticeFixedAssetTransferRequestContract.

splitAsset

Splits a fixed asset book with the standard asset split (AssetSplit, the fixed asset book's Split asset action) and posts the split journal it creates, in one transaction. The split moves the percentage of the book's acquisition, depreciation and other values to a book of the receiving asset: an existing asset, or a new asset created as a copy of the asset to split with the standard Copy fixed asset (AssetCopy: same group and details, every book copied, none acquired).

• Visibility: public
• Returns: MGCLatticeOrderOperationResponseContract An MGCLatticeOrderOperationResponseContract: DocumentId is the asset that was split, PostedDocumentId the asset that received the split (the new asset when one was created); the message names the posted split journal.

Name	Type	Optional	Description
_request	MGCLatticeFixedAssetSplitRequestContract	No	The request containing AssetId (or AssetIdExternalKey), AssetBookId, ToAssetId (or ToAssetIdExternalKey; empty for a new asset), ToAssetBookId, Percent or Quantity, SplitDate, JournalNameId and the standard header fields.

splitAssetBatch

Splits several fixed asset books in a single bulk operation; each item runs as a single splitAsset and gets its own result.

• Visibility: public
• Returns: MGCLatticeBulkOperationResponseContract An MGCLatticeBulkOperationResponseContract containing per-item results.

Name	Type	Optional	Description
_requests	List	No	List of MGCLatticeFixedAssetSplitRequestContract.

reverseAssetTransaction

Reverses a posted fixed asset voucher of a book with the standard fixed asset transaction reversal (TransactionReversal_Asset, the fixed asset transactions page's Reverse transaction), called as the standard reversal provider (AssetTransactionReversal) calls it, with a TransactionReversalContract so no dialog is shown: the ledger voucher and every asset transaction of the voucher are reversed and the book is updated (a reversed acquisition, depreciation or disposal resets the book as the standard reversal does), in one transaction.

• Visibility: public
• Returns: MGCLatticeOrderOperationResponseContract An MGCLatticeOrderOperationResponseContract: DocumentId is the reversed voucher, PostedDocumentId the reversal voucher.

Name	Type	Optional	Description
_request	MGCLatticeFixedAssetReversalRequestContract	No	The request containing AssetId (or AssetIdExternalKey), AssetBookId, Voucher, TransactionDate (only when the voucher has several dates), ReversalDate, ReasonCode, ReasonComment and the standard header fields.

reverseAssetTransactionBatch

Reverses several fixed asset vouchers in a single bulk operation; each item runs as a single reverseAssetTransaction and gets its own result.

• Visibility: public
• Returns: MGCLatticeBulkOperationResponseContract An MGCLatticeBulkOperationResponseContract containing per-item results.

Name	Type	Optional	Description
_requests	List	No	List of MGCLatticeFixedAssetReversalRequestContract.