API开放平台

TIP

# 查询车铺销售单

请求方式： 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：否
prods.promotion_code VARCHAR(32) 否 买赠促销编码
prods.promotion_name VARCHAR(32) 否 买赠促销名称
prods.superposition_promotion_code VARCHAR(32) 否 买赠叠加编码
prods.superposition_promotion_name VARCHAR(32) 否 买赠叠加名称
prods.amount_promotion_code VARCHAR(32) 否 买赠送金额编码
prods.amount_promotion_name VARCHAR(32) 否 买赠送金额名称

# 新增车铺销售单

请求方式： 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 响应数据

← 车铺单推送 →