Customs Tariffs

Prev Next

Feature Overview

When shipping internationally, brokers require item-level customs information alongside the physical shipment data. Shipping Manager's Customs Tariffs feature provides a structured way to attach customs line data to any source document — sales orders, warehouse shipments, posted shipments, transfer orders, and purchase orders — so the information can be transmitted to the broker as part of the waybill.

Each customs tariff line represents a group of items in the shipment and captures the tariff number (HS code), country of origin, quantity, weight (both gross and net), declared amount, currency, and unit of measure. The feature supports both individual line entries and summary totals (Type: Line or Total), allowing you to structure the customs declaration as the broker or customs authority requires.

Customs tariff lines are linked to their source document by record ID, which means they travel with the document through its lifecycle. The customs tariff page can be accessed from a factbox or sub-page on the relevant document, so users do not need to navigate away to maintain this data.

The setup for customs-related defaults (Declaration Type, Reason for Export, Type of Goods, and Weight Unit of Measure for Customs) is centralised in Shipping Manager Setup, ensuring consistent defaults across all new waybills.

Key Facts

Item Detail
Main page Customs Tariff Lines (accessible from source documents as a subpage/factbox)
Supported documents Sales Orders, Warehouse Shipments, Posted Shipments, Transfer Orders, Purchase Orders
Key fields per line Tariff No. (HS code), Item No., Description, Country of Origin, Quantity, Gross Weight, Net Weight, Amount, Currency Code
Line types Line (individual item entry) or Total (summary line)
Weight UOM for customs Separate from the waybill weight UOM — configured in Shipping Manager Setup
Defaults Declaration Type, Reason for Export, and Type of Goods on Shipping Manager Setup pre-populate new waybills
Automatic Paperless Clearance Optional feature on Shipping Manager Setup to enable electronic customs submission

Getting Started

  1. Go to Shipping Manager Setup and configure the customs defaults:
    • Default Declaration Code (e.g., C88 or the code required by your broker)
    • Default Reason for Export (e.g., Sale, Gift, Return)
    • Default Type of Goods (e.g., Commercial Goods)
    • Default Weight Unit of Measure for Customs (the weight UOM expected by customs, e.g., KG)
  2. Enable Show Customs Tariffs in Abakion Manager Foundation feature settings (enabled by default during the Shipping Manager wizard).
  3. Open a sales order or warehouse shipment that you want to add customs information to.
  4. Navigate to the Customs Tariff Lines subpage or factbox on the document.
  5. Insert a line for each group of goods being exported.
  6. Fill in the Tariff No. (HS code), Country of Origin, Quantity, Gross Weight, Net Weight, and Amount for each line.
  7. When the waybill is sent to the broker, the customs tariff lines are included in the transmission payload.

Related Features

Waybills are the transmission vehicle for customs data — the waybill header carries the Declaration Type, Reason for Export, and Type of Goods fields at the shipment level, while customs tariff lines provide the item-level detail. Connectors receive the customs data as part of the waybill API payload; the specific fields transmitted depend on the connector app and the broker's requirements. Shipping Manager Setup provides the default values that pre-populate new waybills and reduce manual entry for routine exports.


User Stories

US-01: Add customs tariff lines to a sales order for international shipment

As a Sales Order Processor
I want to add customs tariff information to a sales order before shipment
So that the broker receives the required item-level customs data when the waybill is sent

Setup:

  1. Open the Sales Order for an international customer.
  2. Navigate to the Customs Tariff Lines subpage (visible when the Show Customs Tariffs feature is enabled).
  3. Insert a new line.
  4. Enter the Tariff No. (HS/commodity code).
  5. Enter the Item No. and Description for the goods on this line.
  6. Enter the Country of Origin for the goods.
  7. Enter the Quantity, Ship Quantity, Gross Weight, Net Weight, and Amount.
  8. Set the Currency Code to match the invoice currency.
  9. Repeat for each different tariff category in the shipment.
  10. The customs lines are included when the associated waybill is transmitted to the broker.
US-02: Add a summary total line to the customs declaration

As a Sales Order Processor
I want to add a total summary line to the customs tariff declaration
So that the declaration includes both itemised lines and the consolidated totals required by some brokers

Setup:

  1. Open the Customs Tariff Lines for the relevant document.
  2. Insert a line and set Type (Indentation) to Total.
  3. Enter the combined totals for Quantity, Gross Weight, Net Weight, and Amount that represent the sum of the preceding lines.
  4. The Total line type visually separates summary entries from itemised lines in the declaration.
US-03: Configure default customs values on Shipping Manager Setup

As a IT Manager
I want to set default customs values in Shipping Manager Setup
So that new waybills are pre-populated with the correct declaration type, reason for export, and type of goods, reducing repetitive entry

