Upload duty tax invoices

How to upload carrier invoices to Zonos for duty and tax reconciliation

This guide outlines how to upload carrier invoices to the Zonos system for accurate duty and tax processing. By uploading invoices directly through the Zonos Dashboard, partners can ensure that duties and taxes billed by carriers are correctly reconciled with customer shipments.

Uploading your invoice

To upload a duty and tax invoice:

Log in to your Zonos Dashboard
Navigate to Invoices -> Duty Tax Invoices
Select the carrier format for your invoice file
Upload your invoice file in the supported format
The system will validate your file based on the selected format
View the status of your uploaded invoice

Note: This feature must be enabled on your account. Contact Zonos support if you don’t see this option in your Dashboard.

Supported formats & requirements

Zonos supports multiple invoice formats from major carriers, plus our own standard template format. Each format has specific requirements that must be followed for successful upload and processing.

Zonos invoice requirements

Field Name↕	Type↕	Required↕	Description↕
account_number	string	Yes	Required
invoice_number	string	Yes	Required
invoice_date	date	Yes	Must be a valid date
charge_amount	number	Yes	Must be a number
charge_type	enum	Yes	Must be a valid charge type
charge_description	string	Yes	Required
charge_currency_code	enum	Yes	Must be a valid currency code
due_date	date	Yes	Must be a valid date
carrier	string	Yes	Required
service_level	string	Yes	Required
tracking_number	string	Yes	Required
sender_name	string	Yes	Required
sender_company_name	string	No	Optional
sender_address_1	string	Yes	Required
sender_city	string	Yes	Required
sender_country	enum	Yes	Must be a valid country code
receiver_name	string	Yes	Required
receiver_company_name	string	No	Optional
receiver_address_1	string	Yes	Required
receiver_city	string	Yes	Required
receiver_country	enum	Yes	Must be a valid country code
commodity_part_number	string	No	Optional

UPS invoice requirements

Field Name↕	Type↕	Required↕	Description↕
version	string	Yes	Version is required
recipientnumber	string	Yes	Recipient number is required
accountnumber	string	Yes	Account number is required
accountcountry	enum	Yes	Must be a valid country code
invoicedate	date	Yes	Must be a valid date
invoicenumber	string	Yes	Invoice number is required
invoicetypecode	string	Yes	Invoice type code is required
invoicecurrencycode	enum	Yes	Must be a valid currency code
invoiceamount	number	Yes	Must be a number
transactiondate	date	Yes	Must be a valid date
leadshipmentnumber	string	Yes	Lead shipment number is required
billoptioncode	string	Yes	Bill option code is required
packagequantity	integer	Yes	Must be a positive integer
oversizequantity	integer	Yes	Must be a non-negative integer
trackingnumber	string	Yes	Tracking number is required
enteredweight	number	Yes	Must be a number
enteredweightunitofmeasure	string	Yes	Required
billedweight	number	Yes	Must be a number
billedweightunitofmeasure	string	Yes	Required
chargecategorycode	string	Yes	Required
chargedetailcode	string	Yes	Required
chargesource	string	Yes	Required
chargeclassificationcode	string	Yes	Required
chargedescriptioncode	string	Yes	Required
chargedunitquantity	number	Yes	Must be a number
basiscurrencycode	enum	Yes	Must be a valid currency code
basisvalue	number	Yes	Must be a number
transactioncurrencycode	enum	Yes	Must be a valid currency code
netamount	number	Yes	Must be a number
invoicelevelcharge	number	Yes	Must be a number
invoiceduedate	date	Yes	Must be a valid date
sendername	string	Yes	Required
sendercompanyname	string	No	Optional
senderaddressline1	string	Yes	Required
sendercity	string	Yes	Required
senderstate	string	Yes	Required
senderpostal	string	Yes	Required
sendercountry	enum	Yes	Must be a valid country code
receivername	string	Yes	Required
receivercompanyname	string	No	Optional
receiveraddressline1	string	Yes	Required
receivercity	string	Yes	Required
receiverstate	string	Yes	Required
receiverpostal	string	Yes	Required
receivercountry	enum	Yes	Must be a valid country code
shipmentdate	date	Yes	Must be a valid date
customsnumber	string	No	Optional
goodsdescription	string	Yes	Required
enteredvalue	number	Yes	Must be a number
dutyamount	number	Yes	Must be a number
weight	number	Yes	Must be a number
unitofmeasure	string	Yes	Required
itemquantity	integer	Yes	Must be a positive integer
itemquantityunitofmeasure	string	Yes	Required
dutyrate	number	Yes	Must be a number
vatbasisamount	number	Yes	Must be a number
vatamount	number	Yes	Must be a number
vatrate	number	Yes	Must be a number
storeid	string	No	Optional

