{"templateId":"markdown","versions":[{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/shipstation-v2/docs/shipping/international","default":true,"active":false,"folderId":"58c9a61d"},{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/shipping/international","default":false,"active":true,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/shipping/international","default":false,"active":false,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@shipengine/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"International Shipments","keywords":"shipping, labels, shipstation, documentation, api","siteUrl":"https://docs.shipstation.com","lang":"en-US","llmstxt":{"hide":false,"title":"ShipStation API LLM Docs","description":"Find links and references to all markdown documentation for use with LLMs","excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"international-shipments","__idx":0},"children":["International Shipments"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To ship internationally, your package will be required to go through customs in the destination country. For your shipment to effectively pass through customs, include all the required data for customs declarations in your ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/shipping/create-a-shipment"},"children":["create shipment request"]}," and ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/labels/create-a-label"},"children":["create label request"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"requirements","__idx":1},"children":["Requirements"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["International shipments must include the required properties for the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customs"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["products"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tax_identifiers"]}," objects. You may also need to add specific details like ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["harmonized_tarrif_code"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vat_rate"]}," to each of the products in your shipment."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Specific properties may be required depending on which countries you are shipping to and which carriers you are using. Be sure to check with your carrier and customs authority if you are uncertain what details you need to include with your shipments."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"customs-object-properties","__idx":2},"children":["Customs Object Properties"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Property"},"children":["Property"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contents"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["enumerated string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The contents of the shipment. Valid values include: ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["gift"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchandise"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["returned_goods"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["documents"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sample"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["other"]}," - The package contains something other than the items listed above."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contents_explanation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Explanation for contents (required if the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contents"]}," is set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["other"]}," )."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["non_delivery"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["enumerated string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Indicates what should be done if the shipment cannot be delivered. Valid values include: ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["treat_as_abandoned"]},"  ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["return_to_sender"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["terms_of_trade_code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["enumerated string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the supported terms of trade code (incoterms). Valid values include: ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["exw"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fca"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cpt"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cip"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dpu"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dap"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ddp"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fas"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fob"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cfr"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cif"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ddu"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["daf"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deq"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["des"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["declaration"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Declaration statement to be placed on the commercial invoice."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invoice_additional_details"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["object"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The additional information to put on a commercial invoice. See the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://shipengine.github.io/shipengine-openapi/#operation/create_shipments"},"children":["full API Reference"]}," for object fields."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["importer_of_record"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["object"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The importer of records' address, anywhere in the world. See the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://shipengine.github.io/shipengine-openapi/#operation/create_shipments"},"children":["full API Reference"]}," for object fields."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customs_items"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array of objects"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Deprecated"]}," - please provide this information in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["products"]}," property inside Packages. ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," Customs declarations for each item in the shipment. ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," See the Products section for details about which fields to include."]}]}]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["NOTE:"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"deprecated-the-customs_items-object","__idx":3},"children":["Deprecated: The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customs_items"]}," Object"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["As of ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["July 31, 2023"]},", the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customs_items"]}," object has been deprecated. All properties for customs items should now be added to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["products"]}," object, which also includes 3 additional fields not previously available for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customs_items"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["While we will continue to support ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customs_items"]}," temporarily, you cannot use both  ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customs_items"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["products"]}," in your create shipment request. Your request can only contain one of them."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"products-object","__idx":4},"children":["Products Object"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you request an international shipping label, you are ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["required"]}," to send ShipStation API a list of that shipment's contents, along with their declared values. The following table describes the properties available."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Property"},"children":["Property"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["description"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["<= 100 characters, Nullable ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," A short description of the item in this package."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["value"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["object"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The declared value of ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["each"]}," item. ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," Object includes 2 properties: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["value.currency"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ShipStation API supports those ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.iso.org/iso-4217-currency-codes.html"},"children":["currencies specified by ISO 4217"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["value.amount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["number"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The monetary amount, in the specified currency."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["weight"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["object"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The item weight. Object includes 2 properties:  ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["value"]},"  and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unit"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["weight.value"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["number"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The weight, in the specified unit."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["weight.unit"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["enumerated string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The possible weight unit values. Valid values are: ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"  ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pound"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ounce"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["gram"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["kilogram"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["harmonized_tariff_code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Nullable ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," The Harmonization Codes, as standardized by the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.wcoomd.org/en/topics/nomenclature/overview/what-is-the-harmonized-system.aspx"},"children":["World Customs Organization"]},". See the Harmonization Codes section below for more information."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country_of_origin"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Nullable ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," The 2-character country code as it corresponds to ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2"},"children":["ISO 3166-1 alpha-2"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unit_of_measure"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Nullable ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," The possible dimensions unit values."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sku"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Nullable ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," The ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://en.wikipedia.org/wiki/Stock_keeping_unit"},"children":["Stock Keeping Unit (SKU)"]}," for this item. This value must be between 1 and 20 characters. ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," Required only by some carriers."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sku_description"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Nullable ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," A description of the SKU."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mid_code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Nullable ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," Manufacturers Identification code."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["product_url"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Nullable ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," Link to the item on the seller website."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vat_rate"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Nullable ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," VAT rate applicable to the item."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"tax-identifiers-object","__idx":5},"children":["Tax Identifiers Object"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ShipStation API supports adding tax IDs to your shipment to comply with current international shipping requirements. Note that the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tax_identifiers"]}," object exists inside the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shipments"]}," object, so you will need to take this into account when creating both ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/shipping/create-a-shipment"},"children":["shipments"]}," and ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/labels/create-a-label"},"children":["labels"]},"."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Property"},"children":["Property"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["taxable_entity_type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["enumerated string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The taxable entity type for this tax item. Valid values include: ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shipper"]}," - The shipper is responsible for this tax. ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["recipient"]}," - The recipient of the shipment is responsible for this tax. ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ior"]}," - The importer of record is responsible for the tax."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["identifier_type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["enumerated string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The tax identifier type. Valid values include: ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vat"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eori"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ssn"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ein"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tin"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ioss"]},"  ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pan"]},"  ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["voec"]},"  ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pccc"]},"  ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["oss"]},"  ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["passport"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["abn"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ukims"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["value"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The actual tax id number."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["issuing_authority"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✔"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The authority that issued this tax. This must be a valid 2-character ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2"},"children":["ISO 3166 Alpha 2"]}," country code."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"downloading-forms","__idx":6},"children":["Downloading Forms"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Any forms you will need to include with your shipment will be in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["form_download"]}," object. In some cases, the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["form_download"]}," object will be empty, as is the case with electronic submissions or carriers that print customs details directly on the label (like USPS)."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["When shipping with UPS, FedEx, or DHL Express, ShipStation API can electronically submit your forms to the carrier."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["When using USPS, your customs forms print with your label rather than as separate documents."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For other carriers, you will need to download and print any generated files and include them in your shipment."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-request--response","__idx":7},"children":["Example Request & Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Now that you understand the objects required for international shipping, we can drop those into a basic label request by adding a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["products"]}," object, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customs"]}," object, and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tax_identifiers"]}," object."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["POST /v1/labels"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v1/labels HTTP/1.1\nHost: api.shipengine.com\nAPI-Key: __YOUR_API_KEY_HERE__\nContent-Type: application/json\n\n{\n  \"shipment\": {\n    \"service_code\": \"usps_priority_mail_international\",\n    \"ship_from\": {\n        \"company_name\": \"Example Corp.\",\n        \"name\": \"John Doe\",\n        \"phone\": \"111-111-1111\",\n        \"email\": \"sender@example.com\",\n        \"address_line1\": \"4301 Bull Creek Rd Ste. 300\",\n        \"city_locality\": \"Austin\",\n        \"state_province\": \"TX\",\n        \"postal_code\": \"78731\",\n        \"country_code\": \"US\",\n        \"address_residential_indicator\": \"no\"\n    },\n    \"ship_to\": {\n      \"name\": \"John Doe\",\n      \"company_name\": \"Example Corp\",\n      \"address_line1\": \"Röntgenstr. 3\",\n      \"city_locality\": \"Esslingen am Neckar\",\n      \"state_province\": \"Stuttgart\",\n      \"postal_code\": \"73730\",\n      \"country_code\": \"DE\",\n      \"phone\": \"5555555555\",\n      \"email\": \"recipient@example.com\"\n    },\n    \"packages\": [\n      {\n        \"content_description\": \"Dog Toys\",\n        \"products\": [\n          {\n            \"quantity\": 4,\n            \"value\": {\n              \"currency\": \"usd\",\n              \"amount\": 75\n            },\n            \"sku\": \"4225-776-3234\",\n            \"sku_description\": \"Rubber-Ball\",\n            \"harmonized_tariff_code\": \"4016.99.20\",\n            \"country_of_origin\": \"US\",\n            \"description\": \"Pet Chew Toy\",\n            \"product_url\": \"https://tinyurl.com/adorable-womabt\",\n            \"mid_code\": \"123456\",\n            \"vat_rate\": 0.02,\n            \"weight\": {\n              \"value\": 1,\n              \"unit\": \"ounce\"\n            }\n          },\n          {\n            \"quantity\": 2,\n            \"value\": {\n              \"currency\": \"usd\",\n              \"amount\": 100\n            },\n            \"sku\": \"3001-776-3234\",\n            \"sku_description\": \"Tug-of-War-Rope\",\n            \"harmonized_tariff_code\": \"6307.90.75\",\n            \"country_of_origin\": \"US\",\n            \"description\": \"Cotton Pet Chew Toy\",\n            \"product_url\": \"https://tinyurl.com/adorable-womabt\",\n            \"mid_code\": \"123456\",\n            \"vat_rate\": null,\n            \"weight\": {\n              \"value\": 2,\n              \"unit\": \"ounce\"\n            }\n          }\n        ],\n        \"package_id\": \"se-3\",\n        \"package_code\": \"package\",\n        \"weight\": {\n          \"value\": 9.6,\n          \"unit\": \"ounce\"\n        },\n        \"dimensions\": {\n          \"unit\": \"inch\",\n          \"length\": 10.0,\n          \"width\": 8.0,\n          \"height\": 8.0\n        },\n        \"insured_value\": {\n          \"currency\": \"usd\",\n          \"amount\": 0\n        },\n      }\n    ],\n    \"customs\": {\n      \"contents\": \"merchandise\",\n      \"non_delivery\": \"treat_as_abandoned\",\n      \"terms_of_trade_code\": \"DDP\",\n      \"declaration\": \"I hereby certify that the information on this invoice is true and correct and the contents and value of this shipment is as stated above.\",\n    },\n    \"tax_identifiers\": [\n      {\n      \"taxable_entity_type\": \"shipper\",\n      \"identifier_type\": \"eori\",\n      \"value\": \"GB987654312000\",\n      \"issuing_authority\": \"GB\"\n      }\n    ]\n  }\n}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example Response"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Note that the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customs"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["products"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tax_identifier"]}," objects are not returned in the response. Any customs forms and commercial invoices you need to print will be returned in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["form_download"]}," object. In this example, since it uses a USPS service, the customs details are printed directly on the label, so no additional forms are returned."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"label_id\": \"se-120659535\",\n    \"status\": \"completed\",\n    \"shipment_id\": \"se-236919990\",\n    \"ship_date\": \"2022-01-04T00:00:00Z\",\n    \"created_at\": \"2022-01-04T19:34:43.6076942Z\",\n    \"shipment_cost\": {\n        \"currency\": \"usd\",\n        \"amount\": 60.18\n    },\n    \"insurance_cost\": {\n        \"currency\": \"usd\",\n        \"amount\": 0.0\n    },\n    \"tracking_number\": \"LX678657357US\",\n    \"is_return_label\": false,\n    \"rma_number\": null,\n    \"is_international\": true,\n    \"batch_id\": \"\",\n    \"carrier_id\": \"se-121493\",\n    \"service_code\": \"usps_priority_mail_international\",\n    \"package_code\": \"package\",\n    \"voided\": false,\n    \"voided_at\": null,\n    \"label_format\": \"pdf\",\n    \"display_scheme\": \"label\",\n    \"label_layout\": \"4x6\",\n    \"trackable\": false,\n    \"label_image_id\": null,\n    \"carrier_code\": \"stamps_com\",\n    \"tracking_status\": \"unknown\",\n    \"label_download\": {\n        \"pdf\": \"https://api.shipengine.com/v1/downloads/10/79vVrg0ovkSgviVkZS1csg/label-120659535.pdf\",\n        \"png\": \"https://api.shipengine.com/v1/downloads/10/79vVrg0ovkSgviVkZS1csg/label-120659535.png\",\n        \"zpl\": \"https://api.shipengine.com/v1/downloads/10/79vVrg0ovkSgviVkZS1csg/label-120659535.zpl\",\n        \"href\": \"https://api.shipengine.com/v1/downloads/10/79vVrg0ovkSgviVkZS1csg/label-120659535.pdf\"\n    },\n    \"form_download\": null,\n    \"insurance_claim\": null,\n    \"packages\": [\n        {\n            \"package_id\": 127260247,\n            \"package_code\": \"package\",\n            \"weight\": {\n                \"value\": 4.00,\n                \"unit\": \"pound\"\n            },\n            \"dimensions\": {\n                \"unit\": \"inch\",\n                \"length\": 0.0,\n                \"width\": 0.0,\n                \"height\": 0.0\n            },\n            \"insured_value\": {\n                \"currency\": \"usd\",\n                \"amount\": 0.00\n            },\n            \"tracking_number\": \"LX678657357US\",\n            \"label_messages\": {\n                \"reference1\": null,\n                \"reference2\": null,\n                \"reference3\": null\n            },\n            \"external_package_id\": null,\n            \"sequence\": 1\n        }\n    ],\n    \"charge_event\": \"carrier_default\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your label and customs forms can be found by going to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_download.href"]}," and",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[" links.form_download"]}," in the response, respectively."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"shipping-from-us-to-canada","__idx":8},"children":["Shipping from US to Canada"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you ship from the US to Canada using USPS First-Class Mail International, Priority Mail International, or Priority Mail Express International, you have the option to create a Delivered Duty Paid (DDP) shipment."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you create a DDP shipment, you will be charged a flat fee to pay duties or taxes in advance so that your recipient does not have to pay them upon delivery. The fee is $9.95 for all eligible services."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To use the pre-pay DDP option, add an ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/carriers/advanced-options"},"children":["advanced option"]}," object to your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shipment"]}," object with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canada_delivered_duty"]}," property set to \"sender_prepay\"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"shipment\":{\n      \"advanced_options\": {\n        \"canada_delivered_duty\":\"sender_prepay\"\n    },\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example Response"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The flat fee will display in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["other_amount"]}," field of the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rate_response"]}," object. (This response is truncated to more easily demonstrate the relevant property.)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"rate_response\": {\n    \"rates\": [\n      {\n        \"rate_id\": \"se-2095723696\",\n        \"rate_type\": \"shipment\",\n        \"carrier_id\": \"se-3377959\",\n        \"shipping_amount\": {\n          \"currency\": \"usd\",\n          \"amount\": 14.11\n        },\n        \"insurance_amount\": {\n          \"currency\": \"usd\",\n          \"amount\": 0.0\n        },\n        \"confirmation_amount\": {\n          \"currency\": \"usd\",\n          \"amount\": 0.0\n        },\n        \"other_amount\": {\n          \"currency\": \"usd\",\n          \"amount\": 9.9500\n        },\n      \"rate_details\": []\n      }\n    ],\n    \"billing_source\": \"Carrier\",\n    \"rate_request_id\": \"se-301944927\",\n    \"shipment_id\": \"se-458174406\",\n    \"created_at\": \"2022-11-04T20:45:30.2987928Z\",\n    \"status\": \"completed\",\n    \"errors\": []\n  },\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"shipping-to-and-from-mexico","__idx":9},"children":["Shipping to and from Mexico"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Mexican government requires all shipments to, from, and within Mexico to include a Bill of Lading Complement (Complemento Carta Porte). The Bill of Lading must include package-level merchandise descriptions, which are separate from traditional customs item information requirements."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To create a Bill of Lading with your shipping label and other customs documents, include the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["content_description"]}," property in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["packages"]}," object of your label request."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more information about the Carta Porte requirement, visit the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"http://omawww.sat.gob.mx/cartaporte/Paginas/default.htm"},"children":["Gobierno de México Servicio de Administración Tributaria page"]}," (Español) or the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.trade.gov/market-intelligence/mexico-new-invoicing-requirements-and-obligations-carta-porte"},"children":["US International Trade Administration's Carta Porte page"]}," (English)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-packages-object","__idx":10},"children":["Example Packages Object"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"packages\": [\n    {\n      \"content_description\": \"Dog Toys\",\n      \"products\": []\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"shipping-to-the-eu","__idx":11},"children":["Shipping to the EU"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All shipments to and passing through most countries in the EU require Harmonization Codes to be included on customs forms with accurate descriptions of the package contents."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This means that descriptions such as \"Clothes\" will not be accepted. Instead, more detailed descriptions such as \"Men's Cotton Shirt\" or \"Women's Leather Shoes\" are required."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Learn more about the Harmonization Code requirement from the following resources:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://blog.stamps.com/2023/02/24/new-harmonized-code-requirement/"},"children":["Stamps.com Blog: New Harmonized Code Requirement Coming March 1"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.usps.com/international/new-eu-customs-rules.htm"},"children":["USPS.com: New Customs Requirements for Packages to European Union (EU) Countries"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"shipping-to-northern-ireland","__idx":12},"children":["Shipping to Northern Ireland"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For merchants shipping from Great Britain to Northern Ireland, see our page to learn how to ship in accordance with the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/shipping/windsor-framework"},"children":["Windsor Framework"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"shipping-to-new-zealand-low-value-goods-lvg-levy","__idx":13},"children":["Shipping to New Zealand: Low Value Goods (LVG) Levy"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.customs.govt.nz/customs-information-and-legislation/goods-clearance-fees/goods-fees-2026-changes"},"children":["New Zealand Customs and the Ministry for Primary Industries (MPI)"]}," are overhauling how they charge for border clearance, replacing old \"goods fees\" with new \"goods management levies.\" For e-commerce, the biggest shift is the end of consolidated reporting subsidies."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["As of April 1st, 2026"]},", low-value parcels shipped into New Zealand will attract a mandatory border levy ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["per consignment"]},"."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How much is the new levy for low-value e-commerce orders?"]}," ","For standard e-commerce air freight, the new Low-Value Goods (LVG) import levy is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["NZD $2.21 plus GST"]}," per consignment. This is a combined fee made up of a Customs levy ($1.46) and an MPI biosecurity levy ($0.75). If you ship via sea freight, the combined levy is slightly lower at NZD $2.09 plus GST."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Is this fee charged per item (like the EU) or per package?"]}," ","Unlike the upcoming EU regulations that charge based on item categories (HS codes), the New Zealand levy is much simpler. It is charged ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["per consignment"]}," (specifically, per low-value customs declaration). If your NZ customer orders three different items shipped in the same box, it only attracts a single NZD $2.21 levy."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What is considered a \"low-value\" good in New Zealand?"]}," ","New Zealand defines low-value consignments as those with a total customs value of ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["NZD $1,000"]}," or less. Anything above this threshold triggers a formal import entry."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Does this apply if I use standard postal mail (like Australia Post)?"]}," ","Yes, but the billing structure is different. For goods arriving via the Universal Postal Union (UPU) mail stream, New Zealand is introducing an ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Import UPU mail levy of NZD $1.28 plus GST per kilogram"]},". This will be billed directly to the postal carriers, meaning you will likely see this cost passed down to you in the form of increased standard international postage rates."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Who actually pays this new $2.21 levy?"]}," ","Legally, the levy is billed to the entity submitting the customs declaration—typically your freight forwarder, express courier (like DHL or FedEx), or broker. However, they will absolutely pass this cost along. You need to check with your logistics provider immediately to see if they will bill this back to you (the retailer) as a line-item surcharge, bake it into your base shipping rates, or pass it to the consumer upon delivery."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Does this replace the New Zealand GST I already collect?"]}," ","No. If your business sells more than NZD $60,000 annually to New Zealand consumers, you are still legally required to collect 15% GST at your online checkout. This new $2.21 levy is strictly a border management and biosecurity screening fee, completely separate from your GST obligations."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What happens if a customer's order is over NZD $1,000?"]}," ","Consignments over NZD $1,000 are classified as \"high-value\" and have entirely different rules. Under the new April 2026 fee structure, a high-value air import will attract a hefty combined Customs and MPI levy of ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["NZD $51.81"]},". Traditionally, the NZ consumer is responsible for paying this (along with import duties and GST) before the package is released, unless you deliberately ship Delivered Duty Paid (DDP) for high-value carts."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Why is the New Zealand Government doing this?"]}," ","The explosion of cross-border e-commerce has put a massive strain on NZ Customs and biosecurity screeners. Previously, low-value goods were largely subsidised by the taxpayer because they were cleared in bulk cargo reports. The government is implementing these levies to ensure full, fair cost-recovery directly from the shipments creating the workload."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["With the change happening next month, what must I do right now?"]}]}]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Forecast the hit"]},": Pull your New Zealand order volume from the last 12 months and multiply it by NZD $2.21 to understand your exact margin exposure."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Call your shipping rep"]},": Ask your couriers and freight forwarders exactly how this levy will appear on your April invoices."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Adjust pricing"]},": Decide whether you will absorb this cost, incrementally raise your retail prices for the NZ market, or bump up your flat-rate shipping fee to cover the difference."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you require further support or need assistance, please contact our local support team: ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["support@shipstation.com.au"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"international-shipping-faq","__idx":14},"children":["International Shipping FAQ"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What are Harmonization Codes?"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The purpose of a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Harmonization Code"]}," (also referred to as ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Tariff Codes"]},", ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Customs Tariffs"]},", ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Harmonized Tariff Codes"]},", and ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Harmonized System Codes"]}," or ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["HS Codes"]},") is to expedite the delivery of international shipments. The system of codes for your goods is a universal economic language used to trade merchandise that is shipped internationally and assess taxes."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once an order reaches an international border, the Harmonization Codes help the customs office to identify what it is you are shipping. We recommend that you list and properly identify your Harmonization Codes at the time of label creation."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a full list of Harmonization Codes, use the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://hts.usitc.gov/"},"children":["Harmonized Tariff Schedule search"]},"."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["IMPORTANT: USPS International Shipping Update - HS Codes Required"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["As of ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["September 1, 2025"]},", the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://about.usps.com/postal-bulletin/2025/pb22682/pb22682.pdf"},"children":["U.S. Postal Service will require"]}," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["all international commercial shipments"]}," to include a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.trade.gov/harmonized-system-hs-codes"},"children":["six-digit Harmonized System (HS) code"]}," on customs declarations ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["for each item"]},", regardless of mail class."," ","The HS code system, created by the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.wcoomd.org/en/topics/nomenclature/overview/what-is-the-harmonized-system.aspx"},"children":["World Customs Organization"]},", is used by customs authorities worldwide to classify goods and assess tariffs. This update aligns USPS mailing standards with new ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Universal Postal Union (UPU) regulations"]},", also taking effect Sept 1, requiring all member countries to enforce six-digit HS codes for commercial goods."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Does ShipStation API print USMCA forms for international shipments?"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Currently, ShipStation API does not receive USMCA forms (formerly called NAFTA forms) from carriers for international shipments. If you'd like to include a USMCA form with a shipment, you must download and fill out the form outside of ShipStation API."]}]},"headings":[{"value":"International Shipments","id":"international-shipments","depth":1},{"value":"Requirements","id":"requirements","depth":2},{"value":"Customs Object Properties","id":"customs-object-properties","depth":3},{"value":"Deprecated: The customs_items Object","id":"deprecated-the-customs_items-object","depth":3},{"value":"Products Object","id":"products-object","depth":3},{"value":"Tax Identifiers Object","id":"tax-identifiers-object","depth":3},{"value":"Downloading Forms","id":"downloading-forms","depth":2},{"value":"Example Request & Response","id":"example-request--response","depth":2},{"value":"Shipping from US to Canada","id":"shipping-from-us-to-canada","depth":2},{"value":"Shipping to and from Mexico","id":"shipping-to-and-from-mexico","depth":2},{"value":"Example Packages Object","id":"example-packages-object","depth":3},{"value":"Shipping to the EU","id":"shipping-to-the-eu","depth":2},{"value":"Shipping to Northern Ireland","id":"shipping-to-northern-ireland","depth":2},{"value":"Shipping to New Zealand: Low Value Goods (LVG) Levy","id":"shipping-to-new-zealand-low-value-goods-lvg-levy","depth":2},{"value":"International Shipping FAQ","id":"international-shipping-faq","depth":2}],"frontmatter":{"seo":{"title":"International Shipments"}},"lastModified":"2026-04-08T10:47:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/shipengine/docs/shipping/international","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}