Commercial Invoice Requirements

For international orders, MasonHub relies on your API payload to create compliant commercial invoices that meet customs requirements. Proper commercial invoice data is essential for smooth international shipping and customs clearance.

​

Overview

Commercial invoices are legal documents required for international shipments that provide customs authorities with details about the goods being shipped, their value, and origin.

​

Required Order-Level Fields

When creating international orders, include these mandatory fields in your API payload:

​

Currency and Pricing Fields

​

Calculation Formula

total_price = total_line_items_price - total_discounts

​

Required Line Item Fields

Each line item in international orders must include:

​

Pricing Information

​

Example International Order Payload

{
  "order": {
    "external_id": "INTL-ORDER-12345",
    "currency_code": "USD",
    "total_line_items_price": 185.00,
    "total_discounts": 15.00,
    "total_price": 170.00,
    "shipping_address": {
      "name": "Jean Dupont",
      "street": "123 Rue de la Paix",
      "city": "Paris",
      "state": "Île-de-France",
      "zip": "75001",
      "country": "FR"
    },
    "line_items": [
      {
        "sku": "PRODUCT-001",
        "quantity": 2,
        "price": 50.00,
        "name": "Premium Widget",
        "description": "High-quality widget for industrial use"
      },
      {
        "sku": "PRODUCT-002", 
        "quantity": 1,
        "price": 85.00,
        "name": "Professional Gadget",
        "description": "Professional-grade electronic gadget"
      }
    ]
  }
}

​

Additional International Considerations

​

Product Information

Ensure your SKUs include international-specific data:

​

Restricted Items

Common restrictions include:

• Electronics with certain frequencies
• Food and agricultural products
• Pharmaceuticals and medical devices
• Weapons and military equipment
• Cultural artifacts

​

Currency Considerations

​

Supported Currencies

MasonHub supports major international currencies. Common options include:

​

Exchange Rate Handling

• Use the currency the customer was charged in
• Ensure consistency across all monetary fields
• Consider exchange rate fluctuations for multi-day processing

​

Customs Documentation

​

Commercial Invoice Content

The commercial invoice generated by MasonHub will include:

​

Additional Documents

Depending on the destination and products, additional documentation may be required:

• Certificate of Origin: For preferential duty rates
• Export Licenses: For controlled goods
• Product Certifications: For regulated products
• Insurance Documentation: For high-value shipments

​

Compliance Best Practices

​

Data Accuracy

​

Record Keeping

Maintain records of:

• Original order values and currency
• Exchange rates used
• Discount calculations
• Product classifications
• Shipping documentation

​

Testing International Orders

​

Sandbox Testing

​

Common Issues & Solutions

{
  "currency_code": "USD",
  "total_price": 150.00
}

{
  "quantity": 3,
  "price": 25.00  // Unit price, not 75.00
}

{
  "total_line_items_price": 200.00,
  "total_discounts": 20.00,
  "total_price": 180.00
}

​

API Reference

​

Support for International Shipping

For questions about international shipping requirements or commercial invoice setup:

​

Next Steps

After configuring international order support, proceed to production readiness to prepare for launch.