# 查询销量上报记录数据

请求方式: 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) 勤策(原外勤365)销量上报记录ID
sod_no VARCHAR(32) 勤策(原外勤365)销量上报记录编码
cm_id VARCHAR(32) 勤策(原外勤365)客户唯一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) 响应说明