Skip to main content
iVentureTeam
Odoo Implementation

Odoo Landed Costs Guide: Setup, Split Methods, Valuation and Duties

Odoo landed costs for Odoo 19 and 20: setup, split methods, FIFO and AVCO valuation, journal entries, import duties and what Odoo 20 changes for importers.

Siddharth JambukiyaSiddharth JambukiyaOdoo Techno-Functional Consultant
November 14, 202614 min read3 views
Odoo Landed Costs Guide: Setup, Split Methods, Valuation and Duties cover

Import businesses rarely pay one invoice per shipment. The supplier bills the goods, a forwarder bills freight, a broker bills duties, and each arrives on a different day. Our Odoo implementation services set up Odoo landed costs so every one of those bills ends up in the right product's cost.

Related service: Odoo implementation services — fixed-scope implementations with a named senior team.

This tutorial is for finance leads, inventory managers and importers on Odoo 19 or 20. If you buy EXW or FOB and need stock tracked at sea first, start with our Odoo transit warehouse guide for EXW and FOB imports, then come back here for the costing.

What are landed costs in Odoo?

Landed costs in Odoo are the extra charges, beyond the supplier price, that you add to the value of received stock. Odoo's landed costs documentation lists shipment, insurance, customs duties, taxes and other fees.

Without them, a product bought at $10 and shipped for $2 a unit sits in stock at $10. Your gross margin looks better than it is until month-end, when someone books freight to an expense account and nobody knows which products it belonged to.

The accounting rule behind this is simple. Under the IAS 2 Inventories standard, the cost of purchase includes the purchase price, import duties and other non-recoverable taxes, transport and handling. Most local GAAP rules say the same.

This guide covers the full landed cost cycle on purchases. For production overhead and work order costing, see our separate guide to Odoo manufacturing cost accounting.

How do you set up Odoo landed costs in Odoo 19 and 20?

Odoo landed cost setup takes four settings: the feature, a journal, landed cost products and a costing method on the product categories. The steps are the same in both versions.

  1. Enable the feature: go to Inventory, Configuration, Settings, tick Landed Costs in the Valuation section and save.
  2. Pick a default journal: a Default Journal field appears below the setting; choose the journal for all landed cost entries.
  3. Create cost products: add a product such as "Sea Freight" or "Customs Duty", set Product Type to Service, and tick "Is a Landed Cost" on the Purchase tab.
  4. Set a default split method: choose one on the same tab, so each new cost line starts with the right rule.
  5. Set the expense account: on the cost product or its category, use a clearing account, not a profit and loss account, because the landed cost entry credits it.
  6. Check costing methods: stored products must sit in categories using FIFO or AVCO, or the cost will not change their value.

Odoo says landed cost products "must" be Services. In the source code, once a cost product is used in a journal item, Odoo blocks changing its type or unticking the landed cost option. Name and map these products carefully on day one.

We suggest one product per charge type: sea freight, air freight, insurance, customs duty, broker fee, port charges. Reports then show duty apart from freight, which your accountant and customs auditor will both want.

Which Odoo landed cost split method should you use?

Pick the split method that matches what drives the charge: weight or volume for freight, value for duty and insurance, quantity for per-unit fees. You set it per cost line, so one landed cost can mix methods.

Split methodHow Odoo splits the costBest for
EqualSame amount to each product line, whatever the quantityFlat fees, such as a document or inspection charge
By QuantityBy units received across all linesPer-unit handling or labelling fees
By Current CostBy each line's value on the receiptAd valorem duty, insurance, value-based broker fees
By WeightBy product weight times quantityAir freight, road freight, heavy goods
By VolumeBy product volume times quantitySea freight in shared containers, bulky goods

Weight and volume splits read the Weight and Volume fields on each product. If those are empty, the split cannot work as intended. This is a common cause of forum posts such as landed cost value only being added for the first item.

You can also edit the Valuation Adjustments lines by hand before you validate, which an Odoo forum answer on custom split methods suggests. A truly new rule, such as duty by HS code rate, needs a small custom module.

How does Odoo split freight and duty on one receipt? A worked example

