--- title: "Customs Warehouse" slug: "customs-warehouse" description: "Explore the Customs Warehouse feature for duty suspension on goods, enabling efficient management of bonded warehouse scenarios in various industries." updated: 2026-05-01T09:09:39Z published: 2026-05-01T09:11:22Z canonical: "docs.abakion.com/customs-warehouse" stale: true --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.abakion.com/llms.txt > Use this file to discover all available pages before exploring further. # Customs Warehouse ## Feature Overview The Customs Warehouse feature supports bonded warehouse scenarios where goods are stored at a designated location under duty suspension. This is common in industries such as beverages, tobacco, and energy products, where excise duty is not payable at the point of purchase but only when goods leave the bonded premises for domestic consumption. When items subject to a Warehousekeeper duty are received into a customs warehouse location, the system creates a **Suspension** duty entry rather than an Imposition. The duty obligation exists — it is tracked in the duty ledger — but it is not yet payable. The duty is only converted to an Imposition (and becomes payable) when the goods are shipped out of the customs warehouse and into regular circulation. If goods are consumed in production at the customs warehouse and that location has duty-free consumption enabled, the duty is settled without creating a payable imposition. Transfers between locations are also handled: goods can be moved between customs warehouse locations, and the suspension carries forward to the destination. Transfers out of the customs warehouse to a regular location trigger imposition at the point of transfer. A special Physical Inventory Journal integration allows positive adjustments to the customs warehouse inventory to be treated as duty-suspended replenishments — for example, when goods are produced on-site and entered into the bonded store. This requires the journal batch to be linked to the customs warehouse location in setup. **Key Facts** | Topic | Detail | | --- | --- | | Setup page | Customs Warehouse Setup | | Duty type required | The Duty Code must have the **Warehousekeeper** flag enabled | | Suspension entry | Created when duty-subject items are received into a customs warehouse location | | Imposition trigger | Shipment out of the customs warehouse to a non-customs location | | Duty-free consumption | Enabled per location; consumption from production at the customs warehouse is settled without creating a payable imposition | | Allow Output Posting | If enabled, production output can be posted to the customs warehouse and treated as a suspension | | Phys. Invt. Journal Batch | If linked in setup, positive physical inventory adjustments on that batch/location are treated as duty-suspended replenishments | | Transfer rules | Items can be transferred between customs warehouse locations; items cannot be transferred *to* a customs warehouse using a standard transfer | | Re-application blocked | Item Ledger Entries carrying duty entries cannot be unapplied | --- ## Getting Started 1. Ensure the relevant Duty Code has the **Warehousekeeper** flag enabled (see the Duty Setup article). 2. Open **Customs Warehouse Setup** from the search or the Duty Reporting menu. 3. Add a line for each location that is a bonded/customs warehouse. Set **Location Code** to the BC location. 4. Enter a **Name** for the customs warehouse (used for identification in error messages). 5. If production output should be allowed to enter the customs warehouse as a suspension, enable **Allow Output Posting**. 6. If consumption of goods in production at this location should be treated as duty-free (no payable imposition), enable **Allow Duty-free Consumption**. 7. If you need physical inventory adjustments to this location to be treated as duty-free replenishments, create a dedicated **Physical Inventory Journal Batch** and link it in the **Phys. Invt. Journal Batch Name** field on the Customs Warehouse Setup line. 8. Verify by posting a test purchase receipt to the customs warehouse location for a duty-subject item — the resulting duty entry should have Entry Type = Suspension. --- ## Related Features Customs Warehouse is an extension of the standard duty lifecycle described in **Duty Entries and the Duty Lifecycle**. The Warehousekeeper flag on the Duty Code (configured in **Duty Setup**) is a prerequisite — without it, no customs warehouse behaviour is triggered. When goods leave the customs warehouse and an Imposition entry is created, it flows into the **Duty Settlement, Reimbursement, and Reporting** processes in exactly the same way as a standard imposition from a regular purchase. --- ## User Stories ****US-01: Register a location as a customs warehouse**** **As a** Business Manager **I want to** configure a BC location as a bonded customs warehouse **So that** goods received at that location are treated as duty-suspended rather than duty-imposed **Setup:** 1. Open **Customs Warehouse Setup**. 2. Select **New** and set **Location Code** to the location that represents your bonded warehouse. 3. Enter a **Name** for recognition purposes. 4. Leave **Allow Output Posting** and **Allow Duty-free Consumption** off unless these scenarios apply (see separate user stories). 5. Save. 6. Confirm that the Duty Code used for items stored here has the **Warehousekeeper** flag enabled in **Duties**. > **Note:** If a duty-subject item is received on a Warehousekeeper duty code at a location that is not in Customs Warehouse Setup, the system will block posting with an error. Always register the location before receiving goods. ****US-02: Receive goods into the customs warehouse under duty suspension**** **As a** Purchasing Agent **I want to** post a purchase receipt for duty-subject goods to the customs warehouse location **So that** the duty obligation is recorded as suspended and not immediately payable **Setup:** 1. Create a **Purchase Order** from a vendor whose Gen. Bus. Posting Group has a matching line in **Duty Posting Setup** (not set to duty-free, so the system evaluates the Warehousekeeper logic). 2. Set the **Location Code** on the purchase lines to the customs warehouse location. 3. Post the receipt. 4. Open **Duty Entries** and verify that the item has a Suspension entry — not an Imposition. > **Note:** The duty rate on a Suspension entry is always zero. The actual rate is applied when the suspension is converted to an Imposition at the point of shipment from the customs warehouse. ****US-03: Ship goods out of the customs warehouse and trigger imposition**** **As a** Sales Order Processor **I want to** post a sales shipment from the customs warehouse to a regular customer **So that** the suspended duty is converted to an Imposition entry and becomes part of the payable duty balance **Setup:** 1. Create a **Sales Order** with the **Location Code** set to the customs warehouse. 2. Post the shipment. 3. Open **Duty Entries** and verify that a new Imposition entry has been created, applying against the original Suspension entry. The Suspension entry's Remaining Quantity decreases accordingly. > **Note:** If the customer has a duty exemption or their posting group is set to duty-free in Duty Posting Setup, the system creates a Reimbursement entry rather than an Imposition — meaning no net duty is payable on the sale. ****US-04: Allow production output to enter the customs warehouse**** **As a** Production Planner **I want to** enable output posting to the customs warehouse **So that** finished goods produced on-site can be entered into the bonded store under suspension **Setup:** 1. Open **Customs Warehouse Setup** and find the relevant location. 2. Enable **Allow Output Posting**. 3. Post a production output journal with the location set to the customs warehouse. 4. Verify that a Suspension entry is created for the output quantity. > **Note:** Without this flag, posting output to a customs warehouse location will result in an error. ****US-05: Enable duty-free consumption from the customs warehouse**** **As a** Production Planner **I want to** enable duty-free consumption at the customs warehouse **So that** raw materials consumed in production at this location are not subject to a payable duty imposition **Setup:** 1. Open **Customs Warehouse Setup** and find the relevant location. 2. Enable **Allow Duty-free Consumption**. 3. Post a consumption journal (production or assembly) from this location. 4. Verify that the resulting duty entries show the Imposition being settled immediately (forced settlement), with a corresponding Reimbursement entry — net duty payable is zero. > **Note:** This flag only applies to Warehousekeeper duty codes. Standard imposition duties are not affected by this setting. ****US-06: Transfer goods between two customs warehouse locations**** **As a** Purchasing Agent **I want to** transfer duty-suspended goods from one customs warehouse to another **So that** the suspension is maintained and no imposition is triggered by the movement **Setup:** 1. Create a **Transfer Order** with the **Transfer-from Code** set to the source customs warehouse and the **Transfer-to Code** set to the destination customs warehouse. 2. Post the transfer. 3. Open **Duty Entries** and verify that the existing Suspension entries have been transferred to new entries at the destination location, and the original entries have been closed. > **Note:** The transfer quantity must exactly match the suspended quantity for a given item. If the quantities don't match, the system will block the transfer. Items cannot be transferred *to* a customs warehouse using a standard transfer shipment from a non-customs location. ****US-07: Transfer goods from the customs warehouse to a regular location**** **As a** Purchasing Agent **I want to** transfer goods from the customs warehouse to a non-bonded location **So that** the suspended duty is converted to an Imposition at the point of transfer **Setup:** 1. Create a **Transfer Order** with the **Transfer-from Code** set to the customs warehouse and the **Transfer-to Code** set to a regular (non-customs) location. 2. Post the transfer. 3. Verify in **Duty Entries** that the Suspension entry at the customs warehouse has been closed and a new Imposition entry has been created at the destination location. ****US-08: Post a duty-free physical inventory replenishment to the customs warehouse**** **As a** Accountant **I want to** use a linked Physical Inventory Journal batch to post positive adjustments to the customs warehouse **So that** the adjustment is treated as a duty-suspended replenishment rather than a regular positive adjustment **Setup:** 1. Open **Customs Warehouse Setup** and find the relevant location. 2. Set **Phys. Invt. Journal Batch Name** to the name of the Physical Inventory Journal batch dedicated to this customs warehouse. 3. Open the **Physical Inventory Journal** using that batch. 4. Enter a positive quantity adjustment for the relevant item on the customs warehouse location. 5. Enable the **Duty Phys. Invt. Adjustment** flag on the journal line (this field is only visible when the batch is linked to a customs warehouse location in setup). 6. Post the journal. 7. Verify that a Suspension duty entry is created for the adjustment. > **Note:** The **Duty Phys. Invt. Adjustment** field is only visible on the Physical Inventory Journal when the journal batch is linked to a Customs Warehouse Setup line. It is not available on other journal types or batches. Positive adjustments without this flag on a customs warehouse location will be blocked for Warehousekeeper duty items. --- ## Field Reference | Field | Where to find it | What it does | Default | | --- | --- | --- | --- | | Location Code | Customs Warehouse Setup | The BC location that acts as a customs/bonded warehouse | — | | Name | Customs Warehouse Setup | Descriptive name for the customs warehouse | — | | Allow Output Posting | Customs Warehouse Setup | If enabled, production output can be posted to this location under suspension | Off | | Allow Duty-free Consumption | Customs Warehouse Setup | If enabled, consumption from production at this location is treated as duty-free | Off | | Phys. Invt. Journal Batch Name | Customs Warehouse Setup | Links a Physical Inventory Journal batch to this location for duty-free positive adjustments | — | | Duty Phys. Invt. Adjustment | Physical Inventory Journal | Marks a positive adjustment line as a duty-suspended replenishment to the customs warehouse | Off |