国际一票多件&速达非专线&海外仓头程下单接口

接口环境	接口地址
正式环境	https://apis.speedaf.com/
测试环境	https://uat-api.speedaf.com/

1. 单个下单

接口地址: https://uat-api.speedaf.com/open-api/express/order/intl/create?appCode=你的appCode&timestamp=当前毫秒时间戳

请求方式:POST

请求数据类型:application/json

接口描述:

请求参数示例:


x
{
  "customerOrderNo": "1234567",
  "customerCode": "CN000090",
  "orderProductTypeCode": "ST04",
  "settlementMethod": "PA03",
  "transportType": "TT02",
  "pickUpType": 1,
  "deliveryType": "DE01",
  "taxMethod": "DDU",
  "goodsCategory":"IT01",
  "valueAddedServices":[1,2],
  "sender": {
    "address": "senderAddeess",
    "areaCode": "CNA02651",
    "areaName": "Linying County",
    "cityCode": "CNC00344",
    "cityName": "Luohe",
    "countryCode": "CN",
    "mobile": "12345678999",
    "name": "sendName",
    "phone": "12345678999",
    "provinceName": "Henan",
    "provinceCode": "CNR00033"
  },
  "receiver": {
    "address": "receiverAddress",
    "areaCode": "",
    "areaName": "",
    "cityCode": "NGC00469",
    "cityName": "Edo",
    "countryCode": "NG",
    "mobile": "12345678999",
    "name": "receiverName",
    "phone": "12345678999",
    "provinceName": "Akwa Ibom",
    "provinceCode": "NGR00031"
  },
  "orderDetailList": [
    {
      "predictedLength": 1,
      "predictedWidth": 1,
      "predictedHeight": 1,
      "predictedWeight": 1,
      "remark": "remark",
      "orderGoodsList": [
        {
          "sku": "sku",
          "name": "衣服",
          "nameDialect": "dress",
          "quantity": 1,
          "declarePrice": 1,
          "currency": "USD",
          "unitWeight": 1,
          "length": 1,
          "wide": 1,
          "high": 1,
          "hasBattery": 0,
          "blInsured": 1,
          "hsCode": "123456",
          "blMobile": 0,
          "mPid":"",
          "nsPid":"",
          "sPid":""
        }
      ]
    }
  ]
}

请求参数描述:

订单信息

参数	参数说明	是否必须	数据类型	长度	备注
sender	寄件信息	true	ContactReqDto
receiver	收件信息	false	ContactReqDto		国际一票多件、速达非专线业务必传，海外仓不用传
warehouseCode	海外仓仓库地址code	false	String	32	海外仓必传见附件1
orderDetailList	子单包裹列表	true	List<OrderDetailReqDTO>		子单包裹最大数量不超过999
customerOrderNo	客户订单编号(参考号)	true	String	50
customerCode	客户代码	true	String	32
orderProductTypeCode	产品类型(发货方式)	true	String	32	ST04=国际快递(单票≤30KG) ST05=海外仓头程 ST10=速达非专线(单票＞30KG) 见附件2
goodsCategory	物品类型	true	String	32	见附件3
settlementMethod	结算方式	true	String	32	见附件4
transportType	运输方式	true	String	32	1、当产品类型选国际快递、速达非专线时，运输方式只能为：TT02（空运） 2、当产品类型选海外仓头程时，运输方式只能可以为：TT02（空运）/TT03（海运）见附件5
pickUpType	揽件类型	false	Integer		见附件6
deliveryType	派送方式	true	String	32	见附件7
receivingTimeRange	预计上门揽收时间范围	false	Integer		见附件8
taxMethod	税费方式	true	String	32	见附件9
valueAddedServices	增值服务	false	List		见附件10

收寄件人信息（ContactReqDto）

参数	参数说明	是否必须	数据类型	长度	备注
name	姓名	true	String	100
company	公司	false	String	100
idCard	身份证	false	String	50
idType	身份ID类型	false	String	8	174=身份证,167=税务账号,53=护照
mobile	电话	true	String	50
phone	座机	false	String	50
email	邮箱	false	String	100
address	地址	true	String	500
areaCode	区/县编号	false	String	50
areaName	区/县名	false	String	50
cityCode	城市编号	false	String	50
cityName	城市名	false	String	50
provinceCode	省编号	false	String	50
provinceName	省名	false	String	50
countryCode	国家二字码（大写）	true	String	50	e.g.：NG 见附件11
postCode	邮编	false	String	20
taxIdNumber	税务识别号	false	String	64	UZ必传
acceptBirthday	收件人出生日期	false	String	16	UZ校验格式：dd.MM.yyyy

子单包装信息（OrderDetailReqDTO）

参数	参数说明	是否必须	数据类型	长度	备注
predictedLength	预报长(cm)	true	BigDecimal		取值范围 1-1000
predictedWidth	预报宽(cm)	true	BigDecimal		取值范围 1-1000
predictedHeight	预报高(cm)	true	BigDecimal		取值范围 1-1000
predictedWeight	预报重量(kg)	true	BigDecimal	9,3
remark	备注	false	String	200
domesticTransportNo	国内转运单号	false	String	50
orderGoodsList	子单包装物品信息列表	true	List<OrderGoodsReqDto>

子单包装物品信息（OrderGoodsReqDto）

