TIP
- 新增直营订单发货单
- 新增直营订单
- 关闭直营订单
- DMS外部客户余额同步接口
- 查询直营采购订单
- 查询分销销售订单
- 查询分销或者直营发货单
- 查询分销或者直营签收单
- 查询盘点单
- 查询车铺单
- 查询实时库存
- 查询直营或分销退货单
- 查询兑货券明细
- 新增兑货券
- 审批兑货券
- 直营订单业务状态同步接口
- 新增客户配额
- 修改客户配额
- 查询共享配额
- 查询客户配额(限量)-按商品
- 查询客户配额(限量)-按商品组
- 经销商车辆查询接口
- 分销车销 - 调拨单查询接口
- 分销车销 - 车销单查询接口
- 经销商车辆库存查询接口
- 分销订单发货单第三方签收数量写入接口
- 直营订单退货订单新增接口
- 直营退货订单新增收货接口
- 查询车辆盘点单
- 直营订单发货单自动签收
- 直营订单自定义字段修改
- 新增直营订单发货单运输信息
- 新增收款单(收预存款)接口
- 新增收款单(收货款)接口
- 收款单查询接口
- 新增退款单(退预存款)接口
- 新增退款单(退货款)接口
- 退款单查询接口
- 退换货订单查询接口
# 新增直营订单发货单
请求方式: POST(HTTPS)
请求地址: https://openapi.waiqin365.com/api/dmssent/v1/addSent/{ openid }/{ timestamp }/{ digest }/{ msg_id }
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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_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_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 }
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
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 }
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
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 }
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
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 }
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
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 | 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 | 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 | 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 }
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 }
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
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 }
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
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 |