下单接口

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

1. 单个下单

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

请求方式:POST

请求数据类型:application/json

接口描述:

请求参数示例:


x
{
  "acceptAddress": "",
  "acceptCitizenType": "174",
  "acceptCitizenId": "78456478965",
  "acceptCityCode": "",
  "acceptCityName": "",
  "acceptCompanyName": "",
  "acceptCountryCode": "NG",
  "acceptCountryName": "Nigiera",
  "acceptDistrictCode": "",
  "acceptDistrictName": "",
  "acceptEmail": "123@Test.com",
  "acceptMobile": "17789222226",
  "acceptName": "",
  "acceptPhone": "999999",
  "acceptPostCode": "",
  "acceptProvinceCode": "",
  "acceptProvinceName": "",
  "acceptStreetName ": "",
  "billCode":"",
  "codFee": 100,
  "currencyType": "NGN",
  "customOrderNo": "",
  "customerCode": "",
  "changeLable": 0,
  "deliveryType": "DE01",
  "goodsQTY": 1,
  "goodsWeight": 0,
  "insurePrice": 0,
  "isAllowOpen": 0,
  "itemList": [
    {
      "battery": 0,
      "blInsure": 0,
      "currencyType": "NGN",
      "dutyMoney": 0,
      "goodsHigh": 0,
      "goodsLength": 100,
      "goodsMaterial": "",
      "goodsName": "English goodsName",
      "goodsNameDialect": "",
      "goodsQTY": 2,
      "goodsRemark": "",
      "goodsRule": "",
      "goodsType": "IT02",
      "goodsValue": 100,
      "goodsVolume": 1.52,
      "goodsWeight": 100,
      "goodsWidth": 100,
      "hsCode": "",
      "makeCountry": "CN",
      "goodsUrl": "",
      "salePath": "",
      "sku": "sku001",
      "unit": "box",
      "blMobile": 1,
      "mobileType": 1,
      "mobileBrand": "TECNO",
      "domesticExpValue": 100.00,
      "domesticExpCurrency": "CNY",
      "mPid":"",
      "nsPid":"",
      "sPid":""
    }
  ],
  "orderBusinessType": "3",
  "packetCenterCode": "",
  "parcelCurrencyType": "NGN",
  "parcelHigh": 100,
  "parcelLength": 100,
  "parcelType": "PT01",
  "parcelVolume": 1.52,
  "parcelWeight": 100,
  "parcelWidth": 100,
  "parcelValue": 10,
  "payMethod": "PA01",
  "pickupBatch": "",
  "pickUpAging": 0,
  "pickupCity": "",
  "pickupCountry": "",
  "pickupDetailAddress": "",
  "pickupDistrict": "",
  "pickupName": "",
  "pickupPhone": "",
  "pickupProvince": "",
  "pickupType": 0,
  "piece": 1,
  "platformSource": "csp",
  "prePickUpTime": "2022-04-12 10:00:00",
  "productService": "",
  "remark": "",
  "sendAddress": "",
  "sendCityCode": "",
  "sendCityName": "",
  "sendCompanyName": "",
  "sendCountryCode": "CN",
  "sendCountryName": "China",
  "sendDistrictCode": "",
  "sendDistrictName": "",
  "sendMail": "",
  "sendMobile": "",
  "sendName": "",
  "sendPhone": "",
  "sendPostCode": "",
  "sendProvinceCode": "",
  "sendProvinceName": "",
  "shipType": "ST01",
  "shippingFee": 0,
  "smallCode": "",
  "threeSectionsCode": "",
  "transportType": "TT02",
  "taxMethod": "DDP",
  "warehouseCode": "GZ01"
}

请求参数描述:

