收货单新增/修改

websocket测试

POST

请求地址/router

系统相关界面

"界面路径：【采购】----【收货单管理】----【新增收货单/修改】"

请求地址

|环境|服务地址(HTTP/HTTPS)| |-|-| |V2正式环境| https://gw.superboss.cc/router| **2022年4月1日**以后申请的APP Key，统一使用V2正式环境的请求地址：**https://gw.superboss.cc/router**

公共参数

调用任何一个API都必须传入的参数，目前支持的公共参数有： | 参数名称 | 参数类型 | 是否必须 | 参数描述 | | --- | --- | --- | --- | | method | string | 是 | API接口名称 | | appKey | string | 是 | 分配给应用的AppKey | | timestamp | string | 是 | 时间戳，时区为GMT+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 | 是 | 签名 | | session | string | 是 | 授权会话信息（即access_token，由系统分配） |

请求头

参数名

类型

描述

必填

Content-Type

string

multipart/form-data

必填

API接口地址

参数名

类型

描述

必填

method

string

warehouse.entry.addorupdate

必填

请求参数

参数名

类型

描述

必填

purchaseOrderId

long

采购单ID

可选

weOuterCode

string

收货单外部单号(不允许重复)

可选

long

收货单id(编辑时必填)

可选

supplierCode

string

供应商(编码) - 必填

必填

items

string

采购的商品列表 json [{"outerId":"springday","quantity":1,"price":1}],（price 单位：元）

必填

outerId

string

商家编码(最小粒度)

必填

quantity

long

数量

必填

price

number

单价（单位：元）

必填

batchNo

string

批次(相同商品不允许出现不同的批次+效期)

可选

productDate

Date

效期(相同商品不允许出现不同的批次+效期)，格式“2024-04-11”

可选

warehouseCode

string

仓库外部编码

必填

status

integer

状态，支持传入 NOT_FINISH （未完成）、FINISHED(已完成)

必填

请求示例

``` { appKey:1124664101 format:json version:1.0 timestamp:2023-09-16 14:39:33 session:a4958627c07b4f0eb9f255b81234c2a8 method:warehouse.entry.addorupdate sign_method:md5 supplierCode:0003 warehouseCode:A status:NOT_FINISH items: [{"outerId":"批次效期测试商品","quantity":1,"price":10,"batchNo":"20230718","productTime":1689746502482}] sign:32B28DA9EBDB1D605014D8E60F062338 } ```

响应参数

参数名

类型

描述

string

示例：收货单id

响应示例

``` { "traceId": "2695278502560167389", "success": true, "id": 4387287189219907 } ```

异常示例

```` { "code": "25", "msg": "服务方法(warehouse.entry.addorupdate:1.0)的签名无效", "success": false, "trace_id": "3553483395423660" } ````

错误码解释

| 错误码 |错误信息|解决方案| |-|-|-| |25|服务方法(warehouse.entry.addorupdate:1.0)的签名无效|签名参数错误|