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.
Client's default IOSS value - If no other IOSS value is found, the system defaults to the client's default IOSS value.
The system checks each level in order and uses the first IOSS number it finds. If no IOSS value is found at any level, the system defaults to the client's default IOSS value.
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.
Important: Changes made to orders in integrated platforms (e.g., Shopify) after they are imported into Mintsoft do not sync back into Mintsoft. Any updates or corrections must be made directly within Mintsoft.
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. Note: If no IOSS value is found during import, you may need to manually add it following the steps above.