On a mixed receipt, the split method changes each product's unit cost a lot, so test it on a real shipment before go-live. The figures below are illustrative.

One receipt holds Product A (100 units at $10, 50 kg, 1.2 m³ in total) and Product B (50 units at $40, 150 kg, 0.8 m³). Sea freight of $600 arrives on a separate forwarder bill.

Split method for $600 freightProduct A shareProduct B share
Equal$300$300
By Quantity$400$200
By Current Cost$200$400
By Weight$150$450
By Volume$360$240

Now add $300 of customs duty that applies to Product B only. In Odoo 20, you set the duty line's "Apply On" field to Product B. With freight by weight, A ends at $11.50 a unit and B at $55.00 a unit.

In Odoo 19 there is no Apply On field, so the duty line spreads over every product on the receipt. The usual fix is to edit the valuation adjustment lines before you validate, or post a separate landed cost on a receipt that holds only the dutiable goods.

How do Odoo landed costs change inventory valuation?

Validating a landed cost raises the value of the received stock moves, which raises the unit cost of FIFO and AVCO products. Standard Price products keep their standard cost.

After you pick the transfers and click Compute, the Valuation Adjustments tab shows Original Value, Additional Landed Cost and New Value for each line. Validate, and the new value feeds the product's cost for later deliveries.

  • FIFO: the extra cost sits on the receipt layer, so units from that shipment leave stock at the higher cost.
  • AVCO: the extra cost raises the average cost of all units on hand.
  • Standard Price: in Odoo 19, Odoo refuses to compute a landed cost on these products; in Odoo 20, it accepts the line but only FIFO and AVCO values change.

How the change reaches the ledger depends on the accounting method in Accounting settings. Odoo's inventory valuation guide for accountants describes Perpetual (at invoicing) and Periodic (at closing). Our post on Odoo 20 inventory valuation changes compares FIFO and AVCO in detail.

What accounting entries do Odoo landed costs post?

The cost bill debits the cost product's expense account, and the validated landed cost moves the in-stock share from that account to stock valuation. That is why the expense account should be a clearing account.

StepDebitCreditNotes
Forwarder bill for freight ($600)Freight and duty clearingAccounts payableLine uses the Sea Freight cost product
Broker bill for duty ($300)Freight and duty clearingAccounts payableImport VAT or GST goes to its tax account, not here
Landed cost validated, all goods in stock ($900)Stock valuationFreight and duty clearingPosted in the landed cost journal
Correction or vendor credit noteFreight and duty clearingStock valuationOdoo creates a negative landed cost

In the Odoo 20 landed cost source code, the entry is scaled to the quantity still in stock, and products not valued in real time get no journal entry. With periodic valuation, the new value shows at the next closing.

If 20 of Product A's 100 units were sold before validation, Odoo posts only the in-stock share of A's $150 freight, which is $120. The next section explains what Odoo 20 does with the rest.

Bills in foreign currency are converted at the bill's rate when you click Create Landed Costs. For FX gains and rate rules, see our Odoo multi currency accounting guide.

What changed for Odoo landed costs in Odoo 20?

Odoo Landed Costs: What changed in Odoo 20?

Odoo 20 adds per-product landed costs and retroactive COGS, while setup, split methods and journals stay the same as Odoo 19. Both are listed as Community changes in our Odoo 20 inventory release notes.

AreaOdoo 19Odoo 20
Split methodsFive: equal, quantity, cost, weight, volumeSame five methods
Costing methodsFIFO or AVCO only, else an errorAny product, only FIFO and AVCO revalued
Cost on chosen productsSpread over the whole transferApply On field per cost line
Default products per costNot availableDefault Apply On list on cost product
Goods sold before the costOnly the in-stock share revaluedDelivery value and invoice COGS updated
Reversing a posted costNegative landed cost, no cancelNegative landed cost, no cancel

The COGS change matters most to importers. If goods were delivered before the freight bill arrived, Odoo 20 replays the valuation, recomputes the delivery value and, with perpetual accounting, updates the COGS lines on the posted customer invoice.

