invoiceCurrencyCode
接口说明
创建直邮小包订单
路径
HTTP Verb | URL |
|---|---|
| Post | qa: https://cfs-qa.etowertech.com/api/supplier-service/ /v1/openApi/packetOrder/b2c/createOrders |
...
请求头样例
POST /v1/openApi/packetOrder/b2c/createOrders HTTP/1.1 Host: http://cfs-qa.etowertech.com/ Content-Type: application/jsonUser-Agent: Mozilla 5.0 lang:zh_CN Host: http://cfs-qa.etowertech.com/api/supplier-serviceAuthorization:WallTech etotest8xkIIphLnbkjRACNj4P:pc9H97D-_b2_TSCVvNj81AThu Tue,06 Aug 2020 02 Aug 2022 06:21 43:24 37 GMT Authorization: WallTech testLvs2jdug2qIoRsJyuxs:2THPh5_j4OTYUGdinstTC4nYqDE= |
请求字段（request）
| 字段 | 三级字段 | 四级字段 | 类型 | 长度限制 | 中文含义 | 描述 | 是否必填 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| facility | String | 50 | 发件人网点 | B2C：shipper facility FF：warehouse | O |
referenceNo??? | String | 50 | 订单唯一编码 | 区分不同订单用 | M | orderType | String | 10 | 订单类型 | 枚举: B2C=小包直邮（此处为该值） Fulfillment=仓库一件代发 | M | originPortCode | String | 始发港（空港/海港） | 英文代码 | O | injectPortCode | String | 50 | 目的港 | 英文代码 | O | channelCode | String | 64 | 渠道代码 | 英文、英文标点 | M | channelOption | String | 64 | 渠道选项 | 英文、英文标点 | O | platform | Short | 20 | 平台 | 枚举 1: Amazon 2: eBay | O | incoterm | String | 50 | 贸易术语 | 枚举 DDU DDP | O | collectionType | 20 | 揽收类型 | 枚举 Pick up上门揽收 Drop off自送到仓 不填默认drop off | O |
isInsurance | Boolean | 3 | 是否投保 | boolean 不填默认false | O |
isSignature | Boolean | 3 | 是否签名 | boolean 不填默认false | O | remark | 200 | 备注 | O | extendData | 拓展字段 | 比如IOSS key-value形式 | consignee | addressCode | String | 50 | 收件人地址代码 | 比如ONT8表示某个亚马逊仓库 | name | String | 50 | 收件人姓名 | M | company | String | 512 | 收件人公司 | phone | String | 50 | 收件人电话 | String | 50 | 收件人邮箱 | countryCode | String | 2 | 目的国二字代码 | 英文代码 | M | state | String | 80 | 收件人省/州 | city | String | 80 | 收件人城市 | M | district | String | 128 | 收件人区 | addressLine1 | String | 200 | 收件人地址第一行 | M | addressLine2 | String | 200 | 收件人地址第二行 | addressLine3 | String | 80 | 收件人地址第三行 | zipCode | String | 16 | 收件人邮编 | taxId | String | 255 | 收件人税号 | taxId1 | String | 255 | 收件人税号1 | extendData | 拓展字段 | shipper | name | String | 50 | 发件人姓名 | company | String | 512 | 发件人公司 | phone | String | 50 | 发件人电话 | String | 50 | 发件人邮箱 | countryCode | String | 2 | 始发国二字代码 | 英文代码 | state | String | 80 | 发件人省 |
请求字段（request）
| Table Filter | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
拓展字段
...
拓展字段key-value（新增）
'keepShipService': xxx boolean 是/否
'xxId':xxx
...
matertial
material
...
collectionInfo
collection
（说明：如果类型是pickup，要填）
...
请求样例
...
返回样例
成功样例
{
"code": "0",
"data": {},
"errors": "",
"message": "",
"messageId": "",
"success": true,
"warnList": ""
}
失败样例
{
"code": "0",
"data": {
"test002": [
{ "code": "600222", "message": "referenceNo APITES032Field already exists, cannot be repeated" }
],
"test001": [
{ "code": "600222", "message": "referenceNo APITES033Field already exists, cannot be repeated" }
]
},
"errors": "",
"message": "",
"messageId": "",
"success": true,
"warnList": ""
}
...
|
请求样例
1、"ordertype":"Fulfillment"
| 代码块 |
|---|
[
{
"businessCode":"B0900919",
"facility": "ALT4300",
"channelCode": "ZYMD-SKU-UPS",
"channelOption": "",
"referenceNo": "NX_{{$timestamp}}",
"orderType": "Fulfillment",
"originPortCode": "",
"injectPortCode": "",
"platform": "eBay",
"incoterm": "",
"collectionType": null,
"isInsurance": "",
"isSignature": "",
"remark": "testremark1234567890",
"isNeedConfirm": false,
"extendData": {
"extend": null
},
"purchaseOrderNo":"test2026",
"consignee": {
"addressCode": "AU POST",
"addressLine1": " address1 ",
"addressLine2": " address2 ",
"addressLine3": " address3 ",
"city": " city ",
"company": " testcompany 测试 ",
"countryCode": "AU",
"district": " district",
"email": " 123456789@12.cn ",
"extendData": null,
"name": " 迈克尔 杰克逊 ",
"phone": " 1551234 56781234 ",
"state": " state ",
"taxId": " testtaxid ",
"taxId1": "testtaxid1",
"zipCode": " 8238 juej "
},
"shipper": {
"addressLine1": "",
"addressLine2": "",
"addressLine3": "",
"city": "",
"company": "",
"countryCode": "",
"district": "",
"email": "",
"extendData": null,
"name": "",
"phone": "",
"state": "",
"taxId": "",
"taxId1": "",
"zipCode": ""
},
"returnAddress": {
"addressLine1": "",
"addressLine2": "",
"addressLine3": "",
"city": "",
"company": "",
"countryCode": "",
"district": "",
"email": "",
"extendData": null,
"name": "",
"phone": "",
"returnOption": "",
"state": "",
"zipCode": ""
},
"parcels": [
{
"referenceNo": "123",
"referenceNo1": "",
"referenceNo2": "",
"consignmentId": "",
"trackingNo": "{{$timestamp}}",
"label": "http:\/\/erp-huanan.oss-cn-shenzhen.aliyuncs.com\/html2pdf\/ec\/pdf\/2023\/04\/10\/8ed24f790c86a1b950ab89d6fd473c4d.pdf",
"labelName":"testfile.pdf",
"labelType": "0",
"descriptionEn": "",
"description": "",
"dangerousGoods": false,
"batteryType": "false",
"weight": null,
"weightUnit": null,
"length": "",
"width": "",
"height": "",
"dimensionUnit": null,
"invoiceCurrencyCode": null,
"invoiceValue": "12",
"transactionCurrency": "usd",
"transactionAmount": "5.12",
"shippingInstruction": "",
"sortCode": "",
"attachments":[
{
"attachName": "1234567890",
"attachData": "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ZShEOjIwMjMwOTExMTkxNTQyKzA4JzAwJykvQ3JlYXRpb25EYXRlKEQ6MjAyMzA5MTExOTE1NDIrMDgnMDAnKS9Qcm9kdWNlcihpVGV4dCAyLjEuNyBieSAxVDNYVCk+PgplbmRvYmoKeHJlZgowIDExCjAwMDAwMDAwMDAgNjU1MzUgZiAKMDAwMDAwMDI4OSAwMDAwMCBuIAowMDAwMDAwMDE1IDAwMDAwIG4gCjAwMDAwMDE2NzQgMDAwMDAgbiAKMDAwMDAwMDEyOSAwMDAwMCBuIAowMDAwMDAwNzA3IDAwMDAwIG4gCjAwMDAwMDA4MzEgMDAwMDAgbiAKMDAwMDAwMTIzNCAwMDAwMCBuIAowMDAwMDAxNDg0IDAwMDAwIG4gCjAwMDAwMDE3MzcgMDAwMDAgbiAKMDAwMDAwMTc4MiAwMDAwMCBuIAp0cmFpbGVyCjw8L0luZm8gMTAgMCBSL0lEIFs8MTM5ZmM3ZTE3NTY3OWQ3MDI5YmMyYWVjNjZjYjdiMTQ+PGNmYzI3MjZjZjgzMGExYzhhYjYxNDcyMDE1ZjdkZGNmPl0vUm9vdCA5IDAgUi9TaXplIDExPj4Kc3RhcnR4cmVmCjE5MDUKJSVFT0YK",
"attachType": "pdf"
}
],
"extendData": {
"keepShipService": false
},
"items": [
{
"extendData": null,
"hsCode": "",
"itemDesc": "",
"itemDescEn": "",
"itemNumber": "",
"matertial": "",
"originCountryCode": "",
"picture": "",
"quantity": "2",
"quantityUnit": "",
"salesURL": "",
"sku": "testals001",
"unitPrice": "",
"usage": "",
"weight": null
}
],
"insurance": [
{
"insuranceAmount": null,
"insuranceCurrencyCode": null,
"insuranceType": null,
"beneficiaryType": null,
"beneficiary": null,
"beneficiaryId": null,
"extendData": null
}
]
}
],
"collectionInfo": {
"date": "",
"addressLine1": "",
"addressLine2": "",
"addressLine3": "",
"city": "",
"company": "",
"countryCode": "",
"district": "",
"email": "",
"extendData": null,
"name": "",
"phone": "",
"state": "",
"zipCode": ""
}
}
] |
2、"ordertype":"B2C"
| 代码块 |
|---|
[
{
"businessCode":"B0900919",
"facility": "B2C321",
"channelCode": "UBI.CN2US.AC.GENERAL.LIGHT",
"channelOption": "B2Cchanneloption",
"referenceNo": "XB03094",
"orderType": "B2C",
"originPortCode": "",
"injectPortCode": "",
"platform": "eBay",
"incoterm": "DDP",
"collectionType": "Drop off",
"isInsurance": false,
"isSignature": false,
"remark": "testremark",
"extendData": {
"extend": null
},
"consignee": {
"addressCode": null,
"addressLine1": "testaddressline1",
"addressLine2": "8349hao",
"addressLine3": "345shi",
"city": "testcity",
"company": "testcompany",
"countryCode": "us",
"district": "testdistrict",
"email": "testemail@123.com",
"extendData": null,
"name": "testconsigneename",
"phone": "36247938384",
"state": "teststate",
"taxId": "testtaxid",
"taxId1": "testtaxid1",
"zipCode": "8238juej"
},
"shipper": {
"addressLine1": "",
"addressLine2": "",
"addressLine3": "",
"city": "",
"company": "",
"countryCode": "us",
"district": "",
"email": "",
"extendData": null,
"name": "",
"phone": "",
"state": "",
"taxId": "",
"taxId1": "",
"zipCode": ""
},
"returnAddress": {
"addressLine1": "",
"addressLine2": "",
"addressLine3": "",
"city": "",
"company": "",
"countryCode": "",
"district": "",
"email": "",
"extendData": null,
"name": "",
"phone": "",
"returnOption": "",
"state": "",
"zipCode": ""
},
"parcels": [
{
"referenceNo": "PARCEL0323002",
"referenceNo1": "",
"referenceNo2": "",
"consignmentId": "",
"trackingNo": "",
"descriptionEn": "descriptionen",
"description": "description",
"dangerousGoods": true,
"batteryType": true,
"weight": 1.245,
"weightUnit": null,
"length": "25",
"width": "26",
"height": "27",
"dimensionUnit": null,
"invoiceCurrencyCode": "USD",
"invoiceValue": 12.5,
"transactionCurrency": null,
"transactionAmount": null,
"shippingInstruction": "",
"sortCode": "",
"extendData": {
"keepShipService": false
},
"items": [
{
"extendData": null,
"hsCode": "111",
"itemDesc": "desc",
"itemDescEn": "descen",
"itemNumber": "1",
"material": "testmaterial",
"originCountryCode": "cn",
"picture": "",
"quantity": "1",
"quantityUnit": "个",
"salesURL": "testsalesurl",
"sku": "QW",
"unitPrice": "21",
"usage": "testusage",
"weight": "12"
}
],
"insurance": [
{
"insuranceAmount": "12",
"insuranceCurrencyCode": "usd",
"insuranceType": null,
"beneficiaryType": null,
"beneficiary": null,
"beneficiaryId": null,
"extendData": null
}
]
}
],
"collection": {
"date": "2023-03-09",
"addressLine1": "testaddress1",
"addressLine2": "testaddress2",
"addressLine3": "testaddress3",
"city": "testcity",
"company": "testcompany",
"countryCode": "us",
"district": "testdistrict",
"email": "testemail@123.com",
"extendData": null,
"name": "testname",
"phone": "phone",
"state": "teststate",
"zipCode": "123456"
}
}
] |
返回样例
成功样例
1、"ordertype":"Fulfillment"
| 代码块 |
|---|
[
{
"code": "0",
"data": {
"orderNo": "C12283230322000025O",
"referenceNo": "TestA00001"
},
"errors": "",
"message": "",
"messageId": "",
"success": true,
"warnList": ""
},
{
"code": "0",
"data": {
"orderNo": "C12283230322000026O",
"referenceNo": "TestA00002"
},
"errors": "",
"message": "",
"messageId": "",
"success": true,
"warnList": ""
}
] |
2、"ordertype":"B2C"
| 代码块 |
|---|
[
{
"code": "0",
"data":
{ "orderNo": "UBI2303230008", "referenceNo": "XB03094" },
"errors": "",
"message": "",
"messageId": "",
"success": true,
"warnList": ""
}
] |
失败样例
1、"ordertype":"Fulfillment"
| 代码块 |
|---|
1、
[{
"code": "0005",
"data": {
"orderNo": "",
"referenceNo": "test-0022-1"
},
"errors": [{
"code": "600906",
"message": "warehouseServiceName:qudao1 ,Does not exist in the shipperAddressCode:code0001"
}],
"message": "paramter error",
"messageId": "",
"success": false
}]
2、
[
{
"code": "0005",
"data": {
"orderNo": "",
"referenceNo": "NX_1703583922"
},
"errors": [
{
"code": "0020",
"message": "Operation Error: Operation Error: When the file type is a label,the warehouse supports uploading file format: pdf"
}
],
"message": "paramter error",
"messageId": "",
"success": false,
"warnList": ""
}
] |
2、"ordertype":"B2C"
| 代码块 |
|---|
[
{
"code": "0005",
"data": "XB03094",
"errors": [
{
"code": "600222",
"message": "referenceNo:XB03094 field value already exists and cannot be repeated"
},
{
"code":"700094",
"message": "Multiple business codes are not allowed for the same order"
}
],
"message": "paramter error",
"messageId": "",
"success": false,
"warnList": ""
}
] |
| 附件 |
|---|