EPC系统对接
对接接口前获取token接口
物流单据同步
同步经销商
同步完成物流单据To-C
上海中商网络股份有限公司版权所有
-
+
首页
同步完成物流单据To-C
### API描述 API描述:同步to c物流完成订单和数码,基础校验接口返回成功,异步处理 1.重复单据上传,拦截 2.一个单据下商品编号重复,拦截 3.一个单据下数码重复,拦截 4.单请求数码总量上限 10000 ### 请求信息 | | | |------|------ | 请求方法 | POST | 【测试】请求路径 | https://api-fat.yesno.com.cn/hivezs/epc/upload/receipt-code | 【生产】请求路径 | https://sapi.supercarrier8.com/hivezs/epc/upload/receipt-code ### 传入参数 json | 参数名称 | 是否必填 | 参数类型 | 参数说明 | |-------------|------|--------|-------------------------------------------------| | app_key | 是 | string | 见[获取token](https://developers.yesno.com.cn/doc/818/ "获取token") | | access_token | 是 | string | 见[获取token](https://developers.yesno.com.cn/doc/818/ "获取token")| | bizparams | 是 | object | json数据| 请求示例: ``` { "app_key": "test123", "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJPQXV0aC1Kd3QiLCJleHAiOiJcL0RhdGUoMTc3OTMwMzE2MDc4MSlcLyIsImNsYWltMSI6MCwiY2xhaW0yIjoiY2xhaW0yLXZhbHVlIiwiT3BlbklkIjoiOWVmOTU2ODMtNDJlMy00YThhLTkzMWUtZDJhYzNlMDVhMTIxIiwiYWNjZXNzS2V5IjoidGVzdDEyMyJ9.T11K4Se0oHcpur27uh4OTl2bOmqu3KK1SSZSs4772Qc", "bizparams": { "receiptNo": "AAA003", "receiptType": "196720", "senderNo": "ck001", "receiverNo": "jxs001", "contact": "", "telephone":"", "address":"", "createdAt":"2023-03-01 00:00:00", "completedTime":"2023-03-01 00:00:00", "remark":"", "products": [ { "productNo": "P001", "plannedQuantity":200, "codes":["123","123"] }, { "productNo": "P002", "plannedQuantity":300, "codes":["123","123"] } ] } } ``` #### 参数说明 | 字段 | 必须 | 规则 | 描述 | | :--- | :--- | :--- | :--- | | ReceiptNo | 是 | 输入6~30位的数字、字母、或下划线 | 单号 | | ReceiptType | 是 | 196720:销售出库 | 单据类型 | | SenderNo | 是 | 出库:一般是仓库编号<br>入库:一般是经销商编号 | 发货方编号<br>(与中商平台内维护一致) | | ReceiverNo | 是 | 出库:一般是经销商编号<br>入库:一般是仓库编号 | 收货方编号<br>(与中商平台内维护一致) | | Contact | 否 | 长度20位内的任意字符 | 联系人 | | Telephone | 否 | 符合号码规则 | 联系电话 | | Address | 否 | 长度200位内的任意字符 | 收货地址 | | CreatedAt | 否 | yyyy-MM-dd HH:mm:ss<br>不传递默认当前时间 | 创建时间 | | CompletedTime | 否 | yyyy-MM-dd HH:mm:ss<br>不传递默认当前时间 | 完成时间 | | Remark | 否 | 500的任意字符 | 备注 | | Products | 是 | list | 商品数据集合 | ##### Products字段 | 字段 | 必须 | 规则 | 描述 | | :--- | :--- | :--- | :--- | | ProductNo | 是 | 长度4-30位的任意字符,中文除外 | 商品编号 (与中商平台内维护一致)| | PlannedQuantity | 是 | 正整数 | 计划出库数量 | | Codes | 是 | 字符串数组 | 数码集,限制长度12,14,24 | ### 出参示例json ``` json 成功: { "code": 200, "message": "success", "data":null, "timestamp": 1773381729223, "traceId": "0fd5b036-3baa-4f53-ba95-37833ea2c154", "exception": null, "meta": null, "ext": null } -- 参数格式错误 httpcode=400 { "code": 400, "message": "联系电话应为11位大陆手机号", "data": null, "timestamp": 1791455992599, "traceId": "", "exception": "Invalid parameter [telephone]: [联系电话应为11位大陆手机号]", "meta": null, "ext": null } 失败 错误码:25920001~25929001 参数校验失败 { "code": 25920023, "message": "单据编号已存在", "data": null, "timestamp": 1779334383601, "traceId": "", "exception": "", "meta": null, "ext": null } token失败 { "code": 25920101, "message": "token校验失败", "data": { "status": 200, "code": 25920101, "reason": "token校验失败", "data": null }, "timestamp": 1779332229866, "traceId": "", "exception": null, "meta": { "status": 200, "code": 25920101, "reason": "token校验失败", "data": null }, "ext": null } ```
zhangjiahao
2026年10月8日 18:44
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
PDF文档
PDF文档(打印)
分享
链接
类型
密码
更新密码
有效期