Test this before you rely on it. Run one full cycle in a copy of your database, then check that your clearing account nets to zero and the COGS posted on invoices matches the new delivery value.

How should import duties, customs and import VAT be handled in Odoo?

Treat customs duty as a landed cost, and treat recoverable import VAT or GST as a tax, not a cost. Mixing the two overstates stock and understates your tax claim.

  • Customs duty: a landed cost product split By Current Cost, or Apply On the dutiable products in Odoo 20.
  • Anti-dumping or excise duty: a separate cost product, so the amount is visible in reports.
  • Recoverable import VAT or GST: post on the broker bill with your localization's import tax, to the tax receivable account.
  • Non-recoverable taxes: a landed cost, as IAS 2 includes non-recoverable taxes in purchase cost.
  • Broker and port fees: landed costs if they are part of bringing goods to their location; ask your accountant once and document it.

Customs values often differ from the supplier invoice because of freight and insurance in the duty base. Odoo does not calculate duty for you. Enter the duty amount from the customs entry, then let the split method or Apply On field place it.

How do landed costs work with goods in transit and late bills?

Post landed costs on the receipt that brought the value into stock, which for EXW and FOB imports is the vendor-to-transit receipt. The later move from transit to your warehouse changes location, not value.

Only validated transfers can be selected on a landed cost. When you click Create Landed Costs on the supplier's own bill, Odoo fills in that purchase order's receipts. A forwarder or broker bill has no purchase order, so you pick the transfers yourself.

One landed cost can cover several receipts, such as a container that consolidated three supplier orders. Odoo also supports landed costs on manufacturing orders when the Manufacturing app is installed, useful for outside processing charges.

For bills that arrive weeks later, two patterns work. Post an estimated landed cost at receipt and a positive or negative correction when the real bill lands, or wait for the bill and rely on Odoo 20's COGS replay. We help clients pick one and write it into the month-end close checklist.

What are the common Odoo landed cost mistakes?

Most landed cost problems come from master data and account mapping, not from the feature itself. These are the issues we see most often.

  • Wrong costing method: products in a Standard Price category get no value change.
  • Missing weight or volume: weight and volume splits fail silently when product fields are blank.
  • Profit and loss as the cost account: the validation entry then credits an expense, so freight vanishes from both P&L and stock reports.
  • Wrong transfer: costs posted on the transit-to-stock move, which carries no value, instead of the receipt.
  • Duplicates: two landed costs for the same bill, which inflates value; a user on the Odoo forum saw a 30,000 SAR landed cost show as 48,000 SAR.
  • Trying to cancel: a posted landed cost cannot be cancelled; Odoo asks you to create a negative landed cost instead.

Which importers need Odoo landed costs most?

Any business that buys abroad or pays freight separately needs landed costs, but the right split method depends on what you import. Our Odoo for trading companies guide covers the purchasing side.

IndustryPain or cost driverOdoo approachHow iVentureTeam helps
Retail importersMixed containers, many small SKUsFreight by volume, duty by current costProduct volumes loaded, see Odoo ERP for retail
Wholesale and distributionMargins of a few pointsLanded costs on every containerClearing accounts and month-end checks
Logistics and 3PL-led importersForwarder and broker bills per shipmentSeveral receipts on one landed costFlow design with Odoo ERP for logistics
Electronics and hardwareDuty differs by productApply On per duty line in Odoo 20Duty products per tariff group
Food and beverageCold freight, exciseFreight by weight, excise as its own costLot valuation and expiry tested together
ManufacturersImported raw materialsLanded costs on component receiptsCosts flow into BOM and work order costs

How iVentureTeam helps set up Odoo landed costs

Planning an import setup? Price your Odoo project

iVentureTeam designs, tests and documents your Odoo landed cost flow so stock value, COGS and the ledger agree. We have delivered 150+ ERP projects across 35+ countries with 40+ Odoo specialists, led by a consultant with 13+ years in Odoo.

  • Cost model: one cost product per charge type, with split methods agreed with your accountant.
  • Accounts: clearing accounts, journals and import tax mapping for your localization.
  • Import flow: receipts, transit locations and broker bills built into one process as part of our Odoo implementation services.
  • Testing: a full PO, receipt, bill, landed cost, delivery and invoice cycle in a copy of your database.
  • Upgrade checks: for Odoo 19 to 20 moves, we test Apply On and the COGS replay before cutover.

