下单预报接口

POST

/api/order/sync

用于下单并预报订单，接口会直接返回跟踪号和面单，测试环境用户名为：YOTOTEST，测试token为：vVTrLw3LNw7/zKTnBPH9wg==

请求参数

Body 参数application/json

示例

{
    "user_code": "YOTOTEST",
    "orders": [
        {
            "recipient_company": "Jose Carlos Ruiz Pereira",
            "recipient_address1": "Profesor Manuel Olivencia Ruiz N9 Portal 1 Bajo D",
            "length": 12,
            "recipient_state": "Sevilla",
            "total_weight": 0.03,
            "ioss_number": "IM5280002556",
            "total_declare_value": 25.26,
            "ship_channel_code": "TJZX01",
            "recipient_country": "TJ",
            "reference_order_number": "LP007671834704592",
            "width": 11,
            "recipient_city": "Sevilla",
            "recipient_name": "Jose Carlos Ruiz Pereira",
            "items": [
                {
                    "quantity": 1,
                    "declare_name": "storage cover",
                    "declare_value": 25.26,
                    "declare_name_cn": "保护套",
                    "hs_code": "9503008200",
                    "sku": "10050056104310719"
                },
                {
                    "declare_name": "two duck doll",
                    "declare_name_cn": "信息",
                    "declare_value": 3.4,
                    "hs_code": "920210",
                    "quantity": 3,
                    "sku": "1005005610431079"
                },
                {
                    "declare_name": "a big doll",
                    "declare_name_cn": "模块",
                    "declare_value": 3.5,
                    "hs_code": "850440",
                    "quantity": 1,
                    "sku": "1005005610431080"
                }
            ],
            "recipient_zip": "41019",
            "recipient_phone": "653073151",
            "height": 2,
            "pickup_pointid": 1953296506745847808
        }
    ],
    "token": "vVTrLw3LNw7/zKTnBPH9wg=="
}

请求示例代码

Shell

Java

PHP

Python

HTTP

curl --location --request POST 'https://tms-test.gjxlh.com/api/order/sync' \
--header 'Content-Type: application/json' \
--data-raw '{
    "user_code": "YOTOTEST",
    "orders": [
        {
            "recipient_company": "Jose Carlos Ruiz Pereira",
            "recipient_address1": "Profesor Manuel Olivencia Ruiz N9 Portal 1 Bajo D",
            "length": 12,
            "recipient_state": "Sevilla",
            "total_weight": 0.03,
            "ioss_number": "IM5280002556",
            "total_declare_value": 25.26,
            "ship_channel_code": "TJZX01",
            "recipient_country": "TJ",
            "reference_order_number": "LP007671834704592",
            "width": 11,
            "recipient_city": "Sevilla",
            "recipient_name": "Jose Carlos Ruiz Pereira",
            "items": [
                {
                    "quantity": 1,
                    "declare_name": "storage cover",
                    "declare_value": 25.26,
                    "declare_name_cn": "保护套",
                    "hs_code": "9503008200",
                    "sku": "10050056104310719"
                },
                {
                    "declare_name": "two duck doll",
                    "declare_name_cn": "信息",
                    "declare_value": 3.4,
                    "hs_code": "920210",
                    "quantity": 3,
                    "sku": "1005005610431079"
                },
                {
                    "declare_name": "a big doll",
                    "declare_name_cn": "模块",
                    "declare_value": 3.5,
                    "hs_code": "850440",
                    "quantity": 1,
                    "sku": "1005005610431080"
                }
            ],
            "recipient_zip": "41019",
            "recipient_phone": "653073151",
            "height": 2,
            "pickup_pointid": 1953296506745847808
        }
    ],
    "token": "vVTrLw3LNw7/zKTnBPH9wg=="
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "status": "success",
    "msg": "请求成功",
    "data": {
        "LP007671834704592": {
            "status": "success",
            "msg": null,
            "order_number": "OR2510271419564225",
            "tracking_number": "BEK9975POSTCU",
            "label_url": "https://xlhdan.oss-cn-shenzhen.aliyuncs.com/SelfSupportLabel_TEST_1761545996739.pdf",
            "invoice_url": null,
            "customer_order_code": "LP007671834704592"
        }
    }
}

修改于 2025-11-07 09:51:32

轨迹查询接口