API开放平台

TIP

# 查询销量上报记录数据

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/std_xlsb/v1/queryStdXlsbBas/{openid}/{timestamp}/{digest}/{msg_id} 在线调试
请求示例：

{ 
	 "page_number" : "1",
	 "id" : "7380445682462409504",
	 "start_create_date" : "2020-01-15",
	 "end_create_date" : "2020-03-12" 
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
page_number VARCHAR(32) 是 页码默认1，每页默认1000条
id VARCHAR(32) 否 勤策销量上报记录ID
sod_no VARCHAR(32) 否 勤策销量上报记录编码
cm_id VARCHAR(32) 否 勤策客户唯一ID
cm_code VARCHAR(32) 否 客户编码，有效字符详见附录：有效字符说明 (opens new window)
start_create_date VARCHAR(32) 否 开始创建时间。格式：yyyy-MM-dd
end_create_date VARCHAR(32) 否 结束创建时间。格式：yyyy-MM-dd
start_modify_date VARCHAR(32) 否 开始修改时间。格式：yyyy-MM-dd
end_modify_date VARCHAR(32) 否 结束修改时间。格式：yyyy-MM-dd

响应示例：

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",  
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
    {
        "id":"7660990926344748617",
         "status":"0",
         "sod_no":"SL202003060007",
         "submit_date":"2020-03-20",
         "order_status":"1",
         "emp_id":"9085738668330031017",
         "emp_name":"cwq",
         "emp_code":"cwq",
         "emp_source_code":"",
         "cm_id":"8945065116197240796",
         "cm_name":"cwq_终端门店",
         "cm_code":"DDJY0201900002",
         "cm_source_code":"",
         "dealer_id":"",
         "dealer_source_code":"",
         "dealer_code":"",
         "dealer_name":"",
         "confirm_emp_id":"9085738668330031017",
         "confirm_emp_code":"cwq",
         "confirm_emp_name":"cwq",
         "confirm_emp_source_code":"",
         "confirm_time":"2020-03-06 17:25:26",
         "cancel_reason":"",
         "all_amount":"1.00",
         "pictures": "",
         "prods":[{
            "product_id":"5526049081368313017",
            "product_code":"cwq",
            "product_name":"cwq",
            "product_source_code":"",
            "product_spec":"zzz [ XXL 灰 喷蓝火的加特林 火神 ]",
            "input_unit":"5670026514456841449",
            "input_unit_name":"箱",
            "bas_unit":"9135273768540919597",
            "bas_unit_name":"杯",
            "qty":"1.000",
            "base_unit_qty":"10.000",
            "price":"1.00",
            "amount":"1.00",
            "remark":"这是cwq商品的备注"
         }]
    }
]

参数说明：