FedEx invoice requirements

Field Name↕	Type↕	Required↕	Description↕
bill_to_account_number	string	Yes	Required
invoice_date	date	Yes	Must be a valid date
invoice_number	string	Yes	Required
original_amount_due	number	Yes	Must be a number
current_balance	number	Yes	Must be a number
payor	string	Yes	Required
express_or_ground_tracking_id	string	Yes	Required
transportation_charge_amount	number	No	Optional
net_charge_amount	number	Yes	Must be a number
shipment_date	date	Yes	Must be a valid date
pod_delivery_date	date	No	Optional
pod_delivery_time	string	No	Optional
actual_weight_amount	number	Yes	Must be a number
actual_weight_units	string	Yes	Required
rated_weight_amount	number	No	Optional
rated_weight_units	string	No	Optional
number_of_pieces	integer	Yes	Must be an integer
service_packaging	string	Yes	Required
recipient_name	string	Yes	Required
recipient_address_line1	string	Yes	Required
recipient_city	string	Yes	Required
recipient_state	string	Yes	Required
recipient_zip_code	string	Yes	Required
recipient_country_territory	enum	Yes	Must be a valid country code
shipper_company	string	No	Optional
shipper_address_line1	string	Yes	Required
shipper_city	string	Yes	Required
shipper_state	string	Yes	Required
shipper_zip_code	string	Yes	Required
shipper_country_territory	enum	Yes	Must be a valid country code
original_customer_reference	string	No	Optional
zone_code	string	No	Optional
cost_allocation	string	No	Optional
customs_value	number	No	Optional
customs_value_currency_code	enum	No	Optional
declared_value	number	No	Optional
declared_value_currency_code	enum	No	Optional
commodity_description	string	No	Optional
commodity_country_territory_code	enum	No	Optional
rated_method	string	No	Optional
sort_hub	string	No	Optional
mps_package_id	string	No	Optional

DHL invoice requirements

Field Name↕	Type↕	Required↕	Description↕
invoice_number	string	Yes	Required
tracking_number	string	Yes	Required
invoice_date	date	Yes	Must be a valid date
due_date	date	Yes	Must be a valid date
shipment_date	date	Yes	Must be a valid date
ship_from_company	string	No	Optional
ship_from_name	string	Yes	Required
ship_from_line1	string	Yes	Required
ship_from_city	string	Yes	Required
ship_from_postal_code	string	Yes	Required
ship_to_company	string	No	Optional
ship_to_name	string	Yes	Required
ship_to_line1	string	Yes	Required
ship_to_city	string	Yes	Required
ship_to_postal_code	string	Yes	Required
currency_code	enum	Yes	Must be a valid currency code
amount	number	Yes	Must be a number
billing_account	string	Yes	Required
billing_country	enum	Yes	Must be a valid country code
billing_account_name	string	Yes	Required
billing_address1	string	Yes	Required
billing_postcode	string	Yes	Required
billing_city	string	Yes	Required
billing_state	string	Yes	Required
billing_country1	enum	Yes	Must be a valid country code
product	string	Yes	Required
pieces	integer	Yes	Must be a positive integer
origin	string	Yes	Required
destination	string	Yes	Required
total_amount	number	Yes	Must be a number
xc1_code	string	Yes	Required
xc1_charge	number	Yes	Must be a number
created_at	date	Yes	Must be a valid date

You can download templates for each format in the Upload Invoice modal by clicking the Download button next to the carrier name.

Make sure your file matches the selected format. The system will validate the file and display any errors if the format does not align.

Invoice statuses

After uploading an invoice, you'll see one of the following statuses:

Status↕	Description↕
Pending	The invoice has been uploaded but not yet processed
Processing	The invoice is currently being validated and processed
Completed	The invoice has been successfully processed and added to the system
Failed	The invoice could not be processed due to validation errors
Duplicate	The invoice has already been uploaded and processed

If an invoice fails processing, you'll receive detailed error information to help correct the issues.

Book a demo

Upload duty tax invoices

Uploading your invoice

Supported formats & requirements

Invoice statuses

Was this page helpful?