Want a budget first? The Odoo project estimate tool gives an indicative cost and timeline in minutes.

Odoo inventory costing case study: KMF Technologies

Landed costs only work on a clean product master and a reliable purchase-to-stock flow, which is what we built for a West African hardware distributor. KMF Technologies supplies IT services, computer hardware and network infrastructure across the region.

Its back office ran on manual tracking. Products and categories lived in hand-kept lists, there was no real-time stock visibility, and sales, purchase and store teams could not see each other's data.

We configured Odoo Sales, Purchase, Inventory and Accounting in a seven-phase, 8-week rollout. We defined warehouses, product categories and locations, imported the full product master with cost and sale prices, and built a chart of accounts for The Gambia.

KMF now runs an integrated purchase-to-delivery workflow with live stock across warehouses. Read the KMF Technologies Odoo inventory implementation case study.

The bottom line on Odoo landed costs

Odoo landed costs work well once the basics are right: Service cost products, a clearing account, FIFO or AVCO categories and a split method per charge. Odoo 20 makes late bills and per-product duty much easier.

Start with one real shipment. Post the bills, split them, deliver some goods, invoice them, and check stock value, COGS and the clearing account. If all three agree, your import costing is ready for go-live.

Ready to get your import costs right in Odoo?

Talk to a costing consultant

Get freight, duty and stock value lined up before your next container lands. Ask an Odoo inventory costing consultant, call +91-90235-15208, or email business@iventureteam.com.

Frequently Asked Questions

What are landed costs in Odoo?

+

Landed costs are extra charges such as freight, insurance and customs duties that Odoo adds to the value of received stock. They raise the unit cost of FIFO and AVCO products so margins reflect the real cost of goods.

How do I enable landed costs in Odoo?

+

Go to Inventory, Configuration, Settings, tick Landed Costs in the Valuation section and save. Then choose a Default Journal and create Service products with "Is a Landed Cost" ticked on the Purchase tab.

Is the landed costs feature available in Odoo Community?

+

Yes. The landed costs module is part of Odoo's open-source code under the LGPL-3 license, and the Odoo 20 landed cost changes are listed as Community features. Your accounting setup decides how entries post.

Do landed costs work with standard price products?

+

No value change happens for Standard Price products. Odoo 19 refuses to compute the cost on them, and Odoo 20 accepts the line but only revalues FIFO and AVCO products. Move imported goods to a FIFO or AVCO category.

Which split method should I use for freight?

+

Use By Weight for air and road freight, and By Volume for sea freight in shared containers. Make sure every product has weight and volume filled in, or the split will not work as intended.

Should import VAT be a landed cost in Odoo?

+

Not if you can recover it. Recoverable import VAT or GST is a tax receivable, so post it with the import tax on the broker bill. Customs duty and non-recoverable taxes belong in landed costs.

Can I cancel a validated landed cost?

+

No. Odoo blocks cancelling a posted landed cost and asks you to create a negative landed cost to reverse it. A vendor credit note with landed cost lines creates a negative landed cost when you click Create Landed Costs.

What happens if goods were sold before the freight bill arrived?

+

Odoo posts only the in-stock share to stock valuation. In Odoo 20, the delivery value is recomputed and, with perpetual accounting, COGS on the posted invoice is updated. Test this in a copy of your database first.

Can one landed cost cover several receipts?

+

Yes. A landed cost can be linked to several validated transfers, which suits a container that combined goods from more than one purchase order. The split method then spreads the cost across all lines.

Free written cost estimate

Working out what Odoo will cost you?

Tell us your users, apps and processes. We send a written estimate covering licenses, implementation, migration and support.

Free, with no obligation. A senior consultant replies within 12 business hours.

We use cookies to improve your experience

Essential cookies make the site work, and we use analytics to improve it. Choose “Only necessary” to turn analytics off. See our cookie policy.