
| 接口环境 | 接口地址 |
|---|---|
| 正式环境 | https://apis.speedaf.com/ |
| 测试环境 | https://uat-api.speedaf.com/ |
接口地址:https://uat-api.speedaf.com/open-api/express/order/updateOrder?appCode=你的appCode×tamp=当前毫秒时间戳
请求方式:POST
请求数据类型:application/json
接口描述:国际件入库前、本地件揽收前调用该接口生效
请求参数示例:
[{ "billCode": "23456789", "customerCode": "2340002", "acceptAddress": "acceptAddress", "acceptCityCode": "acceptCityCode", "acceptCityName": "acceptCityName", "acceptCompanyName": "acceptCompanyName", "acceptDistrictCode": "acceptDistrictCode", "acceptDistrictName": "acceptDistrictName", "acceptEmail": "123@Test.com", "acceptMobile": "1778922222", "acceptName": "acceptName", "acceptPhone": "999999", "acceptPostCode": "acceptPostCode", "acceptProvinceCode": "acceptProvinceCode", "acceptProvinceName": "acceptProvinceName", "codFee": 100, "parcelHigh": 1000, "parcelLength": 1000, "goodsQTY": 99, "parcelVolume": 1, "parcelWeight": 200, "parcelWidth": 1000, "insurePrice": 876, "piece": 1, "remark": "1", "sendAddress": "sendAddress", "sendCityCode": "sendCityCode", "sendCityName": "sendCityName", "sendCompanyName": "sendCompanyName", "sendDistrictCode": "sendDistrictCode", "sendDistrictName": "sendDistrictName", "sendMail": "sendMail", "sendMobile": "sendMobile", "sendName": "sendName", "sendPhone": "sendPhone", "sendPostCode": "sendPostCode", "sendProvinceCode": "sendProvinceCode", "sendProvinceName": "sendProvinceName", "shippingFee": 1, "deliveryType": "DE01", "payMethod": "PA01", "shipType":"ST01", "transportType":"TT01", "smallCode": ""},{ }]请求参数描述:
| 参数 | 参数说明 | 是否必须 | 数据类型 | 长度 | 备注 |
|---|---|---|---|---|---|
| billCode | 运单号 | true | string | 60 | |
| customerCode | 客户编号 | true | string | 60 | |
| acceptName | 收件人姓名 | false | string | 100 | |
| acceptCompanyName | 收件人公司 | false | string | 60 | |
| acceptPostCode | 收件客户邮编 | false | string | 60 | |
| acceptMobile | 收件人手机号 | false | string | 60 | |
| acceptPhone | 收件人座机 | false | string | 60 | |
| acceptEmail | 收件人邮箱 | false | string | 60 | |
| acceptAddress | 收件人详细地址 | false | string | 500 | |
| acceptProvinceName | 收件人省 | false | string | 60 | |
| acceptProvinceCode | 收件人省编码 | false | string | 60 | |
| acceptCityName | 收件人市 | false | string | 60 | |
| acceptCityCode | 收件人市编码 | false | string | 60 | |
| acceptDistrictName | 收件人区 | false | string | 60 | |
| acceptDistrictCode | 收件人区编码 | false | string | 60 | |
| sendName | 寄件人姓名 | false | string | 60 | |
| sendCompanyName | 寄件人公司 | false | string | 100 | |
| sendAddress | 寄件人地址 | false | string | 500 | |
| sendPostCode | 寄件客户邮编 | false | string | 60 | |
| sendMobile | 寄件人手机号 | false | string | 60 | |
| sendPhone | 寄件人座机 | false | string | 60 | |
| sendMail | 寄件人邮箱 | false | string | 60 | |
| sendProvinceName | 寄件人省份 | false | string | 60 | |
| sendProvinceCode | 寄件人省编码 | false | string | 60 | |
| sendCityName | 寄件人市 | false | string | 60 | |
| sendCityCode | 寄件人市编码 | false | string | 60 | |
| sendDistrictName | 寄件人区 | false | string | 60 | |
| sendDistrictCode | 寄件人区编码 | false | string | 60 | |
| piece | 包裹件数 | false | Long | 10 | |
| insurePrice | 保价金额 | false | decimal | 10,2 | |
| goodsQTY | 商品总数 | false | Long | 10 | |
| parcelLength | 货物长度 | false | Long | 10 | 单位mm |
| parcelWidth | 货物宽度 | false | Long | 10 | 单位mm |
| parcelHigh | 货物高度 | false | Long | 10 | 单位mm |
| parcelWeight | 货物重量 | false | decimal | 10,3 | 单位KG |
| goodsVolume | 货物体积 | false | decimal | 10,2 | 单位m² |
| shippingFee | 运费 | false | decimal | ||
| codFee | 代收货款 | false | decimal | ||
| smallCode | 国内转运单号 | false | string | 60 | |
| deliveryType | 派送方式 | false | string | 60 | 见附件5 |
| transportType | 运输方式 | false | string | 60 | 见附件3 |
| shipType | 订单发货类型 | false | string | 60 | 见附件6 |
| payMethod | 支付方式 | false | string | 60 | 见附件7 |
| remark | 备注 | false | string | 200 |
响应状态:
响应参数示例:
x失败:{ "success": false, "error": { "code": "500", "message": "Customer not exists!" }, "data": null}
成功:{ "success": true, "error": null, "data": [ { "billCode": "47233200734710", "success": false, "message": "Order not exists" }, { "billCode": "47233200734712", "success": true } ]}
响应参数描述:
| 参数名称 | 参数说明 | 类型 | 备注 |
|---|---|---|---|
| billCode | 运单号 | String | |
| success | 是否成功 | Boolean | true 修改成功,false 修改失败 |
| message | 错误原因 | String | 修改失败的原因 |