参数	参数说明	是否必须	数据类型	长度	备注
customOrderNo	客户单号	false	string	50
billCode	速达非运单号	false	string	50	根据业务需求，由速达非决定是否传值，默认不传
productService	服务产品	false	string	50	由速达非商务提供专属专线产品，如尼日利亚小包专线
orderBusinessType	订单业务类型	false	string	4	传code，e.g.：0 0：纯派，1：纯清，2：清派，3：全链路
customerCode	客户编号	true	string	50	速达非提供
platformSource	平台来源	true	string	50	速达非提供
parcelType	快递类型	true	string	50	见附件4
smallCode	国内转运单号	false	string	50
deliveryType	派送方式	true	string	50	见附件5
transportType	运输方式	true	string	50	见附件3
shipType	订单发货类型	true	string	50	见附件6
payMethod	支付方式	true	string	50	见附件7
changeLable	是否更换面单	false	int	4	0=无需换单（默认） 1=换单
isAllowOpen	是否允许打开包裹	false	int	4	0=不允许收件人开包验货（默认） 1=允许收件人开包验货
acceptName	收件人姓名	true	string	100
acceptCompanyName	收件人公司	false	string	100
acceptPostCode	收件客户邮编	false	string	20
acceptMobile	收件人手机号	true	string	20
acceptPhone	收件人座机	false	string	20
acceptEmail	收件人邮箱	false	string	50
acceptAddress	收件人详细地址	true	string	500
acceptCountryName	收件人国家	false	string	50
acceptCountryCode	收件人国家编码	true	string	50	见附件2
acceptCitizenType	收件人身份类型	false	string	50	见附件8 南非、土耳其必传
acceptCitizenId	收件人身份ID	false	string	50	南非、土耳其必传
acceptProvinceName	收件人省	true	string	50
acceptProvinceCode	收件人省编码	false	string	50
acceptCityName	收件人市	true	string	50
acceptCityCode	收件人市编码	false	string	50
acceptDistrictName	收件人区	true	string	50
acceptDistrictCode	收件人区编码	false	string	50
acceptStreetName	收件人街道名称	false	string	500
sendName	寄件人姓名	true	string	100
sendCompanyName	寄件人公司	false	string	100
sendAddress	寄件人地址	true	string	500
sendPostCode	寄件客户邮编	false	string	50
sendMobile	寄件人手机号	true	string	20
sendPhone	寄件人座机	false	string	20
sendMail	寄件人邮箱	false	string	50
sendCountryName	寄件人国家	false	string	50
sendCountryCode	寄件人国家编码	true	string	50	见附件2
sendProvinceName	寄件人省份	true	string	50
sendProvinceCode	寄件人省编码	false	string	50
sendCityName	寄件人市	true	string	50
sendCityCode	寄件人市编码	false	string	50
sendDistrictName	寄件人区	true	string	50
sendDistrictCode	寄件人区编码	false	string	50
parcelLength	包裹长度	false	Long	10	单位mm
parcelWidth	包裹宽度	false	Long	10	单位mm
parcelHigh	包裹高度	false	Long	10	单位mm
parcelVolume	包裹体积	false	decimal	10,2	单位m²
parcelWeight	包裹重量	true	decimal	10,3	单位KG，整个包裹重量，用于入库差异对比称重
piece	包裹件数	true	Long	10	默认：1
parcelValue	整个包裹申报货值	false	decimal	10,2	整个包裹申报货值
parcelCurrencyType	包裹申报货值币种	false	string	10	整个包裹申报货值币种，国际币种三字码（大写）
goodsQTY	商品总数	true	Long	10	itemList中的goodsQTY合计
shippingFee	运费	false	decimal	10,2
codFee	代收货款	false	decimal	10,2
currencyType	货币类型	false	string	10	代收货款币种，仅支持收件国本地币，各国币种类型取国际币种三字码（大写）
insurePrice	保价金额	false	decimal	10,2
packetCenterCode	集包中心代码	false	string	50
threeSectionsCode	三段码	false	string	50
taxMethod	税费方式	true	string	50	DDP,DDU 注：shipType：ST01(本地快递)，该字段不需要传值
warehouseCode	转运仓库	false	string	50	GZ01,SZ01,HK01
pickupBatch	揽收批次	false	string	50
pickUpAging	揽件时效	true	int	4	0=否（默认） 1=预约揽件 2=客户自送
prePickUpTime	预约揽件时间	false	string	20	yyyy-MM-dd HH:mm:ss
pickupType	揽收类型	false	int	4	0=否（默认） 1=预约揽件 2=客户自送
pickupPhone	揽收信息-电话	false	string	20
pickupName	揽收信息-姓名	false	string	100
pickupCountry	揽收信息-国家	false	string	50	见附件2
pickupProvince	揽收信息-省份	false	string	50
pickupCity	揽收信息-城市	false	string	50
pickupDistrict	揽收信息-区	false	string	50
pickupDetailAddress	揽收信息-详细地址	false	string	500
remark	备注	false	string	200
itemList	商品列表	true	List

