新增其他出库单
系统相关界面
"界面路径:【仓储】----【其他出库单管理】----【新增出库单】"
请求地址
环境 | 服务地址(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.out.order.add
必填
请求参数
参数名
类型
描述
必填
customType
string
示例:出入库类型
prSourceId
string
示例:外部单号(不允许重复)
outLocation
string
示例:出库位置,货位/入库暂存区/销退暂存区/次品暂存区/通用暂存区, 1/2/3/4/5 可以参考:采退的位置选择,字段的选择是一样
remark
string
示例:备注
items
string
示例:商品列表 json [{"outerId":"springday","quantity":1,"price":1}],(price 单位:元)
必填
outerId
string
商家编码(最小粒度)
必填
quantity
long
良品数量
必填
badNum
long
次品数量
price
number
单价(单位:元)
必填
productDate
Date
效期
batchNo
string
批次
warehouseCode
string
示例:出库仓库(编码) - 仓库外部编码
必填
status
integer
示例:状态 0 草稿, 1 已审核,2 已出库
uniqueCodes
string
唯一码,逗号拼接。当type为1时传入
type
integer
类型 0或不传 普通, 1 唯一码
请求示例
{
"customType": "string",
"prSourceId": "string",
"outLocation": "integer",
"remark": "string",
"items": "array",
"warehouseCode": "string",
"status": "integer"
}
响应参数
参数名
类型
描 述
必填
id
string
示例:id
必填
响应示例
{
"id": 12345
}
异常示例
{
"code": "25",
"msg": "服务方法(other.out.order.add:1.0)的签名无效",
"success": false,
"trace_id": "3553483395423660"
}
错误码解释
错误码 | 错误信息 | 解决方案 |
---|---|---|
25 | 服务方法(other.out.order.add:1.0)的签名无效 | 签名参数错误 |