API 接口文档

Appearance

业务下单 Business order

​

接口说明 ​

接口地址

下单：  https://track.ptemu.233trans.com/api/order/createForecast

请求方式： POST

请求参数 ​

请求字段说明

字段名称字段类型字段长度是否必需字段说明
authorizationJSONObject接口校验信息
codeString5-20Y客户编码
tokenString50YAPI授权码
datasJSONObject本次提交数据集
requestJSONObject预报下单入参
packageSnStringY包裹号
channelCodeStringY渠道代码
goodsCountIntY商品数量
packageWeightIntY预估包裹总重量,单位:g
encryptedIossTaxNumberInt加密的IOSS税号,仅欧洲需要
totalPriceDouble总价值
currencyCodeString申报币别
consigneeJSONObject收件人信息
countryCodeStringY收件人所在国家，填写国际通用标准 2 位简码
fullNameStringY收件人姓名
additionalNameString收件人别名
taxcodeString税号
address1StringY地址1
address2String地址2
stateStringY收件人洲
cityStringY城市
districtString区
phoneNumberStringY收件人手机号
phoneCodeString收件人手机区号
emailString收件人电子邮箱
postCodeStringY收件人邮编
shipperJSONObject寄件人信息
countryCodeStringY寄件人所在国家，填写国际通用标准 2 位简码
fullNameString寄件人姓名
address1String地址1
address2String地址2
stateString寄件人洲
cityString城市
districtString区
phoneNumberString寄件人手机号
phoneCodeString寄件人手机区号
emailString寄件人电子邮箱
postCodeString寄件人邮编
goodsListArray申报物品信息
importNameEnStringY进口国海关商品申报名称(英文)
importNameChString进口国海关商品申报名称(中文)
importHsCodeStringY进口国海关编码
quantityIntY商品数量
unitPriceDoubleY商品单价
unitWeightLong单重:单位 g
currencyCodeStringY申报币别
goodsDeclUnitPriceString国内报关单价
goodsDeclCurrencyString商品报关币种

请求报文示例 ​