其中item list的参数为：

参数	参数说明	是否必传	类型	长度	备注
sku	sku	true	string	50
goodsName	商品名称	true	string	100	英文（国际业务必传）
goodsNameDialect	商品名称（本地语言）	false	string	100	中文（国际业务必传）
hsCode	海关商品编码				土耳其必传
goodsQTY	商品数量	true	Long	10
goodsValue	商品单价	true	decimal	10,2
currencyType	货币类型	false	string	10	传USD，用于关务，仅支持美金，摩洛哥支持MAD
domesticExpValue	国内出口货值单价	false	decimal	10,2	国内：表示中国
domesticExpCurrency	国内出口货值货币	false	string	10	不传默认为CNY
unit	计量单位	false	string	10	如：箱，袋，盒
goodsRemark	商品备注	false	string	100
goodsMaterial	商品材质	false	string	50
goodsWeight	商品重量	false	decimal	10,3	单位KG
goodsRule	商品规格	false	string	50
goodsType	商品类型	true	string	50	见附件1，传code即可，如：传“IT01”
goodsLength	商品长度	false	Long	10	单位mm
goodsWidth	商品宽度	false	Long	10	单位mm
goodsHigh	商品高度	false	Long	10	单位mm
goodsVolume	商品体积	false	decimal	10,3	单位㎡
makeCountry	原产国	false	string	20
dutyMoney	预付税费	false	decimal	10,2
goodsUrl	商品链接	false	string	200
salePath	销售地址	false	string	200
blInsure	是否保价	true	Long	2	0=否1=是（默认 0，无保价业务）
battery	是否带电货物	true	Long	2	0-否 1-是 2-纯电注：与goodsType不冲突
blMobile	是否手机	false	Long	2	0=否 1=是
mobileType	手机类型	false	Long	2	0=无 1=新机 2=二手 blMobile=1时必填，同时mobileType不能传0
mobileBrand	手机品牌	false	string	32	见附件9，传code即可，如：传“TECNO” blMobile=1时必填
mPid	商家产品标识符	false	string	64	欧盟国家必传，国家明细，见附件10
nsPid	非标准化制造商产品标识符	false	string	64	欧盟国家必传，国家明细，见附件10
sPid	标准化产品标识符	false	string	64	欧盟国家必传，国家明细，见附件10

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

响应状态:

响应参数示例:


xxxxxxxxxx
{
    "success":true,
    "data":{
        "billCode": "47254200540551",
        "customerOrderNo":"DO2021082793320744962",
        "success": true,
        "message":"success"
    }
}

响应参数描述:

参数名称	参数说明	类型
billCode	运单号	string
customerOrderNo	客户单号	string
success	是否成功	boolean
message	消息描述	string

2. 批量下单（限制20票）

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

请求方式:POST

请求数据类型:application/json

接口描述:

请求参数示例:


