...
字段 | 类型 | 必填 | 校验规则 | 说明 | |
|---|---|---|---|---|---|
trackingNo | String | 否 | 跟踪号（仅编辑时有值） | ||
refNo | String | 是 | 必填 | 参考号 | |
refNo1 | String | 否 | 参考号1 | ||
dangerousGoods | Boolean | 否 | 包含其他危险品 | ||
incoterm | String | 否 | 付税方式，可选值见下文"付税方式选项" | ||
invoiceCurrency | String | 是 | 必填 | 发票币种 | |
invoiceValue | Number | 是 | ≥0≥0 必填 | 发票金额 | |
instruction | String | 否 | 装运提示 | ||
weight | Number | 否 | ≥0 | 重量 | |
weightUnit | String | 是 | 必填 | 重量单位，可选值：kg、lb | |
volume | Number | 否 | ≥0 | 体积 | |
description | String | 是 | 必填 | 货物描述（英文） | |
nativeDescription | String | 否 | 货物描述（中文） | ||
length | Number | 否 | ≥0 | 长度 | |
width | Number | 否 | ≥0 | 宽度 | |
height | Number | 否 | ≥0 | 高度 | |
dimensionUnit | String | 否 | 体积单位，可选值：cm、in、m | ||
batteryPacking | String | 否 | 电池包装（系统码：BOT001） | ||
batteryType | String | 否 | 电池类型（系统码：BPT001） | ||
recipientTaxId | String | 否 | 收件人税号 |
...
字段 | 类型 | 必填 | 校验规则 | 说明 |
|---|---|---|---|---|
addressId | String | 否 | 地址ID（仅编辑时需要） | |
country | String | 是必填 | 国家代码 | |
addressLine1 | String | 是 | 必填 | 地址第一行 |
addressLine2 | String | 否 | 地址第二行 | |
addressLine3 | String | 否 | 地址第三行 | |
city | String | 是 | 必填 | 城市 |
state | String | 否 | 省/州 | |
postcode | String | 是必填 | 邮编 | |
shipperOrganizationCode | String | 否 | 企业统一社会信用代码 | |
shipperCompanyName | String | 否 | 发货人公司名 |
...
| 代码块 |
|---|
curl 'https://tracking-qa.etowertech.com/parcel/order/create' \
-H 'Accept: application/json, text/plain, */*' \
-H 'language: zh_CN' \
-H 'sessionId: MuETuXqSzpU_QQFiSD-dbQ' \
-H 'Content-Type: application/json' \
-d '{
"facility": "*",
"addressCountry": "GB",
"channel": 3,
"serviceOption": "STANDARD",
"billingPartyName": "Test Company",
"platform": "eBay",
"lockerService": false,
"authorityToLeave": true,
"recipientName": "John Smith",
"recipientCompany": "Smith Ltd",
"phone": "+44 20 1234 5678",
"email": "john.smith@example.com",
"addressLine1": "123 Main Street",
"addressLine2": "Apt 4B",
"addressLine3": "London",
"city": "London",
"state": "England",
"postcode": "SW1A 1AA",
"refNo": "REF123456",
"refNo1": "REF789012",
"dangerousGoods": false,
"incoterm": "DDU",
"invoiceCurrency": "GBP",
"invoiceValue": 25.99,
"instruction": "Please call before delivery",
"weight": 1.5,
"weightUnit": "kg",
"volume": 0.003,
"description": "Cotton T-Shirt",
"nativeDescription": "纯棉T恤",
"length": 30,
"width": 20,
"height": 5,
"dimensionUnit": "cm",
"batteryPacking": "NOBATTERY",
"batteryType": "NOBATTERY",
"recipientTaxId": "GB123456789",
"extendData": {
"vendorid": "VENDOR001",
"agentID": "AGENT001",
"sortCode": "SORT001",
"purpose": "GIFT",
"material": "COTTON",
"codAmount": 0,
"codCurrency": "",
"receiverKycType": "INDIVIDUAL",
"receiverKycNo": "KYC123456",
"injectPort": "LHR",
"abnnumber": "",
"gstexemptioncode": "",
"platformorderno": "EBAY-ORDER-123",
"coveramount": 100,
"senderTaxId": "CN123456789",
"postage": "",
"icms": "",
"vat": "GB20",
"originPort": "CN",
"osnr": "",
"specialHandlingType": "",
"holdForPickup": "",
"residentialSignatureRequired": "",
"saturdayDelivery": "",
"exportInvoiceValue": 30,
"exportInvoiceCurrency": "GBP",
"imei1": "",
"imei2": "",
"warehouseID": "",
"shipperOrganizationCode": "91310000MA1X4QC",
"shipperCompanyName": "Shenzhen Tech Co., Ltd"
},
"parcelItems": [
{
"sku": "ITEM001",
"description": "Cotton T-Shirt - Blue",
"nativeDescription": "纯棉T恤-蓝色",
"hsCode": "61091000",
"originCountry": "CN",
"unitValue": 12.99,
"itemCount": 2,
"weight": 0.3,
"productURL": "https://example.com/product/123",
"warehouseNo": "WH-SZ-001",
"itemExportInvoiceValue": 15,
"itemExportInvoiceCurrency": "GBP",
"pictures": [
"https://example.com/images/item1-front.jpg",
"https://example.com/images/item1-back.jpg"
]
}
],
"shipperAddress": {
"country": "CN",
"addressLine1": "456 Shipping Street, Suite 100",
"addressLine2": "Futian District",
"addressLine3": "Shenzhen",
"city": "Shenzhen",
"state": "Guangdong",
"postcode": "518000",
"shipperOrganizationCode": "91310000MA1X4QC",
"shipperCompanyName":
"Shenzhen Tech Co., Ltd"
},
"returnAddress": {
"addressLine1": "789 Return Street",
"addressLine2": "Warehouse B",
"addressLine3": "Industrial Zone",
"city": "Shenzhen",
"state": "Guangdong",
"postcode": "518001",
"country": "CN",
"returnOption": "Return",
"returnPhone": "+86 13900139000"
},
"insur": {
"cancel": false,
"insureType": "01",
"insuredContackName": "Zhang San",
"insuredName": "Li Si",
"insureAmount": 100,
"insureCurrency": "GBP",
"insureCardNo": "110101199001001234"
}
}'
|
...
- 包含33个字段
- 如果接口未返回某字段，传空字符串""
- shipperOrganizationCode和shipperCompanyName虽然属于extendData：
- 展示在发货人地址模块
- 提交时包含在shipperAddress对象中提交时放在extendData对象中
- 6. 响应处理规则
- warnings有值，errors为空：
...