# 查询车铺销售单

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/dmscardistributeorder/v1/queryCarDistributeOrder/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "page_number": 1,
    "page_length": 100,
    "start_date": "2016-12-09",
    "end_date": "2016-12-09"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
page_number INT 当前页数,不传默认为1
page_length int 每页记录条数,默认最大是1000条,可以根据业务数据的大小自行优化调整
after_create_date VARCHAR(32) 创建时间之后。格式:yyyy-MM-dd HH:mm:ss
after_modify_date VARCHAR(32) 修改时间之后。格式:yyyy-MM-dd HH:mm:ss
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示例:

[
    {
        "emp_dept_id": "10", 
        "supply_id": "4770912364031621073", 
        "from_storehouse_code": "CK1", 
        "prods": [
            {
                "order_input_unit_name": "盒", 
                "is_gift": "N", 
                "order_discount_amount": 0, 
                "product_id": "6692513571119135747", 
                "order_base_unit_count": 1, 
                "remark": "", 
                "order_input_unit": "1", 
                "product_name": "测试商品1", 
                "order_id": "5387924606115660563", 
                "order_price": 1200, 
                "posnr": 10, 
                "order_cost_price": 5, 
                "base_unit": "1", 
                "product_source_code": null, 
                "order_amount": 1200, 
                "order_tax": 0.17, 
                "product_code": "1HBSKLSD", 
                "order_tax_amount": 174.36, 
                "order_base_unit_name": "盒", 
                "order_cost_amount": 5, 
                "order_count": 1
            }
        ], 
        "cm_id": "7581300961993665224", 
        "receive_phone": "", 
        "receive_name": "", 
        "supply_name": "南京雨花一级经销商", 
        "emp_dept_code": "dms", 
        "pictures": null, 
        "remarks": "", 
        "cm_dept_code": "dms", 
        "from_storehouse_target_name": "南京雨花一级经销商", 
        "from_storehouse": "1", 
        "date": "2017-03-28", 
        "order_no": "CP20170328000001", 
        "id": "5387924606115660563", 
        "cm_code": "CUS000066", 
        "cm_source_code": null, 
        "order_amount": 1200, 
        "cm_dept_id": "10", 
        "order_tax_amount": 174.36, 
        "order_source": "NBZHSJ", 
        "order_cost_amount": 5, 
        "receive_addr": "", 
        "receive_tel": "", 
        "cm_name": "newmendian1", 
        "emp_dept_name": "dms", 
        "emp_code": "xyd", 
        "emp_dept_source_code": "dms", 
        "order_discount_amount": 0, 
        "supply_code": "0008099346", 
        "status": "1", 
        "from_storehouse_name": "11", 
        "emp_id": "5623756076322438484", 
        "from_storehouse_target_code": "0008099346", 
        "from_storehouse_target_source_code": null, 
        "cm_dept_name": "dms", 
        "emp_source_code": "xyd", 
        "supply_source_code": null, 
        "from_storehouse_target_id": "4770912364031621073", 
        "emp_name": "翔业代", 
        "cm_dept_source_code": "dms", 
        "order_type": "FX"
    }
]

参数说明:

