Create international logistics order

POST

/v2/open/pp/logistics/orderBookingFreight

请求参数

Query 参数

timestamp

string

必需

sign

string

必需

Header 参数

nonce-str

string

可选

默认值:

nonce-str

Body 参数application/json

renderId

string | null

可选

receiverAddress

object (ReceiverAddressTO)

可选

name

string | null

可选

string | null

可选

phone

string | null

可选

mobilePhone

string | null

可选

address

string | null

可选

taxId

string | null

可选

country

string | null

可选

city

string | null

可选

zip

string | null

可选

state

string | null

可选

lineItems

array [object {8}] | null

可选

itemId

string | null

可选

skuId

string | null

可选

quantity

integer | null

可选

title

string | null

可选

imageUrl

string | null

可选

freightInfo

object (FreightInfoTO)

可选

currency

string | null

可选

price

string | null

可选

tmallOrderInfo

object (TmallOrderInfoTO)

可选

tmallOrderId

string | null

可选

remark

string | null

可选

示例

{
    "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": ""
            }
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v2/open/pp/logistics/orderBookingFreight?timestamp&sign' \
--header 'nonce-str: nonce-str' \
--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": ""
            }
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

errorCode

integer | null

返回码

可选

errorMsg

string | null

返回码对应信息

可选

success

boolean | null

可选

data

object (OrderBookingFreightResult)

返回内容

可选

orderId

string | null

可选

orderFee

object (FeeTO)

可选

subOrders

array[object (FreightSubOrderTO) {2}] | null

可选

示例

成功示例异常示例

{
    "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"
                }
            }
        ]
    }
}

修改于 2025-04-25 06:18:37

Update domestic logistics information