参数 类型 必填 说明
id VARCHAR(32) 是 销量上报记录ID
status VARCHAR(1) 是 销量上报记录状态 0：已删除，1：正常
sod_no VARCHAR(32) 是 销量上报记录编号
submit_date VARCHAR(32) 是 业务日期，yyyy-mm-dd 格式
order_status VARCHAR(1) 是 销量上报记录单据状态 0:待确认，1:已确认，2:打回
emp_id VARCHAR(32) 是 提交人id
emp_code VARCHAR(32) 是 提交人编码
emp_name VARCHAR(32) 是 提交人名称
emp_source_code VARCHAR(32) 是 提交人sourcecode
cm_id VARCHAR(32) 是 客户id
cm_code VARCHAR(32) 是 客户编码
cm_name VARCHAR(32) 是 客户名称
cm_source_code VARCHAR(32) 是 客户sourcecode
dealer_id VARCHAR(32) 是 经销商id
dealer_code VARCHAR(32) 是 经销商编码
dealer_name VARCHAR(32) 是 经销商名称
dealer_source_code VARCHAR(32) 是 经销商sourcecode
confirm_emp_id VARCHAR(32) 是 确认人/打回人id
confirm_emp_code VARCHAR(32) 是 确认人/打回人编码
confirm_emp_name VARCHAR(32) 是 确认人/打回人名称
confirm_emp_source_code VARCHAR(32) 是 确认人/打回人sourcecode
cancel_reason VARCHAR(400) 是 打回原因
confirm_time VARCHAR(32) 是 确认时间/打回时间，yyyy-mm-dd hh24:mi:ss 格式
all_amount VARCHAR(32) 是 上报的总金额
remarks VARCHAR(4000) 否 订单备注
pictures TEXT 否 图片
prods List 是 列表
prods.product_id VARCHAR(32) 是 商品id
prods.product_name VARCHAR(400) 是 商品名称
prods.product_code VARCHAR(400) 是 商品编码
prods.product_source_code VARCHAR(400) 是 商品对应sourcecode
prods.product_spec VARCHAR(400) 是 商品规格
prods.input_unit VARCHAR(32) 是 商品录入单位id
prods.input_unit_name VARCHAR(32) 是 商品录入单位名称
prods.bas_unit VARCHAR(32) 是 商品基本单位id
prods.bas_unit_name VARCHAR(32) 是 商品基本单位名称
prods.qty VARCHAR(32) 是 录入单位上报数量
prods.base_unit_qty VARCHAR(32) 是 录入单位上报数量转化成基本单位数量
prods.price VARCHAR(32) 是 商品上报价格
prods.amount VARCHAR(32) 是 商品上报金额
prods.remark varchar(400) 是 备注

# 新增销量上报记录数据

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/std_xlsb/v1/addStdXlsbBas/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{ 
    "cm_id":"8945065116197240796",
    "submit_date":"2020-03-20",
    "emp_id":"9085738668330031017",
    "dealer_id":"7570909532784661629",
    "prods":[
        {
            "product_id":"5526049081368313017",
            "qty":"1",
            "price":"1",
            "amount":"1",
            "input_unit":"5670026514456841449",
            "remarks":"这是徐兵商品的备注"
        }
    ]
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
emp_id VARCHAR(32) 否 上报人Id,上报人编码，上报人名称必须传一个
emp_code VARCHAR(100) 否 上报人Id,上报人编码，上报人名称必须传一个
emp_name VARCHAR(100) 否 上报人Id,上报人编码，上报人名称必须传一个
dealer_id VARCHAR(32) 否 经销商Id，经销商编码和经销商名称传一个,非必传
dealer_code VARCHAR(100) 否 经销商Id，经销商编码和经销商名称传一个,非必传
dealer_name VARCHAR(100) 否 经销商Id，经销商编码和经销商名称传一个,非必传
cm_id VARCHAR(32) 否 客户Id，客户编码和客户名称必须传一个
cm_code VARCHAR(100) 否 客户Id，客户编码和客户名称必须传一个
cm_name VARCHAR(100) 否 客户Id，客户编码和客户名称必须传一个
submit_date VARCHAR(32) 是 上报日期。格式：yyyy-MM-dd
remarks VARCHAR(4000) 否 订单备注
prods List 否 列表
prods.product_id VARCHAR(100) 否 商品id，商品编码和商品名称必须传一个
prods.product_code VARCHAR(100) 否 商品id，商品编码和商品名称必须传一个
prods.product_name VARCHAR(100) 否 商品id，商品编码和商品名称必须传一个
prods.input_unit VARCHAR(100) 否 录入单位Id和录入单位名称必须传一个
prods.input_unit_name VARCHAR(100) 否 录入单位Id和录入单位名称必须传一个
prods.qty VARCHAR(100) 是 上报数量
prods.price VARCHAR(100) 是 上报价格
prods.amount VARCHAR(100) 是 上报金额
prods.remarks VARCHAR(400) 否 备注

响应示例：

{
    "return_code": "0",
    "return_msg": "",
    "msg_id": "X000001"
}

参数说明：

参数 类型 必填 说明
msg_id VARCHAR(32) 是 消息ID
return_code VARCHAR(32) 是 响应编码：0成功 1失败
return_msg VARCHAR(100) 是 响应说明

← 月销量上报接口 →