Xportcn KA client
  1. Warehouse logistics
Xportcn KA client
  • English version
    • API Reference
      • Basics
        • Get user address information
        • Address added and updated
      • Warehouse logistics
        • Please refer to the estimated overseas freight
          POST
        • Order overseas freight preview
          POST
        • Create international logistics orders
          POST
        • Update domestic logistics information
          POST
      • KA
        • Interface description flowchart
        • AlibabaProduct
          • AlibabaProductKeywordsQuery
          • AlibabaProductImageQuery
          • AlibabaProductCategory
          • AlibabaProductDetail
          • AlibabaProductFreightEstimateGet
          • AlibabaProductPoolList
        • AlibabaOrderController
          • Order list
          • Order Preview (The preview interface needs to be called before creating an order)
          • Create an order
          • Get order details
      • wms
        • Package forecasting
        • package inbound
        • package update
    • Product Documentation
      • Announcement
      • Summarize
      • Beginner's guide
        • Become a developer
        • Obtain the Access Key and Access key
        • Start development
      • API tutorial
        • Development manual
        • Error code
      • Message service access
        • Message access manual
      • Account test
        • 1688 Test account
      • Q&A
        • Merchandise store search screening
  1. Warehouse logistics

Create international logistics orders

POST
/open/pp/logistics/orderBookingFreight

Request

Query Params

Body Params application/json

Example
{
    "renderId": "FF2024080200007",
    "tmallOrderInfo": {
        "tmallOrderId": "123123444"
    },
    "receiverAddress": {
        "country": "US",
        "state": "California",
        "city": "VALLEY VLG",
        "zip": "91607",
        "address": "5818 WHITSETT AVE 401",
        "name": "Ofir Birinbaum",
        "phone": "5083326888",
        "mobilePhone": "5083326888",
        "email": "1229220680@qq.com"
    },
    "lineItems": [
        {
            "itemId": "2048020617114736",
            "skuId": "413185732720",
            "quantity": 1,
            "title": "这是商品1",
            "imageUrl":"url",
            "freightInfo": {
                "serviceId": "1",
                "companyName": "",
                "serviceCategory": ""
            }
        },
        {
            "itemId": "2048232789087639",
            "skuId": "4970432383383",
            "quantity": 2,
            "title": "这是商品2",
            "imageUrl":"url",
            "freightInfo": {
                "serviceId": "2",
                "companyName": "",
                "serviceCategory": ""
            }
        }
    ]
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://www.xportcn.com/api/open/pp/logistics/orderBookingFreight?timestamp&sign' \
--header 'Content-Type: application/json' \
--data-raw '{
    "renderId": "FF2024080200007",
    "tmallOrderInfo": {
        "tmallOrderId": "123123444"
    },
    "receiverAddress": {
        "country": "US",
        "state": "California",
        "city": "VALLEY VLG",
        "zip": "91607",
        "address": "5818 WHITSETT AVE 401",
        "name": "Ofir Birinbaum",
        "phone": "5083326888",
        "mobilePhone": "5083326888",
        "email": "1229220680@qq.com"
    },
    "lineItems": [
        {
            "itemId": "2048020617114736",
            "skuId": "413185732720",
            "quantity": 1,
            "title": "这是商品1",
            "imageUrl":"url",
            "freightInfo": {
                "serviceId": "1",
                "companyName": "",
                "serviceCategory": ""
            }
        },
        {
            "itemId": "2048232789087639",
            "skuId": "4970432383383",
            "quantity": 2,
            "title": "这是商品2",
            "imageUrl":"url",
            "freightInfo": {
                "serviceId": "2",
                "companyName": "",
                "serviceCategory": ""
            }
        }
    ]
}'

Responses

🟢200成功
application/json
Body

Examples
{
    "errorCode": 200,
    "errorMsg": null,
    "success": true,
    "data": {
        "orderId": "21",
        "orderFee": {
            "amount": "322.92",
            "currency": "USD"
        },
        "subOrders": [
            {
                "itemInfos": [
                    {
                        "itemId": "2048020617114736",
                        "skuId": "413185732720",
                        "quantity": 1,
                        "title": "这是商品1"
                    }
                ],
                "internationalLogisticInfos": {
                    "logisticNumer": "FARJP2408000013YQ",
                    "logisticCompanyName": "UCS",
                    "trackingUrl": "https://www.far800.com/logistics/result?key=FARJP2408000013YQ",
                    "logisticType": "UCS"
                }
            },
            {
                "itemInfos": [
                    {
                        "itemId": "2048232789087639",
                        "skuId": "4970432383383",
                        "quantity": 2,
                        "title": "这是商品2"
                    }
                ],
                "internationalLogisticInfos": {
                    "logisticNumer": "FARJP2408000014YQ",
                    "logisticCompanyName": "UCS",
                    "trackingUrl": "https://www.far800.com/logistics/result?key=FARJP2408000014YQ",
                    "logisticType": "UCS"
                }
            }
        ]
    }
}
Modified at 2025-08-19 06:50:46
Previous
Order overseas freight preview
Next
Update domestic logistics information
Built with