订单发货主动通知
一. 对接流程图
此场景适用于商家自研商城、小程序商城等自建平台店铺订单在快麦ERP发货后，⽀持回调⾃建平台店铺预留的url，以主动通知的形式下通知⾃建平台订单发货通知消息。
二. 操作说明
-
⾃建平台通过“创建⾃建平台订单接⼝：erp.trade.create.new”创建订单到快⻨ERP
-
⾃建平台发货回调地址维护：⾃建平台店铺管理回调Url填写：把⾃建平台发货回调地址填写到⾃建平台店铺的物流同步地址处，如下图所示
-
⾃建平台⾃⾏对接快⻨的发货消息通知接⼝：
3.1 具体对接⽂档如下：
POST 请求地址/router
公共参数
调⽤任何⼀个API都必须传⼊的参数，⽬前⽀持的公共参数有：参数名称 参数类型 是否必须 参数描述 method string 是 API接口名称 appKey string 是 分配给应用的AppKey timestamp string 是 时间戳，时区为MT+8，例如：2020-09-21 16:58:00。API服务端允许客户端请求最大时间误差为10分钟 format string 否 响应格式。默认为json格式，可选值：json version string 是 API协议版本 可选值：1.0 sign_method string 否 签名的摘要算法(默认hmac)，可选值为：hmac，md5，hmac-sha256。 sign string 是 签名 请求头
参数名 类型 描述 必填 Content-Type string multipart/form-data 必填 API接⼝名
参数名 类型 描述 必填 method string open.token.refresh 是 timestamp int 请求时间 是 sign string 签名 是 请求参数
参数名 类型 描述 必填 sid long 快麦ERP系统订单号 是 tid string 平台订单号(创建接口) 是 logistics_out_sid string 物流运单号 是 logistics_code string 物流编码 是 logistics_name string 物流公司名字 是 send_date string 发货时间 是 warehouse_id string 仓库编码 是 source string 订单来源 是 ext string 预留 是 orders list 商品列表 是 oid long 平台⼦订单号 是 sku_outer_id string 商品编码(平台商品编码) 是 sku_id string 平台商品skuId 是 number string 数量 是 name string 商品名称 是 tid string 平台订单号 是 order_id string 快麦ERP生成的子订单号(逗号分隔) 是 响应参数
参数名 类型 描述 必填 session object session 是 expiresIn long 到期时间 是 companyId long 关联的企业ID 是 userId long 关联的用户ID 是 accessToken string 会话Token 是 refreshToken string 用来刷新会话的Token 是 返回示例
{
"session": {
"expiresIn": 12345,
"companyId": 12345,
"accessToken": "zhangsan",
"userId": 12345,
"refreshToken": "zhangsan",
}
}注意事项 每⼀个⼩时内最多刷新⼀次，不能频刷新，会话已经过期也不⽀持刷新了
-
⾃建平台订单系统发货后⾃动上传发货通知到自建平台店铺