开放接口API说明-进销存相关接口

参数名称 参数值
应用编码 esss_car_inventory
应用版本 v1
接口名称 新增车辆盘点单
接口编码 addEsssCarInventory
接口URL https://openapi.waiqin365.com/api/esss_car_inventory/v1/addEsssCarInventory/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求信息 参数 类型 必填 说明
emp_name VARCHAR(100) 经办人姓名,经办人姓名和经办人编码必须传一个
emp_code VARCHAR(100) 经办人编码,经办人编码和经办人名称必须传一个
inventory_status VARCHAR(2) 盘点状态:0、未审核,1、已审核/td>
inventory_type VARCHAR(2) 盘点类型:1、全部盘点,2、部分盘点
date VARCHAR(30) 盘点日期
car_code VARCHAR(200) 车辆编码,车辆编码和车辆名称必须传一个
car_name VARCHAR(200) 车辆名称,车辆编码和车辆名称必须传一个
remarks VARCHAR(4000) 备注
prods[].prod_code VARCHAR(200) 正常商品清单:商品编码
prods[].actual_stock VARCHAR(50) 正常商品清单:实时库存(实时库存和差异数量必须传一个,两个都传以实时库存优先)
prods[].difference_stock VARCHAR(50) 差异数量(实时库存和差异数量必须传一个,两个都传以实时库存优先,正数表示盘盈库存将增加,负数表示盘亏库存将减少)
prods[].unit_name VARCHAR(50) 单位:不传默认基本单位
prods[].remarks VARCHAR(4000) 正常商品清单:备注说明
change_prods[].prod_code VARCHAR(200) 换货商品清单:商品编码
change_prods[].actual_stock VARCHAR(50) 换货商品清单:实时库存(实时库存和差异数量必须传一个,两个都传以实时库存优先)
change_prods[].difference_stock VARCHAR(50) 差异数量(实时库存和差异数量必须传一个,两个都传以实时库存优先,正数表示盘盈库存将增加,负数表示盘亏库存将减少)
change_prods[].unit_name VARCHAR(50) 单位:不传默认基本单位
change_prods[].remarks VARCHAR(4000) 换货商品清单:备注说明
return_prods[].prod_code VARCHAR(200) 退货商品清单:商品编码
return_prods[].actual_stock VARCHAR(50) 退货商品清单:实时库存(实时库存和差异数量必须传一个,两个都传以实时库存优先)
return_prods[].difference_stock VARCHAR(50) 差异数量(实时库存和差异数量必须传一个,两个都传以实时库存优先,正数表示盘盈库存将增加,负数表示盘亏库存将减少)
return_prods[].unit_name VARCHAR(50) 单位:不传默认基本单位
return_prods[].remarks VARCHAR(4000) 退货商品清单:备注说明
响应信息 参照表响应信息格式
msg_id VARCHAR(32) 消息ID
return_code VARCHAR(32) 响应编码:0成功 1失败
return_msg VARCHAR(100) 响应说明
response_data.id VARCHAR(100) 保存成功以后返回数据id
response_data.code VARCHAR(100) 保存成功以后返回单据编号
							
请求消息体示例:
{
    "emp_code": "scklb",
    "inventory_status": "0",
    "inventory_type": "1",
    "date": "2017-12-28",
    "car_name": "苏A99988",
    "remarks": "apitest",
    "prods": [
        {
            "prod_code": "000144aaa",
            "actual_stock": "10",
            "remarks": "apitest",
            "sequ": "0"
        }
    ],
    "change_prods": [
        {
            "prod_code": "100005",
            "actual_stock": "10",
            "remarks": "apitest",
            "sequ": "0"
        }
    ],
    "return_prods": [
        {
            "prod_code": "100004",
            "actual_stock": "10",
            "remarks": "apitest",
            "sequ": "0"
        }
    ]
}

响应信息示例:
{
    "return_code": "0",
    "return_msg": "",
    "msg_id": "X000001",
    "response_data":"{\"id\":\"6804307014933072458\",\"code\":\"PD201807170004\"}"
}
                  
						
参数名称 参数值
应用编码 esss_car_inventory
应用版本 v1
接口名称 审核库存盘点单
接口编码 verifyEsssCarInventory
接口URL https://openapi.waiqin365.com/api/esss_car_inventory/v1/verifyEsssCarInventory/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求信息 参数 类型 必填 说明
id VARCHAR(30) 订单id
remarks VARCHAR(4000) 备注
响应信息 参照表响应信息格式
msg_id VARCHAR(32) 消息ID
return_code VARCHAR(32) 响应编码:0成功 1失败
return_msg VARCHAR(100) 响应说明
							
请求消息体示例:
{
    "id": "8960493106396863467",
    "remarks": "verifytest",
}

响应信息示例:
{
    "return_code": "0",
    "return_msg": "",
    "msg_id": "X000001"
}