Set up IOSS channel mapping
IOSS (Import One-Stop Shop) channel mapping allows you to automatically assign IOSS numbers to orders from specific sales channels. This feature helps ensure compliance with EU VAT requirements for imports.
Note: IOSS channel mapping is not available for BigCommerce. For Etsy or Amazon IOSS numbers, refer to their specific help articles.
How IOSS numbers are applied
The system applies IOSS numbers following this priority order:
Order/API upload - Uses the IOSS field in Extra Info if present.
Channel mapping - Uses the IOSS number from your channel mapping settings.
Connection field - Uses the IOSS field captured in channel-specific settings (such as Amazon).
Hardcoded value - Uses any hardcoded IOSS value in the system.
Client screen - Uses the IOSS number from the Edit Client screen.
The system checks each level in order and uses the first IOSS number it finds.
Before you begin
You must add IOSS mapping before orders import. For orders already imported, you'll need to add the IOSS number manually through the order's Extra Info section.
Enable IOSS permissions
First, ensure the relevant user accounts have IOSS mapping permissions:
Go to Settings then Warehouse User Accounts.
Click Actions then Manage Roles.
In the Admin-Super group, select:
AdminAddIOSSMapping.
AdminEditIOSSMapping.
AdminViewIOSSMapping.
Click Update.
Add IOSS mapping
To map an IOSS number to an order integration:
Go to Orders then IOSS Channel Mapping.
Click Add Mapping.
Complete the required fields (IOSS number holder, client details).
Turn the Active toggle to ON.
Click Add.
Add IOSS numbers manually
For orders already imported without an IOSS number:
Go to Orders then Overview.
Find your order.
Click Actions then Details.
Click History then ExtraInfo.
Select IOSS from the Name dropdown.
Enter the IOSS number in the Value field.
Click Add.