A voucher gathering the incidental costs of a receipt — freight, customs duty and other charges — so they can be apportioned across the received items and capitalised. LandedCostPostingService splits the three charges over the child lines (by line value, or by quantity when AllocationMethod reads exactly ByQuantity), stamps the per-line split and final unit cost, posts one journal debiting the inventory account and crediting a landed-cost clearing account for the allocated total, records the journal in GLId and flips the status to Posted. Two limits matter for anyone reasoning about costs: the capitalisation reaches the general ledger only — it does not update InventoryCostLot or the inventory value layers, so engine COGS still ignores landed cost — and no controller, handler, job or metadata action invokes the posting service, so in the shipped product the voucher can be authored but never posted from the application.
Fields
| Field | Label | Type | Required | What it does |
|---|
AllocationMethod | Allocation Method | Text | | Only the exact value ByQuantity selects the quantity basis; every other value, empty included, falls through to apportioning by line value. The comparison ignores case but not spelling. |
BranchId | Branch | Lookup → Branch | | Copied to the capitalisation journal header and to both of its lines, so it determines which branch the inventory uplift and the clearing credit land in. |
CreatedById | Created By | Lookup → UserAccount | Yes | |
CreatedDateTime | Created Date | DateAndTime | Yes | |
DocumentDate | Document Date | DateAndTime | | Supplies the posting date of the capitalisation journal when the caller does not override it; if it is empty the current UTC date is used instead. |
DocumentNumber | Document Number | Text | | |
DutyAmount | Duty Amount | Currency | | Customs or excise duty to capitalise, split across the lines on the chosen basis independently of the freight and other charges. |
FreightAmount | Freight Amount | Currency | | One of the three charges to capitalise. Each charge is apportioned separately across the lines rather than pooled with the others, so each carries its own rounding remainder on the last line. |
GLId | GL | Lookup → Journal | | Points at the capitalisation journal created when the voucher posts. A non-empty value blocks a second posting just as firmly as a Posted status does. |
Id | Id | Guid | Yes | |
ModifiedById | Modified By | Lookup → UserAccount | Yes | |
Name | Name | Text | Yes | |
OtherAmount | Other Amount | Currency | | Any remaining incidental cost — clearing, insurance, handling — capitalised as a third independent pool split on the same basis as the other two. |
OwnerId | Owner | Lookup → UserAccount | Yes | |
PartnerAccountId | Partner Account | Lookup → Account | | Carried onto the capitalisation journal as its partner. An empty value does not stop posting — the journal is simply raised against an empty partner. |
RecordTypeId | Record Type | Guid, hidden | | |
SourceEntityName | Source Entity Name | Text | | A plain string naming the entity the costs originate from, such as a goods receipt or a bill. It is not a lookup and nothing in the platform validates it or follows it back to a record. |
SourceRecordId | Source Record | Guid | | The identifier of the originating document, stored without a foreign key. No service resolves it, so the link back to the receipt or bill is documentation rather than an enforced relationship. |
Status | Status | Text | | Starts as Draft and is set to Posted by the capitalisation service, which refuses to run again once it reads Posted. The intermediate 'Allocated' state the column contemplates is written by no code, so it only ever appears if something sets it by hand. |
TotalAllocated | Total Allocated | Currency | | Written by the posting service as the rounded sum of the per-line allocations, and used as the amount of the capitalisation journal. Posting is refused outright when it works out at zero or less. |
UIProps | UI Props | Text | | |
UpdatedDateTime | Modified Date | DateAndTime | Yes | |
Actions
| Action | Label | Type | What it does |
|---|
Clone | Clone | ServerAction (Clone) | Create a copy of this record |
Delete | Delete | Delete | Delete |
Edit | Edit | Edit | Edit |
New | New | New | New |
View | View | View | View |
Lookup filters
| Filter | Lookup field | Notes |
|---|
| Branch For Partner Account | BranchId | |
| Partner Account Filter | PartnerAccountId | |