x
[{
  "acceptAddress": "",
  "acceptCitizenType": "174",
  "acceptCitizenId": "78456478965",
  "acceptCityCode": "",
  "acceptCityName": "",
  "acceptCompanyName": "",
  "acceptCountryCode": "NG",
  "acceptCountryName": "Nigiera",
  "acceptDistrictCode": "",
  "acceptDistrictName": "",
  "acceptEmail": "123@Test.com",
  "acceptMobile": "17789222226",
  "acceptName": "",
  "acceptPhone": "999999",
  "acceptPostCode": "",
  "acceptProvinceCode": "",
  "acceptProvinceName": "",
  "acceptStreetName": "",
  "billCode":"",
  "codFee": 100,
  "currencyType": "NGN",
  "customOrderNo": "",
  "customerCode": "",
  "changeLable": 0,
  "deliveryType": "DE01",
  "goodsQTY": 1,
  "goodsWeight": 0,
  "isAllowOpen": 0,
  "insurePrice": 0,
  "itemList": [
    {
      "battery": 0,
      "blInsure": 0,
      "currencyType": "NGN",
      "dutyMoney": 0,
      "goodsHigh": 0,
      "goodsLength": 100,
      "goodsMaterial": "",
      "goodsName": "English goodsName",
      "goodsNameDialect": "",
      "goodsQTY": 2,
      "goodsRemark": "",
      "goodsRule": "",
      "goodsType": "IT02",
      "goodsValue": 100,
      "goodsVolume": 1.52,
      "goodsWeight": 100,
      "goodsWidth": 100,
      "hsCode": "",
      "makeCountry": "CN",
      "goodsUrl":"",
      "salePath": "",
      "sku": "sku001",
      "unit": "box",
      "blMobile": 1,
      "mobileType": 1,
      "mobileBrand": "TECNO",
      "domesticExpValue": 100.00,
      "domesticExpCurrency": "CNY",
      "mPid":"",
      "nsPid":"",
      "sPid":""
    }
  ],
  "orderBusinessType": "3",
  "packetCenterCode": "",
  "parcelCurrencyType": "NGN",
  "parcelHigh": 100,
  "parcelLength": 100,
  "parcelType": "PT01",
  "parcelVolume": 1.52,
  "parcelWeight": 100,
  "parcelWidth": 100,
  "parcelValue": 10,
  "payMethod": "PA01",
  "pickupBatch": "",
  "pickUpAging": 0,
  "pickupCity": "",
  "pickupCountry": "",
  "pickupDetailAddress": "",
  "pickupDistrict": "",
  "pickupName": "",
  "pickupPhone": "",
  "pickupProvince": "",
  "pickupType": 0,
  "piece": 1,
  "platformSource": "csp",
  "prePickUpTime": "2022-04-12 10:00:00",
  "productservice": "",
  "remark": "",
  "sendAddress": "",
  "sendCityCode": "",
  "sendCityName": "",
  "sendCompanyName": "",
  "sendCountryCode": "",
  "sendCountryName": "",
  "sendDistrictCode": "",
  "sendDistrictName": "",
  "sendMail": "",
  "sendMobile": "",
  "sendName": "",
  "sendPhone": "",
  "sendPostCode": "",
  "sendProvinceCode": "",
  "sendProvinceName": "",
  "shipType": "ST01",
  "shippingFee": 0,
  "smallCode": "",
  "threeSectionsCode": "",
  "transportType": "TT02",
  "taxMethod": "DDP",
  "warehouseCode": "GZ01"
},{
  ...
}]

请求参数描述:

