Using the IOSS Number

The IOSS number is required by your parcel carrier to help them to identify that the tax has been paid for the goods.

❗️

Warning

Do not share this number with anyone other than your parcel carrier.

❗️

Warning

You need to ensure that you are using the Production system.

❗️

Warning

You should not provide the service's IOSS number to your Parcel Carrier or use it in any way for transactions where Taxamo does not become VAT liable, as these transactions are not IOSS eligible and this would result in a false declaration.

For transactions where Taxamo is liable for tax, the IOSS number is returned in the response sent by the Confirm Transaction request. You can find it in the ioss_number field.

For example:

],
                "tax_liability_owner_code": "Taxamo",
                "line_num": 1,
                "is_seller_permanent": true,
                "quantity": 1,
                "ioss_number": "{IOSS_Number}",
                "invoice_capable": true,
                "total_amount": 21.95,
                "seller_code": "seller_jftest_1",
                "product_cn_code": "0305420000",
                "invoice_image_url_secret": "WTB8fOhp7g4XIMmI",
                "tax_entity_name": "France",
                "tax_supported": true
            }

Where {IOSS_Number} is the alphanumeric code that represents the IOSS number.

You send this number to your parcel carrier.