API开放平台

TIP

# 分销车销 - 调拨单查询接口

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

{
	"page_number": 1,
	"start_create_date": "2017-05-01",
	"end_create_date": "2017-05-31"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
start_create_date TIMESTAMP 否 创建时间开始。格式：yyyy-MM-dd
end_create_date TIMESTAMP 否 创建时间结束。格式：yyyy-MM-dd
start_modify_date TIMESTAMP 否 修改时间开始。格式：yyyy-MM-dd
end_modify_date TIMESTAMP 否 修改时间结束。格式：yyyy-MM-dd
page_number INT 否 页码默认1，每页默认1000条
page_length INT 否 每页记录条数，默认最大是1000条，可以根据业务数据的大小自行优化调整

响应示例：

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

数据DATA示例:

[
    {
        "bill_date": "2019-09-04 16:58:08",
        "requisition_id": "",
        "requisition_code": "",
        "creator_id": "4952428432913340544",
        "creator_code": "xubing",
        "creator_name": "徐兵老板测试账号",
        "emp_id": "4952428432913340544",
        "emp_code": "xubing",
        "emp_name": "徐兵老板测试账号",
        "from_storehouse_id": "3333",
        "from_storehouse_code": "CK0124",
        "from_storehouse_name": "经销商仓库",
        "to_storehouse_id": "4444",
        "to_storehouse_code": "CK0124",
        "to_storehouse_name": "车辆",
        "supplier_id": "8590605014384524975",
        "supplier_code": "CS000835",
        "supplier_name": "灭霸势力团伙",
        "from_storehouse_type": "CL",
        "to_storehouse_type": "CL",
        "remark": "备注",
        "approval_status": "待审批",
        "approval_time": "2019-09-11 13:35:11",
        "status": "1",
        "create_time": "2019-09-04 16:57:57",
        "modify_time": "2019-09-11 13:38:04",
        "prods": [
            {
                "prod_id": "5037862861364899019",
                "prod_code": "1010",
                "prod_name": "果粒橙",
                "out_cargo_space": "正常品库",
                "in_cargo_space": "正常品库",
                "basic_unit_cnt": "1",
                "requisition_unit_cnt": "1",
                "requisition_unit_id": "10",
                "requisition_unit_name": "1",
                "remark": ""
            }
        ]
    }
]

参数说明：

参数 类型 必填 说明
bill_date TIMESTAMP 否 单据日期。格式：yyyy-mm-dd
requisition_id VARCHAR(32) 否 调拨单主表id
requisition_code VARCHAR(32) 否 调拨单号
creator_id VARCHAR(32) 否 创建人Id
creator_code VARCHAR(32) 否 创建人编码
creator_name VARCHAR(100) 否 创建人名称
emp_id VARCHAR(32) 否 经办人Id
emp_code VARCHAR(32) 否 经办人编码
emp_name VARCHAR(100) 否 经办人名称
from_storehouse_id VARCHAR(32) 否 调出仓库/车库id
from_storehouse_code VARCHAR(32) 否 调出仓库/车库编码
from_storehouse_name VARCHAR(100) 否 调出仓库名称/车号
to_storehouse_id VARCHAR(32) 否 调入仓库/车库id
to_storehouse_code VARCHAR(32) 否 调入仓库/车库编码
to_storehouse_name VARCHAR(100) 否 调入仓库/车号
supplier_id VARCHAR(32) 否 经销商ID
supplier_code VARCHAR(32) 否 经销商代码
supplier_name VARCHAR(100) 否 经销商名称
from_storehouse_type VARCHAR(32) 否 调出仓库类型。CL：车，JXSCK：经销商仓库
to_storehouse_type VARCHAR(32) 否 调入仓库类型。CL：车，JXSCK：经销商仓库
remark VARCHAR(300) 否 备注
approval_status VARCHAR(1) 否 审批状态。0：待确认，1：已确认，2：作废
approval_time TIMESTAMP 否 审批时间
status VARCHAR(1) 否 删除状态。0：删除，1：未删除
create_time TIMESTAMP 否 创建时间
modify_time TIMESTAMP 否 修改时间
prods List 否 列表
prods.prod_id VARCHAR(32) 否 商品id
prods.prod_code VARCHAR(32) 否 商品编码
prods.prod_name VARCHAR(100) 否 商品名称
prods.out_cargo_space VARCHAR(1) 否 调出货位。1：正常品库，2：报废品库，3：处理品库（不传认为是正常品库）
prods.in_cargo_space VARCHAR(1) 否 调入货位。1：正常品库，2：报废品库，3：处理品库（不传认为是正常品库）
prods.basic_unit_cnt numeric(28,8) 否 基本单位数量
prods.requisition_unit_cnt numeric(28,8) 否 调拨单位数量
prods.requisition_unit_id VARCHAR(32) 否 调拨单位id
prods.requisition_unit_name VARCHAR(100) 否 调拨单位名称
prods.remark VARCHAR(200) 否 行备注

# 分销车销 - 车销单查询接口

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

{
    "page_number": 1,
    "start_create_date": "2017-05-01",
    "end_create_date": "2017-05-31"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
start_create_date TIMESTAMP 否 创建时间开始。格式：yyyy-MM-dd
end_create_date TIMESTAMP 否 创建时间结束。格式：yyyy-MM-dd
start_modify_date TIMESTAMP 否 修改时间开始。格式：yyyy-MM-dd
end_modify_date TIMESTAMP 否 修改时间结束。格式：yyyy-MM-dd
page_number INT 否 页码默认1，每页默认1000条
page_length INT 否 每页记录条数，默认最大是1000条，可以根据业务数据的大小自行优化调整

响应示例：

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

数据DATA示例:

[
    {
        "car_sale_id": "8195117324252240294",
        "hc_status": "0",
        "supplier_id": "6479661642303758510",
        "supplier_code": "",
        "supplier_name": "",
        "car_id": "7231446725934251640",
        "car_no": "CK0001",
        "car_name": "张昊忱经销商",
        "car_sale_no": "CXD201909200014",
        "submit_time": "2019-09-20 15:27:16",
        "create_time": "2019-09-20 15:27:16",
        "emp_id": "6001765659012760985",
        "emp_code": "zuoxiao",
        "emp_name": "左潇",
        "emp_sourcecode": "",
        "cm_id": "7966827811826367011",
        "cm_code": "DD000201900573",
        "cm_name": "审批0902",
        "cm_sourcecode": "",
        "sale_amount": "45000.00",
        "discount_amount": "100.00",
        "total_amount": "50000.00",
        "return_amount": "200.00",
        "deal_amount": "45000.00",
        "remark": "bz",
        "return_reason": "退货原因",
        "status": "1",
        "prods": [
            {
                "car_sale_type": "销售",
                "sale_type_id": "123",
                "sale_type_name": "",
                "prod_id": "7849829512066200770",
                "prod_name": "6644",
                "prod_code": "6644",
                "prod_sourcecode": "",
                "input_cnt": "1",
                "input_unit_id": "7213508454850586085",
                "input_unit_name": "袋",
                "prod_basic_unit_id": "7213508454850586085",
                "prod_basic_unit_name": "袋",
                "prod_basic_unit_cnt": "1",
                "amount": "44.00",
                "input_unit_price": "100.00",
                "line_discount_amount": "44.00",
                "remark": "bz",
                "is_gift": "0",
                "promotion_code": "CUX0052",
                "promotion_name": "促销1",
                "promotion_type": "OVERLAP",
                "promotion_tag": "TAG_TJ",
                "promotion_calc_mode": "MODE_MZ",
                "promotion_calc_type": "TYPE_NUM",
                "superposition_promotion_code": "",
                "superposition_promotion_name": "",
                "amount_promotion_code": "",
                "amount_promotion_name": ""
            }
        ]
    }
]

参数说明：

参数 类型 必填 说明
car_sale_id VARCHAR(32) 否 车销单ID
hc_status VARCHAR(1) 否 红冲状态。0：正常，1：被红冲，2：红冲
supplier_id VARCHAR(32) 否 经销商ID
supplier_code VARCHAR(32) 否 经销商代码
supplier_name VARCHAR(100) 否 经销商名称
car_id VARCHAR(32) 否 车辆id
car_no VARCHAR(32) 否 车辆编号
car_name VARCHAR(100) 否 车辆名称
car_sale_no VARCHAR(32) 否 车销单编号
submit_time TIMESTAMP 否 提交日期。格式：yyyy-mm-dd hh24:mi:ss
create_time TIMESTAMP 否 创建日期。格式：yyyy-mm-dd hh24:mi:ss
emp_id VARCHAR(32) 否 业务员id
emp_code VARCHAR(32) 否 业务员编码
emp_name VARCHAR(50) 否 业务员名称
emp_sourcecode VARCHAR(32) 否 业务员sourcecode
cm_id VARCHAR(32) 否 客户id
cm_code VARCHAR(32) 否 客户编码
cm_name VARCHAR(100) 否 客户名称
cm_sourcecode VARCHAR(32) 否 客户sourcecode
sale_amount numeric(20,2) 否 优惠前销售金额合计
discount_amount numeric(20,2) 否 销售优惠金额
total_amount numeric(20,2) 否 优惠后销售金额合计
return_amount numeric(20,2) 否 退货金额合计
deal_amount numeric(20,2) 否 成交金额
remark VARCHAR(100) 否 备注
return_reason VARCHAR(100) 否 退货原因
status VARCHAR(1) 否 删除状态。0：删除，1：未删除
prods List 否 列表
prods.car_sale_type VARCHAR(1) 否 车销类型。1：销售，2：退货
prods.sale_type_id VARCHAR(32) 否 销售类型id
prods.sale_type_name VARCHAR(100) 否 销售类型名称
prods.prod_id VARCHAR(32) 否 商品id
prods.prod_name VARCHAR(50) 否 商品名称
prods.prod_code VARCHAR(32) 否 商品编码
prods.prod_sourcecode VARCHAR(32) 否 商品对应sourcecode
prods.input_cnt numeric(28,8) 否 录入数量
prods.input_unit_id VARCHAR(32) 否 录入单位id
prods.input_unit_name VARCHAR(50) 否 录入单位名称
prods.prod_basic_unit_id VARCHAR(32) 否 商品基本单位id
prods.prod_basic_unit_name VARCHAR(50) 否 商品基本单位名称
prods.prod_basic_unit_cnt numeric(28,8) 否 基本单位数量
prods.amount numeric(20,2) 否 金额
prods.input_unit_price numeric(28,8) 否 录入单位单价
prods.line_discount_amount numeric(20,2) 否 行优惠金额
prods.remark VARCHAR(100) 否 子表行备注
prods.is_gift VARCHAR(1) 否 是否赠品。1:是，0：否
prods.promotion_code varchar(200) 否 促销编码
prods.promotion_name varchar(200) 否 促销名称
prods.promotion_type varchar(200) 否 促销类型。BASE：基本策略，OVERLAP：叠加策略。默认BASE
prods.promotion_tag varchar(200) 否 促销力度。TAG_CHG：常规，TAG_TJ：特别推荐。默认TAG_CHGv
prods.promotion_calc_mode varchar(200) 否 促销模式。MODE_MZ：满赠，MODE_JT：阶梯
prods.promotion_calc_type varchar(200) 否 搭赠方式。TYPE_NUM：按订购量，TYPE_MONEY：按订购额
prods.superposition_promotion_code varchar(200) 否 叠加促销编码
prods.superposition_promotion_name varchar(200) 否 叠加促销名称
prods.amount_promotion_code varchar(200) 否 金额促销编码
prods.amount_promotion_name varchar(200) 否 金额促销名称

# 经销商车辆查询接口

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

{
    "page_number": 1,
    "start_create_date": "2017-05-01",
    "end_create_date": "2017-05-31"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
start_create_date TIMESTAMP 否 创建时间开始。格式：yyyy-MM-dd
end_create_date TIMESTAMP 否 创建时间结束。格式：yyyy-MM-dd
start_modify_date TIMESTAMP 否 修改时间开始。格式：yyyy-MM-dd
end_modify_date TIMESTAMP 否 修改时间结束。格式：yyyy-MM-dd
page_number INT 否 页码默认1，每页默认1000条
page_length INT 否 每页记录条数，默认最大是1000条，可以根据业务数据的大小自行优化调整

响应示例：

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

数据DATA示例:

[
    {
       "car_id": "5629025084242505422",
        "car_code": "CK0830",
        "car_no": "CK0830",
        "supplier_id": "6803193180468604054",
        "supplier_code": "CM20190428051",
        "supplier_name": "苏果夫子庙店20190428051",
        "emp_id": "4952428432913340544",
        "emp_code": "xubing",
        "emp_name": "徐兵老板测试账号",
        "status": "1",
           "is_enable": "QY",
        "create_time": "2019-10-15",
        "modify_time": "2020-01-17"
    }
]

参数说明：

参数 类型 必填 说明
car_id VARCHAR(32) 否 车辆ID
car_code VARCHAR(32) 否 编码
car_no VARCHAR(32) 否 车号
supplier_id VARCHAR(32) 否 经销商ID
supplier_code VARCHAR(32) 否 经销商编码
supplier_name VARCHAR(100) 否 经销商名称
emp_id VARCHAR(32) 否 业务员ID
emp_code VARCHAR(32) 否 业务员代码
emp_name VARCHAR(100) 否 业务员名称
status VARCHAR(1) 否 状态。0：删除，1：未删除
is_enable VARCHAR(10) 否 停用启用状态。QY：启用，TY：停用
create_time TIMESTAMP 否 创建时间
modify_time TIMESTAMP 否 修改时间

# 经销商车辆库存查询接口

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

{
    "page_number": 1,
    "start_create_date": "2017-05-01",
    "end_create_date": "2017-05-31"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
start_create_date TIMESTAMP 否 创建时间开始。格式：yyyy-MM-dd
end_create_date TIMESTAMP 否 创建时间结束。格式：yyyy-MM-dd
start_modify_date TIMESTAMP 否 修改时间开始。格式：yyyy-MM-dd
end_modify_date TIMESTAMP 否 修改时间结束。格式：yyyy-MM-dd
page_number INT 否 页码默认1，每页默认1000条
page_length INT 否 每页记录条数，默认最大是1000条，可以根据业务数据的大小自行优化调整

响应示例：

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

数据DATA示例:

[
    {
       "car_id": "5629025084242505422",
       "car_no": "",
       "car_name": "",
       "supplier_id": "6803193180468604054",
       "supplier_code": "CS000835",
       "supplier_name": "灭霸势力团伙",
       "prod_id": "7849829512066200770",
       "prod_code": "",
       "prod_name": "",
       "prod_sourcecode": "",
       "basic_unit_id": "7213508454850586085",
       "basic_unit_name": "",
       "basic_unit_stock_cnt": "3",
       "status": "1",
       "create_time": "2019-10-15",
       "modify_time": "2020-01-17"
    }
]

参数说明：

参数 类型 必填 说明
car_id VARCHAR(32) 否 车辆ID
car_no VARCHAR(32) 否 车辆编码
car_name VARCHAR(100) 否 车辆名称
supplier_id VARCHAR(32) 否 经销商ID
supplier_code VARCHAR(32) 否 经销商代码
supplier_name VARCHAR(100) 否 经销商名称
prod_id VARCHAR(32) 否 商品ID
prod_code VARCHAR(32) 否 商品编码
prod_name VARCHAR(100) 否 商品名称
prod_sourcecode VARCHAR(32) 否 商品第三方id
basic_unit_id VARCHAR(32) 否 基本单位ID
basic_unit_name VARCHAR(100) 否 基本单位名称
basic_unit_stock_cnt numeric(28,8) 否 基本单位库存数量
status VARCHAR(1) 否 状态。0：删除，1：未删除
create_time TIMESTAMP 否 创建时间
modify_time TIMESTAMP 否 修改时间

# 查询车辆盘点单

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


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

参数说明：

参数 类型 必填 说明
start_create_date TIMESTAMP 否 创建时间开始。格式：yyyy-MM-dd
end_create_date TIMESTAMP 否 创建时间结束。格式：yyyy-MM-dd
start_modify_date TIMESTAMP 否 修改时间开始。格式：yyyy-MM-dd
end_modify_date TIMESTAMP 否 修改时间结束。格式：yyyy-MM-dd
after_create_date TIMESTAMP 否 创建时间之后。格式：yyyy-MM-dd HH:mm:ss
after_modify_date TIMESTAMP 否 修改时间之后。格式：yyyy-MM-dd HH:mm:ss
page_number INT 否 页码默认值是1，每页默认1000条
page_length INT 否 每页记录条数，默认最大是1000条，可以根据数据的大小自行优化调整

响应示例：

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

数据DATA示例:

[
    {
       "confirm_emp_code": null, 
       "inventory_type": "1", 
       "confirm_emp_source_code": null, 
       "confirm_emp_name": null, 
       "prods": [
           {
               "goods_location": "1",
               "actual_stock": 2137.145, 
               "current_stock": 2137.145, 
               "prod_source_code": null, 
               "prod_id": "6692513571119135747", 
               "detail_id": "5183969319998512131", 
               "sequ": 0, 
               "difference_stock": 0, 
               "prod_code": "1HBSKLSD", 
               "prod_name": "测试商品1"
           }
       ], 
       "inventory_status": "1", 
       "remarks": "", 
       "emp": "8724832689904775768", 
       "date": "2017-08-21", 
       "car": "8878885617773144765", 
       "id": "5183969319998512131", 
       "car_name": "1ed", 
       "car_code": "CK0076", 
       "supplier_id": "5012103144063463929", 
       "create_name": "张三",
       "create_emp_name": "王伟", 
       "create_emp_code": "wangwei", 
       "status": "1", 
       "emp_source_code": "wangwei", 
       "confirm_emp_id": null, 
       "emp_name": "员工1", 
       "confirm_time": null
    }
]

参数说明：

参数 类型 必填 说明
id INT8 是 盘点单ID
status VARCHAR(32) 否 0：已删除，1：正常
inventory_status VARCHAR(32) 否 盘点状态。0：未审核，1：已审核，2：已作废
inventory_type VARCHAR(32) 否 盘点类型。1：全部盘点，2：部分盘点
date VARCHAR(100) 否 盘点日期。格式：yyyy-mm-dd
create_time VARCHAR(100) 否 创建时间。格式：yyyy-mm-dd HH:mm:ss
modify_time VARCHAR(100) 否 修改时间。格式：yyyy-mm-dd HH:mm:ss
emp INT8 否 经办人ID
emp_code VARCHAR(100) 否 经办人编码
emp_source_code VARCHAR(100) 否 经办人源编码
emp_name VARCHAR(100) 否 经办人名称
create_id INT8 否 创建人ID
create_emp_code VARCHAR(100) 否 创建人编码
create_emp_source_code VARCHAR(100) 否 创建人源编码
create_emp_name VARCHAR(100) 否 创建人名称
car INT8 否 车辆ID
car_code VARCHAR(100) 否 车辆编码
car_name VARCHAR(100) 否 车辆名称
supplier_id INT8 否 经销商id
remarks text 否 备注
confirm_emp_id INT8 否 确认人ID
confirm_emp_code VARCHAR(100) 否 确认人编码
confirm_emp_source_code VARCHAR(100) 否 确认人源编码
confirm_emp_name VARCHAR(100) 否 确认人名称
confirm_time VARCHAR(100) 否 确认时间。格式：yyyy-mm-dd HH:mm:ss
prods List 列表
prods.detail_id INT8 是 盘点子表ID
prods.prod_id VARCHAR(32) 否 商品ID
prods.prod_code VARCHAR(100) 否 商品编码
prods.prod_source_code VARCHAR(100) 否 商品源编码
prods.prod_name VARCHAR(100) 否 商品名称
prods.current_stock numeric(10,8) 否 当前库存，基本单位
prods.actual_stock numeric(10,8) 否 实物库存，基本单位
prods.difference_stock numeric(10,8) 否 差异数量，基本单位
prods.goods_location VARCHAR(32) 否 1：正常品库(可销库存)，2：报废品库(退货库存)，3：处理品库(换货库存)

← 企业仓库接口 →