企迈云-开放平台

API 2.0

API 2.0 > 3.1 商品 > 3.1.7 商品出库

3.1.7 商品出库

开启令牌和权限后可调用。签名方式请查看开发指南

场景描述：商品从该店铺或该店铺下的门店下进行出库

零售

请求地址

请求方式	版本信息	请求地址
POST	V2	http://openapi.zvcms.com/api/v2

公共参数

参数	参数类型	是否必填	默认值	描述
OpenId	string	是		密钥Id
GrantCode	string	是		授权code
Token	string	是		签名，参考《数字签名sign》
Timestamp	string	是		当前时间戳
Nonce	string	是		随机正整数
Action	string	是	goods.stock-add	接口方法
Params	array	是		业务参数

请求参数

参数	参数类型	是否必填	默认值	描述
out_stock_type	int	是		出库的类型，出库类型 1 破损 2领用 3其他，4门店-销售出库，5.店铺销售出库
batch_date	string	否		出库日期
remark	string	否		出库备注
type	int	否		店铺或门店的标识，1代表店铺 2代表门店
out_stock	array	否
├0	array	否
├reta_trade_mark	string	是		出库编号：支持商品标识和条码（69）码。flag传1的时候reta_trade_mark参数的值为商品标识（最大支持64位长度的字符串），传2的时候reta_trade_mark的值为barcode（69码）
├qty	int	是		出库商品数量
flag	int	否	1	flag有两个值1和2。
reta_multi_mark	string	否		门店编码当 type=2 时该参数必填

响应参数

参数	参数类型	描述
errorData	array
├0	array
├barcode	string	请求成功时-》出库中出库失败的商品的编码
├qty	int	请求成功时-->r出库失败的出库数量
├errorMessage	string	错误提示信息
├reta_multi_mark	string	商品编码（标识）

请求示例

{
    "OpenId": "6dc05b4ac175cf316d226252b05cf685",
    "GrantCode": "782c281f62",
    "Timestamp": "1547186244",
    "Nonce": "658965",
    "Token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "Action": "goods.stock-add",
    "Params": {
        "out_stock_type": "",
        "batch_date": "",
        "remark": "",
        "type": "",
        "out_stock": [
            {
                "reta_trade_mark": "",
                "qty": ""
            }
        ],
        "flag": "",
        "reta_multi_mark": ""
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": {
        "errorData": [
            {
                "barcode": "",
                "qty": "",
                "errorMessage": "",
                "reta_multi_mark": ""
            }
        ]
    }
}

异常示例

{
    "status": true,
    "code": "异常编码，根据不同的业务返回编码",
    "message": "异常说明：查询的信息不存在"
}

错误码

{
    "status": false,
    "code": "系统错误编码：详见全局返回编码",
    "message": "系统错误说明"
}