Configuring Customs
Customs gives store managers full control over how EU import duties are calculated, presented to customers and exported for customs declarations. This guide covers global settings, product-level attributes, paperwork generation and PRO features.
Global settings
Section titled “Global settings”Open WooCommerce > EU Import Duty to adjust store-wide parameters:
General calculation options
Section titled “General calculation options”- Enable duty estimate: Controls whether the calculation runs on front-end cart and checkout requests.
- Who pays the duty: Determines how customs duty is handled during purchase:
- Charge at checkout (DDP - Delivered Duty Paid): The duty fee is added directly to the customer’s total at checkout. The merchant collects the fee and pays import duties upon entry.
- Show as estimate outside total (DAP - Delivered at Place): Discloses the estimated duty to the customer without increasing the payable total. The customer pays charges directly to the delivery carrier or postal operator upon delivery.
- Absorb the duty internally: Calculates and logs the duty amount in the order details without presenting or charging it to the customer.
- Duty per tariff line (EUR): The statutory EU flat rate is 3 EUR per item/tariff line (Council Regulation (EU) 2026/382). You can adjust this amount if required.
- Goods-value threshold (EUR): Sets the maximum intrinsic value of qualifying goods in EUR (default: 150 EUR). The duty line only applies to orders whose goods total is at or below this value.
- Store currency per 1 EUR: The conversion rate used to translate EUR thresholds and duty amounts into your store’s native currency. In stores using EUR as the base currency, keep this set to 1.0.
Origin and geographic rules
Section titled “Origin and geographic rules”- Store origin country: The primary dispatch country for store orders. Import duty calculations apply only when this origin is outside the EU customs territory. Note that Ceuta and Melilla (Spanish territories outside the EU customs territory under Regulation (EU) No 952/2013) are treated as non-EU origins and destinations.
- Default country of origin: Fallback manufacturing country assigned to products that do not have an explicit country of origin set on their Shipping tab.
- Only apply duty between 1 July 2026 and 1 July 2028: When checked, the duty fee calculation is restricted to the statutory transitional window defined in Council Regulation (EU) 2026/382, Article 2.
Tariff line counting basis
Section titled “Tariff line counting basis”- Tariff line basis: Defines how distinct tariff lines in the cart are identified:
- One line per distinct product category (recommended): Groups items by their assigned product categories. Items sharing the same category count as a single tariff line unless explicit tariff codes or different countries of origin are defined.
- One line per distinct product: Treats each distinct catalog product as a separate tariff line. Variations of the same parent product are grouped together under the parent.
- Count a subcategory under the category it sits in: When enabled, child categories are consolidated under their top-level parent category for line counting.
- Product tariff code override: Regardless of the global basis setting, any product or variation with an explicit tariff code (
_customs_tariff_code) is always counted according to its normalized HS code.
Product Shipping tab settings
Section titled “Product Shipping tab settings”On each product edit screen, navigate to the Shipping tab to access item-specific customs options:
- Tariff code (HS): Enter a 6 to 10 digit Harmonized System classification code (e.g.,
6109.10.00). Codes are normalized (spaces, dots and hyphens stripped), so6109.10and610910are treated identically. - Country of origin: Select the manufacturing country. If two items in the cart share the same HS code but originate from different countries, they are counted as separate tariff lines in accordance with EU customs rules (Delegated Regulation (EU) 2015/2446, Article 1(61)).
- Outside the 3 EUR duty: Check this box for goods that qualify for preferential tariff measures (such as free trade agreements) when imported without IOSS. Flagged items and their variations are excluded from duty calculations.
- Customs description: Specify a precise goods description for commercial invoices and carrier manifests (e.g., “Men knitted cotton t-shirt”) while retaining customer-friendly marketing titles on the storefront. If left empty, the standard product title is used.
Customs paperwork and carrier export
Section titled “Customs paperwork and carrier export”Customs includes tools for generating international shipping paperwork directly from the WooCommerce order screen:
Store EORI number
Section titled “Store EORI number”Under WooCommerce > EU Import Duty, enter your store’s EORI number (Economic Operators Registration and Identification, UCC Regulation (EU) No 952/2013, Article 9). This identifier is automatically printed on commercial invoices and included in carrier data files.
Commercial Invoice and CN22 slip
Section titled “Commercial Invoice and CN22 slip”From any single order view or via the order list actions, click Print Customs Paperwork:
- Generates a print-ready Commercial Invoice and CN22 customs declaration formatted for standard A4 and thermal label printers.
- Includes sender and recipient addresses, EORI numbers, order currency, HS tariff codes, itemized quantities, net weights in kilograms, customs values and statutory legal declaration text.
Carrier CSV export
Section titled “Carrier CSV export”Store managers can export customs parcel data for logistics providers and postal carriers:
- Single order export: Download customs data from the order edit screen.
- Bulk export: Select multiple orders in the WooCommerce > Orders list and choose Export Carrier Customs CSV from the Bulk Actions menu.
- Spreadsheet security: Built-in formula injection defenses (CWE-1236) neutralize cells beginning with
=, +, -, @, \t, \rby prefixing them with a single quote to prevent spreadsheet execution vulnerabilities.
REST API integration
Section titled “REST API integration”Third-party logistics (3PL) providers, warehouse management systems (WMS) and ERP software can fetch structured customs data via the REST API:
- Endpoint:
GET /wp-json/customs/v1/orders/<order_id> - Access control: Gated to authenticated users with
edit_shop_ordersormanage_woocommercecapabilities. - Payload: Returns structured JSON containing order totals, EORI identifiers, itemized tariff lines, HS codes, weights and customs declarations.
Customs PRO features
Section titled “Customs PRO features”For expanding cross-border operations, Customs PRO adds advanced automation tools:
- Automated ECB exchange rates: Automatically fetches daily reference exchange rates from the European Central Bank via WP-Cron, ensuring currency conversions reflect official rates without manual maintenance.
- Bulk tariff code management: Edit HS codes across dozens of products simultaneously using WooCommerce bulk edit, or import and export HS codes using standard WooCommerce product CSV files.
- Monthly EU duty reporting: Access WooCommerce > EU Duty Report to inspect monthly breakdowns of assessed duties, destination EU countries, tariff line counts and order volumes, with one-click CSV export.