参数	参数说明	是否必须	数据类型	长度	备注
customOrderNo	客户单号	false	string	50
billCode	速达非运单号	false	string	50	根据业务需求，由速达非决定是否传值，默认不传
productservice	服务产品	false	string	50	由速达非商务提供专属专线产品，如尼日利亚小包专线
orderBusinessType	订单业务类型	false	string	4	传code，e.g.：0 0：纯派，1：纯清，2：清派，3：全链路
customerCode	客户编号	true	string	50	速达非提供
platformSource	平台来源	true	string	50	速达非提供
parcelType	快递类型	true	string	50	见附件4
smallCode	国内转运单号	false	string	50
deliveryType	派送方式	true	string	50	见附件5
transportType	运输方式	true	string	50	见附件3
shipType	订单发货类型	true	string	50	见附件6
payMethod	支付方式	true	string	50	见附件7
changeLable	是否更换面单	false	int	4	0=无需换单（默认） 1=换单
isAllowOpen	是否允许打开包裹	false	int	4	0=不允许收件人开包验货（默认） 1=允许收件人开包验货
acceptName	收件人姓名	true	string	100
acceptCompanyName	收件人公司	false	string	100
acceptPostCode	收件客户邮编	false	string	20
acceptMobile	收件人手机号	true	string	20
acceptPhone	收件人座机	false	string	20
acceptEmail	收件人邮箱	false	string	50
acceptAddress	收件人详细地址	true	string	500
acceptCountryName	收件人国家	false	string	50
acceptCountryCode	收件人国家编码	true	string	50	见附件2
acceptCitizenType	收件人身份类型	false	string	50	见附件8 南非、土耳其必传
acceptCitizenId	收件人身份ID	false	string	50	南非、土耳其必传
acceptProvinceName	收件人省	true	string	50
acceptProvinceCode	收件人省编码	false	string	50
acceptCityName	收件人市	true	string	50
acceptCityCode	收件人市编码	false	string	50
acceptDistrictName	收件人区	true	string	50
acceptDistrictCode	收件人区编码	false	string	50
acceptStreetName	收件人街道名称	false	string	500
sendName	寄件人姓名	true	string	100
sendCompanyName	寄件人公司	false	string	100
sendAddress	寄件人地址	true	string	500
sendPostCode	寄件客户邮编	false	string	50
sendMobile	寄件人手机号	true	string	20
sendPhone	寄件人座机	false	string	20
sendMail	寄件人邮箱	false	string	50
sendCountryName	寄件人国家	false	string	50
sendCountryCode	寄件人国家编码	true	string	50	见附件2
sendProvinceName	寄件人省份	true	string	50
sendProvinceCode	寄件人省编码	false	string	50
sendCityName	寄件人市	true	string	50
sendCityCode	寄件人市编码	false	string	50
sendDistrictName	寄件人区	true	string	50
sendDistrictCode	寄件人区编码	false	string	50
parcelLength	包裹长度	false	Long	10	单位mm
parcelWidth	包裹宽度	false	Long	10	单位mm
parcelHigh	包裹高度	false	Long	10	单位mm
parcelVolume	包裹体积	false	decimal	10,2	单位m²
parcelWeight	包裹重量	true	decimal	10,3	单位KG，整个包裹重量，用于入库差异对比称重
piece	包裹件数	true	Long	10	默认：1
parcelValue	整个包裹申报货值	false	decimal	10,2	整个包裹申报货值
parcelCurrencyType	包裹申报货值币种	false	string	10	整个包裹申报货值币种，国际币种三字码（大写）
goodsQTY	商品总数	true	Long	10	itemList中的goodsQTY合计
shippingFee	运费	false	decimal	10,2
codFee	代收货款	false	decimal	10,2
currencyType	货币类型	false	string	10	代收货款币种，仅支持收件国本地币，各国币种类型取国际币种三字码（大写）
insurePrice	保价金额	false	decimal	10,2
packetCenterCode	集包中心代码	false	string	50
threeSectionsCode	三段码	false	string	50
taxMethod	税费方式	true	string	50	DDP,DDU 注：shipType：ST01(本地快递)，该字段不需要传值
warehouseCode	转运仓库	false	string	50	GZ01,SZ01,HK01
pickupBatch	揽收批次	false	string	50
pickUpAging	揽件时效	true	int	4	0=否（默认） 1=预约揽件 2=客户自送
prePickUpTime	预约揽件时间	false	string	20	yyyy-MM-dd HH:mm:ss
pickupType	揽收类型	false	int	4	0=否（默认） 1=预约揽件 2=客户自送
pickupPhone	揽收信息-电话	false	string	20
pickupName	揽收信息-姓名	false	string	100
pickupCountry	揽收信息-国家	false	string	50	见附件2
pickupProvince	揽收信息-省份	false	string	50
pickupCity	揽收信息-城市	false	string	50
pickupDistrict	揽收信息-区	false	string	50
pickupDetailAddress	揽收信息-详细地址	false	string	500
remark	备注	false	string	200
itemList	商品列表	true	List