参数 类型 必填 说明
id INT8 车铺单ID
status VARCHAR(32) 车铺单状态。0:已删除,1:正常
order_no VARCHAR(100) 车铺单编号
date VARCHAR(100) 业务日期。格式:yyyy-mm-dd
emp_dept_id INT8 业务员当时下单所在的部门id
emp_dept_code VARCHAR(100) 业务员当时下单所在的部门编码
emp_dept_name VARCHAR(100) 业务员当时下单所在的部门名
emp_id INT8 经办人ID
emp_code VARCHAR(100) 经办人编码
emp_source_code VARCHAR(100) 员工关联的第三方id
emp_name VARCHAR(100) 经办人名称
cm_dept_id INT8 客户部门id
cm_dept_code VARCHAR(100) 客户部门编码
cm_dept_source_code VARCHAR(100) 客户部门源编码
cm_dept_name VARCHAR(100) 客户部门名
cm_id INT8 客户ID
cm_code VARCHAR(100) 客户编码
cm_source_code VARCHAR(100) 客户源编码
cm_name VARCHAR(100) 客户名称
pictures VARCHAR(100) 订单图片,全路径(多张逗号分隔)
supply_id INT8 供货商id 默认值是-1,-1就是厂家
supply_code VARCHAR(100) 供货商编码
supply_source_code VARCHAR(100) 供货商源编码
supply_name VARCHAR(100) 供货商名
order_type VARCHAR(100) 订单类型。ZY:直营,FX:分销
order_source varchar(100) NBZHSJ:内部账号手机(业代手机),NBZHWB:内部账号web(业代web),WBZHSJ:外部账号手机(客户手机),WBZHWB:外部账号web(客户web),MDWXXD:客户微信下单,JK:接口,DINGHUO365:(客户手机端),GJBF:高级拜访(业代高级拜访)
receive_name VARCHAR(100) 收货人名称
receive_phone VARCHAR(100) 收货人手机号码
receive_tel VARCHAR(100) 收货人电话
receive_addr VARCHAR(100) 收货地址
remarks text 备注
order_amount VARCHAR(100) 订货金额
order_discount_amount VARCHAR(100) 订货优惠金额
order_tax_amount VARCHAR(100) 订货税额
order_cost_amount VARCHAR(100) 订货成本金额
from_storehouse INT8 发货仓库id
from_storehouse_code VARCHAR(100) 发货仓库编码
from_storehouse_name VARCHAR(100) 仓库名称
from_storehouse_target_id INT8 发货仓库分配对象客户id
from_storehouse_target_code VARCHAR(100) 发货仓库分配对象客户编码
from_storehouse_target_source_code VARCHAR(100) 发货仓库分配对象客户源编码
from_storehouse_target_name VARCHAR(100) 发货仓库分配对象客户名称
visit_implement_id VARCHAR(100) 关联的高级拜访id
prods List 列表
prods.id INT8 子表id
prods.product_id varchar(32) 商品ID
prods.product_code VARCHAR(100) 商品编码
prods.product_source_code VARCHAR(100) 商品源编码
prods.product_name VARCHAR(100) 商品名称
prods.order_price numeric(20,8) 订货价格
prods.order_count numeric(10,8) 订货数量
prods.order_input_unit INT8 订货单位id
prods.order_input_unit_name VARCHAR(100) 订货单位名
prods.base_unit INT8 商品的基本单位id
prods.order_base_unit_name VARCHAR(100) 商品的基本单位名
prods.order_base_unit_count numeric(10,8) 订货数量转化成基本单位的数量
prods.order_amount numeric(20,2) 订货的金额
prods.order_cost_amount numeric(20,2) 订货成本金额
prods.order_cost_price numeric(20,8) 订货商品成本价
prods.order_discount_amount numeric(20,2) 订货优惠金额
prods.order_tax numeric(20,2) 订货商品税率
prods.order_tax_amount numeric(20,2) 订货税额
prods.remark text 备注
prods.order_id INT8 车铺单主表id
prods.posnr NUMERIC(20) 序号
prods.is_gift VARCHAR(32) 是否是商品促销策略里面的赠品。Y:是,N:否

# 新增车铺销售单

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/dmscardistributeorder/v1/saveCarDistributeOrder/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "operate_type": "1",
    "order_no": "CP20220712000002",
    "date": "2022-07-01 13:15",
    "supply_code": "CUS010323",
    "cm_code": "CUS010644",
    "emp_code": "wuhao",
    "from_storehouse_code": "CK0465",
    "order_amount": "1233.00",
    "order_discount_amount": "112",
    "products": [
        {
            "product_code": "066",
            "order_price": "11",
            "order_count": "11",
            "order_input_unit_name": "盒",
            "order_amount": "11",
            "is_gift": "1",
            "posnr": "11"
        }
    ]
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
operate_type VARCHAR(32) 1:新增车铺单
order_no VARCHAR(100)  新增的时候传递作为新订单的单号(不传系统自动生成)
date VARCHAR(32)  下单时间。格式:yyyy-MM-dd HH:mm
supply_id VARCHAR(32)  供货商id;供货商id和供货商编码必须传一个
supply_code VARCHAR(100) 供货商编码;供货商id和供货商编码必须传一个
cm_id VARCHAR(32)  客户id;客户id和客户编码必须传一个
cm_code VARCHAR(100)  客户编码;客户id和客户编码必须传一个 
emp_id VARCHAR(32)  业务员Id;业务员id和业务员编码都不传时,默认取客户的一个客户经理 
emp_code VARCHAR(100)  业务员编码;业务员id和业务员编码都不传时,默认取客户的一个客户经理 
from_storehouse VARCHAR(32)  供货商发货仓库id;如果供应商发货仓库id和供应商发货仓库编码都不传,则根据供应商去查询默认仓库 
from_storehouse_code VARCHAR(100)  供货商发货仓库编码;如果供应商发货仓库id和供应商发货仓库编码都不传,则根据供应商去查询默认仓库 
order_amount NUMERIC(20,2)  订单金额;精度最高两位小数  
order_discount_amount NUMERIC(20,2)  订单优惠金额;精度最高两位小数 
products.product_id VARCHAR(32)  商品id;商品id和商品编码必须传一个 
products.product_code VARCHAR(100)  商品编码;商品id和商品编码必须传一个 
products.order_price NUMERIC(20,8)  订货价;不传就取客户价格,赠品价格为0 
products.order_count NUMERIC(10,8)  订货数量 
products.order_input_unit INT8  订货单位id;订货单位id和订货单位名称传一个即可,不传使用基本单位 
products.order_input_unit_name VARCHAR(100)  订货单位名称;订货单位id和订货单位名称传一个即可,不传使用基本单位 
products.order_amount NUMERIC(20,2)  订货金额 
products.is_gift VARCHAR(2)  是否是赠品。1:是,0:否。不传默认为非赠品 
products.posnr VARCHAR(32)  序号 

响应示例:

{
	"msg_id": "X000001",
	"return_code": 1,
	"return_msg": "",
	"response_data": null
}

参数说明:

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码。0:成功,1:失败。其他详见附录错误码说明 (opens new window)
return_msg String 响应说明
response_data String 响应数据