文档
测试

新增其他入库单

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
other.in.order.add
必填

请求参数

参数名
类型
描述
必填
weSourceId
string
示例:外部单号
可选
customType
string
示例:出入库类型
可选
remark
string
示例:备注
可选
inLocation
string
示例:入库位置,货位/入库暂存区/销退暂存区/次品暂存区/通用暂存区/采退暂存区/补货暂存区/拣货暂存区, 1/2/3/4/5/6/7/8
可选
items
string
示例:商品列表json [{"outerId":"springday","quantity":1,"price":1}],(price 单位:元)
必填
outerId
string
商家编码(最小粒度)
必填
quantity
long
良品数量
必填
badNum
long
次品数量
可选
price
number
单价(单位:元)
必填
batchNo
string
批次
可选
productDate
Date
效期
可选
warehouseCode
string
示例:仓库外部编码
必填
status
integer
示例:状态 0 草稿, 1 审核并入库,-1 待入库(已审核)
可选
uniqueCodes
string
唯一码 当type为1时传入 json [{"uniqueCode":123, "outerId":"商家编码1","supplierName":"张三供应商"}] 其中 uniqueCode字段必填。 当传入的唯一码在系统中不存在时,outerId和supplierName需要传入。supplierName不填则取商品对应的供应商
可选
type
integer
类型 0或不传 普通, 1 唯一码
可选
code
string
单据号
可选

请求示例

```json { "outerCode": "string", "startModified": "string", "endModified": "string", "fields": "string", "customTypeStr": "string", "status": "string" } ````

响应参数

参数名
类型
描述
id
string
示例:id

响应示例

```json { "id": 12345 } ```

异常示例

```` { "code": "25", "msg": "服务方法(other.in.order.add:1.0)的签名无效", "success": false, "trace_id": "3553483395423660" } ````

错误码解释

| 错误码 |错误信息|解决方案| |-|-|-| |25|服务方法(other.in.order.add:1.0)的签名无效|签名参数错误|