其中item list的参数为：

参数	参数说明	是否必传	类型	长度	备注
sku	sku	true	string	50
goodsName	商品名称	true	string	100	英文（国际业务必传）
goodsNameDialect	商品名称（本地语言）	false	string	100	中文（国际业务必传）
hsCode	海关商品编码				土耳其必传
goodsQTY	商品数量	true	Long	10
goodsValue	商品单价	true	decimal	10,2
currencyType	货币类型	false	string	10	传USD，用于关务，仅支持美金，摩洛哥支持MAD
domesticExpValue	国内出口货值单价	false	decimal	10,2	国内：表示中国
domesticExpCurrency	国内出口货值货币	false	string	10	不传默认为CNY
unit	计量单位	false	string	10	如：箱，袋，盒
goodsRemark	商品备注	false	string	100
goodsMaterial	商品材质	false	string	50
goodsWeight	商品重量	false	decimal	10,3	单位KG
goodsRule	商品规格	false	string	50
goodsType	商品类型	true	string	50	见附件1，传code即可，如：传“IT01”
goodsLength	商品长度	false	Long	10	单位mm
goodsWidth	商品宽度	false	Long	10	单位mm
goodsHigh	商品高度	false	Long	10	单位mm
goodsVolume	商品体积	false	decimal	10,3	单位㎡
makeCountry	原产国	false	string	20
dutyMoney	预付税费	false	decimal	10,2
goodsUrl	商品链接	false	string	200
salePath	销售地址	false	string	200
blInsure	是否保价	true	Long	2	0=否1=是（默认 0，无保价业务）
battery	是否带电货物	true	Long	2	0-否 1-是 2-纯电注：与goodsType不冲突
blMobile	是否手机	false	Long	2	0=否 1=是
mobileType	手机类型	false	Long	2	0=无 1=新机 2=二手 blMobile=1时必填，同时mobileType不能传0
mobileBrand	手机品牌	false	string	32	见附件9，传code即可，如：传“TECNO” blMobile=1时必填
mPid	商家产品标识符	false	string	64	欧盟国家必传，国家明细，见附件10
nsPid	非标准化制造商产品标识符	false	string	64	欧盟国家必传，国家明细，见附件10
sPid	标准化产品标识符	false	string	64	欧盟国家必传，国家明细，见附件10

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

响应状态:

响应参数示例:


xxxxxxxxxx
{
    "success":true,
    "data":[
        {
            "billCode": "47254200540551",
            "customerOrderNo":"DO2021082793320744961",
            "success": true,
            "message":"success"
        },{
            "customerOrderNo":"DO2021082793320744962",
            "success": false,
            "message":"Create order failed."
        },
        ...
    ]
}

响应参数描述:

参数名称	参数说明	类型
billCode	运单号	string
customerOrderNo	客户单号	string
success	是否成功	boolean
message	消息描述	string

3. 附件

1、goodsType: 传以下code即可

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

2、countryCode:传以下code即可

Code	Description
CN	China
GH	Ghana
UG	Uganda
KE	Kenya
NG	Nigeria
MA	Morocco
EG	Egypt
BD	Bangladesh
PK	Pakistan
SA	Saudi Arabia
AE	Arab Emirates
TR	Turkey

3、transportType:传以下code即可

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

4、parcelType:传以下code即可

Code	Description
PT01	快递
PT02	快运

5、deliveryType:传以下code即可

Code	Description
DE01	送货上门
DE02	自提

6、shipType:传以下code即可

Code	Description
ST01	本地快递
ST02	电商小包

7、payMethod: 传以下code即可

Code	Description
PA01	现金
PA02	月结

8、acceptCitizenType：传以下code即可

Code	Description
53	护照
167	税务账号
174	身份证

9、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

10、欧盟国家明细

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