logistics_sync_ack.php(物流同步回写)
¥标准
1.接口说明
1.1 接口描述:将物流同步(发货状态、物流单号等)是否成功的结果批量回传给旺店通ERP。 |
1.2 适用版本:未限制 |
1.3 注意事项:仅支持自有/其他平台店铺 |
2.调用场景
3.请求参数说明
3.1 请求地址
环境 | HTTP地址 |
---|
测试环境 | https://openapitest.huice.com/openapi/logistics_sync_ack.php |
正式环境 | https://openapi.huice.com/openapi/logistics_sync_ack.php |
3.2 公共请求参数
名称 | 字段 | 类型 | 长度
| 必须 | 描述 |
---|
卖家账号 | sid | String |
| 是 | 购买ERP时由旺店通分配给ERP购买方,请从ERP购买方获取。 |
接口账号 | appkey | String |
| 是 | 本开放平台“自助对接”功能模块内自助申请,获取方式点击这里
|
时间戳 | timestamp | int |
| 是 | 北京时间1970-01-01 08:00:00起至现在的总秒数,10位int值,旺店通企业版API服务端允许请求最大时间误差为5min,date.timezone = Asia/Shanghai。 |
签名 | sign | String |
| 是 | API输入参数签名结果,签名算法介绍单击这里
|
3.3 业务请求参数
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
物流同步状态回传列表 | logistics_list | data[] |
| 是 | 请求参数的1级数据节点,包含订单同步状态的数据节点,节点下数据字段详见下述“logistics_list” 注意 数据不要超过50条。否则容易出现超时 |
logistics_list
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|
回写的记录id | rec_id | int | 11 | 是 | 回写的记录id,见logistics_sync_query中rec_id |
回写状态 | status | tinyint | 4 | 是 | 回写状态: 0成功 1失败 |
相关描述信息 | message | varchar | 255 | 否 | 相关描述信息,可在erp的物流同步界面看到 |
4.响应参数
4.1 公共响应参数
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|
错误码 | code | int | 11 | 是 | 状态码:0表示成功,其他表示失败 |
错误原因 | message | varchar | 255 | 是 | 错误原因 |
处理失败的错误列表 | errors | data | data[]
| 否 | 处理失败的错误列表,当code为0且有错误信息时才非空.只列出同一批内有错误的记录.如果code=0,errors为空说明全部成功 |
4.2 业务响应参数
errors
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|
回写的记录id | rec_id | int | 11 | 是 | 回写的记录id |
错误信息的描述 | error | varchar | 255 | 否 | 错误信息的描述 |