json
{
    "authorization": {
    "code": "KJHB",
    "token": "c60bf762-01f7-470e-8c8f-acde06c81fed"
    },
    "datas":{
        "request": {
        "packageSn": "BG-24061055XHK1M6LV-TEST1",
        "channelCode": "AU001T",
        "goodsCount": 5,
        "packageWeight": 1810,
        "encryptedIossTaxNumber": null,
        "totalPrice": 85.36,
        "currencyCode": "AUD",
        "consignee": {
            "countryCode": "AU",
            "fullName": "Stan Sharpe",
            "additionalName": null,
            "taxcode": null,
            "address1": "1 Musgrove Av",
            "address2": "",
            "state": "NSW",
            "city": "KELSO",
            "district": null,
            "phoneNumber": "61485874427,7883#",
            "phoneCode": "61",
            "email": "tzdgctxghu1209c@us.shipping.temuemail.com",
            "postCode": "2795"
        },
        "shipper":{
            "countryCode": "AU",
            "fullName": "Stan Sharpe",
            "address1": "1 Musgrove Av",
            "address2": "",
            "state": "NSW",
            "city": "KELSO",
            "district": null,
            "phoneNumber": "61485874427,7883#",
            "phoneCode": "61",
            "email": "tzdgctxghu1209c@us.shipping.temuemail.com",
            "postCode": "2795"
        },
        "goodsList": [
            {
                "importNameEn": "storage bag",
                "importNameCh": "收纳袋",
                "importHsCode": "4202920000",
                "quantity": 2,
                "unitPrice": 13.15,
                "unitWeight": 344,
                "currencyCode": "AUD",
                "goodsDeclUnitPrice": 29.58,
                "goodsDeclCurrency": "CNY"
            },
            {
                "importNameEn": "Nylon emergency kit",
                "importNameCh": "急救包",
                "importHsCode": "3006500000",
                "quantity": 1,
                "unitPrice": 20.45,
                "unitWeight": 374,
                "currencyCode": "AUD",
                "goodsDeclUnitPrice": 29.7,
                "goodsDeclCurrency": "CNY"
            },
            {
                "importNameEn": "drone",
                "importNameCh": "无人机",
                "importHsCode": "9503008900",
                "quantity": 1,
                "unitPrice": 23.17,
                "unitWeight": 383,
                "currencyCode": "AUD",
                "goodsDeclUnitPrice": 56.5,
                "goodsDeclCurrency": "CNY"
            },
            {
                "importNameEn": "backpack",
                "importNameCh": "背包",
                "importHsCode": "4202129000",
                "quantity": 1,
                "unitPrice": 15.44,
                "unitWeight": 365,
                "currencyCode": "AUD",
                "goodsDeclUnitPrice": 19.8,
                "goodsDeclCurrency": "CNY"
            }
        ]
    }
    }
  
}
{
    "authorization": {
    "code": "KJHB",
    "token": "c60bf762-01f7-470e-8c8f-acde06c81fed"
    },
    "datas":{
        "request": {
        "packageSn": "BG-24061055XHK1M6LV-TEST1",
        "channelCode": "AU001T",
        "goodsCount": 5,
        "packageWeight": 1810,
        "encryptedIossTaxNumber": null,
        "totalPrice": 85.36,
        "currencyCode": "AUD",
        "consignee": {
            "countryCode": "AU",
            "fullName": "Stan Sharpe",
            "additionalName": null,
            "taxcode": null,
            "address1": "1 Musgrove Av",
            "address2": "",
            "state": "NSW",
            "city": "KELSO",
            "district": null,
            "phoneNumber": "61485874427,7883#",
            "phoneCode": "61",
            "email": "tzdgctxghu1209c@us.shipping.temuemail.com",
            "postCode": "2795"
        },
        "shipper":{
            "countryCode": "AU",
            "fullName": "Stan Sharpe",
            "address1": "1 Musgrove Av",
            "address2": "",
            "state": "NSW",
            "city": "KELSO",
            "district": null,
            "phoneNumber": "61485874427,7883#",
            "phoneCode": "61",
            "email": "tzdgctxghu1209c@us.shipping.temuemail.com",
            "postCode": "2795"
        },
        "goodsList": [
            {
                "importNameEn": "storage bag",
                "importNameCh": "收纳袋",
                "importHsCode": "4202920000",
                "quantity": 2,
                "unitPrice": 13.15,
                "unitWeight": 344,
                "currencyCode": "AUD",
                "goodsDeclUnitPrice": 29.58,
                "goodsDeclCurrency": "CNY"
            },
            {
                "importNameEn": "Nylon emergency kit",
                "importNameCh": "急救包",
                "importHsCode": "3006500000",
                "quantity": 1,
                "unitPrice": 20.45,
                "unitWeight": 374,
                "currencyCode": "AUD",
                "goodsDeclUnitPrice": 29.7,
                "goodsDeclCurrency": "CNY"
            },
            {
                "importNameEn": "drone",
                "importNameCh": "无人机",
                "importHsCode": "9503008900",
                "quantity": 1,
                "unitPrice": 23.17,
                "unitWeight": 383,
                "currencyCode": "AUD",
                "goodsDeclUnitPrice": 56.5,
                "goodsDeclCurrency": "CNY"
            },
            {
                "importNameEn": "backpack",
                "importNameCh": "背包",
                "importHsCode": "4202129000",
                "quantity": 1,
                "unitPrice": 15.44,
                "unitWeight": 365,
                "currencyCode": "AUD",
                "goodsDeclUnitPrice": 19.8,
                "goodsDeclCurrency": "CNY"
            }
        ]
    }
    }
  
}

响应数据 ​

响应字段说明

字段名称字段说明
code接口请求是否通过 0：表示接口请求通过，其他表示失败
msg说明信息
data
success判断是否调用成功
errorCode1000000 业务处理成功,不成功为 5000
errorMsg说明信息
res
wayBillSn中性单号

响应数据示例 dog gate io

json
{
    "code": 0,
    "msg": "调用成功",
    "data":{
      "success": true,
      "errorCode": 1000000,
      "errorMsg": null,
      "res": {
        "wayBillSn": "AYH240611000017"
       }
    }
  
}
{
    "code": 0,
    "msg": "调用成功",
    "data":{
      "success": true,
      "errorCode": 1000000,
      "errorMsg": null,
      "res": {
        "wayBillSn": "AYH240611000017"
       }
    }
  
}