跳到主要内容

新增完成的调拨单

请求地址​

环境服务地址(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
allocate.task.add
必填

请求参数​

参数名
类型
描述
必填
outWarehouseCode
long
调出仓库外部编码
必填
inWarehouseCode
long
调入仓库外部编码
必填
outNum
int
调出总数
inNum
int
调入总数
details
array
调拨单明细
必填
outerId
string
商家编码
必填
qualityType
boolean
质量true/false. 默认true
outNum
int
申请调拨数
actualOutNum
int
实际调出数量
必填
inNum
int
实际调入数量
必填
remark
string
备注

请求示例​

{
"outWarehouseCode":"cangchucode1",
"inWarehouseCode":"cangchucode2",
"details":[ 
      {"actualOutNum":2,"inNum":1,"outerId":"ceshi","qualityType":true,"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