{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"International Orders","siteUrl":"https://developer.wineshipping.com/","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"international-orders","__idx":0},"children":["International Orders"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Wineshipping API supports international shipments via select carriers and services. This guide covers how to map international address fields — particularly for United Kingdom addresses — to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BillingContactInfo"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientContactInfo"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DeliveryContactInfo"]}," request objects."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"country-code","__idx":1},"children":["Country Code"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All contact address blocks accept an ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ISO 3166-1 alpha-3"]}," (3-letter) country code in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Country"]}," field."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The most commonly used international country codes are listed below, ranked by order volume:"]},{"$$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":"Destination"},"children":["Destination"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Country value"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Country"]}," value"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["United States"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["USA"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["United Kingdom"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GBR"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Japan"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["JPN"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Puerto Rico"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PRI"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Canada"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CAN"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["South Korea"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["KOR"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Hong Kong"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["HKG"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Singapore"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SGP"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For destinations not listed here, look up the 3-letter code in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3"},"children":["ISO 3166-1 alpha-3 reference"]}," or contact ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"mailto:api@wineshipping.com"},"children":["api@wineshipping.com"]}," to confirm support."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"international-address-mapping","__idx":2},"children":["International Address Mapping"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For all international (non-US/CA) addresses, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["State"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ZipCode"]}," must be left blank. Use the table below as a guide."]},{"$$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":"Address component"},"children":["Address component"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"API field"},"children":["API field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Notes"},"children":["Notes"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Building number + street"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Address"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["10 Downing Street"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Flat, floor, or suite"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Address2"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Town or city"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["City"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["London"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["State / Province"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["State"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Leave blank"]}," for international addresses. This field accepts US/CA 2-letter codes only (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maxLength: 2"]},")."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Postal / ZIP code"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ZipCode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Leave blank"]}," for international addresses. This field is for US/CA postal codes only."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Country"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Country"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ISO 3166-1 alpha-3 code, e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GBR"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Phone"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PhoneNumber"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Include the international dialling prefix, e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["+44 20 7925 0918"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"carrier-and-service-codes","__idx":3},"children":["Carrier and Service Codes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["International shipments require a carrier and service that supports the destination country. Contact Wineshipping to confirm which combinations are enabled for your account."]},{"$$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":"Carrier"},"children":["Carrier"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Service code"},"children":["Service code"]},{"$$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":["FEX"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INPR"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["FedEx International Priority"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a full list of carrier and service codes, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/codes/carriercodes"},"children":["Carrier Codes"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example---united-kingdom-retail-fedex-international-priority","__idx":4},"children":["Example - United Kingdom (Retail, FedEx International Priority)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["International — United Kingdom"]}," example in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/v3.1/openapi/fulfillment/createsalesorder"},"children":["CreateSalesOrder"]}," endpoint for a full request body."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Key fields at a glance:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"BillingContactInfo\": {\n    \"City\": \"London\",\n    \"State\": \"\",\n    \"ZipCode\": \"\",\n    \"Country\": \"GBR\"\n  },\n  \"ShipmentInfo\": {\n    \"ShippingCarrier\": \"FEX\",\n    \"ShippingCarrierService\": \"INPR\"\n  }\n}\n","lang":"json"},"children":[]}]},"headings":[{"value":"International Orders","id":"international-orders","depth":2},{"value":"Country Code","id":"country-code","depth":3},{"value":"International Address Mapping","id":"international-address-mapping","depth":3},{"value":"Carrier and Service Codes","id":"carrier-and-service-codes","depth":3},{"value":"Example - United Kingdom (Retail, FedEx International Priority)","id":"example---united-kingdom-retail-fedex-international-priority","depth":3}],"frontmatter":{"title":"International Orders","description":"How to submit orders shipping to international addresses, including country code reference and UK-specific field mapping guidance.","seo":{"title":"International Orders"}},"lastModified":"2026-07-07T15:29:16.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/internationalorders","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}