# 新增直营订单发货单

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

{
    "sent_no": "FH201612100000001",
    "sent_date": "2020-12-10",
    "order_no": "DD201612090000001",
    "purchase_no": "CK20161209000001",
    "order_create_date": "2020-12-10",
    "cm_id": "6389893435290873348",
    "cm_code": "CM0001",
    "date": "2016-12-09",
    "emp_id": "9090338090192516225",
    "emp_code": "EMP0001",
    "consignment_date": "2016-12-10",
    "supply_id": "4778886974871755755",
    "supply_code": "SU00001",
    "sent_storehouse_id": "6210170610020953209",
    "sent_storehouse_code": "CK0001",
    "receive_name": "张三",
    "receive_phone": "18569854561",
    "receive_tel": "02578946932",
    "receive_addr": "江苏省南京市康缘智汇港",
    "receive_addr_id": "",
    "remark": "加急订单抓紧送货",
    "distribution_method": "配送方式",
    "exts": [
        {
            "cm_ext_key": "级别",
            "cm_ext_value": "四星"
        },
        {
            "cm_ext_key": "主营商品",
            "cm_ext_value": "食品,电器,日化用品"
        }
    ],
    "prods": [
        {
            "product_id": "7755038711664976249",
            "product_code": "PD001",
            "order_price": "20.000000",
            "order_count": "10.00000000",
            "order_input_unit": "6782340125265424027",
            "order_input_unit_name": "箱",
            "order_amount": "200.00",
            "order_discount_amount": "0.00",
            "sent_num": "5.00000000",
            "sent_input_unit": "6782340125265424027",
            "sent_input_unit_name": "箱",
            "is_gift": "N",
            "posnr": "10",
            "remark": "易损件",
            "exts": [
                {
                    "cm_ext_key": "级别",
                    "cm_ext_value": "四星"
                },
                {
                    "cm_ext_key": "主营商品",
                    "cm_ext_value": "食品,电器,日化用品"
                }
            ]
        }
    ]
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
sent_no VARCHAR(100) 发货单号不传自动生成
sent_date VARCHAR(32) 发货日期。格式:yyyy-mm-dd
order_no VARCHAR(100) 销售订单号,销售订单号和采购单号必须传一个
purchase_no VARCHAR(100) 采购单号,销售订单号和采购单号必须传一个
order_create_date VARCHAR(32) 订单创建日期。格式:yyyy-mm-dd
cm_id VARCHAR(32) 客户id,客户id和客户编码必须传一个
cm_code VARCHAR(100) 客户编码,客户id和客户编码必须传一个
date VARCHAR(32) 业务日期。格式:yyyy-mm-dd
emp_id VARCHAR(32) 业务员Id,业务员id和业务员编码都不传,默认取其中一个客户经理的
emp_code VARCHAR(100) 业务员编码,业务员id和业务员编码都不传默认取其中一个客户经理的
consignment_date VARCHAR(32) 要求交货日期。格式:yyyy-mm-dd
supply_id VARCHAR(32) 供应商id,-1表示厂家供货。如果供应商id和供应商编码(经销商的编码)都不传将根据客户的上级经销商来查询
supply_code VARCHAR(100) 供应商编码(经销商的编码),-1表示厂家供货。如果供应商id和供应商编码(经销商的编码)都不传将根据客户的上级经销商来查询
sent_storehouse_id VARCHAR(32) 供应商发货仓库id。如果供应商发货仓库id和供应商发货仓库编码都不传,则根据供应商去查询默认仓库
sent_storehouse_code VARCHAR(100) 供应商发货仓库编码。如果供应商发货仓库id和供应商发货仓库编码都不传,则根据供应商去查询默认仓库
receive_name VARCHAR(100) 收货人名称
receive_phone VARCHAR(32) 收货人手机
receive_tel VARCHAR(32) 收货人电话
receive_addr VARCHAR(1000) 收货地址
receive_addr_id VARCHAR(32) 收货地址id
remark text 订单表体备注
distribution_method text 配送方式
sent_receive_id VARCHAR(32) 发货单收货方id
sent_receive_code VARCHAR(100) 发货单收货方编码
sent_receive_name VARCHAR(100) 发货单收货方名称
sent_receive_addr_id VARCHAR(32) 发货单收货地址id
sent_receive_addr VARCHAR(100) 发货单收货地址名称
prods List 列表
prods.product_id VARCHAR(32) 商品id和商品编码必须传一个
prods.product_code VARCHAR(100) 商品id和商品编码必须传一个
prods.order_price NUMERIC(18,8) 订货价不传就取客户价格,赠品价格为0
prods.order_count NUMERIC(18,8) 订货数量
prods.order_input_unit VARCHAR(32) 订货单位id和订货单位名称传一个即可,不传使用基本单位
prods.order_input_unit_name VARCHAR(32) 订货单位id和订货单位名称传一个即可,不传使用基本单位
prods.order_amount NUMERIC(18,2) 订货金额
prods.order_discount_amount NUMERIC(18,2) 订货优惠金额
prods.sent_num NUMERIC(18,8) 发货数量
prods.sent_input_unit VARCHAR(32) 发货单位和发货单位名称传一个即可,不传使用基本单位
prods.sent_input_unit_name VARCHAR(32) 发货单位和发货单位名称传一个即可,不传使用基本单位
prods.is_gift VARCHAR(10) 是否是赠品。Y:是,N:否。不传默认为非赠品
prods.posnr NUMERIC(10) 对应订单下单商品的序号,标识本行发货是对着订单中的哪行商品进行发货的,且序号必须能对应上订单中序号
prods.remark text 订单子表的备注
prods.sent_remark text 发货单行备注
costpooldetails List 列表
costpooldetails.account VARCHAR(32) 客户账户名称
costpooldetails.amount NUMERIC(18,8) 核销金额
products.exts List 发货单详情信息扩展字段列表
products.exts.ext_key varchar(4000) 发货单详情信息扩展字段key值扩展字段需先在我方系统中创建
products.exts.ext_value varchar(4000) 扩展字段value值对多个选项值,以“,”分隔拼接
exts List 发货单主信息扩展字段列表
exts.ext_key varchar(4000) 发货单主信息扩展字段key值扩展字段需先在我方系统中创建
exts.ext_value varchar(4000) 扩展字段value值对多个选项值,以“,”分隔拼接

接口说明:订货价order_price不传默认取客户价格,是否是赠品is_gift不传默认为非赠品。如果该商品是赠品,order_price传0,is_gift传Y。未免出错,这二个字段建议必填

响应示例:

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

参数说明:

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

# 新增直营订单

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

{
    "operate_type": "1",
    "order_no": "DD201612090000001",
    "order_create_date": "2016-12-09",
    "cm_id": "6389893435290873348",
    "cm_code": "CM0001",
    "date": "2016-12-09 12:12",
    "emp_id": "9090338090192516225",
    "emp_code": "EMP0001",
    "consignment_date": "2016-12-10",
    "receive_name": "张三",
    "receive_phone": "18569854561",
    "receive_tel": "02578946932",
    "receive_addr": "江苏省南京市康缘智汇港",
    "receive_addr_id": "",
    "remark": "加急订单抓紧送货",
    "order_amount":"1212.00",
    "order_discount_amount":"38.00",
    "distribution_method": "配送方式",
    "exts": [
        {
            "ext_key": "级别",
            "ext_value": "四星"
        },
        {
            "ext_key": "主营商品",
            "ext_value": "食品,电器,日化用品"
        }
    ],
    "products": [
        {
            "id": "7755038711664976249",
            "code": "PD001",
            "price": "20.000000",
            "num": "10.00000000",
            "unit": "6782340125265424027",
            "unit_name": "箱",
            "amount": "200.00",
            "is_gift": "0",
            "posnr": "10",
            "remark": "易损件",
            "exts": [
                {
                    "ext_key": "级别",
                    "ext_value": "四星"
                },
                {
                    "ext_key": "主营商品",
                    "ext_value": "食品,电器,日化用品"
                }
            ]
        }
    ]
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
operate_type VARCHAR(32) 1:新增直营订单,2:编辑直营订单
order_no VARCHAR(100) 新增的时候传递作为新订单的单号(不传系统自动生成),编辑的时候传递作为参数进行编辑订单
order_create_date VARCHAR(32) 订单创建日期。格式:yyyy-MM-dd HH:mm
cm_code VARCHAR(100) 客户编码,客户id和客户编码必须传一个
cm_id VARCHAR(32) 客户id,客户id和客户编码必须传一个
date VARCHAR(32) 业务日期。格式:yyyy-MM-dd HH:mm
emp_id VARCHAR(32) 业务员Id,业务员id和业务员编码都不传,默认取其中一个客户经理的
emp_code VARCHAR(100) 业务员编码,业务员id和业务员编码都不传,默认取其中一个客户经理的
consignment_date VARCHAR(32) 要求交货日期。格式:yyyy-mm-dd
receive_name VARCHAR(100) 收货人名称
receive_phone VARCHAR(32) 收货人手机
receive_tel VARCHAR(32) 收货人电话
receive_addr VARCHAR(1000) 收货地址
receive_addr_id VARCHAR(32) 收货地址id
remark text 订单表体备注
order_amount VARCHAR(32) 订单金额,精度最高两位小数
order_discount_amount VARCHAR(32) 订单优惠金额,精度最高两位小数
distribution_method text 配送方式
order_class VARCHAR(100) 单据类型。ZC:销售订单,HC:换出订单
exts List 采购单主信息扩展字段列表
exts.ext_key varchar(4000) 采购单主信息扩展字段key值扩展字段需先在我方系统中创建
exts.ext_value varchar(4000) 扩展字段value值对多个选项值,以“,”分隔拼接
products List 商品订购信息列表
products.id VARCHAR(32) 商品id和商品编码必须传一个
products.code VARCHAR(100) 商品id和商品编码必须传一个
products.price NUMERIC(18,8) 订货价不传就取客户价格,赠品价格为0
products.num NUMERIC(18,8) 订货数量
products.unit VARCHAR(32) 订货单位id和订货单位名称传一个即可,不传使用基本单位
products.unit_name VARCHAR(32) 订货单位id和订货单位名称传一个即可,不传使用基本单位
products.amount NUMERIC(18,2) 订货金额
products.is_gift VARCHAR(10) 是否是赠品。1:是,0:否。不传默认为非赠品
products.posnr NUMERIC(10) 序号
products.remark text 订单子表的备注
products.exts List 采购单详情信息扩展字段列表
products.exts.ext_key varchar(4000) 采购单详情信息扩展字段key值扩展字段需先在我方系统中创建
products.exts.ext_value varchar(4000) 扩展字段value值对多个选项值,以“,”分隔拼接

接口说明:订货价price不传默认取客户价格,是否是赠品is_gift不传默认为非赠品。如果该商品是赠品,price传0,is_gift传1。未免出错,这二个字段建议必填

响应示例:

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": "外请365直营订单详情数据"
}

参数说明:

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码。0:成功,1:失败。其他详见附录错误码说明 (opens new window)
return_msg String id
cm_id String 客户id
cm_name String 客户名称
consignment_date_str String 要求发货日期。格式:yyyy-MM-dd
create_name String 提交人名称
create_time String 提交时间。格式:yyyy-MM-dd hh:mi
create_time_str String 创建时间。格式:yyyy-MM-dd HH:mm:ss.SSS
date String 业务日期。格式:yyyy-MM-dd
emp_id String 业务员id
emp_name String 业务员名称
extColumnValues List 自定义字段码列表
extColumnValues.code String 自定义字段码
extColumnValues.compid String 组件id
extColumnValues.items String 单选,多选下拉框可选项,#分割
extColumnValues.name String 自定义字段名称
extColumnValues.type String 组件类型
extColumnValues.value String 自定义字段值
modify_time_str String 修改时间。格式:yyyy-MM-dd HH:mm:ss.SSS
order_amount String 订单金额
order_cost_amount String 成本金额
order_discount_amount String 优惠金额
order_tax_amount String 税额
pictures String 图片
products List 商品订购信息列表
products.barcode String 条形码
products.base_unit String 基本单位id
products.base_unit_name String 基本单位名称
products.brand String 品牌
products.code String 商品编码
products.detail_id String 订单详情ID
products.extColumnValues List 商品自定义字段列表
products.extColumnValues.code String 自定义字段编码
products.extColumnValues.compid String 组件id
products.extColumnValues.items String 单选,多选下拉框可选项,#分割
products.extColumnValues.name String 自定义字段名称
products.extColumnValues.type String 自定义字段类型
products.fomat_order_count String 根据商品是否阶梯单位格式化数量(带单位)
products.id String 商品ID
products.is_gift String 是否赠品
products.name String 商品名称
products.order_amount String 采购金额
products.order_base_unit_count String 采购数量转换成基本单位数量
products.order_count String 采购数量
products.order_input_unit String 录入单位ID
products.order_input_unit_name String 录入单位名称
products.order_price String 采购单价
products.remark String 备注
products.spec String 规格属性
purchase_business_status String 采购单业务状态码
purchase_business_status_name String 采购单业务状态中英文名称
purchase_no String 采购单号
purchase_status String 采购单系统状态码
purchase_status_name String 采购单系统状态中英文名称
receive_addr String 收货人地址
receive_name String 收货人姓名
receive_phone String 收货人手机
receive_tel String 收货人电话
remark String 单据备注
supply_id String 供货商ID
supply_name String 供货商名称

# 关闭直营订单

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

{
    "order_id": "6037741540892319799",
    "order_no": "DD201612090000001"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
order_id VARCHAR(32) 订单id,订单id和订单号必须传一个
order_no VARCHAR(100) 订单号,订单id和订单号必须传一个

响应示例:

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

参数说明:

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

# DMS外部客户余额同步接口

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

{
    "data":[
        {
            "dealerCode": "CUS001",
            "balance": "1.00"
        },
        {
            "dealerCode": "CUS002",
            "balance": "2.00"
        }
    ]
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
data List 列表
data.dealerCode VARCHAR(32) 客户编码
data.balance VARCHAR(20,2) 客户余额

响应示例:

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

参数说明:

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

# 查询直营采购订单

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

{
    "page_number": 1,
    "s_status": 1,
    "purchase_no": "CG20150819",
    "s_cmCode": "CUS0001",
    "s_cmName": "客户1",
    "emp_code": "EMP0001",
    "emp_name": "员工1",
    "after_create_date": "2017-05-01 00:00:00",
    "after_modify_date": "2017-05-31 00:00:00"
}
    
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
page_number INT 页码默认1,每页默认1000条
page_length INT 每页记录条数,默认最大是1000条,可以根据业务数据的大小自行优化调整
id INT8 勤策(原外勤365)id
s_status CHAR(1) 记录状态。0:已删除,1:正常
purchase_no VARCHAR(32) 采购单编码,有效字符详见附录:有效字符说明 (opens new window)
s_cmCode VARCHAR(32) 客户编码,有效字符详见附录:有效字符说明 (opens new window)
s_cmName VARCHAR(32) 客户名称,唯一,有效字符详见附录:有效字符说明 (opens new window)
emp_code VARCHAR(32) 业务员编码,有效字符详见附录:有效字符说明 (opens new window)
emp_name VARCHAR(32) 业务员名称,唯一,有效字符详见附录:有效字符说明 (opens new window)
after_create_date TIMESTAMP 创建时间之后。格式:yyyy-MM-dd HH:mm:ss
after_modify_date TIMESTAMP 修改时间之后。格式:yyyy-MM-dd HH:mm:ss
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
purchase_status VARCHAR(100) 采购订单状态。CG_DFH:待发货,CG_DRK:待入库,CG_YWC:已完成,CG_DQR:待确认,CG_YQX:已取消,CG_FHZ:发货中。多状态用逗号分隔

响应示例:

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

数据DATA示例:

[
    {
        "id": "7226306356013346628",
        "status": "1",
        "purchase_no": "CK201612010001",
        "date": "2016-12-01",
        "emp_dept_id": "6173157522867102283",
        "emp_dept_name": "市场部",
        "emp_dept_code": "DP00001",
        "emp_dept_source_code": "000001",
        "emp_id": "6360879952207158181",
        "emp_code": "EMP0001",
        "emp_name": "张明",
        "emp_source_code": "000001",
        "cm_id": "4786443529856258791",
        "cm_code": "CUS00001",
        "cm_name": "南京苏果超市",
        "cm_source_code": "0001",
        "cm_dept_id": "5479044577173277483",
        "cm_dept_name": "南京市场部",
        "cm_dept_code": "DP0001",
        "cm_dept_source_code": "00001",
        "purchase_status": "CG_DFH",
        "purchase_business_status": "CG_DFH",
        "consignment_date": "2016-12-01",
        "order_amount": "35.10",
        "order_discount_amount": "11.10",
        "pictures": "http://imag.jpg",
        "creator_id": "5479044577173277483",
        "create_name": "张三",
        "create_time_str": "2016-12-01 00:00:00.999",
        "modify_time_str": "2016-12-01 00:00:00.999",
        "confirm_emp_id": "5479044577173277483",
        "confirm_emp_name": "李四",
        "confirm_time_str": "2016-12-01 00:00:00",
        "confirm_reason": "错误!",
        "reconfirm_emp_id": "5479044577173277483",
        "reconfirm_emp_name": "李四",
        "reconfirm_time_str": "2016-12-01 00:00:00",
        "reconfirm_reason": "测试!",
        "order_type": "ZY",
        "receive_name": "李四",
        "receive_phone": "18254623212",
        "receive_tel": "02589652314",
        "receive_addr": "江苏省南京建邺区云龙山路66号",
        "receive_addr_id": "",
        "remark": "请尽快送货",
        "distribution_method_name": "配送方式名称",
        "gift_card_usedamount": "10.00",
        "amount_pool_usedamount":"10.00",
        "usedGiftCards": 
        [
           {
                "rebate_account_amount": "10.00",
                "rebate_account_id": "8215768532653672550"
           }
        ],
        "usedAmountPools": 
        [
           {
                "rebate_account_amount": "10.00",
                "rebate_account_id": "8215768532653672550",
                "rebate_account_code": "40"
           }
        ],
        "exts": 
        [
           {
                "ext_key": "级别",
                "ext_value": "四星"
           },
           {
                "id": "7226306356013346628",
                "status": "1",
                "purchase_no": "CK201612010001",
                "date": "2016-12-01",
                "emp_dept_id": "6173157522867102283",
                "emp_dept_name": "市场部",
                "emp_dept_code": "DP00001",
                "emp_dept_source_code": "000001",
                "emp_id": "6360879952207158181",
                "emp_code": "EMP0001",
                "emp_name": "张明",
                "emp_source_code": "000001",
                "cm_id": "4786443529856258791",
                "cm_code": "CUS00001",
                "cm_name": "南京苏果超市",
                "cm_source_code": "0001",
                "cm_dept_id": "5479044577173277483",
                "cm_dept_name": "南京市场部",
                "cm_dept_code": "DP0001",
                "cm_dept_source_code": "00001",
                "purchase_status": "CG_DFH",
                "purchase_business_status": "CG_DFH",
                "consignment_date": "2016-12-01",
                "order_amount": "35.10",
                "order_discount_amount": "11.10",
                "pictures": "http://imag.jpg",
                "creator_id": "5479044577173277483",
                "create_name": "张三",
                "create_time_str": "2016-12-01 00:00:00.999",
                "modify_time_str": "2016-12-01 00:00:00.999",
                "confirm_emp_id": "5479044577173277483",
                "confirm_emp_name": "李四",
                "confirm_time_str": "2016-12-01 00:00:00",
                "confirm_reason": "错误!",
                "reconfirm_emp_id": "5479044577173277483",
                "reconfirm_emp_name": "李四",
                "reconfirm_time_str": "2016-12-01 00:00:00",
                "reconfirm_reason": "测试!",
                "order_type": "ZY",
                "receive_name": "李四",
                "receive_phone": "18254623212",
                "receive_tel": "02589652314",
                "receive_addr": "江苏省南京建邺区云龙山路66号",
                "receive_addr_id": "",
                "remark": "请尽快送货",
                "distribution_method_name": "配送方式名称",
                "gift_card_usedamount":"10.00",
                "amount_pool_usedamount":"10.00",
                "usedGiftCards":
                [
                       {
                       "reduce_amount":"10.00",
                       "card_id":"8215768532653672550",
                       "card_no":"20201120160540000025"
                       }
                ],
                "usedAmountPools":
                [
                    {
                        "rebate_account_amount":"10.00",
                        "rebate_account_id":"8215768532653672550"
                    }
                ],
        "exts": 
        [
            {
                "ext_key": "级别",
                "ext_value": "四星"
            },
            {
                "ext_key": "主营商品",
                "ext_value": "食品,电器,日化用品"
            }
        ],
        "prods": 
        [
             {
                "product_id": "4843786111936788462",
                "product_name": "商品1",
                "product_code": "P0001",
                "allocated_amount": "10.00000000",
                "sale_cus_code": "CUS0001",
                "purchase_price": "10.00000000",
                "purchase_count": "20.00000000",
                "purchase_input_unit": "8215768532653672550",
                "purchase_input_unit_name": "箱",
                "base_unit": "6930792320160995628",
                "base_unit_name": "瓶",
                "purchase_base_unit_count": "120.00000000",
                "purchase_amount": "200.00",
                "purchase_discount_amount": "10.00",
                "remark": "易损件",
                "is_gift": "N",
                "promotion_code": "CUX0052",
                "promotion_name": "促销1",
                "promotion_type": "OVERLAP",
                "promotion_tag": "TAG_TJ",
                "promotion_calc_mode": "MODE_MZ",
                "promotion_calc_type": "TYPE_NUM",
                "posnr": "10",
                "addpd_pool_id":"8215768532653672550",
                "last_kh_price":"1000.00",
                "addpd_pool_source_code":"",
                "sys_input_unit_price":"",
                "exts": 
                [
                    {
                        "ext_key": "级别",
                        "ext_value": "四星"
                    },
                    {
                        "ext_key": "主营商品",
                        "ext_value": "食品,电器,日化用品"
                    }
                ]
            }
        ]
        }
        ]
    }
]

参数说明:

参数 类型 必填 说明
id VARCHAR(32) 采购单ID
status VARCHAR(1) 0:已删除,1:正常
purchase_no VARCHAR(100) 采购单编号
date TIMESTAMP 业务日期。格式:yyyy-mm-dd
emp_dept_id VARCHAR(32) 业务员下单时候所在的部门id
emp_dept_source_code VARCHAR(32) 业务员下单时候所在的部门对应外部数据id
emp_id VARCHAR(32) 单据业务员id
emp_code VARCHAR(100) 员工编码
emp_name VARCHAR(100) 单据业务员名称
emp_source_code VARCHAR(32) 单据业务员对应外部数据id
trade_type VARCHAR(32) 客户类型。2:经销商,3:终端门店
cm_id VARCHAR(32) 客户id
cm_code VARCHAR(32) 客户编码
cm_name VARCHAR(100) 客户名称
cm_source_code VARCHAR(32) 客户对应外部数据id
cm_dept_id VARCHAR(32) 下单时候客户所在的部门id
cm_dept_name VARCHAR(100) 下单时候客户所在部门的名称
cm_dept_code VARCHAR(100) 下单时候客户所在部门的编码
cm_dept_source_code VARCHAR(32) 下单时候客户所在的部门对应外部数据id
purchase_status varchar(32) 采购订单状态。CG_DFH:待发货,CG_DRK:待入库,CG_YWC:已完成,CG_DQR:待确认,CG_YQX:已取消,CG_FHZ:发货中
purchase_business_status VARCHAR(100) 采购单自定义业务状态
consignment_date TIMESTAMP 要求送货日期。格式:yyyy-mm-dd
order_amount numeric(20,2) 采购单据总金额
order_discount_amount numeric(20,2) 销售单据优惠金额
pictures VARCHAR(4000) 照片,多张使用逗号分隔
creator_id VARCHAR(32) 单据创建人
create_name VARCHAR(100) 单据创建人名称
create_time_str TIMESTAMP 单据提交时间。格式:yyyy-mm-dd hh24:mi:ss.us
modify_time_str TIMESTAMP 单据最近一次变更时间。格式:yyyy-mm-dd hh24:mi:ss.us
confirm_emp_id VARCHAR(32) 确认人id
confirm_emp_name VARCHAR(100) 确认人名称
confirm_time_str TIMESTAMP
confirm_reason VARCHAR(100) 确认意见
reconfirm_emp_id VARCHAR(32) 反确认人id
reconfirm_emp_name varchar(100) 反确认人名称
reconfirm_time_str TIMESTAMP 反确认时间。格式:yyyy-mm-dd hh24:mi:ss
reconfirm_reason varchar(4000) 反确认意见
receive_name varchar(1000) 收货人名称
receive_phone varchar(100) 收货人手机号码
receive_tel varchar(100) 收货人电话
receive_addr varchar(4000) 收货地址
receive_addr_id VARCHAR(32) 收货地址id
remark text 备注
distribution_method_name text 配送方式名称
visit_implement_id varchar(100) 关联的高级拜访id
order_source varchar(100) 订单来源。NBZHSJ:内部账号手机(业代手机),NBZHWB:内部账号web(业代web),WBZHSJ:外部账号手机(客户手机),WBZHWB:外部账号web(客户web),MDWXXD:客户微信下单,JK:接口,DINGHUO365:客户订货365(客户手机),GJBF:高级拜访;
pay_status varchar(100) 0:未支付。1:已支付,3:线下支付
order_class varchar(100) ZC:销售订单,HC:换出订单
gift_card_usedamount VARCHAR(32) 代金券使用金额
amount_pool_usedamount VARCHAR(32) 费用池使用金额
business_order_type_name VARCHAR(100) 业务类型名称
business_order_type_code VARCHAR(100) 业务类型编码
usedGiftCards List 列表
usedGiftCards.reduce_amount VARCHAR(32) 代金券使用金额
usedGiftCards.card_id VARCHAR(32) 代金券
usedGiftCards.card_no VARCHAR(32) 代金券号
usedAmountPools.rebate_account_amount VARCHAR(32) 费用池使用金额
usedAmountPools.rebate_account_id VARCHAR(32) 费用池账户id
usedAmountPools.rebate_account_code VARCHAR(32) 费用池账户编码
exts List 采购单主信息扩展字段列表
exts.ext_key varchar(4000) 采购单主信息扩展字段key值扩展字段需先在我方系统中创建
exts.ext_value varchar(4000) 扩展字段value值对多个选项值,以“,”分隔拼接
prods List 列表
prods.product_id varchar(32) 商品id
prods.product_name varchar(100) 商品名称
prods.product_code varchar(100) 商品编码
prods.allocated_amount varchar(32) 分摊后金额
prods.sale_cus_code varchar(32) 分销客户
prods.product_source_code varchar(100) 商品对应外部数据id
prods.purchase_price numeric(28,8) 采购价格
prods.purchase_count numeric(28,8) 采购数量
prods.purchase_input_unit VARCHAR(32) 采购时候录入单位id
prods.purchase_input_unit_name VARCHAR(100) 采购时候录入单位名称
prods.base_unit VARCHAR(32) 采购时候商品基本单位id
prods.base_unit_name VARCHAR(100) 采购时候商品基本单位名称
prods.purchase_base_unit_count numeric(28,8) 采购数量转化成基本单位以后的数量
prods.purchase_amount numeric(20,2) 采购金额
prods.purchase_discount_amount numeric(20,2) 采购优惠金额
prods.gift_amount numeric(20,2) 赠品金额
prods.gift_price numeric(20,2) 赠品单价
prods.remark text 备注
prods.is_gift varchar(2) 是否是赠品。Y:是,N:否
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_CHG
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) 金额促销名称
prods.suggest_num varchar(200) 建议订单数量(基本单位)
prods.onway_inventory varchar(200) 在途库存数量(基本单位)
prods.real_inventory varchar(200) 实物库存数量(基本单位)
prods.safe_inventory varchar(200) 安全库存数量(基本单位)
prods.addpd_pool_id varchar(200) 赠品池ID
prods.exts List 采购单主信息扩展字段列表
prods.exts.ext_key varchar(200) 采购单主信息扩展字段key值,扩展字段需先在我方系统中创建
prods.exts.ext_value varchar(200) 扩展字段value值对多个选项值,以“,”分隔拼接
prods List 列表
prods.posnr numeric(15) 序号
prods.last_kh_price varchar(32) 系统价
prods.addpd_pool_source_code varchar(32) 赠品池sourcecode
prods.sys_input_unit_price varchar(32) 标准价
prods.rebate_account_id varchar(32) 费用池账户id
prods.rebate_account_code varchar(32) 费用池账户编码

# 查询分销销售订单

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


{
    "page_number": 1,
    "s_status": 1,
    "purchase_no": "CG20150819",
    "s_cmCode": "CUS0001",
    "s_cmName": "客户1",
    "s_supplyCode": "CUS0001",
    "s_supplyName": "客户1",
    "emp_code": "EMP0001",
    "emp_name": "员工1",
    "create_time_begin": "2017-05-01 00:00:00",
    "create_time_end": "2017-05-31 00:00:00"
}

说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
page_number INT 页码默认1,每页默认1000条
page_length INT 每页记录条数,默认最大是1000条,可以根据业务数据的大小自行优化调整
s_status CHAR(1) 记录状态。0:已删除,1:正常
order_no VARCHAR(32) 销售订单编码,有效字符详见附录:有效字符说明 (opens new window)
s_cmCode VARCHAR(32) 客户编码,有效字符详见附录:有效字符说明 (opens new window)
s_cmName VARCHAR(32) 客户名称,唯一,有效字符详见附录:有效字符说明 (opens new window)
s_supplyCode VARCHAR(32) 供应商编码,有效字符详见附录:有效字符说明 (opens new window)
s_supplyName VARCHAR(32) 供应商名称,唯一,有效字符详见附录:有效字符说明 (opens new window)
emp_code VARCHAR(32) 业务员编码,有效字符详见附录:有效字符说明 (opens new window)
emp_name VARCHAR(32) 业务员名称,唯一,有效字符详见附录:有效字符说明 (opens new window)
after_create_date TIMESTAMP 创建时间之后。格式:yyyy-MM-dd HH:mm:ss
after_modify_date TIMESTAMP 修改时间之后。格式:yyyy-MM-dd HH:mm:ss
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
s_orderClass VARCHAR(32) 单据类型。ZC:正常订单,HC:换出订单

响应示例:

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

数据DATA示例:

[
    {
        "id": "7226306356013346628",
        "status": "1",
        "purchase_no": "CK201612010001",
        "date": "2016-12-01",
        "emp_dept_id": "6173157522867102283",
        "emp_dept_name": "市场部",
        "emp_dept_code": "DP00001",
        "emp_dept_source_code": "000001",
        "emp_id": "6360879952207158181",
        "emp_code": "EMP0001",
        "emp_name": "张明",
        "emp_source_code": "000001",
        "cm_id": "4786443529856258791",
        "cm_code": "CUS00001",
        "trade_type": "2",
        "cm_name": "南京苏果超市",
        "cm_source_code": "0001",
        "cm_dept_id": "5479044577173277483",
        "cm_dept_name": "南京市场部",
        "cm_dept_code": "DP0001",
        "cm_dept_source_code": "00001",
        "purchase_status": "CG_DFH",
        "purchase_business_status": "CG_DFH",
        "consignment_date": "2016-12-01",
        "order_amount": "35.10",
        "order_discount_amount": "11.10",
        "pictures": "http://imag.jpg",
        "creator_id": "5479044577173277483",
        "create_name": "张三",
        "create_time_str": "2016-12-01 00:00:00.999",
        "modify_time_str": "2016-12-01 00:00:00.999",
        "confirm_emp_id": "5479044577173277483",
        "confirm_emp_name": "李四",
        "confirm_time_str": "2016-12-01 00:00:00",
        "confirm_reason": "错误!",
        "reconfirm_emp_id": "5479044577173277483",
        "reconfirm_emp_name": "李四",
        "reconfirm_time_str": "2016-12-01 00:00:00",
        "reconfirm_reason": "测试!",
        "order_type": "ZY",
        "receive_name": "李四",
        "receive_phone": "18254623212",
        "receive_tel": "02589652314",
        "receive_addr": "江苏省南京建邺区云龙山路66号",
        "remark": "请尽快送货",
        "gift_card_usedamount":"10.00",
        "amount_pool_usedamount":"10.00",
        "usedGiftCards":
        [
             {
                "reduce_amount":"10.00",
                "card_id":"8215768532653672550",
                "card_no":"20201120160540000025"
             }
         ],
         "usedAmountPools":[{
                "rebate_account_amount":"10.00",
                "rebate_account_id":"8215768532653672550"
         }],
        "exts":
        [
                {
                    "ext_key": "级别",
                    "ext_value": "四星"
                },
                {
                    "ext_key": "主营商品",
                    "ext_value": "食品,电器,日化用品"
                }
         ],
        "prods": 
        [
              {
                    "detail_id": "4843786111936788462",
                    "product_id": "4843786111936788462",
                    "product_name": "商品1",
                    "product_code": "P0001",
                    "purchase_price": "10.00000000",
                    "purchase_count": "20.00000000",
                    "purchase_input_unit": "8215768532653672550",
                    "purchase_input_unit_name": "箱",
                    "base_unit": "6930792320160995628",
                    "base_unit_name": "瓶",
                    "purchase_base_unit_count": "120.00000000",
                    "purchase_amount": "200.00",
                    "purchase_discount_amount": "10.00",
                    "remark": "易损件",
                    "is_gift": "N",
                    "promotion_code": "CUX0052",
                    "promotion_name": "促销1",
                    "promotion_type": "OVERLAP",
                    "promotion_tag": "TAG_TJ",
                    "promotion_calc_mode": "MODE_MZ",
                    "promotion_calc_type": "TYPE_NUM",
                    "posnr": "10",
                    "addpd_pool_id":"8215768532653672550"
        }
     ]
    }
]

参数说明:

参数 类型 必填 说明
id VARCHAR(32) 采购单ID
status VARCHAR(1) 0:已删除,1:正常
order_no VARCHAR(100) 销售订单编号
date TIMESTAMP 业务日期,yyyy-mm-dd格式
emp_dept_id VARCHAR(32) 业务员下单时候所在的部门id
emp_dept_name VARCHAR(100) 业务员下单时候所在的部门名称
emp_dept_code VARCHAR(100) 业务员下单时候所在的部门编码
emp_dept_source_code VARCHAR(32) 业务员下单时候所在的部门对应外部数据id
emp_id VARCHAR(32) 单据业务员id
emp_code VARCHAR(100) 员工编码
emp_name VARCHAR(100) 单据业务员名称
emp_source_code VARCHAR(32) 单据业务员对应外部数据id
trade_type VARCHAR(32) 客户类型。2:经销商,3:终端门店
cm_id VARCHAR(32) 客户id
cm_code VARCHAR(32) 客户编码
cm_name VARCHAR(100) 客户名称
cm_source_code VARCHAR(32) 客户对应外部数据id
cm_dept_id VARCHAR(32) 下单时候客户所在的部门id
cm_dept_name VARCHAR(100) 下单时候客户所在部门的名称
cm_dept_code VARCHAR(100) 下单时候客户所在部门的编码
cm_dept_source_code VARCHAR(32) 下单时候客户所在的部门对应外部数据id
order_status varchar(32) 销售订单状态。XS_DFH:待发货,XS_DQS:待签收,XS_YWC:已完成,XS_DQR:待确认,XS_YQX:已取消,XS_FHZ:发货中
supply_id VARCHAR(32) 供货商id
supply_name VARCHAR(100) 供货商名称
supply_code VARCHAR(100) 供货商编码
supply_source_code VARCHAR(100) 供货商第三方id
consignment_date TIMESTAMP 要求送货日期yyyy-mm-dd
order_amount numeric(20,2) 采购单据总金额
order_discount_amount numeric(20,2) 销售单据优惠金额
pictures VARCHAR(4000) 照片,多张使用逗号分隔
creator_id VARCHAR(32) 单据创建人
create_name VARCHAR(100) 单据创建人名称
create_time_str TIMESTAMP 单据提交时间。格式:yyyy-mm-dd hh24:mi:ss.us
modify_time_str TIMESTAMP 单据最近一次变更时间。格式:yyyy-mm-dd hh24:mi:ss.us
confirm_emp_id VARCHAR(32) 确认人id
confirm_emp_name VARCHAR(100) 确认人名称
confirm_time_str TIMESTAMP 确认时间。格式:yyyy-mm-dd hh24:mi:ss
confirm_reason VARCHAR(100) 确认意见
reconfirm_emp_id VARCHAR(32) 反确认人id
reconfirm_emp_name varchar(100) 反确认人名称
reconfirm_time_str TIMESTAMP 反确认时间。格式:yyyy-mm-dd hh24:mi:ss
reconfirm_reason varchar(4000) 反确认意见
receive_name varchar(1000) 收货人名称
receive_phone varchar(100) 收货人手机号码
receive_tel varchar(100) 收货人电话
receive_addr varchar(4000) 收货地址
remark text 备注
visit_implement_id varchar(100) 关联的高级拜访id
order_source varchar(100) NBZHSJ:内部账号手机(业代手机),NBZHWB:内部账号web(业代web),WBZHSJ:外部账号手机(客户手机),WBZHWB:外部账号web(客户web),MDWXXD:客户微信下单,JK:接口,DINGHUO365:(客户手机端),GJBF:高级拜访(业代高级拜访)
order_class varchar(32) ZC:正常订单,HC:换出订单;
gift_card_usedamount VARCHAR(32) 代金券使用金额
amount_pool_usedamount VARCHAR(32) 费用池使用金额
usedGiftCards List 代金券列表
usedGiftCards.reduce_amount VARCHAR(32) 代金券使用金额
usedGiftCards.card_id VARCHAR(32) 代金券id
usedGiftCards.card_no VARCHAR(32) 代金券号
usedAmountPools List 费用池信息列表
usedAmountPools.rebate_account_amount VARCHAR(32) 费用池使用金额
usedAmountPools.rebate_account_id VARCHAR(32) 费用池账户
prods List 列表
prods.detail_id VARCHAR(32) 子表id
prods.product_id varchar(32) 商品id
prods.product_name varchar(100) 商品名称
prods.product_code varchar(100) 商品编码
prods.product_source_code varchar(100) 商品对应外部数据id
prods.order_price numeric(28,8) 价格
prods.order_count numeric(28,8) 数量
prods.order_input_unit VARCHAR(32) 下单时候录入单位id
prods.order_input_unit_name VARCHAR(100) 下单时候录入单位名称
prods.base_unit VARCHAR(32) 下单时候商品基本单位id
prods.base_unit_name VARCHAR(100) 下单时候商品基本单位名称
prods.order_base_unit_count numeric(28,8) 数量转化成基本单位以后的数量
prods.order_amount numeric(20,2) 金额
prods.gift_amount numeric(20,2) 赠品金额
prods.gift_price numeric(20,2) 赠品单价
prods.order_discount_amount numeric(20,2) 优惠金额
prods.remark text 备注
prods.is_gift varchar(2) 是否是赠品。Y:是,N:否
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_CHG
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.superposition_promotion_type varchar(200) 促销类型。BASE:基本策略,OVERLAP:叠加策略。默认值为BASE
prods.superposition_promotion_id varchar(200) 叠加促销id
prods.amount_promotion_code varchar(200) 金额促销编码
prods.amount_promotion_name varchar(200) 金额促销名称
prods.amount_promotion_type varchar(200) 促销类型。BASE:基本策略,OVERLAP:叠加策略。默认值为BASE
prods.amount_promotion_id varchar(200) 金额促销id
prods.suggest_num varchar(200) 建议订单数量(基本单位)
prods.onway_inventory varchar(200) 在途库存数量(基本单位)
prods.real_inventory varchar(200) 实物库存数量(基本单位)
prods.safe_inventory varchar(200) 安全库存数量(基本单位)
prods.posnr numeric(15) 序号
prods.addpd_pool_id varchar(200) 赠品池ID

# 查询分销或者直营发货单

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

{
    "page_number": 1,
    "s_status": 1,
    "send_no": "FH20150819",
    "send_date_begin": "2017-05-01 00:00:00",
    "send_date_end": "2017-05-31 00:00:00"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
page_number INT 页码默认1,每页默认1000条
page_length INT 每页记录条数,默认最大是1000条,可以根据业务数据的大小自行优化调整
s_status CHAR(1) 记录状态。0:已删除,1:正常
send_no VARCHAR(32) 发货单编码,有效字符详见附录:有效字符说明 (opens new window)
order_type VARCHAR(32) 单据类型。ZY:直营,FX:分销
after_create_date TIMESTAMP 创建时间之后。格式:yyyy-MM-dd HH:mm:ss
after_modify_date TIMESTAMP 修改时间之后。格式:yyyy-MM-dd HH:mm:ss
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

响应示例:

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

数据DATA示例:

[
    {
        "id": "7226306356013346628",
        "status": "1",
        "sent_no": "FH201612010001",
        "purchase_no": "CK201612010001",
        "order_no": "FX201612010001",
        "order_id": "7226306356013346628",
        "date": "2016-12-01",
        "order_amount": "10.00",
        "order_discount_amount": "2.00",
        "emp_dept_id": "6173157522867102283",
        "emp_dept_name": "市场部",
        "emp_dept_code": "DP00001",
        "emp_dept_source_code": "000001",
        "emp_id": "6360879952207158181",
        "emp_code": "EMP0001",
        "emp_name": "张明",
        "emp_source_code": "000001",
        "send_time_str": "2016-12-01 00:00:00",
        "send_id": "4786443529856258791",
        "send_name": "张三",
        "send_code": "EMP0001",
        "send_source_code": "EMP0001",
        "cm_id": "4786443529856258791",
        "cm_code": "CUS00001",
        "cm_name": "南京苏果超市",
        "cm_source_code": "0001",
        "cm_dept_id": "5479044577173277483",
        "cm_dept_name": "南京市场部",
        "cm_dept_code": "DP0001",
        "cm_dept_source_code": "00001",
        "sign_status": "CG_DFH",
        "order_status": "CG_DFH",
        "purchase_status": "CG_DFH",
        "consignment_date": "2016-12-01",
        "supply_id": "4786443529856258791",
        "supply_name": "CUS00001",
        "supply_code": "南京苏果超市",
        "supply_source_code": "0001",
        "receive_name": "李四",
        "receive_phone": "18254623212",
        "receive_tel": "02589652314",
        "receive_addr": "江苏省南京建邺区云龙山路66号",
        "remark": "请尽快送货",
        "from_storehouse": "4786443529856258791",
        "from_storehouse_name": "仓库1",
        "from_storehouse_code": "ck001",
        "order_type": "ZY",
        "prods": 
        [
              {
                    "detail_id": "4843786111936788462",
                    "order_detail_id": "4843786111936788462",
                    "product_id": "4843786111936788462",
                    "product_name": "商品1",
                    "product_code": "P0001",
                    "product_source_code": "P0001",
                    "order_price": "10.00000000",
                    "order_count": "20.00000000",
                    "order_input_unit": "8215768532653672550",
                    "order_input_unit_name": "箱",
                    "base_unit": "6930792320160995628",
                    "base_unit_name": "瓶",
                    "order_base_unit_count": "120.00000000",
                    "order_amount": "200.00",
                    "order_discount_amount": "10.00",
                    "is_gift": "N",
                    "sent_input_unit": "8215768532653672550",
                    "sent_input_unit_name": "箱",
                    "sent_base_unit_num": "20.0000"
              }
       ]
    }
]

参数说明:

参数 类型 必填 说明
id VARCHAR(32) 单据ID
status VARCHAR(1) 0:已删除,1:正常
sent_no VARCHAR(100) 发货单编号
purchase_no VARCHAR(100) 直营订单号
order_no VARCHAR(100) 分销订单号
order_id VARCHAR(32) 对应的分销或者直营单id
date TIMESTAMP 单据业务日期。格式:yyyy-mm-dd
order_amount NUMERIC(20,2) 单据金额
order_discount_amount NUMERIC(20,2) 单据优惠金额
emp_dept_id VARCHAR(32) 业务员下单时候所在的部门id
emp_dept_name VARCHAR(100) 业务员下单时候所在的部门名称
emp_dept_code VARCHAR(100) 业务员下单时候所在的部门编码
emp_dept_source_code VARCHAR(32) 业务员下单时候所在的部门对应外部数据id
emp_id VARCHAR(32) 单据业务员id
emp_code VARCHAR(100) 员工编码
emp_name VARCHAR(100) 单据业务员名称
emp_source_code VARCHAR(32) 单据业务员对应外部数据id
send_time_str TIMESTAMP 发货单发货时间。格式:yyyy-mm-dd hh24:mi:ss
send_id VARCHAR(32) 发货人id
send_name VRACHAR(100) 发货人名称
send_code VRACHAR(100) 发货人编码
send_source_code VRACHAR(32) 发货人对应外部数据id
cm_id VARCHAR(32) 客户id
cm_code VARCHAR(32) 客户编码
cm_name VARCHAR(100) 客户名称
cm_source_code VARCHAR(32) 客户对应外部数据id
cm_dept_id VARCHAR(32) 下单时候客户所在的部门id
cm_dept_name VARCHAR(100) 下单时候客户所在部门的名称
cm_dept_code VARCHAR(100) 下单时候客户所在部门的编码
cm_dept_source_code VARCHAR(32) 下单时候客户所在的部门对应外部数据id
sign_status varchar(32) 发货单状态。FH_CLZ:发货处理中,FH_DQS:待签收,FH_YQS:已签收
order_status varchar(32) 销售订单状态。XS_DFH:待发货,XS_DQS:待签收,XS_YWC:已完成,XS_DQR:待确认,XS_YQX:已取消,XS_FHZ:发货中
purchase_status varchar(32) 直营订单状态。CG_DFH:待发货,CG_DRK:待入库,CG_YWC:已完成,CG_DQR:待确认,CG_YQX:已取消,CG_FHZ:发货中
consignment_date TIMESTAMP 要求送货日期。格式:yyyy-mm-dd
supply_id VARCHAR(32) 供货商id,-1就是没有供货商
supply_name VARCHAR(200) 供货商名称
supply_code VARCHAR(200) 供货商编码
supply_source_code VARCHAR(32) 供货商第三方id
receive_name varchar(100) 收货人名称
receive_phone varchar(100) 收货人手机号码
receive_tel varchar(100) 收货人电话
receive_addr varchar(1000) 收货地址
remark varchar(4000) 备注
from_storehouse VARCHAR(32) 发货仓库id
from_storehouse_name VARCHAR(200) 发货仓库名称
from_storehouse_code VARCHAR(200) 发货仓库编码
order_type varchar(20) 单据类型。ZY:直营,FX:分销
prods List 列表
prods.detail_id VARCHAR(32) 发货子表id
prods.order_detail_id VARCHAR(32) 分销单或直营单的子表id
prods.product_id varchar(32) 商品id
prods.product_name varchar(100) 商品名称
prods.product_code varchar(100) 商品编码
prods.product_source_code varchar(32) 商品对应外部数据id
prods.order_price numeric(28,8) 价格
prods.order_count numeric(28,8) 数量
prods.order_input_unit VARCHAR(32) 下单时候录入单位id
prods.order_input_unit_name VARCHAR(100) 下单时候录入单位名称
prods.base_unit VARCHAR(32) 下单时候商品基本单位id
prods.base_unit_name VARCHAR(100) 下单时候商品基本单位名称
prods.order_base_unit_count numeric(28,8) 数量转化成基本单位以后的数量
prods.order_amount numeric(20,2) 金额
prods.order_discount_amount numeric(20,2) 优惠金额
prods.is_gift varchar(2) 是否是赠品。Y:是,N:否
prods.sent_num numeric(28,8) 发货数量
prods.sent_input_unit VARCHAR(32) 发货单位
prods.sent_input_unit_name VARCHAR(100) 发货单位名称
prods.sent_base_unit_num numeric(28,8) 发货数量转化成基本单位的数量
waybilllogs List 列表
waybilllogs.bill_code VARCHAR(100) 运单号
waybilllogs.driver_name VARCHAR(32) 司机姓名
waybilllogs.driver_phone VARCHAR(32) 司机联系电话
waybilllogs.car_no VARCHAR(32) 车牌号码
waybilllogs.delivery_date TIMESTAMP 预计送达时间
waybilllogs.remark TEXT 备注

# 查询分销或者直营签收单

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


{
    "page_number": 1,
    "s_status": 1,
    "send_no": "FH20150819",
    "send_date_begin": "2017-05-01 00:00:00",
    "send_date_end": "2017-05-31 00:00:00"
}  
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
page_number INT 页码默认1,每页默认1000条
page_length INT 每页记录条数,默认最大是1000条,可以根据业务数据的大小自行优化调整
s_status CHAR(1) 记录状态。0:已删除,1:正常
s_sign_status VARCHAR(32) 签收状态。FH_DQS:待签收,FH_YQS:已签收,FH_CLZ:处理中,FH_QSZ:签收中,FH_YJQ:已拒签。不传默认值为FH_YQS,多个值以","隔开
sign_no VARCHAR(32) 签收编码,有效字符详见附录:有效字符说明 (opens new window)
order_type VARCHAR(32) 单据类型。ZY:直营,FX:分销
after_create_date TIMESTAMP 创建时间之后。格式:yyyy-MM-dd HH:mm:ss
after_modify_date TIMESTAMP 修改时间之后。格式:yyyy-MM-dd HH:mm:ss
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

响应示例:

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

数据DATA示例:

[
    {
        "id": "7226306356013346628",
        "status": "1",
        "sign_no": "QS201612010001",
        "sent_no": "FH201612010001",
        "purchase_no": "CK201612010001",
        "order_no": "FX201612010001",
        "order_id": "7226306356013346628",
        "date": "2016-12-01",
        "order_amount": "10.00",
        "order_discount_amount": "2.00",
        "emp_dept_id": "6173157522867102283",
        "emp_dept_name": "市场部",
        "emp_dept_code": "DP00001",
        "emp_dept_source_code": "000001",
        "emp_id": "6360879952207158181",
        "emp_code": "EMP0001",
        "emp_name": "张明",
        "emp_source_code": "000001",
        "sign_time_str": "2016-12-01 00:00:00",
        "sign_object_id": "4786443529856258791",
        "sign_object_name": "张三",
        "cm_id": "4786443529856258791",
        "cm_code": "CUS00001",
        "cm_name": "南京苏果超市",
        "cm_source_code": "0001",
        "cm_dept_id": "5479044577173277483",
        "cm_dept_name": "南京市场部",
        "cm_dept_code": "DP0001",
        "cm_dept_source_code": "00001",
        "order_status": "CG_DFH",
        "purchase_status": "CG_DFH",
        "consignment_date": "2016-12-01",
        "supply_id": "4786443529856258791",
        "supply_name": "CUS00001",
        "supply_code": "南京苏果超市",
        "supply_source_code": "0001",
        "receive_name": "李四",
        "receive_phone": "18254623212",
        "receive_tel": "02589652314",
        "receive_addr": "江苏省南京建邺区云龙山路66号",
        "remark": "请尽快送货",
        "to_storehouse": "4786443529856258791",
        "to_storehouse_name": "仓库1",
        "to_storehouse_code": "ck001",
        "order_type": "ZY",
         "verification_code_sign": "1",
        "prods": 
        [
              {
                    "detail_id": "4843786111936788462",
                    "order_detail_id": "4843786111936788462",
                    "sent_detail_id": "4843786111936788462",
                    "product_id": "4843786111936788462",
                    "product_name": "商品1",
                    "product_code": "P0001",
                    "product_source_code": "P0001",
                    "order_price": "10.00000000",
                    "order_count": "20.00000000",
                    "order_input_unit": "8215768532653672550",
                    "order_input_unit_name": "箱",
                    "base_unit": "6930792320160995628",
                    "base_unit_name": "瓶",
                    "order_base_unit_count": "120.00000000",
                    "order_amount": "200.00",
                    "order_discount_amount": "10.00",
                    "is_gift": "N",
                    "sent_num": "发货数量",
                    "sent_input_unit": "8215768532653672550",
                    "sent_input_unit_name": "箱",
                    "sent_base_unit_num": "20.0000",
                    "sign_num": "发货数量",
                    "sign_input_unit": "8215768532653672550",
                    "sign_input_unit_name": "箱",
                    "sign_base_unit_num": "20.0000",
                    "third_sign_num": ""
              }
       ]
    }
]

参数说明:

参数 类型 必填 说明
id VARCHAR(32) 单据ID
sent_id VARCHAR(32) 发货单据ID
status VARCHAR(1) 0:已删除,1:正常
sent_no VARCHAR(100) 发货单编号
sign_no VARCHAR(100) 签收单编号
purchase_no VARCHAR(100) 直营订单号
order_no VARCHAR(100) 分销订单号
order_id VARCHAR(32) 对应的分销或者直营单id
date TIMESTAMP 单据业务日期。格式:yyyy-mm-dd
order_amount NUMERIC(20,2) 单据金额
order_discount_amount NUMERIC(20,2) 单据优惠金额
emp_dept_id VARCHAR(32) 业务员下单时候所在的部门id
emp_dept_name VARCHAR(100) 业务员下单时候所在的部门名称
emp_dept_code VARCHAR(100) 业务员下单时候所在的部门编码
emp_dept_source_code VARCHAR(32) 业务员下单时候所在的部门对应外部数据id
emp_id VARCHAR(32) 单据业务员id
emp_code VARCHAR(100) 员工编码
emp_name VARCHAR(100) 单据业务员名称
emp_source_code VARCHAR(32) 单据业务员对应外部数据id
sign_time_str TIMESTAMP 签收时间。格式:yyyy-mm-dd hh24:mi:ss
sign_object_id VARCHAR(32) 签收人id
sign_object_name VRACHAR(100) 签收人名称
cm_id VARCHAR(32) 客户id
cm_code VARCHAR(32) 客户编码
cm_name VARCHAR(100) 客户名称
cm_source_code VARCHAR(32) 客户对应外部数据id
cm_dept_id VARCHAR(32) 下单时候客户所在的部门id
cm_dept_name VARCHAR(100) 下单时候客户所在部门的名称
cm_dept_code VARCHAR(100) 下单时候客户所在部门的编码
cm_dept_source_code VARCHAR(32) 下单时候客户所在的部门对应外部数据id
order_status varchar(32) 销售订单状态。XS_DFH:待发货,XS_DQS:待签收,XS_YWC:已完成,XS_DQR:待确认,XS_YQX:已取消,XS_FHZ:发货中
purchase_status varchar(32) 直营订单状态。CG_DFH:待发货,CG_DRK:待入库,CG_YWC:已完成,CG_DQR:待确认,CG_YQX:已取消,CG_FHZ:发货中
consignment_date TIMESTAMP 要求送货日期。格式:yyyy-mm-dd
supply_id VARCHAR(32) 供货商id,-1就是没有供货商
supply_name VARCHAR(200) 供货商名称
supply_code VARCHAR(200) 供货商编码
supply_source_code VARCHAR(32) 供货商第三方id
receive_name varchar(100) 收货人名称
receive_phone varchar(100) 收货人手机号码
receive_tel varchar(100) 收货人电话
receive_addr varchar(1000) 收货地址
remark varchar(4000) 备注
to_storehouse VARCHAR(32) 签收仓库id
to_storehouse_name VARCHAR(200) 签收仓库名称
to_storehouse_code VARCHAR(200) 签收仓库编码
order_type varchar(20) 单据类型,ZY:直营,FX:分销
verification_code_sign varchar(20) 验证码回单确认。1:是,0:否
cm_location_a VARCHAR(100) 客户位置
sign_location_a VARCHAR(100) 签收位置
sign_deviation VARCHAR(100) 偏差距离(米)
sign_deviation_remark VARCHAR(4000) 偏差备注
sign_pictures VARCHAR(4000) 签收照片,多张使用逗号分隔
sign_mode varchar(32) 签收方式:ELECTRONIC_SEAL、电子签章,MESSAGES_SIGNATURE、短信签字,APPOWNER_SIGN、点击签收按钮签收(默认签收方式),SYSTEM_AUTO_SIGN、系统自动签收,OPENAPI_SIGN、外部接口签收,CMTENANT_SIGN、互联下游签收
sign_attachment TEXT 当发货单状态为FH_YQS,为签收文件地址。当发货当状态为FH_YJQ时,为拒收文件地址。
sign_attachment_full_path TEXT sign_attachment的全路径地址
sign_reason TEXT 当发货单状态为FH_YQS,为签收原因。当发货当状态为FH_YJQ时,为拒收原因。
review_position VARCHAR(100) 评价定位地址
sign_status varchar(32) 发货单状态。FH_DQS:待签收,FH_YQS:已签收,FH_CLZ:处理中,FH_QSZ:签收中,FH_YJQ:已拒签
logistics_dept_code varchar(4000) 物流部门编码
prods List 列表
prods.detail_id VARCHAR(32) 签收子表id
prods.sent_detail_id VARCHAR(32) 发货子表id
prods.order_detail_id VARCHAR(32) 分销单或直营单的子表id
prods.product_id varchar(32) 商品id
prods.product_name varchar(100) 商品名称
prods.product_code varchar(100) 商品编码
prods.product_source_code varchar(32) 商品对应外部数据id
prods.order_price numeric(28,8) 价格
prods.order_count numeric(28,8) 数量
prods.order_input_unit VARCHAR(32) 下单时候录入单位id
prods.order_input_unit_name VARCHAR(100) 下单时候录入单位名称
prods.base_unit VARCHAR(32) 下单时候商品基本单位id
prods.base_unit_name VARCHAR(100) 下单时候商品基本单位名称
prods.order_base_unit_count numeric(28,8) 数量转化成基本单位以后的数量
prods.order_amount numeric(20,2) 金额
prods.order_discount_amount numeric(20,2) 优惠金额
prods.is_gift varchar(2) 是否是赠品。Y:是,N:否
prods.gift_amount numeric(20,2) 赠品金额
prods.gift_price numeric(20,2) 赠品单价
prods.sent_num numeric(28,8) 发货数量
prods.sent_input_unit VARCHAR(32) 发货单位
prods.sent_input_unit_name VARCHAR(100) 发货单位名称
prods.sent_base_unit_num numeric(28,8) 发货数量转化成基本单位的数量
prods.sign_num numeric(28,8) 签收数量
prods.sign_input_unit VARCHAR(32) 发货单位
prods.sign_input_unit_name VARCHAR(100) 签收单位名称
prods.sign_base_unit_num numeric(28,8) 签收数量转化成基本单位的数量
prods.third_sign_num numeric(28,8) 第三方签收数量
reviewInfos timestamp 评价内容列表
reviewInfos.review_time timestamp 评价时间。格式:yyyy-mm-dd hh24:mi:ss
reviewInfos.review_score numeric(15,0) 服务评分
reviewInfos.review_content VARCHAR(1000) 评价内容
reviewInfos.review_image VARCHAR(1000) 评价照片

# 查询盘点单

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/dmsinventory/v1/queryDmsInventory/{ 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 TIMESTAMP 创建时间之后。格式:yyyy-MM-dd HH:mm:ss
after_modify_date TIMESTAMP 修改时间之后。格式:yyyy-MM-dd HH:mm:ss
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

响应示例:

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

数据DATA示例:

[
    {
        "confirm_emp_code": null, 
        "inventory_type": "PDLX_BFPD", 
        "confirm_emp_source_code": null, 
        "confirm_emp_name": null, 
        "prods": [
            {
                "remark": null, 
                "actual_stock": 2137.145, 
                "current_stock": 2137.145, 
                "prod_source_code": null, 
                "prod_id": "6692513571119135747", 
                "id": "5183969319998512131", 
                "master_id": "5183969319998512131", 
                "sequ": 0, 
                "difference_stock": 0, 
                "prod_code": "1HBSKLSD", 
                "prod_name": "测试商品1"
            }
        ], 
        "cm_id": "5012103144063463929", 
        "inventory_status": "PDZT_YSH", 
        "remarks": "", 
        "storehouse_target_name": "南京雨花二级经销商", 
        "emp": "8724832689904775768", 
        "date": "2017-08-21", 
        "storehouse": "8878885617773144765", 
        "cm_code": "0008106267", 
        "id": "5183969319998512131", 
        "cm_source_code": null, 
        "storehouse_target_code": "0008106267", 
        "storehouse_name": "1ed", 
        "storehouse_code": "CK0076", 
        "storehouse_target_id": "5012103144063463929", 
        "storehouse_target_source_code": null, 
        "cm_name": "南京雨花二级经销商", 
        "emp_code": "wangwei", 
        "status": "1", 
        "code": "PD201708210001", 
        "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) 盘点状态。PDZT_DSH:待审核,PDZT_YSH:已审核
inventory_type VARCHAR(32) 盘点类型 PDLX_QBPD:全部盘点,PDLX_BFPD:部分盘点
code VARCHAR(100) 单据编号
date VARCHAR(100) 盘点日期。格式:yyyy-mm-dd
emp INT8 经办人ID
emp_code VARCHAR(100) 经办人编码
emp_source_code VARCHAR(100) emp_source_code
emp_name VARCHAR(100) 经办人名称
cm_id INT8 客户ID
cm_code VARCHAR(100) 客户编码
cm_source_code VARCHAR(100) 客户源编码
cm_name VARCHAR(100) 客户名称
storehouse INT8 仓库ID
storehouse_code VARCHAR(100) 仓库编码
storehouse_name VARCHAR(100) 仓库名称
storehouse_target_id INT8 仓库分配对象客户id
storehouse_target_code VARCHAR(100) 仓库分配对象客户编码
storehouse_target_source_code VARCHAR(100) 仓库分配对象客户源编码
storehouse_target_name VARCHAR(100) 仓库分配对象客户名称
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
visit_implement_id VARCHAR(100) 关联的高级拜访id
prods INT8
prods.id INT8 盘点子表ID
prods.master_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.remark text 备注
prods.sequ numeric(20) 排序号

# 查询车铺单

请求方式: 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 TIMESTAMP 创建时间之后。格式:yyyy-MM-dd HH:mm:ss
after_modify_date TIMESTAMP 修改时间之后。格式:yyyy-MM-dd HH:mm:ss
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

响应示例:

{
    "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/dmsstock/v1/queryStock/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "page_number": 1
}
说明: 本示例仅供参考。

请求信信息

参数 类型 必填 说明
page_number INT 当前页数,不传默认为1
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

响应示例:

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

数据DATA示例:

[
    {
        "quantity": 2137.145, 
        "prod_source_code": null, 
        "prod_id": "6692513571119135747", 
        "base_unit_name": "瓶", 
        "base_unit_id": "5183969319998512131", 
        "prod_code": "1HBSKLSD", 
        "prod_name": "测试商品1",
        "cm_id": "5012103144063463929", 
        "cm_name": "南京雨花二级经销商", 
        "storehouse": "8878885617773144765", 
        "cm_code": "0008106267", 
        "cm_source_code": null, 
        "storehouse_name": "1ed", 
        "storehouse_code": "CK0076"
    }
]

参数说明:

参数 类型 必填 说明
cm_id VARCHAR(32) 仓库分配对象客户ID
cm_code VARCHAR(32) 仓库分配对象客户编码
cm_source_code VARCHAR(32) 仓库分配对象客户源编码
cm_name VARCHAR(100) 仓库分配对象客户名称
storehouse VARCHAR(32) 仓库ID
storehouse_code VARCHAR(200) 仓库编码
storehouse_name VARCHAR(200) 仓库名称
prod_id VARCHAR(32) 商品ID
prod_code VARCHAR(100) 商品编码
prod_source_code VARCHAR(100) 商品源编码
prod_name VARCHAR(100) 商品名称
quantity numeric(28,8) 当前库存,基本单位
base_unit_id VARCHAR(32) 基本单位id
base_unit_name VARCHAR(32) 基本单位名称

# 查询直营或分销退货单

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

{
    "page_number": 1,
    "page_length": 100,
    "s_status": "1",
    "order_type": "FXHRHH",
    "after_create_date": "2018-11-06 10:29:11"
}
     
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
page_number INT 页码默认1,每页默认1000条
page_length INT 每页记录条数,默认最大是1000条,可以根据业务数据的大小自行优化调整
s_status CHAR(1) 记录状态。0:已删除,1:正常
order_no VARCHAR(32) 退货单编码,有效字符详见附录:有效字符说明 (opens new window)
order_type VARCHAR(32) 订单类型。FXGLTH:分销关联退货,FXSPTH:分销商品退货,FXHRHH:分销换入换货,ZYGLTH:直营关联退货,ZYSPTH:直营商品退货,ZYHRHH:直营换入换货
after_create_date TIMESTAMP 创建时间之后。格式:yyyy-MM-dd HH:mm:ss
after_modify_date TIMESTAMP 修改时间之后。格式:yyyy-MM-dd HH:mm:ss
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

响应示例:

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

数据DATA示例:

[
    {
        "confirm_emp_code": "",
        "supply_id": 6975322184779002302,
        "remark": "",
        "confirm_emp_name": "",
        "prods": [{
            "ruzhang_input_unit": -1,
            "product_id": 6692513571119135747,
            "remark": "",
            "ruzhang_input_unit_name": "",
            "product_name": "海之蓝1L",
            "shenqing_amount": "1200.00",
            "confirm_input_unit_name": "",
            "posnr": 1,
            "promotion_id": -1,
            "shenqing_count": "1.0",
            "outstock_input_unit_name": "",
            "shouhuo_base_unit_count": "0.0",
            "promotion_name": "",
            "outstock_input_unit": -1,
            "confirm_base_unit_count": "0.0",
            "shenqing_input_unit_name": "盒",
            "shouhuo_amount": "0.00",
            "shouhuo_input_unit_name": "",
            "is_gift": "N",
            "detail_id": "5019132889885603614",
            "confirm_amount": "0.00",
            "shenqing_price": "1200.00",
            "product_type": "",
            "outstock_count": "0.0",
            "superposition_promotion_id": -1,
            "ruzhang_count": "0.0",
            "base_unit": 1,
            "shouhuo_count": "0.0",
            "superposition_promotion_name": "",
            "base_unit_name": "盒",
            "outstock_base_unit_count": "0.0",
            "confirm_count": "0.0",
            "confirm_input_unit": -1,
            "ruzhang_base_unit_count": "0.0",
            "shenqing_input_unit": 1,
            "product_code": "1010000097",
            "shenqing_base_unit_count": "1.0",
            "shouhuo_input_unit": -1,
            "sent_detail_id": "",
            "return_order_detail_type": ""
        }],
        "exts": [{
            "ext_key": "级别",
            "ext_value": "四星"
        }],
        "under_out_time": "",
        "receive_phone": "15005192711",
        "order_no": "TH20181106000002",
        "cm_tenant_id": -1,
        "cm_source_code": "",
        "change_back_reason_id": 1,
        "modify_source_code": "",
        "order_source": "GJBF",
        "modify_time": "",
        "cm_name": "南京雨花二级门店",
        "status": "1",
        "modifyier_id": "",
        "creator_id": 7087551921713004433,
        "order_status": "DD_DQR",
        "confirm_emp_id": "",
        "under_ruzhang_time": "",
        "sent_no": "",
        "emp_name": "老板",
        "order_business_status": "DD_DQR",
        "create_time": "2018-11-06 10:29",
        "creator_name": "老板",
        "change_back_reason_name": "王伟",
        "cm_linkman_name": "",
        "creator_code": "cclb",
        "confirm_time": "",
        "upper_shouhuo_emp_id": "",
        "modify_code": "",
        "confirm_emp_source_code": "",
        "consignment_date": "2018-11-07 00:00",
        "supply_tenant_id": -1,
        "cm_id": 7532586660376575775,
        "supply_name": "A青岛慧鑫酒水批发部",
        "receive_name": "苏善著",
        "creator_source_code": "cclb",
        "date": "2018-11-06",
        "cm_linkman_id": "",
        "cm_code": "CUS000006",
        "id": "6397039557757017362",
        "sent_id": -1,
        "product_count": 1,
        "under_ruzhang_emp_name": "",
        "receive_tel": "",
        "receive_addr": "江苏南京市浦口区kangyuan",
        "emp_code": "cclb",
        "change_order_id": 9210493545854071060,
        "supply_code": "0008113689",
        "emp_id": 7087551921713004433,
        "confirm_reason": "",
        "upper_shouhuo_emp_name": "",
        "emp_source_code": "cclb",
        "under_out_emp_name": "",
        "modify_name": "",
        "under_ruzhang_emp_id": "",
        "upper_shouhuo_time": "",
        "under_out_emp_id": "",
        "order_type": "FXHRHH",
        "return_order_type": ""
    }
]

参数说明:

参数 类型 必填 说明
id VARCHAR(32) 单据ID
status VARCHAR(1) 0:已删除,1:正常
creator_id VARCHAR(32) 创建人id
creator_code VARCHAR(100) 创建人编码
creator_name VARCHAR(100) 创建人名称
creator_source_code VARCHAR(32) 创建人对应外部数据id
create_time TIMESTAMP 创建日期。格式:yyyy-mm-dd hh24:mi
modifyier_id VARCHAR(32) 修改人id
modify_code VARCHAR(100) 修改人编码
modify_name VARCHAR(100) 修改人名称
modify_source_code VARCHAR(32) 修改人对应外部数据id
modify_time TIMESTAMP 修改日期。格式:yyyy-mm-dd hh24:mi
order_no VARCHAR(100) 退货单编号
date TIMESTAMP 单据业务日期。格式:yyyy-mm-dd
emp_id VARCHAR(32) 业务员id
emp_code VARCHAR(100) 业务员编码
emp_name VARCHAR(100) 业务员名称
emp_source_code VARCHAR(32) 业务员对应外部数据id
cm_id VARCHAR(32) 客户id
cm_code VARCHAR(32) 客户编码
cm_name VARCHAR(100) 客户名称
cm_source_code VARCHAR(32) 客户对应外部数据id
cm_linkman_id VARCHAR(32) 门店联系人ID
cm_linkman_name VARCHAR(100) 门店联系人ID名称
sent_id VARCHAR(32) 关联发货单id
sent_no VARCHAR(100) 关联发货单编码
order_status VARCHAR(32) 订单状态。DD_DSH:待收货,DD_YWC:已完成,DD_DQR:待确认,DD_YQX:已取消,DD_YQR:已确认
change_back_reason_id VARCHAR(32) 退换货原因id
change_back_reason_name VARCHAR(100) 退换货原因名称
supply_id VARCHAR(32) 供货商id。默认值是-1,-1就是厂家
supply_code VARCHAR(200) 供货商编码
supply_name VARCHAR(200) 供货商名称
order_type VARCHAR(32) 订单类型,FXGLTH:分销关联退货,FXSPTH:分销商品退货,FXHRHH:分销换入换货
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(1000) 收货地址
remark VARCHAR(4000) 备注
confirm_emp_id VARCHAR(32) 确认人id
confirm_emp_code VARCHAR(100) 确认人编码
confirm_emp_name VARCHAR(100) 确认人名称
confirm_emp_source_code VARCHAR(32) 确认人对应外部数据id
confirm_time TIMESTAMP 确认时间。格式:yyyy-mm-dd hh24:mi
confirm_reason VARCHAR(4000) 审批意见
order_business_status VRACHAR(100) 订单业务状态
under_out_time TIMESTAMP 下游出库时间。格式:yyyy-mm-dd hh24:mi
under_out_emp_id VRACHAR(32) 下游出库操作人id
under_out_emp_name VARCHAR(100) 下游出库操作人名称
under_out_time TIMESTAMP 上游收货时间。格式:yyyy-mm-dd hh24:mi
upper_shouhuo_emp_id VARCHAR(32) 上游收货操作人id
upper_shouhuo_emp_name VARCHAR(100) 上游收货操作人名称
under_out_time TIMESTAMP 下游入账时间。格式:yyyy-mm-dd hh24:mi
under_ruzhang_emp_id VARCHAR(32) 下游入账操作人id
under_ruzhang_emp_name VARCHAR(100) 下游入账操作人名称
supply_tenant_id VARCHAR(32) supply_tenant_id
cm_tenant_id VARCHAR(32) 客户互联企业id
consignment_date TIMESTAMP 交货日期。格式:yyyy-mm-dd hh24:mi
product_count NUMERIC(15) 品种数
change_order_id VARCHAR(32) 换货单id
return_order_type VARCHAR(32) 退货行类型。1:标准,2:签收
prods List 列表
prods.detail_id VARCHAR(32) 退货子表id
prods.product_id VARCHAR(32) 商品id
prods.product_name VARCHAR(100) 商品名称
prods.product_code VARCHAR(100) 商品编码
prods.sent_detail_id VARCHAR(32) 关联发货单详情id
prods.shenqing_price NUMERIC(28,8) 申请价格
prods.shenqing_count numeric(28,8) 申请数量
prods.shenqing_input_unit VARCHAR(32) 申请单位id
prods.shenqing_input_unit_name VARCHAR(100) 申请单位名称
prods.base_unit VARCHAR(32) 商品的基本单位id
prods.base_unit_name VARCHAR(100) 商品的基本单位名称
prods.shenqing_base_unit_count NUMERIC(28,8) 申请数量转化成基本单位的数量
prods.shenqing_amount NUMERIC(20,2) 申请金额
prods.confirm_count NUMERIC(28,8) 确认数量
prods.confirm_input_unit VARCHAR(32) 确认单位id
prods.confirm_input_unit_name VARCHAR(100) 确认单位名称
prods.confirm_amount NUMERIC(20,2) 确认金额
prods.confirm_base_unit_count NUMERIC(28,8) 确认基本单位数量
prods.outstock_count NUMERIC(28,8) 出库数量
prods.outstock_input_unit VARCHAR(32) 出库单位id
prods.outstock_input_unit_name VARCHAR(100) 出库单位名称
prods.outstock_base_unit_count NUMERIC(28,8) 出库基本单位数量
prods.shouhuo_count NUMERIC(28,8) 收货数量
prods.shouhuo_input_unit VARCHAR(32) 收货单位id
prods.shouhuo_input_unit_name VARCHAR(100) 收货单位名称
prods.shouhuo_base_unit_count NUMERIC(28,8) 收货基本单位数量
prods.shouhuo_amount NUMERIC(20,2) 收货金额
prods.ruzhang_count NUMERIC(28,8) 入账数量
prods.ruzhang_input_unit VARCHAR(32) 入账单位id
prods.ruzhang_input_unit_name VARCHAR(100) 入账单位名称
prods.ruzhang_base_unit_count NUMERIC(28,8) 入账基本单位数量
prods.remark VARCHAR(4000) 备注
prods.posnr NUMERIC(20) 10,20,查询排序时候也可使用
prods.product_type VARCHAR(32) 销售类型。赠(Z)、兑(D)、返(F)
prods.is_gift VARCHAR(2) 是否是赠品。Y:是,N:否
prods.promotion_id VARCHAR(32) 促销组ID。促销组中的商品才会有促销组id,默认-1,表明这不是促销组中的商品信息
prods.promotion_name VARCHAR(100) 促销组名称
prods.superposition_promotion_id VARCHAR(32) 叠加促销ID
prods.superposition_promotion_name VARCHAR(100) 叠加促销名称
prods.return_order_detail_type VARCHAR(32) 退货行类型。0:标准,1:破损,2:丢失
exts.ext_key varchar(4000) 退货单主信息扩展字段key值扩展字段需先在我方系统中创建
exts.ext_value varchar(4000) 扩展字段value值对多个选项值,以“,”分隔拼接

# 查询兑货券明细

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

{
    "page_number": 1,
    "page_length": 1000,
    "create_start": "2016-12-09",
    "create_end": "2016-12-09",
    "status": "1"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
page_number INT 当前页数,不传默认为1
page_length INT 每页条数,不传默认为1000
create_start TIMESTAMP 创建时间之后。格式:yyyy-MM-dd
create_end TIMESTAMP 创建时间之前。格式:yyyy-MM-dd
modify_start TIMESTAMP 修改时间之后。格式:yyyy-MM-dd
modify_end TIMESTAMP 修改时间之前。格式:yyyy-MM-dd
status VARCHAR(1) 0:已删除,1:正常

响应示例:

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

数据DATA示例:

[
    {
        "id": "6692513571119135748",
        "status": "1",
        "coupon_no": "00015684", 
        "create_time": "2019-12-05 13:25",
        "modify_time": "2019-12-05 14:25:35.143",
        "effect_date": "2019-11-05~2019-12-25",
        "format_status": "执行中",
        "doorsill_value": "20.00%",
        "recycle_sign_time": "10天",
        "deal_name": "测试协议名称",
        "deal_id": "6692513571119135748",
        "cm_id": "5012103144063463929", 
        "cm_name": "南京雨花二级经销商", 
        "cm_code": "0008106267", 
        "prod_id": "6692513571119135747", 
        "prod_code": "1HBSKLSD", 
        "prod_name": "测试商品1",
        "num": "10箱",
        "price": "25.00",
        "is_used": "已使用",
        "used_time": "2019-12-15 13:25",
        "order_no": "CK0076",
        "order_id": "6692513571119135747",
        "supply_code": "00123", 
        "supply_name": "1ed", 
        "is_back": "已回收", 
        "sign_num": "1箱",
        "sign_time": "2019-12-17 13:25" 
    }
]

参数说明:

参数 类型 必填 说明
id VARCHAR(32) 兑货券明细id
status VARCHAR(1) 0:已删除,1:正常
coupon_no VARCHAR(32) 兑货券编码
create_time VARCHAR(32) 兑货券生成时间。格式:yyyy-MM-dd HH:mm
modify_time VARCHAR(32) 兑货券更新时间。格式:yyyy-MM-dd HH:mm:ss.us
effect_date VARCHAR(32) 兑货券有效期。格式:yyyy-mm-dd ~ yyyy-mm-dd
format_status VARCHAR(32) 兑货券状态,参考值:“待审批”、“被打回”、“未开始”、“执行中”、“已结束”
doorsill_value VARCHAR(32) 兑货券使用门槛,“不限制”或具体百分比数据
recycle_sign_time VARCHAR(32) 兑货券通路回收时间,“不限制”或具体天数
deal_name VARCHAR(32) 兑货券协议名称
deal_id VARCHAR(32) 兑货券协议id
cm_code VARCHAR(100) 兑货券客户编码
cm_name VARCHAR(100) 兑货券客户名称
cm_id VARCHAR(32) 兑货券客户ID
prod_id VARCHAR(32) 商品ID
prod_code VARCHAR(100) 商品编码
prod_name VARCHAR(100) 商品名称
num VARCHAR(32) 商品数量
price VARCHAR(32) 商品单价
is_used VARCHAR(32) 兑货券使用状态,参考值:“未使用”、“已使用”、“已回收”
used_time VARCHAR(32) 兑货券使用时间。格式:yyyy-MM-dd HH:mm
order_no VARCHAR(32) 订单编码
order_id VARCHAR(32) 订单id
supply_code VARCHAR(32) 供应商编码
supply_name VARCHAR(32) 供应商名称
is_back VARCHAR(32) 兑货券回收状态,参考值:“已回收”、“未回收”
sign_num VARCHAR(32) 回收数量
sign_time VARCHAR(32) 回收时间

# 新增兑货券

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

{
    "coupon_no": "DH20200507000001",
    "deal_name": "2020-05-07-001",
    "cm_id": "6389893435290873348",
    "cm_code": "CM0001",
    "start_date": "2020-01-01",
    "end_date": "2020-12-01",
    "promotion_name": "",
    "recycle_date": "2020-12-01",
    "doorsill_percent": "80",
    "prods": [
        {
            "product_id": "7755038711664976249",
            "product_code": "PD001",
            "unit_name": "箱",
            "num": "10.00000000"
        }
    ]
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
coupon_no VARCHAR(100) 兑货券编码。如果传兑货券编码,则按传入的编码;如果不传,则按照365的兑货券生成规则自动生成
deal_name VARCHAR(100) 兑货券协议名称
cm_id VARCHAR(32) 兑货券客户id,客户id和客户编码必须传一个
cm_code VARCHAR(100) 兑货券客户编码,客户id和客户编码必须传一个
start_date VARCHAR(32) 兑货券有效期开始时间。格式:yyyy-mm-dd
end_date VARCHAR(32) 兑货券有效期结束时间。格式:yyyy-mm-dd
promotion_name VARCHAR(100) 关联促销方案
recycle_date VARCHAR(32) 通路回收时间(兑换后天数)
doorsill_percent VARCHAR(32) 兑货券使用门槛。百分比值,如80%,则传80;如果为空,则为不限制
prods List 列表
prods.product_id VARCHAR(32) 商品id。商品id和商品编码不能同时为空
prods.product_code VARCHAR(100) 商品编码,商品id和商品编码不能同时为空
prods.unit_name VARCHAR(32) 商品单位
prods.num NUMERIC(18,8) 兑换数量

响应示例:

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

数据DATA示例:

[
    {
        "id": "8183666817447601554",
        "code": "DH20200507000001"
    }
]

参数说明:

参数 类型 必填 说明
id VARCHAR(32) 兑货券id
code VARCHAR(100) 兑货券编码

# 审批兑货券

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

{
    "coupon_no": "DH20200507000001",
    "coupon_status": "1",
    "confirm_emp": "张三"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
coupon_no VARCHAR(100) 兑货券编码
coupon_status VARCHAR(32) 审批意见。1:通过,2:打回
confirm_emp VARCHAR(100) 审批人

响应示例:

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

参数说明:

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

# 直营订单业务状态同步接口

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

{
    "order_id": "123456",
    "order_no": "DDXXXXXXXXX",
    "order_create_date": "2016-12-09",
    "purchase_business_status": "XS_YWC"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
order_id INT 单据id(单据id或单据编号必传一个)
order_no VARCHAR(32) 单据编号(单据id或单据编号必传一个)
order_create_date VARCHAR(32) 单据创建日期。格式:yyyy-MM-dd
purchase_business_status VARCHAR(32) 单据业务状态码

响应示例:

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

参数说明:

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

# 新增客户配额

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

{
    "name": "指定范围全部配额",
    "start_date": "2020-06-28",
    "end_date": "2020-06-28",
    "trade_type": "1",
    "cus_range_type": "2",
    "dept_id": "7233365496260253510,8233198284131411873",
    "customer_level_id": "8715900737400193117,7287736961434231483",
    "district_id": "2,3,4",
    "products": [
          {
            "id": "9043401268045478811",
            "unit_name": "箱",
            "unit_id": "6362931419429812568",
            "num": "200"
        }
    ]
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
name VARCHAR(100) 配额名称
start_date VARCHAR(32) 开始日期。格式:yyyy-MM-dd
end_date VARCHAR(32) 结束日期。格式:yyyy-MM-dd
trade_type VARCHAR(32) 客户对象。1:全部,2:经销商,3:终端门店。若cus_range_type传2,则本参数必填
cus_range_type VARCHAR (32) 客户范围。2:按客户属性设置范围,1:指定具体客户
dept_id VARCHAR(32) 客户属性-部门id,多个值用“,”分隔
dept_name VARCHAR(100) 客户属性-部门名称,多个值用“,”分隔
dept_code VARCHAR(100) 客户属性-部门编码,多个值用“,”分隔
dept_source_code VARCHAR(100) 客户属性-部门第三方系统的唯一标识,多个值用“,”分隔
customer_level_id VARCHAR(32) 客户属性-客户级别id,多个值用“,”分隔
customer_level_source_code VARCHAR(100) 客户属性-客户级别第三方系统的唯一标识,多个值用“,”分隔
customer_level_name VARCHAR(100) 客户属性-客户级别名称,多个值用“,”分隔
type_id VARCHAR(32) 客户属性-类型id,多个值用“,”分隔
type_code VARCHAR(100) 客户属性-类型编码,多个值用“,”分隔
type_name VARCHAR(100) 客户属性-类型名称,多个值用“,”分隔
type_source_code VARCHAR(100) 客户属性-类型第三方系统的唯一标识,多个值用“,”分隔
district_id VARCHAR(32) 客户属性-销售区域id,多个值用“,”分隔
district_code VARCHAR(100) 客户属性-销售区域编码,多个值用“,”分隔
district_name VARCHAR(100) 客户属性-销售区域名称,多个值用“,”分隔
district_source_code VARCHAR(100) 客户属性-销售区域第三方系统的唯一标识,多个值用“,”分隔
cm_id VARCHAR(32) 指定客户-经销商id。若cus_range_type为1,cm_id、cm_code、cm_name、cm_source_code不能同时为空
cm_code VARCHAR(32) 指定客户-经销商编码。若cus_range_type为1,cm_id、cm_code、cm_name、cm_source_code不能同时为空
cm_name VARCHAR(32) 指定客户-经销商名称。若cus_range_type为1,cm_id、cm_code、cm_name、cm_source_code不能同时为空
cm_source_code VARCHAR(32) 指定客户-经销商第三方系统的唯一标识。若cus_range_type为1,cm_id、cm_code、cm_name、cm_source_code不能同时为空
products List 列表
products.id VARCHAR(32) 商品id。id、code、source_code不能同时为空
products.code VARCHAR(100) 商品编码。id、code、source_code不能同时为空
products.source_code VARCHAR (100) 商品第三方系统的唯一标识。id、code、source_code不能同时为空
products.unit_name VARCHAR (32) 商品单位名称。unit_name和unit_id不能同时为空
products.unit_id VARCHAR(32) 商品单位id。unit_name和unit_id不能同时为空
products.num VARCHAR(32) 数量

响应示例:

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

数据DATA示例:

[
    {
       "id":"5932650281301050831"
    }
]

参数说明:

参数 类型 说明
id String 配额id

# 修改客户配额

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

{
    "quota_id": "5932650281301050831",
    "products": [
          {
            "id": "9043401268045478811",
            "num": "200"
        }
    ]
}
说明: 本示例仅供参考。该接口仅支持按商品设置的客户配额,不支持商品组。

参数说明:

参数 类型 必填 说明
quota_id VARCHAR(32) 配额id
products List 列表
products.id VARCHAR(32) 商品id。id、code、source_code不能同时为空
products.code VARCHAR(100) 商品编码。id、code、source_code不能同时为空
products.source_code VARCHAR (100) 商品第三方系统的唯一标识。id、code、source_code不能同时为空
products.num VARCHAR(32) 传入修改后的配额总量。单位对应为新增时配额行的单位。

响应示例:

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

参数说明:

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

# 查询共享配额

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

{
    "id": "6225324992642325132",
    "name":"测试配额",
    "start_date": "2020-09-21",
    "end_date": "2020-10-21",
    "page_length": 1000,
    "page_number": 1
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
id VARCHAR(32) 客户配额id
name VARCHAR(32) 配额名称,模糊匹配
start_date VARCHAR(32) 开始日期。格式:yyyy-MM-dd
end_date VARCHAR(32) 结束日期。格式:yyyy-MM-dd
page_length int 分页每页记录条数,默认1000
page_number int 分页第几页,默认第1页

响应示例:

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

数据DATA示例:

[
    {
        "end_date": "2020-10-21 23:59:59",
        "name": "测试配额",
        "cus_range_type": "2",
        "customer_level": "8715900737400193117,7287736961434231483,8783574560179216331",
        "trade_type": "1",
        "id": "6225324992642325132",
        "district_id": "5880045821365020046,5151941004870826006",
        "dept_id": "8951924987151419703",
        "start_date": "2020-09-21 00:00:00",
        "type_id":"",
        "prods": [{
            "unit_name": "箱",
            "leave_num": "1.0",
            "use_num": "0.0",
            "pd_id": "6965466323694544792",
            "base_unit_num": "1.0",
            "ratio": 1.00000000
        }, {
            "unit_name": "瓶",
            "leave_num": "1.0",
            "use_num": "0.0",
            "pd_id": "5073938100193484331",
            "base_unit_num": "1.0",
            "ratio": 1.00000000
        }]
    }
]

参数说明:

参数 类型 说明
end_date TIMESTAMP 结束日期
name VARCHAR(32) 配额名称
cus_range_type VARCHAR(1) 客户范围。2:按客户属性设置范围,1:指定具体客户
trade_type VARCHAR(1) 客户对象。1:全部,2:经销商,3:终端门店
id VARCHAR(32) 配额id
district_id VARCHAR(32) 客户属性-销售区域id,多个值用“,”分隔
dept_id VARCHAR(32) 客户属性-部门id,多个值用“,”分隔
type_id VARCHAR(32) 客户属性-类型id,多个值用“,”分隔
customer_level VARCHAR(32) 客户属性-客户级别id,多个值用“,”分隔
prods List 列表
prods.unit_name VARCHAR(32) 录入单位名称
prods.leave_num VARCHAR(32) 基本单位可用配额
prods.use_num VARCHAR(32) 基本单位已用配额
prods.pd_id VARCHAR(32) 商品id
prods.base_unit_num VARCHAR(32) 基本单位配额总量
prods.ratio VARCHAR(32) 单位换算率

# 查询客户配额(限量)-按商品

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

{
    "cm_code": "CUS000002",
    "cm_id":"6225324992642325132",
    "start_date": "2020-09-21",
    "end_date": "2020-10-21",
    "page_number": 1,
    "page_length": 100
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
cm_id VARCHAR(32) 客户ID
cm_code VARCHAR(100) 客户编码,模糊匹配
start_date VARCHAR(32) 开始日期。格式:yyyy-MM-dd
end_date VARCHAR(32) 结束日期。格式: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示例:

[
    {
      "end_date": "2021-11-30",
      "cm_code": "CUS000002",
      "cm_id": "8078723553496786531",
      "cm_name": "老杜的直营经销商",
      "id": "8877331564457593316",
      "start_date": "2021-10-18",
      "prods": [
        {
          "input_unit_name": "箱",
          "base_use_num": "96.00000000",
          "pd_name": "美年达1.5L",
          "input_unit": "5803442770927807830",
          "pd_id": "7143944694665909984",
          "pd_code": "baiyin_meinianda_015",
          "base_unit_num": "12000.00000000",
          "base_leave_num": "11904.00000000",
          "ratio": "12.00000000"
        },
        {
          "input_unit_name": "箱",
          "base_use_num": "206.00000000",
          "pd_name": "美年达1.8L",
          "input_unit": "7436738431149470274",
          "pd_id": "6594438290133846973",
          "pd_code": "baiyin_meinianda_0100",
          "base_unit_num": "12000.00000000",
          "base_leave_num": "11794.00000000",
          "ratio": "12.00000000"
        }
      ]
    }
]

参数说明:

参数 类型 说明
id VARCHAR(32) 配额ID
cm_id VARCHAR(32) 客户ID
cm_code VARCHAR(100) 客户编码
cm_name VARCHAR(100) 客户名称
start_date VARCHAR(32) 开始日期。格式:yyyy-MM-dd
end_date VARCHAR(32) 结束日期。格式:yyyy-MM-dd
prods List 商品集合
prods.pd_id VARCHAR(32) 商品ID
prods.pd_code VARCHAR(100) 商品编码
prods.pd_name VARCHAR(100) 商品名称
prods.input_unit VARCHAR(32) 录入单位ID
prods.input_unit_name VARCHAR(32) 录入单位名称
prods.base_leave_num VARCHAR(32) 基本单位可用配额
prods.base_use_num VARCHAR(32) 基本单位已用配额
prods.base_unit_num VARCHAR(32) 基本单位配额总量
prods.ratio VARCHAR(32) 单位换算率

# 查询客户配额(限量)-按商品组

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

{
    "cm_code": "USER001",
    "cm_id":"8078723553496786531",
    "start_date": "2020-09-21",
    "end_date": "2020-10-21",
    "page_number": 1,
    "page_length": 100
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
cm_id VARCHAR(32) 客户ID
cm_code VARCHAR(100) 客户编码,模糊匹配
start_date VARCHAR(32) 开始日期。格式:yyyy-MM-dd
end_date VARCHAR(32) 结束日期。格式: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示例:

[
    {
      "end_date": "2022-02-18",
      "cm_code": "CUS010057",
      "start_date": "2022-01-29",
      "cm_id": "8261138874684328070",
      "cm_name": "经销商698",
      "set_type": "3",
      "id": 5182948809562810579,
      "pd_group": [
        {
          "prods": [
            {
              "pd_name": "徐福记鸡蛋味磨堡蛋糕开袋有礼袋装@4(5x190g) CN",
              "pd_id": "5649247804170269808",
              "pd_code": "12429127"
            },
            {
              "pd_name": "徐福记芝麻味磨堡蛋糕开袋有礼袋装@4(5x190g) CN",
              "pd_id": "6909802553692176330",
              "pd_code": "12429143"
            },
            {
              "pd_name": "奇欧比混合味皇冠巧伯礼桶巧克力代可可脂巧克力制品桶装@12x400gN1 CN",
              "pd_id": "5305586956782193565",
              "pd_code": "12429342"
            }
          ],
          "num": "1.00000000",
          "leave_num": "1.00000000",
          "id": "6286824530802957326",
          "use_num": "0.00000000"
        },
        {
          "prods": [
            {
              "pd_name": "徐福记沙琪玛蛋黄味礼箱装@4x1.258kg CN",
              "pd_id": "5519612291868405998",
              "pd_code": "12434809"
            },
            {
              "pd_name": "徐福记沙琪玛蛋黄味礼箱装@8x1.258kg CN",
              "pd_id": "6836469404668823760",
              "pd_code": "12434810"
            },
            {
              "pd_name": "徐福记混合口味颐和园综合礼盒@6x502gN1 CN",
              "pd_id": "5410301540946856948",
              "pd_code": "12437461"
            }
          ],
          "num": "1.00000000",
          "leave_num": "1.00000000",
          "id": "7260339783336677243",
          "use_num": "0.00000000"
        }
      ],
      "type_group": [
        {
              "types": [
                {
                  "type_name": "东东测试",
                  "type_id": "7457495518661131674"
                },
                {
                  "type_name": "科技",
                  "type_id": "5516029438444450722"
                }
              ],
              "num": "1.00000000",
              "leave_num": "1.00000000",
              "id": "7238401400236745981",
              "use_num": "0.00000000"
            }
      ]
    }
]

参数说明:

参数 类型 说明
id VARCHAR(32) 配额ID
cm_id VARCHAR(32) 客户ID
cm_code VARCHAR(100) 客户编码
cm_name VARCHAR(100) 客户名称
start_date VARCHAR(32) 开始日期。格式:yyyy-MM-dd
end_date VARCHAR(32) 结束日期。格式:yyyy-MM-dd
set_type VARCHAR(1) 2商品组(类型) 3、商品组(商品)
pd_group List 商品组(商品)集合 set_type=3
pd_group.num VARCHAR(32) 配额总量
pd_group.use_num VARCHAR(32) 已用配额
pd_group.leave_num VARCHAR(32) 可用配额
pd_group.prods List 商品集合
pd_group.prods.pd_id VARCHAR(32) 商品ID
pd_group.prods.pd_code VARCHAR(100) 商品编码
pd_group.prods.pd_name VARCHAR(100) 商品名称
type_group List 商品组(类型)集合 set_type=2
pd_group.num VARCHAR(32) 配额总量
pd_group.use_num VARCHAR(32) 已用配额
pd_group.leave_num VARCHAR(32) 可用配额
pd_group.types List 商品类型集合
pd_group.types.type_id VARCHAR(32) 商品类型ID
pd_group.types.type_name VARCHAR(100) 商品类型名称

# 经销商车辆查询接口

请求方式: 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/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",
        "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"
            }
        ]
    }
]

参数说明:

参数 类型 必填 说明
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) 备注
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:否

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

请求方式: 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/dmssent/v1/thirdSignNum/{openid}/{timestamp}/{digest}/{msg_id} 在线调试
请求示例:

{
  "sent_create_date":"",
  "order_sent_id":"",
  "prods":[
      {
          "order_sent_detail_id":"",
          "third_sign_num":""
      }
  ]
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必须 说明
sent_create_date VARCHAR(32) 发货单创建日期。格式yyyy-mm-dd
order_sent_id VARCHAR(32) 发货单ID
prods List 列表
prods.order_sent_detail_id VARCHAR(32) 发货单明细ID
prods.third_sign_num NUMERIC(20,8) 第三方基本单位签收数量

响应示例:

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

参数说明:

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

# 直营订单退货订单新增接口

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

{
    "operate_type": "",
    "order_no": "",
    "type": "",
    "erp_type": "",
    "erp_No": "",
    "sent_id": "",
    "rel_order_id": "",
    "cm_code": "",
    "cm_id": "",
    "date": "",
    "emp_id": "",
    "emp_code": "",
    "consignment_date": "",
    "receive_name": "",
    "receive_phone": "",
    "receive_tel": "",
    "receive_addr": "",
    "remark": "",
    "reason": "",
    "order_amount": "",
    "prods": [
		{
			"id": "",
			"code": "",
			"price": "",
			"num": "",
			"unit": "",
			"unit_name": "",
			"amount": "",
			"is_gift": "",
			"remark": "",
            "dms_order_detail_id": ""
		}
	],
    "exts": [
        {
    		"ext_key": "自定义字段1",
    		"ext_value": "四星"
    	},
    	{
    		"ext_key": "自定义字段2",
    		"ext_value": "SO123123123"
    	}
    ]
}  
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
operate_type VARCHAR(32) 1:新增直营退货订单,2:编辑直营退货订单
order_no VARCHAR(100) 新增的时候传递作为新订单的单号(不传系统自动生成),编辑的时候传递作为参数进行编辑订单
type CHAR(1) 订单类型。1:退货订单,2:换入订单
erp_type VARCHAR(10) ERP订单类型,不传默认为“退货订单”
erp_No VARCHAR(32) ERP退货订单号
sent_id VARCHAR(32) 退货发货单id
rel_order_id VARCHAR(32) 关联订单ID
cm_code VARCHAR(100) 客户编码,客户id和客户编码必须传一个
cm_id VARCHAR(32) 客户id,客户id和客户编码必须传一个
date VARCHAR(32) 业务日期。格式:yyyy-MM-dd HH:mm
emp_id VARCHAR(32) 业务员Id,业务员id和业务员编码都不传,默认取其中一个客户经理的
emp_code VARCHAR(100) 业务员编码,业务员id和业务员编码都不传,默认取其中一个客户经理的
consignment_date VARCHAR(32) 要求交货日期。格式:yyyy-mm-dd
receive_name VARCHAR(100) 收货人名称
receive_phone VARCHAR(32) 收货人手机
receive_tel VARCHAR(32) 收货人电话
receive_addr VARCHAR(1000) 收货地址
remark text 订单单据头备注
reason VARCHAR(32) 退货原因
order_amount VARCHAR(32) 退货金额,精度最高两位小数
prods List 列表
prods.id VARCHAR(32) 商品id和商品编码必须传一个
prods.code VARCHAR(100) 商品id和商品编码必须传一个
prods.price numeric(18,8) 退货价不传就取客户价格,赠品价格为0
prods.num numeric(18,8) 退货数量
prods.unit VARCHAR(32) 退货单位id和退货单位名称传一个即可,不传使用基本单位
prods.unit_name VARCHAR(32) 退货单位id和退货单位名称传一个即可,不传使用基本单位
prods.amount numeric(18,2) 退货金额
prods.is_gift VARCHAR(10) 是否是赠品。1:是,0:否。不传默认是非赠品
prods.remark text 订单子表的备注
prods.dms_order_detail_id VARCHAR(32) 关联订单详情id,只在关联订单退货的时候需要传递
exts List 退货订单主信息扩展字段列表
exts.ext_key VARCHAR(4000) 退货订单主信息扩展字段key值扩展字段需先在我方系统中创建
exts.ext_value VARCHAR(4000) 扩展字段value值对多个选项值,以“,”分隔拼接

接口说明:退货价price不传默认取客户价格,是否是赠品is_gift不传默认为非赠品。如果该商品是赠品,price传0,is_gift传1。未免出错,这二个字段建议必填

响应示例:

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

参数说明:

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

# 直营退货订单新增收货接口

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

{
  "no":"",
  "order_no":"",
  "order_id":"",
  "date":"",
  "erp_stock_no":"",
  "prods":[
      {
          "id":"",
          "order_detail_id":"",
          "erp_stock_detail_id":"",
          "product_id":"",
          "product_code":"",
          "num":"",
          "unit":"",
          "unit_name":"",
          "amount":""
      }
  ]
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
no VARCHAR(100) 有ERP入库单号则传ERP入库单号,不传自动生成
order_no VARCHAR(100) 退货订单号,退货订单号和退货订单ID必须传一个
order_id VARCHAR(32) 退货订单id,退货订单号和退货订单ID必须传一个
date VARCHAR(32) ERP入库日期。格式:yyyy-mm-dd
erp_stock_no VARCHAR(32) ERP入库单号
prods List 列表
prods.id VARCHAR(32) 入库单明细行ID
prods.order_detail_id VARCHAR(32) 对应退货订单明细行ID
prods.erp_stock_detail_id VARCHAR(32) ERP入库单明细行ID
prods.product_id VARCHAR(32) 商品id和商品编码必须传一个
prods.product_code VARCHAR(100) 商品id和商品编码必须传一个
prods.num NUMERIC(18,8) 入库数量
prods.unit VARCHAR(32) 入库单位和入库单位名称传一个即可,不传使用基本单位
prods.unit_name VARCHAR(32) 入库单位和入库单位名称传一个即可,不传使用基本单位
prods.amount NUMERIC(18,2) 入库金额

响应示例:

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

参数说明:

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

# 查询车辆盘点单

请求方式: 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:处理品库(换货库存)

# 直营订单发货单自动签收

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

{
    "sent_no": "FH20201110000001"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
sent_no VARCHAR(100) 发货单号

响应示例:

{
	"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 响应数据

# 直营订单自定义字段修改

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

{
    "order_no": "FH20201110000001",
    "exts":[{
        "ext_key":"等级",
        "ext_value":"VIP"
    }],
    "products":[{
        "id":"20201110000001",
        "exts":[{
        	"ext_key":"商品等级",
        	"ext_value":"88VIP"
    	}]
    }]
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
order_no VARCHAR(100) 订单单号
exts List 列表
exts.ext_key VARCHAR(100) 订单主数据扩展字段名称
exts.ext_value VARCHAR(100) 订单主数据扩展字段数据值
products List 列表
products.id VARCHAR(100) 订单明细行id
products.exts List 订单明细数据扩展字段列表
products.exts.ext_key VARCHAR(100) 订单明细数据扩展字段名称
products.exts.ext_value VARCHAR(100) 订单明细数据扩展字段数据值

响应示例:

{
	"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 响应数据

# 新增直营订单发货单运输信息

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

{
    "bill_code": "FH20201110000001",
    "driver_name":"小杜呀",
    "driver_phone":"13675189390",
    "car_no":"che1",
    "delivery_date":"2020-12-27",
    "remark":"我这是备注",
    "logistics_url":"",
    "orderSents":[
        {
            "sent_id":"7817081791819132613",
            "sent_no":"FH20210118000003"
        }
    ]
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
bill_code VARCHAR(100) 运单号
driver_name VARCHAR(32) 司机名称
driver_phone VARCHAR(32) 司机手机号
car_no VARCHAR(32) 车牌号
delivery_date TIMESTAMP 预计送达日期。格式:yyyy-MM-dd
remark TEXT 备注
logistics_url VARCHAR(100) 物流链接地址
orderSents List 发货单列表
orderSents.sent_id INT8 发货单id,接口传参至少要传一条发货单数据
orderSents.sent_no VARCHAR(100) 发货单号

响应示例:

{
	"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 响应数据

# 新增收款单(收预存款)接口

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

{
	"supply_id": "-1",
    "supply_code": "",
	"cm_code": "",
	"business_type": "",
	"capitalpool_code": "",
	"from_details": [
		{
			"settlement_name": "",
			"amount": ""
		}
	],
	"receive_date": "",
	"receiver": "",
	"remark": "",
	"main_exts": [
		{
			"ext_name": "",
			"ext_value": ""
		},
		{
			"ext_name": "",
			"ext_value": ""
		}
	]
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
supply_id VARCHAR(32)  收款单位id。收款单位id和收款单位编码必须传一个。厂家/直接经销商传值为-1
supply_code VARCHAR(100) 收款单位编码,收款单位id和收款单位编码必须传一个 
cm_code VARCHAR(100)  客户编码 
business_type VARCHAR(100)  收款类型。0:收欠款,1:收订金,2:退订金 3:收预存款
capitalpool_code VARCHAR(100)  资金池编码
receive_date TIMESTAMP  收款日期。格式:yyyy-MM-dd
receiver VARCHAR(100)  收款人 (编码)
remark VARCHAR(300) 备注说明
from_details List 列表
from_details.settlement_name VARCHAR(100)  结算方式名称 
from_details.amount VARCHAR(100)  收款金额
main_exts List 自定义字段列表
main_exts.ext_name VARCHAR(100)  自定义字段名称
main_exts.ext_value VARCHAR(100)  自定义字段值 

响应示例:

{
	"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 响应数据

# 新增收款单(收货款)接口

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

{
	"supply_id": "-1",
	"supply_code": "",
	"cm_code": "",
	"business_type": "",
	"pool_details": [
		{
			"capitalpool_code": "",
			"use_amount": ""
		}
	],
	"from_details": [
		{
			"settlement_name": "",
			"amount": ""
		}
	],
	"receive_discount_amount": "",
	"receive_date": "",
	"receiver": "",
	"remark": "",
	"main_exts": [
		{
			"ext_name": "",
			"ext_value": ""
		},
		{
			"ext_name": "",
			"ext_value": ""
		}
	],
	"details": [
		{
			"bill_code": "TH20211109000005",
			"amount": "200",
			"bill_type": ""
		}
	]
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
supply_id VARCHAR(32) 收款单位id。收款单位id和收款单位编码必须传一个。厂家/直接经销商传值为-1
supply_code VARCHAR(100) 收款单位编码,收款单位id和收款单位编码必须传一个
cm_code VARCHAR(100)  客户编码 
business_type VARCHAR(100) 收款类型。0:收欠款,1:收订金,2:退订金 3:收预存款
pool_details List  列表
pool_details.capitalpool_code VARCHAR(100)  使用预存款子表-资金池编码
pool_details.use_amount VARCHAR(100)  使用预存款子表-使用金额
receive_date TIMESTAMP  收款日期。格式:yyyy-MM-dd
receiver VARCHAR(100)  收款人(编码) 
remark VARCHAR(300) 备注说明
receive_discount_amount VARCHAR(100) 收款优惠
from_details List 列表
from_details List 列表
from_details.settlement_name VARCHAR(100)  收款子表-结算方式名称 
from_details.amount VARCHAR(100) 收款子表-收款金额
details List 列表
details.bill_code VARCHAR(100) 关联单据-单据号
details.amount VARCHAR(100) 关联单据-本单结算金额
details.bill_type VARCHAR(100) 关联单据-单据类型。CXD:车销单,ZYFHD:直营发货单,FXFHD:分销发货单,CPD:车铺单,THD:退货单
main_exts List 列表
main_exts.ext_name VARCHAR(100)  自定义字段名称
main_exts.ext_value VARCHAR(100)  自定义字段值 

响应示例:

{
	"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 响应数据

# 收款单查询接口

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

{
    "page_number": 1,
    "page_length": 100,
    "supply_id": -1,
    "cm_code": "USER001",
    "start_create_date": "2016-12-09",
    "end_create_date": "2016-12-19",
    "start_modify_date": "2017-12-09",
    "end_modify_date": "2017-12-09"
}
    

参数说明:

参数 类型 必填 说明
supply_id VARCHAR(32) 收款单位ID。总部传-1。
cm_code VARCHAR(100) 客户编码
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": true,
	"response_data":"<<DATA>>"
}

数据DATA示例:

[
		{
			"id": "",
			"receive_no": "",
			"confirm_status": "",
			"confirm_status_name": "",
			"cm_id": "",
			"cm_code": "",
			"cm_name": "",
			"supply_id": "",
			"supply_code": "",
			"supply_name": "",
			"receive_type": "",
			"receive_type_name": "",
			"capitalpool_id": "",
			"capitalpool_code": "",
			"capitalpool_name": "",
			"small_amount": "",
			"receive_date": "",
			"emp_name": "",
			"remark": "",
             "details": [
				{
					"bill_id": "",
					"bill_code": "",
					"bill_type": "",
					"bill_type_name": "",
					"bill_amount": ""
				}
			],
			"pool_detail": [
				{
					"pool_detail_id": "",
					"pool_detail_code": "",
					"pool_detail_amount": ""
				}
			],
			"settlement_detail": [
				{
					"settlement_detail_id": "",
					"settlement_detail_name": "",
					"settlement_detail_amount": ""
				}
			],
			"ext_infos": [
				{
					"ext_code": "",
					"ext_name": "",
					"ext_value": ""
				}
			]
		}
]

参数说明:

参数 类型 必填 说明
id INT8 收款单ID
receive_no VARCHAR(32) 收款单号
confirm_status VARCHAR(32) 状态。0:待审批,1:待入账,2:已作废,3:已入账
confirm_status_name VARCHAR(100) 状态名称
cm_id VARCHAR(100) 客户id
cm_code VARCHAR(100) 客户编码
cm_name VARCHAR(100) 客户名称
supply_id INT8 收款单位id
supply_code VARCHAR(100) 收款单位编码
supply_name VARCHAR(100) 收款单位名称
receive_type VARCHAR(32) 业务类型。0:收货款,2:退订金 3:收预存款
receive_type_name VARCHAR(100) 收款类型名称
capitalpool_id INT8 资金池id
capitalpool_code VARCHAR(100) 资金池编码
capitalpool_name VARCHAR(100) 资金池名称
small_amount VARCHAR(100) 收款优惠
receive_date VARCHAR(100) 收款日期
emp_name VARCHAR(100) 收款人
remark text 备注说明
details.bill_id INT8 关联单据-单据id
details.bill_code VARCHAR(100) 关联单据-单据号
details.bill_type VARCHAR(100) 关联单据-单据类型。CXD:车销单,FHD:发货单,CPD:车铺单,THD:退货单
details.bill_type_name VARCHAR(100) 关联单据-单据类型名称
details.bill_amount VARCHAR(100) 关联单据-本单结算金额
pool_detail List 使用预存款子表列表
pool_detail.pool_detail_id INT8 使用预存款子表-资金池id
pool_detail.pool_detail_code VARCHAR(100) 使用预存款子表-资金池编码
pool_detail.pool_detail_amount VARCHAR(100) 使用预存款子表-使用金额
settlement_detail List 收款子表列表
settlement_detail.settlement_detail_id INT8 收款子表-结算方式id
settlement_detail.settlement_detail_name VARCHAR(100) 收款子表-结算方式名称
settlement_detail.settlement_detail_amount VARCHAR(100) 收款子表-收款金额
ext_infos VARCHAR(100) 自定义字段列表
ext_infos.ext_code VARCHAR(100) 自定义字段-编码
ext_infos.ext_name VARCHAR(100) 自定义字段-名称
ext_infos.ext_value VARCHAR(100) 自定义字段-值

# 新增退款单(退预存款)接口

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

{
	"supply_id": "-1",
    "supply_code": "",
	"cm_code": "",
	"business_type": "",
	"capitalpool_code": "",
	"from_details": [
		{
			"settlement_name": "",
			"amount": ""
		}
	],
	"receive_date": "",
	"receiver": "",
	"remark": "",
	"main_exts": [
		{
			"ext_name": "",
			"ext_value": ""
		},
		{
			"ext_name": "",
			"ext_value": ""
		}
	]
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
supply_id VARCHAR(32)  退款单位id (退款单位id和退款单位编码必须传一个。总部传-1)
supply_code VARCHAR(100) 退款单位编码,退款单位id和退款单位编码必须传一个 
cm_code VARCHAR(100)  客户编码 
business_type VARCHAR(100)  退款类型(4:退货款 5:退预存款)
capitalpool_code VARCHAR(100)  资金池编码
receive_date TIMESTAMP  退款日期。格式:yyyy-MM-dd
receiver VARCHAR(100)  退款人(编码) 
remark VARCHAR(300) 备注说明
from_details List 列表
from_details.settlement_name VARCHAR(100)  结算方式名称 
from_details.amount VARCHAR(100)  退款金额
main_exts List 列表
main_exts.ext_name VARCHAR(100)  自定义字段名称
main_exts.ext_value VARCHAR(100)  自定义字段值 

响应示例:

{
	"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 响应数据

# 新增退款单(退货款)接口

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

{
	"supply_id": "-1",
    "supply_code": "",
	"cm_code": "",
	"business_type": "",
	"pool_details": [
		{
			"capitalpool_code": "",
			"use_amount": ""
		}
	],
	"from_details": [
		{
			"settlement_name": "",
			"amount": ""
		}
	],
	"receive_date": "",
	"receiver": "",
	"remark": "",
	"main_exts": [
		{
			"ext_name": "",
			"ext_value": ""
		},
		{
			"ext_name": "",
			"ext_value": ""
		}
	],
	"details": [
		{
			"bill_code": "",
			"amount": "",
			"bill_type": ""
		}
	]
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
supply_id VARCHAR(32) 退款单位id (退款单位id和退款单位编码必须传一个。总部传-1)
supply_code VARCHAR(100) 退款单位编码,退款单位id和退款单位编码必须传一个
cm_code VARCHAR(100)  客户编码 
business_type VARCHAR(100) 退款类型(4:退货款 5:退预存款)
pool_details List 列表
pool_details.capitalpool_code VARCHAR(100)  使用预存款子表.资金池编码
pool_details.use_amount VARCHAR(100)  使用预存款子表.使用金额
receive_date TIMESTAMP  退款日期。格式:yyyy-MM-dd
receiver VARCHAR(100)  退款人 (编码)
remark VARCHAR(300) 备注说明
from_details List 列表
from_details.settlement_name VARCHAR(100)  退款子表-结算方式名称 
from_details.amount VARCHAR(100) 退款子表- 退款金额
details List 列表
details.bill_code VARCHAR(100) 关联单据.单据号
details.amount VARCHAR(100) 关联单据.本单结算金额
details.bill_type VARCHAR(100) 关联单据.单据类型 (CXD:车销单, ZYFHD:直营发货单, FXFHD:分销发货单,CPD:车铺单,THD:退货单)
main_exts List 列表
main_exts.ext_name VARCHAR(100)  自定义字段名称
main_exts.ext_value VARCHAR(100)  自定义字段值 

响应示例:

{
	"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 响应数据

# 退款单查询接口

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

{
    "page_number": 1,
    "page_length": 100,
    "start_create_date": "2016-12-09",
    "end_create_date": "2016-12-19",
    "start_modify_date": "2017-12-09",
    "end_modify_date": "2017-12-09"
}
    
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
supply_id VARCHAR(32) 收款单位ID。总部传-1。
cm_code VARCHAR(100) 客户编码
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": true,
	"response_data":"<<DATA>>"
}

数据DATA示例:

[
		{
			"id": "",
			"receive_no": "",
			"confirm_status": "",
			"confirm_status_name": "",
			"cm_id": "",
			"cm_code": "",
			"cm_name": "",
			"supply_id": "",
			"supply_code": "",
			"supply_name": "",
			"receive_type": "",
			"receive_type_name": "",
			"capitalpool_id": "",
			"capitalpool_code": "",
			"capitalpool_name": "",
			"small_amount": "",
			"receive_date": "",
			"emp_name": "",
			"remark": "",
             "details": [
				{
					"bill_id": "",
					"bill_code": "",
					"bill_type": "",
					"bill_type_name": "",
					"bill_amount": ""
				}
			],
			"pool_detail": [
				{
					"pool_detail_id": "",
					"pool_detail_code": "",
					"pool_detail_amount": ""
				}
			],
			"settlement_detail": [
				{
					"settlement_detail_id": "",
					"settlement_detail_name": "",
					"settlement_detail_amount": ""
				}
			],
			"ext_infos": [
				{
					"ext_code": "",
					"ext_name": "",
					"ext_value": ""
				}
			]
		},
		{
			"id": "",
			"receive_no": "",
			"confirm_status": "",
			"confirm_status_name": "",
			"cm_id": "",
			"cm_code": "",
			"cm_name": "",
			"supply_id": "",
			"supply_code": "",
			"supply_name": "",
			"receive_type": "",
			"receive_type_name": "",
			"capitalpool_id": "",
			"capitalpool_code": "",
			"capitalpool_name": "",
			"receive_date": "",
			"emp_name": "",
			"remark": "",
            "details": [
				{
					"bill_id": "",
                      "bill_code": "",
                      "bill_type": "",
                      "bill_type_name": "",
                      "bill_amount": ""
				}
			],
			"pool_detail": [
				{
					"pool_detail_id": "",
					"pool_detail_code": "",
					"pool_detail_amount": ""
				}
			],
			"settlement_detail": [
				{
					"settlement_detail_id": "",
					"settlement_detail_name": "",
					"settlement_detail_amount": ""
				}
			],
			"ext_infos": [
				{
					"ext_code": "",
					"ext_name": "",
					"ext_value": ""
				}
			]
		}
]

参数说明:

参数 类型 必填 说明
id INT8 退款单ID
receive_no VARCHAR(32) 退款单号
confirm_status VARCHAR(32) 状态(0:待审批,1:待入账,2、已作废,3:已入账)
confirm_status_name VARCHAR(100) 状态名称
cm_id VARCHAR(100) 客户id
cm_code VARCHAR(100) 客户编码
cm_name VARCHAR(100) 客户名称
supply_id INT8 退款单位id
supply_code VARCHAR(100) 退款单位编码
supply_name VARCHAR(100) 退款单位名称
receive_type VARCHAR(32) 退款类型(4:退货款 5:退预存款)
receive_type_name VARCHAR(100) 退款类型名称
capitalpool_id INT8 资金池id
capitalpool_code VARCHAR(100) 资金池编码
capitalpool_name VARCHAR(100) 资金池名称
receive_date VARCHAR(100) 退款日期
emp_name VARCHAR(100) 退款人
remark text 备注说明
details.bill_id INT8 关联单据.单据id
details.bill_code VARCHAR(100) 关联单据.单据号
details.bill_type VARCHAR(100) 关联单据.单据类型(CXD:车销单,ZYFHD:直营发货单,FXFHD:分销发货单,CPD:车铺单,THD:退货单)
details.bill_type_name VARCHAR(100) 关联单据.单据类型名称
details.bill_amount VARCHAR(100) 关联单据.本单结算金额
pool_detail List 列表
pool_detail.pool_detail_id INT8 使用预存款子表.资金池id
pool_detail.pool_detail_code VARCHAR(100) 使用预存款子表.资金池编码
pool_detail.pool_detail_amount VARCHAR(100) 使用预存款子表.使用金额
settlement_detail List 列表
settlement_detail.settlement_detail_id INT8 退款子表.结算方式id
settlement_detail.settlement_detail_name VARCHAR(100) 退款子表.结算方式名称
settlement_detail.settlement_detail_amount VARCHAR(100) 退款子表.退款金额
ext_infos List 列表
ext_infos.ext_code VARCHAR(100) 自定义字段-编码
ext_infos.ext_name VARCHAR(100) 自定义字段-名称
ext_infos.ext_value VARCHAR(100) 自定义字段-值

# 退换货订单查询接口

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

{
    "rows": 1000,
    "page": 1,
    "supply_id": -1,
    "order_type": "1",
    "id": 5853717908000492197,
    "order_no": "TH20201012000003",
    "cm_code": "CUS010051",
    "after_create_date": "2021-11-23 10:57:24.487",
    "after_modify_date": "2021-11-23 10:57:24.487",
    "start_create_date": "2017-12-09",
    "end_create_date": "2017-12-09",
    "start_modify_date": "2017-12-09",
    "end_modify_date": "2017-12-09",
    "order_status": "DD_DSH",
    "status": "1"
}
    
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
after_create_date TIMESTAMP 创建时间之后。格式:yyyy-MM-dd HH:mm:ss
after_modify_date TIMESTAMP 修改时间之后。格式:yyyy-MM-dd HH:mm:ss
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 INT 页码默认1,每页默认1000条
rows INT 每页记录条数,默认最大是1000条,可以根据数据的大小自行优化调整
supply_id INT 供货商id。-1为直营退货订单,其他为分销退货订单
order_type VARCHAR(32) 订单类型。1:退货订单,2:换入订单
id INT8 退货订单ID
order_no VARCHAR(32) 退货订单编号
cm_code VARCHAR(32) 客户编码
order_status VARCHAR(100) DD_DSH、待收货,DD_YWC:已完成,DD_DQR:待确认,DD_YQX:已取消,DD_YQR:已确认 , 多状态用逗号分隔
status VARCHAR(32) 记录状态。0:已删除,1:正常

响应示例:

{
	"return_code": "0",
	"response_data":"<<DATA>>"
}

数据DATA示例:

[
    {
        "order_no": "DD20210803000030",
        "date": "2021-08-03 14:03",
        "supply_id": -1,
        "emp_name": "系统服务器",
        "remark": "测试直营订单退货接口",
        "products": [
            {
                "shenqing_count": "2.00000000",
                "shenqing_amount": "42.00",
                "shenqing_price": "21.00000000",
                "rel_remark": "测试直营订单退货接口",
                "product_code": "662_MZ_Master_01",
                "confirm_count": "2.00000000",
                "product_name": "662_MZ_Master_01",
                "unit_name": "箱",
                "order_detail_id": "",
                "is_gift": "N",
                "shenqing_input_unit": "4862203401633905967",
                "product_id": "7421053210327994503",
                "confirm_amount": "42.00"
            }
        ],
        "cm_code": "CUS000002",
        "ext_infos": [
            {
                "code": "ext_2112240123",
                "value": ""
            }
        ],
        "supply_name": "",
        "order_status": "DD_DSH",
        "receive_phone": "18569854561",
        "receive_name": "张三",
        "receive_tel": "02578946932",
        "id": 6107524931439186956,
        "order_type": "ZYGLTH",
        "emp_code": "intfadmin",
        "create_time": "2021-08-12 10:26",
        "change_back_reason_id": -1,
        "visit_implement_id": -1,
        "receive_addr": "江苏省南京市康缘智汇港",
        "cm_id": "8078723553496786531",
        "back_reason": "",
        "cm_name": "老杜的直营经销商",
        "consignment_date": "2021-08-12",
        "supply_code": "",
        "order_id": "7948284691295991321",
        "status": "1"
    },
    {
        "order_no": "DD20210803000030",
        "date": "2021-08-03 14:03",
        "supply_id": -1,
        "emp_name": "系统服务器",
        "remark": "测试直营订单退货接口",
        "products": [
            {
                "shenqing_count": "2.00000000",
                "shenqing_amount": "21.00",
                "shenqing_price": "21.00000000",
                "rel_remark": "测试直营订单退货接口",
                "product_code": "662_MZ_Master_01",
                "confirm_count": "2.00000000",
                "product_name": "662_MZ_Master_01",
                "unit_name": "箱",
                "order_detail_id": "",
                "is_gift": "N",
                "shenqing_input_unit": "4862203401633905967",
                "product_id": "7421053210327994503",
                "confirm_amount": "21.00"
            }
        ],
        "cm_code": "CUS000002",
        "ext_infos": [
            {
                "code": "ext_2112240123",
                "value": ""
            }
        ],
        "supply_name": "",
        "order_status": "DD_DSH",
        "receive_phone": "18569854561",
        "receive_name": "张三",
        "receive_tel": "02578946932",
        "id": 5165826807846570430,
        "order_type": "ZYGLTH",
        "emp_code": "intfadmin",
        "create_time": "2021-08-12 10:31",
        "change_back_reason_id": -1,
        "visit_implement_id": -1,
        "receive_addr": "江苏省南京市康缘智汇港",
        "cm_id": "8078723553496786531",
        "back_reason": "",
        "cm_name": "老杜的直营经销商",
        "consignment_date": "2021-08-12",
        "supply_code": "",
        "order_id": "7948284691295991321",
        "status": "1"
    },
    {
        "order_no": "DD20210428000003",
        "date": "2021-04-28 14:21",
        "supply_id": -1,
        "emp_name": "系统服务器",
        "remark": "测试直营订单退货接口",
        "products": [
            {
                "shenqing_count": "1.00000000",
                "shenqing_amount": "3.00",
                "shenqing_price": "3.00000000",
                "rel_remark": "测试直营订单退货接口",
                "product_code": "baiyin_meinianda_026",
                "confirm_count": "1.00000000",
                "product_name": "百事_美年达_葡萄味_2.5L",
                "unit_name": "袋",
                "order_detail_id": "",
                "is_gift": "N",
                "shenqing_input_unit": "6936228840570112101",
                "product_id": "5130759210739014375",
                "confirm_amount": "3.00"
            },
            {
                "shenqing_count": "1.00000000",
                "shenqing_amount": "3.00",
                "shenqing_price": "3.00000000",
                "rel_remark": "测试直营订单退货接口",
                "product_code": "baiyin_meinianda_027",
                "confirm_count": "1.00000000",
                "product_name": "百事_美年达_蜜桃味_2.5L",
                "unit_name": "箱",
                "order_detail_id": "",
                "is_gift": "N",
                "shenqing_input_unit": "6362931419429812568",
                "product_id": "9043401268045478811",
                "confirm_amount": "3.00"
            }
        ],
        "cm_code": "CUS000002",
        "ext_infos": [
            {
                "code": "ext_2112240123",
                "value": ""
            }
        ],
        "supply_name": "",
        "order_status": "DD_DSH",
        "receive_phone": "18569854561",
        "receive_name": "老杜的直营经销商",
        "receive_tel": "02578946932",
        "id": 7102018506706606280,
        "order_type": "ZYGLTH",
        "emp_code": "intfadmin",
        "create_time": "2021-08-12 10:46",
        "change_back_reason_id": -1,
        "visit_implement_id": -1,
        "receive_addr": "江苏省南京市康缘智汇港",
        "cm_id": "8078723553496786531",
        "back_reason": "",
        "cm_name": "老杜的直营经销商",
        "consignment_date": "2021-08-12",
        "supply_code": "",
        "order_id": "5692740992502705111",
        "status": "1"
    }
]

参数说明:

参数 类型 必填 说明
id INT8 退款单ID
status VARCHAR(32) 0:已删除,1:正常
order_no VARCHAR(32) 退货订单号
cm_code VARCHAR(32) 客户编码
supply_code VARCHAR(32) 供货商编码。直营退货订单供货商为空
supply_id INT 供货商id。-1为直营退货订单,其他为分销退货订单
date VARCHAR(32) 下单时间。格式:yyyy-mm-dd hh:mm
order_type VARCHAR(32) 订单类型。1:退货订单,2:换入订单
order_status VARCHAR(32) 订单状态。DD_DSH、待收货,DD_YWC:已完成,DD_DQR:待确认,DD_YQX:已取消,DD_YQR:已确认
order_id VARCHAR(32) 关联订单ID
emp_code VARCHAR(32) 业务员编码
consignment_date VARCHAR(32) 交货日期。格式:yyyy-mm-dd
receive_name VARCHAR(100) 收货人名称
receive_tel VARCHAR(32) 收货人手机
receive_phone VARCHAR(32) 收货人电话
receive_addr VARCHAR(1000) 收货地址
remark text 订单单据头备注
back_reason VARCHAR(32) 退货原因名称
visit_implement_id INT8 拜访ID
products.product_id VARCHAR(32) 商品id
products.product_code VARCHAR(100) 商品编码
products.shenqing_price numeric(18,8) 退货单价
products.shenqing_count numeric(18,8) 申请数量
products.confirm_count numeric(18,8) 确认数量
products.shenqing_input_unit VARCHAR(32) 退货单位id
products.unit_name VARCHAR(32) 退货单位名称
products.shenqing_amount numeric(18,2) 退货申请金额
products.confirm_amount numeric(18,2) 退货确认金额
products.is_gift VARCHAR(10) 是否是赠品。1:是,0:否。
products.rel_remark text 订单子表的备注
products.order_detail_id VARCHAR(32) 关联订单退货的订单明细id
ext_infos.code VARCHAR(4000) 退货订单主信息扩展字段key值扩展字段需先在我方系统中创建
ext_infos.value VARCHAR(4000) 扩展字段value值对多个选项值,以“,”分隔拼接
create_time TIMESTAMP 单据提交时间。格式:yyyy-mm-dd hh24:mi:ss.us
modify_time TIMESTAMP 单据最近一次变更时间。格式:yyyy-mm-dd hh24:mi:ss.us