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

Prev Next

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