发货单推送
1. 前言:
来伊份主动推送发货单信息至合作方(实时推送)
2. 交互时序图:
3. 请求场景:
创建发货单后实时推送至合作方
4. 接口要求:
使用来伊份openapi加密协议进行加密请求
5. 接口标准
5.1 基本信息
描述 | 值 |
---|---|
服务名称 | 第三方提供 |
URL | |
认证方式 | 令牌 |
请求方式 | HTTP(POST) |
功能描述(适用场景) | 取消发货单 |
5.2 请求头公共参数 (Header)
参数名字 | 参数类型 | 是否必须 | 说明 |
---|---|---|---|
X-Co-Client | String | 是 | 客户端Id(来伊份提供) |
X-Co-Sign | String | 是 | 签名 |
X-Co-TimeStamp | String | 是 | 签名时间戳 |
5.3 入参 Body
参数名字 | 参数类型 | 是否必须 | 说明 |
---|---|---|---|
orderNo | String | 是 | 来伊份发货单 |
sendWay | String | 是 | 配送方式 |
warehouseCode | String | 否 | 仓库编号 |
warehouseName | String | 是 | 仓库名称 |
receiverName | String | 是 | 收货人名称 |
receiverAdress | String | 是 | 收货人地址 |
receiverPhone | String | 是 | 收货人手机号 |
receiverLat | String | 是 | 收货人纬度 |
receiverLng | String | 是 | 收货人经度 |
skuTotalWeight | Double | 是 | 商品总重,单位kg,精确至小数点后两位 |
expectedDeliveryTime | String | 是 | 期望送到时间戳 |
createTime | String | 是 | 发货单创建时间戳 |
skuList | List<SkuInfo> | 是 | 商品信息列表 |
SkuInfo
参数名字 | 参数类型 | 是否必须 | 说明 |
---|---|---|---|
outSkuCode | String | 是 | 三方商品编码 |
skuCode | String | 是 | 来伊份商品编码 |
skuName | String | 是 | 商品名称 |
skuCount | Integer | 是 | 商品数量 |
skuUnit | String | 是 | 商品单位 |
5.4 入参示例
{
"orderNo": "OR86768782123",
"sendWay": "CRD",
"warehouseCode": "C001",
"warehouseName": "仓库1",
"receiverName": "张三",
"receiverAddress": "来伊份青年大厦",
"recivierPhone": "13456789876",
"receiverLat": "11.11",
"receiverLng": "11.11",
"skuTotalWeight": 2.22,
"expectedDeliveryTime": 1631894400000,
"createTime": 1631894400000,
"skuList": [
{
"outSkuCode": "A1212",
"skuCode": "L91721",
"skuName": "商品1",
"skuCount": "1",
"skuUnit": "PAK"
},
{
"outSkuCode": "A1213",
"skuCode": "L91761",
"skuName": "商品2",
"skuCount": "2",
"skuUnit": "PAK"
}
]
}
5.5 返回统一参数
参数名字 | 参数类型 | 是否必须 | 说明 |
---|---|---|---|
code | String | 是 | 返回请求业务代码 |
msg | String | 是 | 返回信息描述 |
data | Json | 是 | 返回参数 |
5.6 返回参数Data
参数名字 | 参数类型 | 是否必须 | 说明 |
---|---|---|---|
outOrderNo | String | 是 | 合作方发货单号 |
5.7 返回示例
{
"code": 0,
"msg": "success",
"data": {
"outOrderNo": "ss2131231"
}
}