跳到主要内容

收货单新增/修改

系统相关界面​

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

请求地址​

环境服务地址(HTTP/HTTPS)
V2正式环境https://gw.superboss.cc/router

2022年4月1日以后申请的APP Key，统一使用V2正式环境的请求地址：https://gw.superboss.cc/router

公共参数​

调用任何一个API都必须传入的参数，目前支持的公共参数有：

参数名称参数类型是否必须参数描述
methodstring是API接口名称
appKeystring是分配给应用的AppKey
timestampstring是时间戳，时区为GMT+8，例如：2020-09-21 16:58:00。API服务端允许客户端请求最大时间误差为10分钟
formatstring否响应格式。默认为json格式，可选值：json
versionstring是API协议版本 可选值：1.0
sign_methodstring否签名的摘要算法(默认 hmac)，可选值为：hmac，md5，hmac-sha256。
signstring是签名
sessionstring是授权会话信息 （即access_token，由系统分配）

请求头​

全部展开
参数名
类型
描述
必填
Content-Type
string
multipart/form-data
必填

API接口地址​

全部展开
参数名
类型
描述
必填
method
string
warehouse.entry.addorupdate
必填

请求参数​

全部展开
参数名
类型
描述
必填
purchaseOrderId
long
采购单ID
weOuterCode
string
收货单外部单号(不允许重复)
id
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 00:00:00”
可选
expireDate
Date
到期日期，格式“2024-04-15 00:00:00”
可选
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":1742887853000,"expireDate":1742974253000}]
sign:32B28DA9EBDB1D605014D8E60F062338
}

响应参数​

全部展开
参数名
类型
描述
必填
id
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)的签名无效签名参数错误