How ERPNext landed cost vouchers add freight and duties to stock value
A landed cost voucher in ERPNext adds freight, customs duty and insurance to the purchase receipts they relate to, so the stock value reflects what the goods cost to reach your warehouse. A distributor or manufacturer often sees only the purchase price on the supplier invoice, while the freight forwarder, customs broker and insurer bill separately. Without a landed cost step, stock is valued at the supplier price and the margin on the item looks better than it is. Teams usually need the voucher when these charges are material to the item cost, when they arrive on separate invoices after the goods, or when import duty forms a large share of the cost. A simpler approach can be enough when the charges are small, when the business accepts the purchase price as the cost basis, or when the charges are expensed in the period they arrive.
The decision that shapes the voucher is how the charges are spread across the items on each receipt. ERPNext distributes charges either by the amount of each line or by the quantity received, so duty and insurance that scale with value usually suit amount-based distribution, while per-unit freight may suit quantity. Confirm with your accountant which expense or clearing accounts each charge type should post to, and confirm in the documentation for your ERPNext version whether a voucher can reference purchase invoices as well as purchase receipts. The accounting entries depend on whether perpetual inventory is enabled for the company, so check that setting before you post a test voucher.
The main risk is timing. A landed cost voucher entered after goods have been sold changes the cost used for those sales, and it can require stock reposting to correct earlier entries. The valuation method (FIFO or moving average) affects how the uplift flows into cost of goods sold, so test the same receipt under your chosen method on a copy of your site. Ask any implementation partner to scope the charge types, account mapping, the test cases for backdated entries and the cancel and amend process in writing. Those items, not the voucher form itself, usually determine the effort.
Distribution options and when each fits
This table compares the distribution basis for a landed cost voucher and the receipt type it attaches to, so you can match each charge to the cost driver it actually follows. Read each row as a question: what does this charge scale with, and how will that shape the per-unit cost of the items on the receipt. The main takeaway is that the basis should follow the cost driver, and the attachment should match where the cost was incurred.
| Option | Best suited to | Effect on per-unit valuation | Points to confirm |
|---|---|---|---|
| Distribute by quantity | Freight or handling charged per unit or per pallet, such as heavy or bulky items of similar value | Each unit absorbs the same share, so low-value units carry a larger share of the charge relative to their price | Confirm whether the carrier bills by weight, volume or count before choosing this basis |
| Distribute by amount | Duties, insurance or charges set as a percentage of invoice value, such as high-value goods of mixed price | Each line absorbs a share in proportion to its purchase value, so expensive items carry more of the charge | Check that the duty base in your customs entry matches the item values on the receipt |
| Attach to a purchase receipt | Freight and handling that arrive with the goods and are known before the supplier invoice is posted | Stock value and cost of goods sold update when the receipt is posted, so the charge flows into valuation at receipt | Confirm the charge is posted before stock is sold, or later stock sales will reflect the earlier cost |
| Attach to a purchase invoice | Charges billed separately by a forwarder, customs broker or insurer after goods have been received | Valuation is adjusted after the invoice is posted, which can require reposting if sales already used the earlier cost | Ask whether the invoice will arrive after period close and plan for backdated adjustments |
| Mixed charges on one voucher | Shipments where some costs are per unit and others are per value, such as freight plus duty | Each charge line can use its own basis, but all lines are posted together against the selected receipts | Confirm how your team will split the charges so each line gets the right distribution |
| Multiple receipts on one voucher | Consolidated freight that covers several supplier deliveries arriving together | The charge is spread across all selected receipt lines using the chosen basis, so allocation must reflect actual shipment content | Verify the receipts and items included before posting, since the allocation affects every linked line |
Setting up landed cost vouchers in ERPNext
This sequence prepares accounts, stock settings and receipts so that freight, duty and insurance costs are allocated to item valuation and posted to the general ledger in a way your accountants can trace. Each step ends with a check that confirms the setup before the next one begins.
Create expense accounts for landed costs
Your accountant or finance lead creates a separate expense or liability account for each cost type you will capitalize, typically freight, customs duty and insurance, under the correct company and root type in the chart of accounts. Keep them separate from the stock asset account so the costs are traceable by type later. Confirm the account names, currency and parent group with finance before anyone builds a voucher. You know this step is done when each account appears in the chart of accounts for the right company and can be selected on a landed cost voucher.
Confirm stock and valuation settings
Your ERP administrator reviews the stock settings and the item valuation method for the items that will receive landed costs, and confirms that the warehouses and stock accounts used on the receipts are mapped to the correct company. Check whether perpetual inventory is in use and which stock received but not billed account the company uses, since these affect where the entries land. Ask your implementation lead to confirm which valuation method applies to each item group, because changing it later has consequences. You know this step is done when a test receipt on a sandbox site shows the expected stock and valuation accounts.
Choose the purchase receipts to link
Your receiving team and accountant agree which purchase receipts or purchase invoices the landed cost will attach to, and confirm that those documents are submitted and have not been closed or cancelled. Identify the supplier invoice for each freight, duty or insurance charge so the voucher matches the actual cost. Check the item lines on each receipt because only items that were received can be allocated costs. You know this step is done when the list of source documents is agreed and each one shows as submitted with the expected item quantities and amounts.
Create and allocate the landed cost voucher
Your accountant creates a landed cost voucher, adds each cost line with its expense account and amount, and links the receipts selected in the previous step. Choose the distribution basis for each cost, either by quantity or by amount, based on the agreed costing policy. Use the distribution preview to check how much of each cost falls on each item before submitting. You know this step is ready when the allocated totals on the voucher equal the total of the charges entered and the per-item distribution matches the policy.
Submit the voucher and confirm valuation rates
Your accountant submits the landed cost voucher, which triggers an update to the valuation of the linked stock. Open the affected items in the stock ledger or stock balance report and confirm that the valuation rate has increased by the allocated landed cost per unit. Compare the new rates with the figures you calculated by hand for a small sample of items. You know this step is done when the valuation rates for the sample items have changed as expected and no unexpected stock values have moved.
Check the stock ledger entries
Your ERP administrator or inventory controller reviews the stock ledger for the linked receipts and confirms that the stock value difference reflects the landed cost allocated to each item. Check that the quantities are unchanged, since landed costs affect value rather than units on hand. Verify that any affected future transactions have been picked up by the reposting process if backdated entries are involved. You know this step is done when the stock ledger shows value adjustments matching the voucher and quantities that agree with the physical count.
Check the general ledger entries
Your accountant reviews the general ledger entries generated by the landed cost voucher and confirms that each cost account has been credited or debited as expected, with the offsetting entry going to the stock asset or stock received but not billed account. Reconcile the total of the landed costs against the supplier invoices for freight, duty and insurance. Confirm that the accounting dimensions, cost centers and currency are correct on each line. You know this step is done when the general ledger totals reconcile to the supplier invoices and the postings sit in the right accounts and dimensions.
What the accounting entries look like for stock and cost of goods
When the received items are still on hand, the landed cost increases the value of the stock. The additional amount is added to the item valuation rate, so the inventory asset account carries a higher balance than the supplier invoice alone would give. In general terms, the inventory account is debited for the extra cost, and the offsetting credit goes to the account where the landed cost charges were booked, typically a clearing or expense account that the voucher references. The stock ledger shows the same receipt with an updated valuation rate, and the stock balance in quantity does not change.
- Inventory asset debit: the warehouse stock account rises by the allocated freight, duty or insurance amount.
- Stock ledger valuation: the receipt row carries a higher incoming rate, and the item valuation rate on hand moves up accordingly.
- Quantity unchanged: no units are added or removed, so the stock balance in quantity stays the same.
- Remaining balance: later issues from this stock draw the higher value, so the effect follows the goods as they move.
- Distribution basis: the method chosen on the voucher (by quantity or by amount) decides how much of each item's value increases.
Confirm the account names and the stock ledger rate in a test company that uses your own chart of accounts and warehouse setup before you rely on these entries.
When some or all of the received items have already been delivered to customers, the extra cost does not sit in stock any more. The effect depends on whether the landed cost voucher is posted before or after the delivery. ERPNext adjusts the valuation of the stock ledger entries, and the cost of goods sold account reflects the cost that belongs to the units actually issued. The gap between the original cost and the corrected cost moves through the cost of goods sold account, so gross margin on those sales is reduced.
- Cost of goods sold debit: the portion of landed cost attached to units already shipped increases the cost of goods sold expense.
- Inventory credit for issued units: the stock account is reduced for the same portion, so the asset does not stay overstated.
- Margin effect: gross profit on the affected invoices falls by the amount that moved to cost of goods sold.
- Backdated vouchers: a voucher dated earlier than later deliveries triggers revaluation of those entries, which can affect closed periods.
- Reposting: large corrections may run as a background stock reposting job, so the report figures settle after the voucher is submitted.
Review the cost of goods sold and gross margin reports in a test company after a voucher posted against shipped stock, and confirm the period impact with your accountant.
A common situation is a purchase receipt that has been posted for goods, while the supplier invoice has not arrived yet. ERPNext records the goods in stock and books an accrual for the value not yet billed, usually through a stock received but not billed account when perpetual inventory is set up that way. A landed cost voucher can reference the receipt before the supplier invoice is matched. The accrual account and the inventory account must still reconcile once the invoice and the landed cost charges are both recorded.
- Accrual account: the received but not billed balance is cleared when the purchase invoice is matched to the receipt.
- Landed cost charges: freight or duty invoices recorded as landed cost charges are held against the voucher until they are booked.
- Matching sequence: the order in which the receipt, the landed cost voucher and the purchase invoice are submitted affects which account carries the balance at each step.
- Open items report: check for unmatched accruals at period end, since they can hide cost that has not yet reached the expense or inventory accounts.
- Period close: cost that remains on the accrual account at close usually needs a reconciliation note from the accounting team.
Walk through a receipt, a landed cost voucher and a matching invoice in a test company, and confirm that the accrual and inventory balances clear as your close process expects.
After the entries post, the inventory valuation report, the stock ledger and the general ledger should agree. Differences usually come from a voucher that was posted after the goods were issued, from a receipt that was cancelled and reposted, or from charges booked to a different account than the one the stock reconciliation expects. Reconciling these at each period end is easier when the landed cost accounts are kept separate from ordinary freight expense.
- Three-way check: compare the stock ledger value, the inventory account balance and the valuation report for each warehouse.
- Separate accounts: keep landed cost clearing distinct from freight expense so the allocation can be traced.
- Cancellations: cancelling a voucher reverses its entries, so check the stock ledger after any cancellation.
- Test before live use: run the full cycle in a test company with the same accounts and warehouse setup as production.
- Accountant sign-off: confirm the treatment of duties and insurance with your tax and audit advisers, since the correct account depends on your policies.
Document the account mapping you approve and keep the test company results as evidence of the expected behavior.
Controls and permissions that protect landed cost postings
Landed cost vouchers change the cost of stock that is already on the books, so they touch valuation and the general ledger at the same time. The cards below cover who can create, submit and cancel these vouchers, what cancellation does to valuation, what the audit trail should show, and when edits should be locked.
Separate creation from submission
A landed cost voucher is a draft until it is submitted, and only a submitted voucher posts to the stock ledger and general ledger. Decide which roles may draft vouchers, which may submit them, and whether the same person can do both. For a freight or duty charge, the person who keys the supplier invoice amount should not also approve the posting without a second check. Confirm how your ERPNext version maps these actions to roles and permissions, since role settings can differ between releases.
Limit who can cancel submitted vouchers
Cancelling a submitted landed cost voucher reverses the cost added to the affected receipts and reposts valuation, so it is a high-impact action. Restrict cancellation to a small group, usually finance leads with stock oversight. Ask your partner or internal admin to confirm which roles hold the cancel permission in your version, and test the cancel path in a staging site with a copy of production data before go-live.
Understand the valuation effect of cancellation
Cancelling a voucher changes the valuation rate of items already received and may change the cost of goods sold for deliveries made since then. Where a backdated voucher is cancelled after sales were invoiced, the gross margin of closed periods can shift. Before granting cancel rights, document how your team will explain such a movement to auditors, and confirm how stock reposting behaves in your version after a cancellation.
Design the audit trail for financial review
Reviewers need to trace each freight, duty or insurance amount from the supplier invoice to the landed cost voucher, the receipt it adjusts and the resulting journal entries. Require a reference to the supplier invoice and customs entry on every voucher, and keep attachments and version history on the record. Confirm which document changes and deletions ERPNext logs by default in your version and what you need to export for an external review.
Restrict edits after period close
Once a financial period is closed, a late landed cost voucher should not silently move closed-period stock value or cost of sales. Agree a written rule for late duty or freight invoices, such as posting them in the current period with a clear note, or reopening the period under sign-off. Confirm how your ERPNext version handles period closing and whether back-posting is blocked or only warned, and set the approval path before the first close.
Separate duties across the receipt and voucher
The person who books the goods receipt, the person who keys the landed cost voucher, and the person who reviews the accounting entries should not be the same person in every case. This split limits the chance that an invoice is loaded twice or allocated to the wrong items. Map these duties to ERPNext roles and to your approval matrix, and run a periodic review of users who hold more than one of them.
Questions buyers ask about landed cost in ERPNext
How much effort does a landed cost setup in ERPNext take?
The effort depends mostly on how many cost types you need, how many suppliers and shipments carry freight, duty or insurance, and how clean your existing purchase receipts are. A single freight charge on one supplier is a small configuration task. A setup with customs duty by country, insurance by policy, and several forwarders with different invoicing habits takes more design time before any voucher is created. Ask any provider to break the work into item setup, cost account mapping, distribution rules, test entries and training, and to state which parts are one-time and which recur when new shipment types appear. Quotes follow from a written scope, so the scope should list the cost types and suppliers you have today.
What drives the cost of landed cost work up?
Four factors move the cost most. The first is the number of landed cost charge types, since each needs its own expense account and sensible defaults. The second is the number of suppliers and forwarders whose invoices you must match to receipts. The third is the distribution logic: distributing by quantity, by amount, or by weight suits different goods, and mixing them across one shipment adds review work. The fourth is historical data. If past receipts were booked without freight, you need a decision on whether to repost them, which changes valuation and should be scoped separately. Ask for each of these to be priced as its own line in the quote.
What does the work need from our finance and warehouse teams?
Finance must confirm the accounts used for freight, duty and insurance, the accounts that hold stock in transit or stock received but not billed, and the rule for when a landed cost is booked into item value. Finance also decides who approves a voucher before it posts, because a posted voucher changes stock valuation and the cost of goods sold. The warehouse team must confirm how receipts are split across purchase orders, which items arrive together, and whether goods are received in partial lots. Their time goes into a sample of real shipments that show how the documents arrive. Agree on both sets of owners before the build starts so that the test cycle has named people signing off.
Can our own team configure landed cost vouchers without outside help?
Yes, a team with ERPNext administration skills can configure landed cost charges, accounts and vouchers, since the feature is part of the core accounting and stock modules. The harder part is agreeing the accounting policy: which costs capitalize into inventory, how distribution works for mixed shipments, and how corrections are made after a period has been reviewed. Teams that lack a stock accountant often find that policy takes longer than the screens. If you configure it yourselves, have your auditors or finance lead review the design before go-live, and keep a short written procedure that explains how each voucher is raised and checked.
How long does a test cycle for landed cost usually take?
The length of a test cycle depends on how many shipment types you must prove and how many periods must be reconciled. A reasonable test cycle covers each cost type with at least one real shipment from start to finish, checks the stock ledger and general ledger entries, and confirms that reports show the expected valuation. Ask any provider to state the number of test scenarios, the number of test shipments you supply, and the sign-off steps in the written scope. Do not accept a duration before those three items are listed, because they set the real length of the cycle.
What mistakes most often break landed cost accounting?
The most common problem is posting a freight or duty charge against the wrong item set, so that cost lands on goods that did not incur it. The second is distributing by amount when the cost depends on weight or volume, which skews unit cost for bulky low-value items. The third is changing a landed cost after the period has been closed or after stock has been sold, which then needs a repost. Each risk should be covered in the test plan with a named check, such as comparing unit cost before and after a voucher on a sample item. Ask the provider how they will verify that valuation reports match the source invoices.
Does DeployOpen issue a compliance certificate for our landed cost accounting?
No. DeployOpen prepares systems, controls and evidence for compliance assessments, including documented approval steps and records of how landed cost vouchers are raised and reviewed. Independent auditors and certification bodies issue any audit report or attestation. Ask your auditors early which evidence they will request, such as voucher approval records, valuation reconciliations and change logs, so the design captures that evidence from the start. Quotes follow from a written scope that names those controls.
What changes for your finance and warehouse teams
Once landed cost is in use, the receipt is no longer the end of costing. A purchase receipt records quantity and the supplier's price, but the item's true cost stays open until the freight invoice, customs duty statement or insurance charge arrives and a landed cost voucher is submitted against the receipt. Warehouse staff need to know that a receipt can be correct for stock and still incomplete for value, and finance needs to know which receipts are waiting for their extra charges. Decide who owns that waiting list, how often it is cleared, and whether goods are released for sale before their cost is final. Those answers shape the rest of the process more than any setting does.
Invoice matching changes as well. A freight forwarder or customs broker bills separately from the goods supplier, so the accounts payable team will see charges that do not match any single purchase order line. Agree in advance which documents are the source of truth for each charge, how a landed cost voucher references them, and who approves a voucher before it posts. Confirm with your auditors how the capitalized charges will be reviewed, because the accounting entries move cost from the expense side into stock value. Month-end costing then depends on every in-scope receipt having its vouchers posted before the period is locked. Plan a cut-off check for that, and confirm the current period-closing and stock reposting behavior in your ERPNext version with your implementation partner before go-live.
