跳到主要内容

新增调拨单

请求地址

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

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

公共参数

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

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

请求头

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

API接口地址

全部展开
参数名
类型
描述
必填
method
string
allocate.task.status.create
必填

请求参数

全部展开
参数名
类型
描述
必填
outWarehouseCode
long
调出仓库外部编码
必填
inWarehouseCode
long
调入仓库外部编码
必填
outLocation
int
出库位置 货位/入库暂存区/销退暂存区/次品暂存区/通用暂存区/拣选暂存区/补货暂存区 1/2/3/4/5/6/8
必填
status
string
调拨状态 CREATED:待审核,AUDITED:待调拨
必填
platformOrderNumber
string
外部单号
details
array
调拨单明细
必填
outerId
string
商家编码
必填
outNum
int
申请调拨数
必填
batchNo
string
批次
productTime
date
生产日期
expireDate
date
到期日期
remark
string
备注

请求示例

{
"outWarehouseCode":"cangchucode1",
"inWarehouseCode":"cangchucode2",
"details":[
{"outNum":2,"outerId":"ceshi","title":"光云台历2021"}]
}

响应参数

全部展开
参数名
类型
描述
必填
success
boolean
示例:true
必填
errorMsg
string
错误信息
必填
allocateCode
String
生成的调拨单单号
必填
allocateId
Long
生成的调拨单Id
必填

响应示例

{
"item": {
"sysItemId": long,
"barcode": "string",
"picPath": "string",
"activeStatus": long,
"title": "string",
"outerId": "string",
"type": "string",
"typeTag": long,
"catId": "string",
"unit": "string",
"isSkuItem": long,
"isVirtual": long,
"hasSupplier": long,
"makeGift": boolean,
"created": long,
"modified": long,
"sellerCids": "string",
"sellerCats": [
{
"id": long,
"cid": long,
"name": "string"
}
]
},
"success": boolean,
"trace_id": "long"
}

异常示例

{
"code": "25",
"msg": "服务方法(item.single.get:1.0)的签名无效",
"success": false,
"trace_id": "3553483395423660"
}

错误码解释

错误码错误信息解决方案
content1content2content3