参数	参数说明	是否必须	数据类型	长度	备注
sku	SKU	false	String	64
name	商品名称	true	String	300
nameDialect	物品名本地语言	true	String	300
barCode	条码	false	String	64
quantity	数量	true	Integer	8
declarePrice	申报价值	true	BigDecimal	10,2
currency	币种	false	String	32	物品列表中的币种必须一致，如果不传，默认为USD
unitWeight	单个重量(kg)	true	BigDecimal	10,3
unitVolume	单个体积(cm³)	false	BigDecimal
length	长cm	false	BigDecimal		取值范围 1-1000
wide	宽cm	false	BigDecimal		取值范围 1-1000
high	高cm	false	BigDecimal		取值范围 1-1000
hasBattery	是否带电池	false	Integer
blInsured	是否保价	false	Integer		0-否 1-是
url	物品链接	false	String	200
hsCode	海关编码	false	String	50
blMobile	是否手机	true	Integer		0=否 1=是
mobileType	手机类型	false	Integer		如果blMobile为是，必填见附件12
mobileBrand	手机品牌	false	String	32	如果blMobile为是，必填见附件13
picUrl	照片url	false	String	200
mPid	商家产品标识符	false	string	64	欧盟国家必传，国家明细，见附件14
nsPid	非标准化制造商产品标识符	false	string	64	欧盟国家必传，国家明细，见附件14
sPid	标准化产品标识符	false	string	64	欧盟国家必传，国家明细，见附件14
remark	备注	false	String	200

注：和金额有关的参数单位均默认收件国家的本地货币

响应状态:

响应参数示例:


x
// 成功响应
{
    "success": true,
    "error": null,
    "data": {
        "customerOrderNo": "6666668",
        "mainWaybillCode": "NG130001506253002",
        "subWaybillCodeList": [
            {
                "domesticTransportNo": "TEST001",
                "waybillCode": "NG130001506253002001"
            },
            {
                "domesticTransportNo": "TEST002",
                "waybillCode": "NG130001506253002002"
            }
        ]
    }
}

// 失败响应
{
  "success": false,
  "error": {
    "code": "60003",
    "message": "invalid appCode"
  },
  "data": null
}

响应参数描述:

参数名称	参数说明	类型
data	数据	Data
success	是否成功	boolean
error	错误信息	Error

返回数据 Data

参数名称	参数说明	类型
customerOrderNo	客户编号	String
mainWaybillCode	主单号	String
subWaybillCodeList	子单信息集合	List < Object>

subWaybillCodeList

参数名称	参数说明	类型	备注
domesticTransportNo	国内转运单号	String
waybillCode	子单号	String

异常数据 Error

参数名称	参数说明	类型	备注
code	错误编码	Integer
message	错误信息	String

2. 附件

1、warehouseCode: 海外仓仓库code 传以下code即可

Code	Description
GH01	加纳海外仓
NG01	尼日利亚海外仓
UG01	乌干达海外仓
KE01	肯尼亚海外仓
MA01	摩洛哥海外仓
PK02	巴基斯坦海外仓
EG01	埃及海外仓

2、orderProductTypeCode:传以下code即可

Code	Description
ST04	国际快递(单票≤30KG)
ST05	海外仓头程
ST10	速达非专线(单票＞30KG)

3、goodsCategory: 商品类型传以下code即可

Code	Description
IT01	普通物品
IT02	文件
IT03	贵重物品
IT04	带电物品
IT05	不带电物品
IT06	纯电
IT07	敏感物品

4、settlementMethod: 传以下code即可

Code	Description
PA01	现金
PA02	月结
PA03	预付

5、transportType:传以下code即可

Code	Description
TT01	汽运
TT02	空运
TT03	海运
TT04	空海联运

6、pickUpType:传以下code即可

Code	Description
1	上门揽件
2	客户自送

7、deliveryType:传以下code即可

Code	Description
DE01	送货上门
DE02	自提

8、receivingTimeRange:传以下code即可

Code	Description
0	无要求
1	24小时内
2	48小时内
3	即时

9、taxMethod:传以下code即可

Code	Description
DDP	税后交货(Delivered Duty Paid)
DDU	未完税交货(Delivered Duty Unpaid)

10、valueAddedServices:传以下code即可

Code	Description
1	木箱加固
2	普通加固
3	拍照
4	单独出口退税
5	保险

11、countryCode:传以下code即可

Code	Description
CN	China
GH	Ghana
UG	Uganda
KE	Kenya
NG	Nigeria
MA	Morocco
EG	Egypt
PK	Pakistan

12、mobileType:传以下code即可

Code	Description
0	无
1	新机
2	二手

13、mobileBrand：传以下code即可

Code	Description
TECNO	TECNO
INFINIX	INFINIX
ITEL	ITEL
HUAWEI	HUAWEI
VIVO	VIVO
MI	MI
HONOR	HONOR
APPLE	APPLE
OPPO	OPPO
REALME	REALME
SAMSUNG	SAMSUNG
21KE	21KE
IQOO	IQOO
NUBIA	NUBIA
MEIZU	MEIZU
NOKIA	NOKIA
K-Touch	K-Touch
GIONEE	GIONEE
PHILIPS	PHILIPS
MOTOROLA	MOTOROLA
ZTE	ZTE
ROG	ROG
Newman	Newman
SONY	SONY
DOOV	DOOV
LEBEST	LEBEST
OTHERS	OTHERS

14、欧盟国家明细

Code	Description
RE	法务海外省-留尼汪(Reunion)
YT	法务海外省-马约特(Mayotte)
GP	法务海外省-瓜德罗普(Guadeloupe)
MQ	法务海外省-马提尼克(Martinique)