Setup:

  1. Go to Shipping Manager Setup.
  2. Set Default Declaration Code to the standard declaration type used for your exports (e.g., the code for a commercial invoice declaration).
  3. Set Default Reason for Export to the value most commonly applicable (e.g., Sale).
  4. Set Default Type of Goods to the standard goods description.
  5. Set Default Weight Unit of Measure for Customs to the UOM required by customs authorities (often KG).
  6. When a new waybill is created, these values are automatically applied to the Declaration Type, Reason for Export, and Type of Goods fields.
US-04: Override customs defaults on a specific waybill

As a Sales Order Processor
I want to change the declaration type or reason for export on an individual waybill
So that shipments with non-standard customs requirements (e.g., a return or a gift) use the correct codes

Setup:

  1. Open the waybill for the shipment.
  2. Update the Declaration Type field to the appropriate code for this shipment.
  3. Update the Reason for Export field (e.g., change from Sale to Return).
  4. Update the Type of Goods field if necessary.
  5. Save. These changes apply only to this waybill; the defaults in Shipping Manager Setup remain unchanged.
US-05: Enable Automatic Paperless Clearance for electronic customs submission

As a IT Manager
I want to enable Automatic Paperless Clearance on Shipping Manager Setup
So that customs documentation is submitted electronically to the relevant authorities through the broker, eliminating paper customs forms

Setup:

  1. Go to Shipping Manager Setup.
  2. Enable Automatic Paperless Clearance.
  3. Verify with your broker/connector app that it supports paperless clearance for your target countries.
  4. From this point, waybills sent to the broker will include the paperless clearance flag, instructing the broker to handle electronic submission.

Note: Paperless clearance support depends on the connected broker and the destination country. Confirm with your connector app documentation that this feature is supported for your shipping lanes.

US-06: Add customs tariff lines to a warehouse shipment

As a Sales Order Processor
I want to add customs tariff lines at the warehouse shipment level rather than on the individual sales orders
So that when multiple orders are combined into one shipment, a single consolidated customs declaration is used

Setup:

  1. Open the Warehouse Shipment.
  2. Navigate to the Customs Tariff Lines subpage.
  3. Add lines covering all goods on the shipment, grouped by tariff number and country of origin.
  4. The customs lines are linked to the warehouse shipment record and transmitted with the associated waybill.
US-07: Review the calculated average unit price on customs lines

As a Accountant
I want to see the average unit price calculated on customs tariff lines
So that I can verify that the declared values are consistent with the actual invoiced prices before the shipment is transmitted

Setup:

  1. Open the Customs Tariff Lines for the relevant document.
  2. Review the Average Unit Price column. This field is calculated automatically (not editable) and represents the Amount divided by the Quantity.
  3. Compare against expected invoice prices. If a discrepancy is found, correct the Amount or Quantity fields on the relevant line.

Field Reference

Field Where to find it What it does Default
Default Declaration Code Shipping Manager Setup Pre-populates Declaration Type on new waybills (blank)
Default Reason for Export Shipping Manager Setup Pre-populates Reason for Export on new waybills (blank)
Default Type of Goods Shipping Manager Setup Pre-populates Type of Goods on new waybills (blank)
Default Weight Unit of Measure for Customs Shipping Manager Setup Weight UOM used on customs tariff lines KG (from wizard)
Automatic Paperless Clearance Shipping Manager Setup Instructs the broker to submit customs electronically Disabled
Declaration Type Waybill Header The customs declaration type for this shipment From setup default
Reason for Export Waybill Header Why the goods are being exported From setup default
Type of Goods Waybill Header General description of the goods From setup default
Tariff No. Customs Tariff Lines HS/commodity code for the goods (blank)
Item No. Customs Tariff Lines Item being declared (blank)
Description Customs Tariff Lines Description of the goods (blank)
Country of Origin Customs Tariff Lines Country where the goods were manufactured (blank)
Quantity Customs Tariff Lines Quantity ordered/shipped (blank)
Ship Quantity Customs Tariff Lines Quantity actually being shipped on this declaration (blank)
Unit of Measure Customs Tariff Lines Unit of measure for the ship quantity (blank)
Gross Weight Customs Tariff Lines Total weight including packaging (blank)
Net Weight Customs Tariff Lines Weight of goods only (blank)
Amount Customs Tariff Lines Declared value of the goods (blank)
Currency Code Customs Tariff Lines Currency of the declared amount (blank)
Average Unit Price Customs Tariff Lines Calculated: Amount ÷ Quantity (read-only) Auto-calculated
Type (Indentation) Customs Tariff Lines Line or Total — controls display grouping Line
Weight Unit of Measure Code Customs Tariff Lines The customs weight UOM applied to this line From setup default