# 查询订单数据
请求方式: POST(HTTPS)
请求地址: https://openapi.waiqin365.com/api/stdorder/v1/queryStdomOrder/{openid}/{timestamp}/{digest}/{msg_id}
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
page_number | INT | 是 | 页码默认1,每页默认1000条 |
status | CHAR(1) | 否 | 记录状态。0:已删除,1:正常 |
cm_id | VARCHAR(32) | 否 | 勤策客户唯一ID |
cm_code | VARCHAR(32) | 否 | 客户编码,有效字符详见附录:有效字符说明 (opens new window) |
dept_id | VARCHAR(32) | 否 | 勤策业务员部门唯一ID |
dept_code | VARCHAR(32) | 否 | 业务员部门编码 |
create_date | VARCHAR(32) | 否 | 创建日期。格式:yyyy-MM-dd |
modify_date | VARCHAR(32) | 否 | 修改日期。格式:yyyy-MM-dd |
after_create_date | VARCHAR(32) | 否 | 创建时间之后。格式:yyyy-MM-dd HH:mm:ss |
after_modify_date | VARCHAR(32) | 否 | 修改时间之后。格式:yyyy-MM-dd HH:mm:ss |
start_create_date | VARCHAR(32) | 否 | 创建时间开始。格式:yyyy-MM-dd |
end_create_date | VARCHAR(32) | 否 | 创建时间结束。格式:yyyy-MM-dd HH:mm:ss |
start_modify_date | VARCHAR(32) | 否 | 修改时间开始。格式:yyyy-MM-dd HH:mm:ss |
end_modify_date | VARCHAR(32) | 否 | 修改时间结束。格式:yyyy-MM-dd |
start_consignment_date | VARCHAR(32) | 否 | 交货日期开始时间。格式:yyyy-MM-dd |
end_consignment_date | VARCHAR(32) | 否 | 交货日期结束时间。格式:yyyy-MM-dd |
id | VARCHAR | 否 | 勤策中id |
order_status | VARCHAR | 否 | 订单状态:0:待确认,1:已确认,2:打回,3:已关闭,4:部分发货 |
start_confirm_time | VARCHAR(32) | 否 | 审批通过开始时间。格式:yyyy-MM-dd HH:mm:ss |
end_confirm_time | VARCHAR(32) | 否 | 审批通过结束时间。格式:yyyy-MM-dd HH:mm:ss |
dealer | VARCHAR | 否 | 供货商ID |
dealer_code | VARCHAR(32) | 否 | 供货商编码 |
响应示例:
{
"return_code": "0",
"return_msg": "响应信息",
"msg_id": "{ msg_id }",
"response_data": "<<DATA>>"
}
数据DATA示例:
[
{
"confirm_emp_code": "cclb",
"submit_emp_code": "smj_lb",
"confirm_emp_name": "老板",
"prods": [
{
"gift_amount": "0.00",
"cost_price": "800.00",
"base_unit_confirm_count": "12.0000",
"confirm_amount": "10665.60",
"gift_price": "0.00",
"discount_amount": "10665.60",
"order_amount": "10665.60",
"cost_amount": "9600.00",
"price": "888.80",
"tax": "0.00",
"confirm_count": "12.0000",
"tax_amount": "0.00",
"base_unit_order_count": "12.0000",
"stay_sent_num": "0.0000",
"order_count": "12.0000",
"incentives_amount": "0.00",
"voucher_discount": "0.00",
"bill_discount": "0.00",
"exts_detail":[
{
"ext_key":"文本框",
"ext_value":""
},
{
"ext_key":"数值输入框",
"ext_value":""
},
{
"ext_key":"下拉选项",
"ext_value":""
}
]
},
{
"gift_amount": "0.00",
"cost_price": "0.00",
"base_unit_confirm_count": "12.0000",
"confirm_amount": "14400.00",
"gift_price": "0.00",
"discount_amount": "14400.00",
"order_amount": "14400.00",
"cost_amount": "0.00",
"price": "1200.00",
"tax": "0.00",
"confirm_count": "12.0000",
"tax_amount": "0.00",
"base_unit_order_count": "12.0000",
"stay_sent_num": "0.0000",
"order_count": "12.0000",
"incentives_amount": "0.00",
"voucher_discount": "0.00",
"bill_discount": "0.00",
"exts_detail":[
{
"ext_key":"文本框",
"ext_value":""
},
{
"ext_key":"数值输入框",
"ext_value":""
},
{
"ext_key":"下拉选项",
"ext_value":""
}
]
}
],
"receive_phone": "",
"order_no": "SD201608090001",
"cm_source_code": "",
"dealer": "",
"write_off_status": "0",
"storehouse_name": "WQ110",
"del_remark": "",
"storehouse_code": "CK0127",
"dealer_name": "",
"cm_name": "Wxxjinxiaoshang",
"status": "1",
"discount_amount": "25185.60",
"order_status": "3",
"close_detail_status": "全部发货关闭",
"cost_amount": "9660.00",
"confirm_emp_id": 5631794108288395000,
"dealer_source_code": "",
"cm_linkman_name": "",
"confirm_time": "2016-08-17 09:51:04",
"visit_implement_id": "",
"submit_emp_name": "宋敏健_lb",
"reconfirm_reason": "",
"consignment_date": "2016-11-23 00:00:00",
"cm_id": 8959813786535511000,
"receive_name": "wangwei",
"order_remark": "",
"pictures": "http://image.waiqin365.com/8958085892090750662/common/delete.png",
"reconfirm_source_code": "",
"receive_amount": "0.00",
"storehouse": 4835274098572455000,
"actual_amount": "25185.60",
"cm_linkman_id": "",
"cm_code": "CUS000190",
"id": 8209030629704786000,
"order_amount": "25185.60",
"tax_amount": "0.00",
"write_off_amount": "0.00",
"submit_dept_id": 8444424302574007000,
"submit_emp_id": 8925976031150112000,
"dealer_code": "",
"order_date": "2016-08-19 00:00:00",
"incentives_amount": "0.00",
"voucher_discount": "0.00",
"bill_discount": "0.00",
"cancel_reason": "",
"receive_addr": "",
"receive_tel": "9865433w",
"reconfirm_time": "",
"submit_dept_name": "部门一",
"confirm_source_code": "",
"print_count": 0,
"reconfirm_emp_name": "",
"ext_1704190003": "",
"emp_source_code": "",
"exts": [
{
"ext_key": "单行文本框1",
"ext_value": "12"
},
{
"ext_key": "日期自定义",
"ext_value": "2016-11-28 20:58"
},
{
"ext_key": "紧急程度",
"ext_value": ""
},
{
"ext_key": "可靠程度",
"ext_value": ""
},
{
"ext_key": "多选1",
"ext_value": ""
},
{
"ext_key": "图片1",
"ext_value": ""
},
{
"ext_key": "数值2",
"ext_value": ""
},
{
"ext_key": "文本框2",
"ext_value": ""
},
{
"ext_key": "自定义时间",
"ext_value": ""
},
{
"ext_key": "自定义时间2",
"ext_value": ""
}
],
"dept_source_code": "",
"reconfirm_emp_code": "",
"reconfirm_emp_id": "",
"submit_dept_code": "001",
"submit_time": "2016-08-09 20:02:53",
"order_type": "1",
"logistics_type": "1",
"plan_distribution_emp_id": "7126915044968425080",
"plan_distribution_emp_name": "cui",
"plan_distribution_emp_code": "waiqin00789",
"plan_distribution_car_id": "3547615044968421567",
"plan_distribution_car_name": "AE86",
"plan_distribution_car_code": "car00859",
"plan_distribution_time": "2016-08-19",
"express_company_id": "",
"express_company_name": "",
"express_no": "",
"pay_status": "3",
"mendian_use_prepare": "0.00"
}
]
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
id | INT8 | 是 | 勤策订单ID |
create_time | VARCHAR(32) | 是 | 创建时间。格式:yyyy-mm-dd hh24:mi:ss |
status | VARCHAR(1) | 是 | 订单状态。0:已删除,1:正常 |
order_no | VARCHAR(100) | 是 | 订单编号 |
order_date | varchar(10) | 是 | 业务日期。格式:yyyy-mm-dd hh24:mi:ss |
submit_dept_id | int8 | 是 | 业务员下单时候所在的部门id |
submit_dept_code | VARCHAR(100) | 是 | 业务员下单时候所在的部门编码 |
submit_dept_name | VARCHAR(100) | 是 | 业务员下单时候所在的部门名称 |
dept_source_code | VARCHAR(100) | 是 | 部门sourcecode |
submit_emp_id | INT8 | 是 | 单据上报人(业务员)id |
submit_emp_code | VARCHAR(100) | 是 | 单据上报人(业务员)编码 |
submit_emp_name | VARCHAR(100) | 是 | 单据上报人(业务员)名称 |
emp_source_code | VARCHAR(100) | 是 | 上报人(业务员)sourcecode |
submit_time | VARCHAR(32) | 是 | 提交时间。格式:yyyy-mm-dd hh24:mi:ss |
cm_id | INT8 | 是 | 客户id |
cm_code | VARCHAR(100) | 是 | 客户编码 |
cm_name | VARCHAR(100) | 是 | 客户名称 |
cm_source_code | VARCHAR(100) | 是 | 客户sourcecode |
cm_linkman_id | INT8 | 是 | 门店联系人id |
cm_linkman_name | VARCHAR(100) | 是 | 门店联系人名称 |
order_amount | numeric(10,2) | 是 | 订单金额 |
actual_amount | numeric(10,2) | 是 | 订单实际金额 |
discount_amount | numeric(10,2) | 是 | 优惠后金额 |
incentives_amount | numeric(10,2) | 是 | 优惠掉的金额 |
bill_discount | numeric(10,2) | 是 | 整单优惠,手动录入的优惠金额 |
voucher_discount | numeric(10,2) | 是 | 优惠券优惠金额 |
tax_amount | numeric(10,2) | 是 | 税额 |
cost_amount | numeric(10,2) | 是 | 成本金额 |
order_status | varchar(32) | 是 | 0:待确认,1:已确认,2:打回,3:已发货,4:部分发货 |
close_detail_status | varchar(32) | 是 | 3:全部发货关闭、2:部分发货关闭、1:未发货关闭、非关闭状态,返回空值; |
confirm_emp_id | INT8 | 是 | 单据确认人id |
confirm_emp_code | VARCHAR(100) | 是 | 单据确认人编码 |
confirm_emp_name | VARCHAR(100) | 是 | 单据确认人名称 |
confirm_source_code | VARCHAR(100) | 是 | 单据确认人sourcecode |
confirm_time | VARCHAR(100) | 是 | 确认时间。格式:yyyy-mm-dd hh24:mi:ss |
cancel_reason | varchar(4000) | 是 | 打回原因 |
order_remark | varchar(4000) | 是 | 备注 |
consignment_date | VARCHAR(100) | 是 | 要求送货日期(交货日期)。格式:yyyy-mm-dd |
visit_implement_id | INT8 | 是 | 高级拜访id |
pictures | varchar4000 | 是 | 订单图片(多个用逗号分割) |
dealer | INT8 | 是 | 经销商id |
dealer_name | VARCHAR(100) | 是 | 经销商名称 |
dealer_code | VARCHAR(100) | 是 | 经销商编码 |
dealer_source_code | VARCHAR(100) | 是 | 经销商sourcecode |
storehouse | INT8 | 是 | 发货仓库 |
storehouse_code | VARCHAR(100) | 是 | 发货仓库编号 |
storehouse_name | VARCHAR(100) | 是 | 发货仓库名称 |
order_type | VARCHAR(32) | 是 | 订单类型。1:订单上报订单,2:门店订单,3:转单订单,4:销货单,5:还货订单 |
write_off_status | VARCHAR(2) | 是 | 收款款核销状。0:未收款,1:已收款,2:部分收款 |
write_off_amount | numeric(10,2) | 是 | 核销收款金额 |
receive_amount | numeric(10,2) | 是 | 收款金额 |
receive_name | varchar(100) | 是 | 收货人 |
receive_phone | varchar(100) | 是 | 收货人手机 |
receive_tel | varchar(100) | 是 | 收货人电话 |
receive_addr | varchar(1000) | 是 | 收货地址 |
reconfirm_time | VARCHAR(32) | 是 | 反审核时间。格式:yyyy-mm-dd hh24:mi:ss |
del_remark | varchar(4000) | 是 | 删除原因 |
reconfirm_emp_id | INT8 | 是 | 反审核人员id |
reconfirm_emp_code | VARCHAR(100) | 是 | 反审核人员编码 |
reconfirm_emp_name | VARCHAR(100) | 是 | 反审核人员名称 |
reconfirm_source_code | VARCHAR(100) | 是 | 反审核人员sourcecode |
reconfirm_reason | varchar(4000) | 是 | 反审核原因 |
print_count | varchar(2) | 是 | 打印次数 |
logistics_type | varchar(2) | 是 | 物流方式。1:配送,2:快递,3:其他 |
plan_distribution_emp_id | INT8 | 是 | 预配送人id |
plan_distribution_emp_name | VARCHAR(100) | 是 | 预配送人姓名 |
plan_distribution_emp_code | VARCHAR(100) | 是 | 预配送人编码 |
plan_distribution_car_id | INT8 | 是 | 预配送车辆id |
plan_distribution_car_name | VARCHAR(100) | 是 | 预配送车辆名 |
plan_distribution_car_code | VARCHAR(100) | 是 | 预配送车辆编码 |
plan_distribution_time | TIMESTAMP | 是 | 预配送时间,yyyy-mm-dd格式 |
express_company_id | INT8 | 是 | 快递公司id |
express_company_name | VARCHAR(100) | 是 | 快递公司名 |
express_no | VARCHAR(100) | 是 | 快递单号 |
pay_status | VARCHAR(1) | 是 | 支付状态。0:未支付,1:已支付,3:线下支付 |
mendian_use_prepare | numeric(10,2) | 是 | 商城使用预收 |
exts | List | 是 | 订单主信息扩展字段列表 |
exts.ext_key | varchar(4000) | 是 | 订单主信息扩展字段key值扩展字段需先在我方系统中创建 |
exts.ext_value | varchar(4000) | 是 | 扩展字段value值对多个选项值,以“,”分隔拼接 |
prods | List | 是 | 列表 |
prods.detail_id | int8 | 是 | 订单子表id |
prods.product_id | int8 | 是 | 商品id |
prods.product_name | varchar(4000) | 是 | 商品名称 |
prods.product_code | varchar(4000) | 是 | 商品编码 |
prods.product_source_code | varchar(4000) | 是 | 商品对应sourcecode |
prods.product_pictures | varchar(4000) | 是 | 商品图片(多个用逗号分割) |
prods.product_spec | varchar(1000) | 是 | 商品规格属性 |
prods.price | numeric(10,8) | 是 | 商品订货价格 |
prods.order_count | numeric(10,8) | 是 | 数量 |
prods.confirm_count | numeric(10,8) | 是 | 确认订购的数量 |
prods.input_unit | INT8 | 是 | 录入单位id |
prods.input_unit_name | VARCHAR(100) | 是 | 录入单位名称 |
prods.base_unit | INT8 | 是 | 商品基本单位id |
prods.base_unit_name | VARCHAR(100) | 是 | 商品基本单位名称 |
prods.base_unit_order_count | numeric(10,8) | 是 | 数量转化成基本单位以后的数量 |
prods.base_unit_confirm_count | numeric(10,8) | 是 | 确认的数量转化成基本单位以后的数量 |
prods.order_amount | numeric(10,2) | 是 | 订购金额 |
prods.confirm_amount | numeric(10,2) | 是 | 确认金额 |
prods.stay_sent_num | numeric(10,2) | 是 | 待发货数量 |
prods.discount_amount | numeric(10,2) | 是 | 优惠后金额 |
prods.incentives_amount | numeric(10,2) | 是 | 优惠掉的金额 |
prods.bill_discount | numeric(10,2) | 是 | 整单优惠分摊 |
prods.voucher_discount | numeric(10,2) | 是 | 优惠券优惠金额分摊 |
prods.tax | numeric(10,2) | 是 | 税率 |
prods.tax_amount | numeric(10,2) | 是 | 税额 |
prods.cost_amount | numeric(10,2) | 是 | 成本金额 |
prods.sequ | varchar(2) | 是 | 下单时的排序 |
prods.remarks | varchar(4000) | 是 | 备注 |
prods.is_gift | varchar(2) | 是 | 是否是赠品。1:是,0:否 |
prods.promotion_code | varchar(200) | 是 | 促销编码 |
prods.promotion_name | varchar(200) | 是 | 促销名称 |
prods.promotion_id | INT8 | 是 | 促销组id(组合促销) |
prods.cost_price | numeric(10,2) | 是 | 商品成本价 |
prods.gift_price | numeric(10,2) | 是 | 赠品的批发价 |
prods.gift_amount | numeric(10,2) | 是 | 赠品金额 |
prods.rebate_account_name | VARCHAR(200) | 是 | 返利账户 |
prods.voucher_id | VARCHAR(32) | 是 | 优惠券id |
prods.voucher_bas_id | VARCHAR(32) | 是 | 优惠券活动id |
prods.exts_detail | List | 是 | 订单明细表信息扩展字段列表 |
prods.exts_detail.ext_key | varchar(4000) | 是 | 订单明细表信息扩展字段key值,扩展字段需先在我方系统中创建 |
prods.exts_detail.ext_value | varchar(4000) | 是 | 扩展字段value值 |
prods.full_discount_id | VARCHAR(32) | 是 | 满折满减id |
prods.pay_promotion_id | VARCHAR(32) | 是 | 满赠促销id |
prods.superposition_promotion_id | VARCHAR(32) | 是 | 叠加促销id |
prods.amount_promotion_id | VARCHAR(32) | 是 | 金额促销id |
prods.min_price_id | VARCHAR(32) | 是 | 特价促销id |
prods.product_type_name | VARCHAR(32) | 是 | 商品行类型 |
prods.rebate_account_id | INT8 | 是 | 返利账户ID |
prods.rebate_discount_amount | numeric(10,2) | 是 | 返利优惠金额 |
# 新增订单数据
请求方式: POST(HTTPS)
请求地址: https://openapi.waiqin365.com/api/stdorder/v1/addStdomOrder/{openid}/{timestamp}/{digest}/{msg_id}
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
order_no | VARCHAR(32) | 否 | 订单编码,不传时自动生成 |
cm_id | VARCHAR(32) | 否 | 客户id,客户id和客户编码、名称必须传一个 |
cm_code | VARCHAR(100) | 否 | 客户编码,客户id和客户编码、名称必须传一个 |
cm_name | VARCHAR(100) | 否 | 客户名称,客户id和客户编码、名称必须传一个 |
emp_id | VARCHAR(32) | 否 | 业务员Id,业务员id和业务员编码、名称必须传一个 |
emp_code | VARCHAR(32) | 否 | 业务员编码,业务员id和业务员编码、名称必须传一个 |
emp_name | VARCHAR(32) | 否 | 业务员名称,业务员id和业务员编码、名称必须传一个 |
creator_id | VARCHAR(32) | 否 | 提交人Id,也是审批流程流转人Id |
creator_code | VARCHAR(32) | 否 | 提交人编码,也是审批流程流转人编码 |
creator_name | VARCHAR(32) | 否 | 提交人名称,也是审批流程流转人名称 |
storehouse_id | VARCHAR(32) | 否 | 发货仓库id,发货仓库id和发货仓库编码、名称必须传一个 |
storehouse_code | VARCHAR(32) | 否 | 发货仓库编码,发货仓库id和发货仓库编码、名称必须传一个 |
storehouse_name | VARCHAR(32) | 否 | 发货仓库名称,发货仓库id和发货仓库编码、名称必须传一个 |
submit_date | CHAR(10) | 是 | 下单日期。格式:yyyy-MM-dd HH:mm:ss |
consignment_date | CHAR(10) | 是 | 要求送货日期(交货日期)。格式:yyyy-MM-dd |
receive_name | VARCHAR(32) | 否 | 收货人姓名 |
receive_addr | VARCHAR(1000) | 否 | 收货人地址 |
receive_phone | varchar(32) | 否 | 收货人手机 |
receive_tel | varchar(32) | 否 | 收货人电话 |
bill_discount | varchar(32) | 否 | 整单优惠,默认0,没有优惠金额 |
remarks | varchar(4000) | 否 | 订单备注 |
logistics_type | varchar(2) | 否 | 物流方式。1:配送,2:快递,3:其他 |
plan_distribution_emp_id | varchar(32) | 否 | 预配送人id,物流方式为配送时,可传参 |
plan_distribution_emp_name | VARCHAR(100) | 否 | 预配送人姓名,物流方式为配送时,可传参 |
plan_distribution_emp_code | VARCHAR(100) | 否 | 预配送人编码,物流方式为配送时,可传参 |
plan_distribution_time | TIMESTAMP | 否 | 预配送时间。格式:yyyy-mm-dd。物流方式为配送时,可传参 |
express_company_id | varchar(32) | 否 | 快递公司id,物流方式为快递时,可传参 |
express_company_name | VARCHAR(100) | 否 | 快递公司名,物流方式为快递时,可传参 |
express_no | VARCHAR(100) | 否 | 快递单号,物流方式为快递时,可传参 |
sale_order_type_id | varchar(32) | 否 | 销售单类型ID |
sale_order_type_name | VARCHAR(100) | 否 | 销售单类型名 |
prods | List | 否 | 列表 |
prods.product_id | VARCHAR(100) | 否 | 商品id。商品id和商品编码、名称必须传一个 |
prods.product_code | VARCHAR(100) | 否 | 商品编码。商品id和商品编码、名称必须传一个 |
prods.product_name | VARCHAR(100) | 否 | 商品名称。商品id和商品编码、名称必须传一个 |
prods.input_price | numeric(20,8) | 是 | 商品的订货价,赠品价格为0 |
prods.input_count | numeric(20,8) | 是 | 商品数量 |
prods.input_unit | VARCHAR(32) | 否 | 录入单位id和录入单位名称传一个即可,不传使用基本单位 |
prods.input_unit_name | varchar(100) | 否 | 录入单位id和录入单位名称传一个即可,不传使用基本单位 |
prods.is_gift | VARCHAR(10) | 否 | 是否是赠品。1:是,0:否。不传就是非赠品 |
prods.remark | VARCHAR(4000) | 否 | 订单子表的备注 |
prods.detail_storehouse_id | VARCHAR(32) | 否 | 发货仓库id,开启多仓有效 |
prods.detail_storehouse_code | VARCHAR(32) | 否 | 发货仓库编码,开启多仓有效 |
prods.detail_storehouse_name | VARCHAR(32) | 否 | 发货仓库名称,开启多仓有效 |
接口说明:是否是赠品is_gift不传默认为非赠品。如果该商品是赠品,input_price传0,is_gift传1。未免出错,这二个字段建议必填
响应示例:
{
"return_code": "0",
"return_msg": "",
"msg_id": "X000001"
}
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
msg_id | VARCHAR(32) | 是 | 消息ID |
return_code | VARCHAR(32) | 是 | 响应编码。0:成功,1:失败 |
return_msg | VARCHAR(100) | 是 | 响应说明 |
# 关闭订单
请求方式: POST(HTTPS)
请求地址: https://openapi.waiqin365.com/api/stdorder/v1/closeStdomOrder/{openid}/{timestamp}/{digest}/{msg_id}
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
id | VARCHAR(100) | 否 | 订单id。订单id和订单编码必须传一个 |
order_no | VARCHAR(32) | 否 | 订单编码。订单id和订单编码必须传一个 |
close_emp_id | VARCHAR(100) | 否 | 关闭人id |
close_emp_name | VARCHAR(100) | 否 | 关闭人姓名 |
close_emp_code | VARCHAR(100) | 否 | 关闭人编码 |
响应示例:
{
"return_code": "0",
"return_msg": "",
"msg_id": "X000001"
}
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
msg_id | VARCHAR(32) | 是 | 消息ID |
return_code | VARCHAR(32) | 是 | 响应编码。0:成功,1:失败 |
return_msg | VARCHAR(100) | 是 | 响应说明 |
# 查询订单发货数据
请求方式: POST(HTTPS)
请求地址: https://openapi.waiqin365.com/api/stdsent/v1/queryStdomSent/{openid}/{timestamp}/{digest}/{msg_id}
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
page_number | INT | 是 | 页码默认1,每页默认1000条 |
status | CHAR(1) | 否 | 记录状态。0:已删除,1:正常 |
cm_id | VARCHAR(32) | 否 | 勤策客户唯一ID |
cm_code | VARCHAR(32) | 否 | 客户编码,有效字符详见附录:有效字符说明 (opens new window) |
create_date | VARCHAR(32) | 否 | 创建日期。格式:yyyy-MM-dd |
modify_date | VARCHAR(32) | 否 | 修改日期。格式:yyyy-MM-dd |
after_create_date | VARCHAR(32) | 否 | 创建时间之后。格式:yyyy-MM-dd HH:mm:ss |
after_modify_date | VARCHAR(32) | 否 | 修改时间之后。格式:yyyy-MM-dd HH:mm:ss |
start_create_date | VARCHAR(32) | 否 | 创建时间开始。格式:yyyy-MM-dd |
end_create_date | VARCHAR(32) | 否 | 创建时间结束。格式:yyyy-MM-dd |
start_modify_date | VARCHAR(32) | 否 | 修改时间开始。格式:yyyy-MM-dd |
end_modify_date | VARCHAR(32) | 否 | 修改时间结束。格式:yyyy-MM-dd |
id | VARCHAR | 否 | 勤策中发货单id |
sent_no | VARCHAR | 否 | 勤策中发货单编码 |
order_id | VARCHAR | 否 | 勤策中订单id |
order_no | VARCHAR | 否 | 勤策中订单编码 |
start_sign_date | VARCHAR(32) | 否 | 签收时间开始。格式:yyyy-MM-dd |
end_sign_date | VARCHAR(32) | 否 | 签收时间结束。格式:yyyy-MM-dd |
响应示例:
{
"return_code": "0",
"return_msg": "响应信息",
"msg_id": "{ msg_id }",
"response_data": "<<DATA>>"
}
数据DATA示例:
[
{
"gift_amount": "0.00",
"disable_reason": "",
"prods": [
{
"gift_amount": "0.00",
"cost_amount": "0.00",
"base_unit_sent_num": "1.0000",
"price": "0.00",
"tax": "0.00",
"cost_price": "0.00",
"tax_amount": "0.00",
"sent_num": "1.0000",
"incentives_amount": "0.00",
"discount_amount": "0.00",
"gift_cm_price": "0.00",
"gift_cm_amount": "0.00",
"prod_ext": [
{
"ext_key": "商品自定义1",
"ext_value": "自定义1"
}
]
}
],
"send_amount": "0.00",
"user_code": "smj_lb",
"order_id": 8956242923759425000,
"storehouse": 10,
"order_no": "",
"id": 8177521589286483000,
"write_off_status": "1",
"hc_status": "",
"send_time": "2016-05-19 17:00:10",
"storehouse_name": "总仓库",
"write_off_amount": "0.00",
"tax_amount": "0.00",
"storehouse_code": "CK001",
"user_id": 8925976031150112000,
"sent_user_id": "",
"incentives_amount": "0.00",
"status": "1",
"print_count": 0,
"is_enable": "1",
"bill_check_status": "0",
"discount_amount": "0.00",
"hc_id": "",
"emp_source_code": "",
"user_name": "宋敏健_lb",
"cost_amount": "0.00",
"sent_name": "",
"sent_no": "FH201605190003",
"sent_code": "",
"sent_source_code": "",
"hc_no": "",
"express_company_name": "",
"express_no": "" ,
"signe_status":"1"
}
]
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
id | INT8 | 是 | 发货单ID |
status | VARCHAR(1) | 是 | 发货单状态。0:已删除,1:正常 |
sent_no | VARCHAR(100) | 是 | 发货单号 |
send_time | VARCHAR(10) | 是 | 发货时间。格式:yyyy-mm-dd hh24:mi:ss |
user_id | int8 | 是 | 发货人id |
user_code | VARCHAR(100) | 是 | 发货人编码 |
user_name | VARCHAR(100) | 是 | 发货人名称 |
user_source_code | VARCHAR(100) | 是 | 发货人sourcecode |
sent_user_id | INT8 | 是 | 送货人id |
sent_code | VARCHAR(100) | 是 | 送货人编码 |
sent_name | VARCHAR(100) | 是 | 送货人名称 |
sent_source_code | VARCHAR(100) | 是 | 送货人sourcecode |
send_amount | numeric(10,2) | 是 | 发货金额 |
discount_amount | numeric(10,2) | 是 | 优惠后金额 |
incentives_amount | numeric(10,2) | 是 | 优惠掉的金额 |
tax_amount | numeric(10,2) | 是 | 税额 |
cost_amount | numeric(10,2) | 是 | 成本金额 |
storehouse | INT8 | 是 | 发货仓库 |
storehouse_code | VARCHAR(100) | 是 | 发货仓库编号 |
storehouse_name | VARCHAR(100) | 是 | 发货仓库名称 |
order_id | INT8 | 是 | 订单id |
order_no | VARCHAR(100) | 是 | 订单编号 |
write_off_status | VARCHAR(2) | 是 | 收款款核销状。0:未收款,1:已收款,2:部分收款 |
write_off_amount | numeric(10,2) | 是 | 核销收款金额 |
bill_check_status | VARCHAR(2) | 是 | 账单对账状态。0:待确认,1:已确认 |
gift_amount | numeric(10,2) | 是 | 赠品金额 |
print_count | VARCHAR(10) | 是 | 打印次数 |
hc_status | VARCHAR(2) | 是 | 红冲状态。1:被红冲,2:红冲 |
hc_id | int8 | 是 | 只有hc_status是1的单据,此字段才会填值关联自己的红冲 |
hc_no | VARCHAR(10) | 是 | 红冲单号 |
disable_reason | VARCHAR(4000) | 是 | 作废原因 |
is_enable | VARCHAR(2) | 是 | 作废状态。0:作废,1:未作废 |
express_company_name | VARCHAR(100) | 是 | 快递公司名称 |
express_no | VARCHAR(100) | 是 | 快递单号 |
sign_status | CHAR(1) | 是 | 签收状态 1:已签收 0:未签收 |
signer_id | int8 | 是 | 签收人id |
signer_name | VARCHAR(100) | 是 | 签收人名称 |
signer_source_code | VARCHAR(100) | 是 | 签收人sourcecode |
sign_time | VARCHAR(100) | 是 | 签收时间。格式:yyyy-MM-dd HH:mm:ss |
prods | List | 是 | 列表 |
prods.order_detail_id | int8 | 是 | 订单子表id |
prods.hc_detail_id | int8 | 是 | 红冲子表id |
prods.product_id | int8 | 是 | 商品id |
prods.product_name | varchar(4000) | 是 | 商品名称 |
prods.product_code | varchar(4000) | 是 | 商品编码 |
prods.product_source_code | varchar(4000) | 是 | 商品sourcecode |
prods.product_pictures | varchar(4000) | 是 | 商品图片,多个值用","分割 |
prods.product_spec | varchar(1000) | 是 | 商品规格属性 |
prods.cost_price | numeric(10,8) | 是 | 商品成本价 |
prods.sent_num | numeric(10,8) | 是 | 发货数量 |
prods.input_unit | INT8 | 是 | 发货时候录入单位id |
prods.input_unit_name | VARCHAR(100) | 是 | 发货时候录入单位名称 |
prods.base_unit | INT8 | 是 | 商品基本单位id |
prods.base_unit_name | VARCHAR(100) | 是 | 商品基本单位名称 |
prods.base_unit_sent_num | numeric(10,8) | 是 | 发货数量转化成基本单位以后的数量 |
prods.send_amount | numeric(10,2) | 是 | 发货金额 |
prods.discount_amount | numeric(10,2) | 是 | 发货优惠后金额 |
prods.incentives_amount | numeric(10,2) | 是 | 优惠掉的金额 |
prods.tax | numeric(10,2) | 是 | 税率 |
prods.tax_amount | numeric(10,2) | 是 | 税额 |
prods.cost_amount | numeric(10,2) | 是 | 成本金额 |
prods.sequ | varchar(2) | 是 | 下单时的排序 |
prods.is_gift | varchar(2) | 是 | 是否是赠品。1:是,0:否 |
prods.price | numeric(10,2) | 是 | 商品订货价 |
prods.gift_amount | numeric(10,2) | 是 | 赠品金额 |
prods.rebate_account_name | VARCHAR(200) | 是 | 返利账户 |
prods.gift_cm_price | numeric(10,2) | 是 | 赠品的客户价 |
prods.gift_cm_amount | numeric(10,2) | 是 | 赠品的客户价算出来的金额 |
prods.prod_ext | List | 否 | 商品信息扩展字段列表 |
prods.prod_ext.ext_key | varchar(4000) | 否 | 商品信息扩展字段key值扩展字段需先在我方系统中创建 |
prods.prod_ext.ext_value | varchar(4000) | 否 | 商品信息扩展字段value值对多个选项值,以“,”分隔拼接 |
# 新增发货单数据
请求方式: POST(HTTPS)
请求地址: https://openapi.waiqin365.com/api/stdsent/v1/addStdomOrderSent/{openid}/{timestamp}/{digest}/{msg_id}
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
send_time | VARCHAR(32) | 否 | 发货单发货时间,格式:yyyy-mm-dd/yyyy-mm-dd hh24:mi/yyyy-mm-dd hh24:mi:ss |
order_id | INT8 | 否 | 销售订单id,销售订单id和销售订单编码必须传一个 |
order_no | VARCHAR(32) | 否 | 销售订单编码,销售订单id和销售订单编码必须传一个 |
emp_id | INT8 | 否 | 发货单配送人员Id,发货单配送人员Id、发货单配送人员编码和发货单配送人员名称必须传一个 |
emp_code | VARCHAR(32) | 否 | 发货单配送人员编码,发货单配送人员Id、发货单配送人员编码和发货单配送人员名称必须传一个 |
emp_name | VARCHAR(32) | 否 | 发货单配送人员名称,发货单配送人员Id、发货单配送人员编码和发货单配送人员名称必须传一个 |
send_remark | VARCHAR(4000) | 否 | 发货单备注 |
express_company_name | VARCHAR(100) | 否 | 快递公司名称 |
express_no | VARCHAR(100) | 否 | 快递单号 |
sent_use_advance | varchar(10) | 否 | 发货使用预收。0:否,1:是,默认值为0 |
storehouse_id | INT8 | 否 | 发货单发货仓库Id,发货单发货仓库Id、发货单发货仓库编码和发货单发货仓库名称传一个 |
storehouse_code | VARCHAR(32) | 否 | 发货单发货仓库编码,发货单发货仓库Id、发货单发货仓库编码和发货单发货仓库名称传一个 |
storehouse_name | VARCHAR(32) | 否 | 发货单发货仓库名称,发货单发货仓库Id、发货单发货仓库编码和发货单发货仓库名称传一个 |
products | List | 否 | 列表 |
products.product_id | INT8 | 否 | 商品id,商品id、商品编码和商品名称必须传一个 |
products.product_code | VARCHAR(100) | 否 | 商品编码,商品id、商品编码和商品名称必须传一个 |
products.product_name | VARCHAR(100) | 否 | 商品名称,商品id、商品编码和商品名称必须传一个 |
products.input_unit | INT8 | 否 | 发货单位id,发货单位id和发货单位名称传一个即可 |
products.input_unit_name | VARCHAR(100) | 否 | 发货单位名称,发货单位id和发货单位名称传一个即可 |
products.sent_num | numeric(20,8) | 是 | 发货数量 |
products.is_gift | VARCHAR(10) | 否 | 是否是赠品。1:赠品,0:非赠品。默认值为0 |
products.order_detail_id | INT8 | 是 | 订单子表ID。传订单子表ID,必传 |
接口说明:是否是赠品is_gift不传默认为非赠品。如果该商品是赠品,is_gift传1。未免出错,这个字段建议必填
响应示例:
{
"return_code": "0",
"return_msg": "",
"msg_id": "X000001"
}
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
msg_id | VARCHAR(32) | 是 | 消息ID |
return_code | VARCHAR(32) | 是 | 响应编码。0:成功,1:失败 |
return_msg | VARCHAR(100) | 是 | 响应说明 |
# 红冲发货单数据
请求方式: POST(HTTPS)
请求地址: https://openapi.waiqin365.com/api/stdsent/v1/cancelSendOrder/{openid}/{timestamp}/{digest}/{msg_id}
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
ids | VARCHAR(32) | 否 | 发货单id,发货单id和发货单编码必须传一个 |
sent_no | VARCHAR(32) | 否 | 发货单编码,发货单id和发货单编码必须传一个 |
响应示例:
{
"return_code": "0",
"return_msg": "",
"msg_id": "X000001"
}
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
msg_id | VARCHAR(32) | 是 | 消息ID |
return_code | VARCHAR(32) | 是 | 响应编码。0:成功,1:失败 |
return_msg | VARCHAR(100) | 是 | 响应说明 |
# 新增退货单数据
请求方式: POST(HTTPS)
请求地址: https://openapi.waiqin365.com/api/std_order/v1/addStdReturn/{ openid }/{ timestamp }/{ digest }/{ msg_id }
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
cm_id | INT8 | 否 | 客户id。客户id和客户编码、名称必须传一个 |
cm_code | VARCHAR(100) | 否 | 客户编码。客户id和客户编码、名称必须传一个 |
cm_name | VARCHAR(100) | 否 | 客户id和客户编码、名称必须传一个 |
emp_id | INT8 | 否 | 业务员Id,业务员id和业务员编码、名称必须传一个 |
emp_code | VARCHAR(32) | 否 | 业务员编码。业务员id和业务员编码、名称必须传一个 |
emp_name | VARCHAR(32) | 否 | 业务员名称。业务员id和业务员编码、名称必须传一个 |
creator_id | INT8 | 否 | 创建人Id |
creator_code | VARCHAR(32) | 否 | 创建人编码 |
creator_name | VARCHAR(32) | 否 | 创建人名称 |
storehouse_id | INT8 | 否 | 收货仓库id。收货仓库id和收货仓库编码、名称必须传一个 |
storehouse_code | VARCHAR(32) | 否 | 收货仓库编码。收货仓库id和收货仓库编码、名称必须传一个 |
storehouse_name | VARCHAR(32) | 否 | 收货仓库名称。收货仓库id和收货仓库编码、名称必须传一个 |
dealer_id | INT8 | 否 | 供应商id |
dealer_code | VARCHAR(32) | 否 | 供应商编码 |
dealer_name | VARCHAR(32) | 否 | 供应商名称 |
return_date | CHAR(10) | 是 | 退货日期。格式:yyyy-MM-dd |
return_name | VARCHAR(32) | 否 | 退货人姓名 |
return_addr | VARCHAR(1000) | 否 | 退货人地址 |
return_tel | varchar(32) | 否 | 退货人手机 |
return_phone | varchar(32) | 否 | 退货人电话 |
remarks | varchar(4000) | 否 | 备注 |
source_type | varchar(32) | 否 | 来源。0:商贸版内部(默认),1:勤策订货,2:旺店,3:转单订单 |
exts | List | 否 | 退货信息扩展字段列表 |
exts.return_ext_key | varchar(100) | 否 | 退货信息扩展字段key值, 退货信息扩展字段需先在我方系统中创建 |
exts.return_ext_value | VARCHAR(4000) | 否 | 退货信息扩展字段value值对多个选项值,以“,”分隔拼接 |
prods | List | 否 | 列表 |
prods.product_id | VARCHAR(100) | 否 | 商品id。商品id和商品编码、名称必须传一个 |
prods.product_code | VARCHAR(100) | 否 | 商品编码。商品id和商品编码、名称必须传一个 |
prods.product_name | VARCHAR(100) | 否 | 商品名称。商品id和商品编码、名称必须传一个 |
prods.return_price | numeric(20,8) | 是 | 商品的退货价,赠品价格为0 |
prods.return_count | numeric(20,8) | 是 | 商品退货数量 |
prods.input_unit | int8 | 否 | 录入单位id和录入单位名称传一个即可,不传使用基本单位 |
prods.input_unit_name | varchar(100) | 否 | 录入单位id和录入单位名称传一个即可,不传使用基本单位 |
prods.return_amount | numeric(20,8) | 否 | 商品退货金额 |
prods.is_gift | VARCHAR(10) | 否 | 是否是赠品。1:是,0:否。不传就是非赠品 |
prods.sequ | VARCHAR(10) | 是 | 排序号 |
prods.remark | VARCHAR(4000) | 否 | 退货单子表的备注 |
prods.detail_storehouse_id | INT8 | 否 | 收货仓库id,开启多仓有效 |
prods.detail_storehouse_code | VARCHAR(32) | 否 | 收货仓库编码,开启多仓有效 |
prods.detail_storehouse_name | VARCHAR(32) | 否 | 收货仓库名称,开启多仓有效 |
接口说明:是否是赠品is_gift不传默认为非赠品。如果该商品是赠品,is_gift传1。未免出错,这个字段建议必填
响应示例:
{
"return_code": "0",
"return_msg": "",
"msg_id": "X000001"
}
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
msg_id | VARCHAR(32) | 是 | 消息ID |
return_code | VARCHAR(32) | 是 | 响应编码。0:成功,1:失败 |
return_msg | VARCHAR(100) | 是 | 响应说明</span |
# 审批退货单数据
请求方式: POST(HTTPS)
请求地址: https://openapi.waiqin365.com/api/std_order/v1/confirmStdReturn/{ openid }/{ timestamp }/{ digest }/{ msg_id }
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
id | VARCHAR(100) | 是 | 退货单id,多个逗号分割 |
approvalType | VARCHAR(100) | 是 | 审批类型。1:通过,2:打回,3:红冲,4:审批入库,5:反审核 |
modifyTimes | VARCHAR(100) | 否 | 退货时间戳,多个逗号分割 |
cancelRe | VARCHAR(4000) | 否 | 审批意见 |
响应示例:
{
"return_code": "0",
"return_msg": "",
"msg_id": "X000001"
}
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
msg_id | VARCHAR(32) | 是 | 消息ID |
return_code | VARCHAR(32) | 是 | 响应编码。0:成功,1:失败 |
return_msg | VARCHAR(100) | 是 | 响应说明 |
# 查询退货单数据
请求方式: POST(HTTPS)
请求地址: https://openapi.waiqin365.com/api/std_order/v1/queryStdReturn/{ openid }/{ timestamp }/{ digest }/{ msg_id }
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
page_number | INT8 | 是 | 页码默认1,每页默认1000条 |
status | CHAR(1) | 否 | 记录状态:0 已删除 1 正常 |
id | VARCHAR(32) | 否 | 勤策中id |
cm_id | VARCHAR(32) | 否 | 勤策客户唯一ID |
cm_code | VARCHAR(32) | 否 | 客户编码。有效字符详见附录:有效字符说明 (opens new window) |
create_date | VARCHAR(32) | 否 | 创建日期。格式:yyyy-MM-dd |
modify_date | VARCHAR(32) | 否 | 修改日期。格式:yyyy-MM-dd |
after_create_date | VARCHAR(32) | 否 | 创建时间之后。格式:yyyy-MM-dd HH:mm:ss |
after_modify_date | VARCHAR(32) | 否 | 修改时间之后。格式:yyyy-MM-dd HH:mm:ss |
start_create_date | VARCHAR(32) | 否 | 创建时间开始。格式:yyyy-MM-dd |
end_create_date | VARCHAR(32) | 否 | 创建时间结束。格式:yyyy-MM-dd |
start_modify_date | VARCHAR(32) | 否 | 修改时间开始。格式:yyyy-MM-dd |
end_modify_date | VARCHAR(32) | 否 | 修改时间结束。格式:yyyy-MM-dd |
响应示例:
{
"return_code": "0",
"return_msg": "响应信息",
"msg_id": "{ msg_id }",
"response_data": "<<DATA>>"
}
数据DATA示例:
[
{
"gift_amount": "16.00",
"confirm_emp_code": "scklb",
"return_order_type_name": "默认退货类型3",
"confirm_emp_name": "孙传宽老板测试账号",
"return_amount": "16.00",
"prods": [
{
"gift_amount": "16.00",
"product_id": "9099952839222507624",
"hc_detail_id": "",
"return_amount": "0.00",
"base_unit_confirm_count": "1.00",
"product_name": "商品4",
"remarks": "",
"gift_price": "16.00",
"base_unit_return_count": "1.00",
"return_id": "7992869671049732483",
"tax_amount": "0.00",
"is_gift": "Y",
"detail_id": "7000982478311031481",
"cost_price": "0.00",
"confirm_amount": "0.00",
"order_detail_id": "",
"base_unit": "9099952839222507625",
"cost_amount": "0.0000",
"price": "0.00",
"base_unit_name": "件",
"confirm_count": "1.00",
"tax": "0.60",
"product_code": "",
"sequ": "1.00",
"return_count": "1.0000",
"input_unit_name": "件",
"input_unit": "9099952839222507625",
"detail_status": "1",
"prod_ext": [
{
"ext_key": "商品自定义1",
"ext_value": "自定义1"
}
]
},
{
"gift_amount": "0.00",
"product_id": "9099952839222507624",
"hc_detail_id": "",
"return_amount": "16.00",
"base_unit_confirm_count": "1.00",
"product_name": "商品4",
"remarks": "",
"gift_price": "0.00",
"base_unit_return_count": "1.00",
"return_id": "7992869671049732483",
"tax_amount": "6.00",
"is_gift": "N",
"detail_id": "4918143653733183193",
"cost_price": "0.00",
"confirm_amount": "16.00",
"order_detail_id": "",
"base_unit": "9099952839222507625",
"cost_amount": "0.0000",
"price": "16.00",
"base_unit_name": "件",
"confirm_count": "1.00",
"tax": "0.60",
"product_code": "",
"sequ": "0.00",
"return_count": "1.0000",
"input_unit_name": "件",
"input_unit": "9099952839222507625",
"detail_status": "1",
"prod_ext": [
{
"ext_key": "商品自定义1",
"ext_value": "自定义1"
}
]
}
],
"order_no": "",
"return_tel": "",
"cm_source_code": "",
"dealer": "",
"write_off_status": "0",
"return_addr": "",
"return_emp_source_code": "",
"storehouse_name": "测试0",
"del_remark": "",
"storehouse_code": "CK0007",
"gift_cost_amount": "0.00",
"modifyier_name": "孙传宽老板测试账号",
"modify_time": "2017-08-23",
"dealer_name": "",
"cm_name": "亲戚去去去",
"status": "1",
"modifyier_id": "6730634712774216679",
"return_phone": "",
"bill_check_status": "",
"creator_id": "5073510449430503303",
"hc_id": "0",
"cost_amount": "0.00",
"confirm_emp_id": "6730634712774216679",
"confirm_count": "2.00000000",
"return_name": "",
"return_no": "TD201708160002",
"dealer_source_code": "",
"create_time": "2017-08-16",
"creator_name": "王老板",
"return_emp_id": "5073510449430503303",
"modifyier_source_code": "",
"creator_code": "wyxlaoban",
"return_emp_name": "王老板",
"confirm_time": "2017-08-23",
"visit_implement_id": "",
"confirm_emp_source_code": "",
"cm_id": "6563654583404943994",
"pictures": "",
"creator_source_code": "",
"remarks": "",
"order_id": "",
"storehouse": "7519287026833534497",
"cm_code": "DD000201700290",
"id": "7992869671049732483",
"hc_status": "",
"return_order_type": "5926299953521597437",
"modifyier_code": "scklb",
"tax_amount": "6.00",
"write_off_amount": "0.00",
"dealer_code": "",
"return_status": "2",
"cancel_reason": "",
"return_emp_code": "wyxlaoban",
"confirm_amount": "16.00",
"print_count": "",
"exts": [
{
"ext_key": "测试文本框",
"ext_value": ""
},
{
"ext_key": "单选框",
"ext_value": "选项1"
}
],
"return_date": "2017-08-16",
"return_time": "2017-08-16",
"return_count": "2.00000000",
"hc_no": ""
}
]
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
id | varchar(32) | 是 | 退货单ID |
status | varchar(1) | 是 | 退货单状态。0:已删除,1:正常 |
creator_id | varchar(32) | 是 | 创建人 |
creator_code | varchar(32) | 是 | 创建人编码 |
creator_name | varchar(32) | 是 | 创建人名称 |
creator_source_code | varchar(32) | 是 | 创建人sourcecode |
create_time | VARCHAR(32) | 是 | 创建时间。格式:yyyy-mm-dd |
modifyier_id | varchar(32) | 否 | 修改人 |
modifyier_code | varchar(32) | 否 | 修改人编码 |
modifyier_name | varchar(32) | 否 | 修改人名称 |
modifyier_source_code | varchar(200) | 否 | 修改人sourcecode |
modify_time | TIMESTAMP | 否 | 修改时间。格式:yyyy-mm-dd |
return_no | VARCHAR(32) | 是 | 退单号 |
cm_id | VARCHAR(32) | 是 | 客户id |
cm_code | varchar(32) | 是 | 客户编码 |
cm_name | varchar(200) | 是 | 客户名称 |
cm_source_code | varchar(32) | 否 | 客户sourcecode |
return_emp_id | varchar(32) | 是 | 上报人(业务员) |
return_emp_code | varchar(32) | 是 | 上报人(业务员)编码 |
return_emp_name | varchar(200) | 是 | 上报人(业务员)名称 |
return_emp_source_code | varchar(32) | 否 | 上报人(业务员)sourcecode |
return_date | varchar(32) | 是 | 业务日期。格式:yyyy-mm-dd |
return_time | varchar(32) | 是 | 退货创建日期。格式:yyyy-mm-dd |
remarks | varchar(4000) | 否 | 备注 |
return_count | numeric(20,8) | 是 | 退货数量 |
return_amount | numeric(20,2) | 是 | 退货金额 |
confirm_count | numeric(20,8) | 否 | 确认数量 |
confirm_amount | numeric(20,2) | 否 | 确认金额 |
tax_amount | numeric(20,2) | 否 | 税额合计 |
cost_amount | numeric(20,2) | 否 | 成本金额合计 |
return_status | varchar(10) | 是 | 状态。0:待确认,1:已入库,2:打回,3:已确认 |
confirm_emp_id | varchar(32) | 否 | 确认人id |
confirm_emp_code | varchar(32) | 否 | 确认人编码 |
confirm_emp_name | varchar(32) | 否 | 确认人名称 |
confirm_emp_source_code | varchar(32) | 否 | 确认人sourcecode |
confirm_time | varchar(32) | 是 | 确认时间。格式:yyyy-mm-dd |
cancel_reason | varchar(4000) | 否 | 打回原因 |
visit_implement_id | varchar(32) | 否 | 高级拜访id |
pictures | varchar(4000) | 否 | 退货单图片 |
dealer | varchar(32) | 否 | 经销商id |
dealer_code | varchar(32) | 否 | 经销商编码 |
dealer_name | varchar(32) | 否 | 经销商名称 |
dealer_source_code | varchar(32) | 否 | 经销商sourcecode |
storehouse | int8 | 是 | 收货仓库 |
storehouse_code | varchar(200) | 是 | 收货仓库编码 |
storehouse_name | varchar(200) | 是 | 收货仓库名称 |
write_off_status | varchar(2) | 否 | 收款款核销状态。0:未收款,1:已收款,2:部分收款 |
write_off_amount | numeric(20,2) | 否 | 核销收款金额 |
del_remark | varchar(4000) | 否 | 删除原因 |
order_id | varchar(32) | 否 | 订单id |
order_no | varchar(32) | 否 | 订单编号 |
bill_check_status | varchar(2) | 否 | 账单对账状态。0、待确认 1、已确认 |
return_name | varchar(32) | 否 | 退货人姓名 |
return_addr | varchar(4000) | 否 | 退货人地址 |
return_tel | varchar(32) | 否 | 退货人手机 |
return_phone | varchar(32) | 否 | 退货人电话 |
print_count | numeric(20) | 否 | 打印次数 |
return_order_type | int8 | 否 | 退货单类型id |
return_order_type_name | varchar(100) | 否 | 退货单类型名称 |
gift_amount | numeric(20,2) | 否 | 赠品金额合计 |
gift_cost_amount | numeric(20,2) | 否 | 赠品成本金额合计 |
hc_status | varchar(2) | 否 | 红冲状态。1、被红冲,2、红冲 |
hc_id | varchar(32) | 否 | 关联的红冲单id |
hc_no | varchar(32) | 否 | 关联的红冲单单号 |
source_type | varchar(32) | 是 | 0:商贸版内部(默认),1:勤策订货,2:旺店,3:转单订单 |
exts | List | 否 | 退货单主信息扩展字段列表 |
exts.ext_key | varchar(4000) | 否 | 退货单主信息扩展字段key值扩展字段需先在我方系统中创建 |
exts.ext_value | varchar(4000) | 否 | 扩展字段value值对多个选项值,以“,”分隔拼接 |
prods | List | 是 | 列表 |
prods.detail_id | VARCHAR(32) | 是 | 退货单子表ID |
prods.detail_status | varchar(1) | 是 | 状态。0:已删除,1:正常 |
prods.return_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) | 否 | 商品sourcecode |
prods.price | numeric(20,8) | 是 | 商品的退货价 |
prods.return_count | numeric(20,8) | 是 | 商品退货数量 |
prods.input_unit | varchar(32) | 是 | 录入单位 |
prods.input_unit_name | varchar(100) | 是 | 单位名称 |
prods.base_unit | int8 | 是 | 基本单位 |
prods.base_unit_name | varchar(100) | 是 | 基本单位名称 |
prods.base_unit_return_count | numeric(20,8) | 是 | 商品退货数量转化成基本单位以后的数量 |
prods.return_amount | numeric(20,2) | 是 | 商品退货的金额 |
prods.confirm_count | numeric(20,8) | 否 | 商品退货确认的数量 |
prods.base_unit_confirm_count | numeric(20,8) | 否 | 商品退货确认的数量转化成基本单位以后的数量 |
prods.confirm_amount | numeric(20,2) | 否 | 商品订购确认的金额 |
prods.tax | numeric(20,2) | 是 | 税率 |
prods.tax_amount | numeric(20,2) | 是 | 税额 |
prods.remarks | VARCHAR(4000) | 否 | 备注 |
prods.cost_amount | numeric(20,2) | 是 | 退货成本金额 |
prods.cost_price | numeric(20,8) | 是 | 商品成本价 |
prods.gift_price | numeric(20,8) | 是 | 赠品价格 |
prods.gift_amount | numeric(20,2) | 是 | 赠品金额 |
prods.sequ | varchar(2) | 是 | 排序号 |
prods.is_gift | varchar(32) | 是 | 是否是赠品。1:是,0:不是 |
prods.hc_detail_id | varchar(32) | 否 | 关联的红冲单id |
prods.prod_ext | List | 否 | 商品信息扩展字段列表 |
prods.prod_ext.ext_key | varchar(4000) | 否 | 商品信息扩展字段key值扩展字段需先在我方系统中创建 |
prods.prod_ext.ext_value | varchar(4000) | 否 | 商品信息扩展字段value值对多个选项值,以“,”分隔拼接 |
# 查询车销单数据
请求方式: POST(HTTPS)
请求地址: https://openapi.waiqin365.com/api/stdcarsle/v2/queryCarSaleOrder/{openid}/{timestamp}/{digest}/{msg_id}
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
page_number | INT | 是 | 页码默认1,每页默认1000条 |
status | CHAR(1) | 否 | 记录状态。0:已删除,1:正常 |
cm_id | VARCHAR(32) | 否 | 勤策客户唯一ID |
cm_code | VARCHAR(32) | 否 | 客户编码,有效字符详见附录:有效字符说明 (opens new window) |
create_date | VARCHAR(32) | 否 | 创建日期。格式:yyyy-MM-dd |
modify_date | VARCHAR(32) | 否 | 修改日期。格式:yyyy-MM-dd |
after_create_date | VARCHAR(32) | 否 | 创建时间之后。格式:yyyy-MM-dd HH:mm:ss |
after_modify_date | VARCHAR(32) | 否 | 修改时间之后。格式:yyyy-MM-dd HH:mm:ss |
start_create_date | VARCHAR(32) | 否 | 创建时间开始。格式:yyyy-MM-dd |
end_create_date | VARCHAR(32) | 否 | 创建时间结束。格式:yyyy-MM-dd |
start_modify_date | VARCHAR(32) | 否 | 修改时间开始。格式:yyyy-MM-dd |
end_modify_date | VARCHAR(32) | 否 | 修改时间结束。格式:yyyy-MM-dd |
id | VARCHAR | 否 | 勤策中id |
响应示例:
{
"return_code": "0",
"return_msg": "响应信息",
"msg_id": "{ msg_id }",
"response_data": "<<DATA>>"
}
数据DATA示例:
[
{
"gift_amount": "0.00",
"sale_amount": "0.00",
"remark": "",
"return_amount": "0.00",
"write_off_time": "2017-09-14 17:26:43",
"prods": [
{
"type": "4",
"sale_type": 10,
"sale_type_name": "正常销售",
"product_id": 6937089532047239000,
"product_name": "商品1",
"product_code": "1",
"product_source_code": "",
"product_pictures": "",
"product_spec": "",
"num": "2.00",
"input_unit": 6937089532047239000,
"input_unit_name": "件",
"base_unit": 6937089532047239000,
"base_unit_name": "件",
"base_unit_num": "2.00",
"amount": "0.00",
"cost_price": "0.00",
"price": "0.00",
"discount_amount": "0.00",
"tax": 0.17,
"tax_amount": "0.00",
"cost_amount": "0.00",
"gift_amount": "0.00",
"gift_price": "0.00",
"reason": "",
"is_gift": "1",
"seq": "2",
"promotion_code": "",
"promotion_name": "",
"promotion_id": "",
"book_id": 5969850178664757000,
"book_no": "DH201709140001"
}
],
"submit_date": "2017-09-14 00:00:00",
"create_emp_name": "王老板",
"car_code": "",
"cm_source_code": "",
"write_off_status": "1",
"back_amount": "10.00",
"back_cost_amount": "0.00",
"gift_cost_amount": "0.00",
"sale_no": "XSD201709140002",
"back_tax_amount": "1.45",
"cm_name": "补补啊",
"sale_tax_amount": "0.00",
"total_amount": "0.00",
"sale_cost_amount": "0.00",
"return_gift_amount": "0.00",
"status": "1",
"return_tax_amount": "0.00",
"car_name": "苏A452Q8",
"is_enable": "1",
"bill_check_status": "1",
"discount_amount": "0.00",
"hc_id": "",
"return_gift_cost_amount": "0.00",
"create_time": "2017-09-14 17:26:43",
"change_cost_amount": "0.00",
"visit_implement_id": "",
"car_id": 7119310922438671000,
"cm_id": 7673378102189802000,
"deal_amount": "0.00",
"create_dept_id": 10,
"receive_amount": "0.00",
"create_emp_id": 5073510449430503000,
"cm_code": "CUS001842",
"id": 8007172427642689000,
"change_amount": "0.00",
"hc_status": "",
"create_emp_code": "wyxlaoban",
"write_off_amount": "0.00",
"create_dept_name": "流程审批测试(勿删)",
"create_dept_code": "test_flow",
"print_count": "",
"return_cost_amount": "0.00",
"emp_source_code": "",
"dept_source_code": "aff",
"debt_amount": "0.00",
"hc_no": ""
}
]
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
id | INT8 | 是 | 车销单ID |
status | VARCHAR(1) | 是 | 车销单状态。0:已删除,1:正常 |
is_enable | VARCHAR(1) | 是 | 是否作废。0:已作废,1:未作废 |
car_id | INT8 | 是 | 车辆id |
car_code | VARCHAR(100) | 否 | 车辆编号 |
car_nam | VARCHAR(100) | 否 | 车辆名称 |
sale_no | VARCHAR(100) | 是 | 车销单编号 |
submit_date | varchar(10) | 是 | 提交日期。格式:yyyy-mm-dd hh24:mi:ss |
create_time | varchar(32) | 是 | 创建日期。格式:yyyy-mm-dd hh24:mi:ss |
create_dept_id | int8 | 否 | 业务员下单时候所在的部门id |
create_dept_code | VARCHAR(100) | 否 | 业务员下单时候所在的部门编码 |
ceate_dept_name | VARCHAR(100) | 否 | 业务员下单时候所在的部门名称 |
dept_source_code | VARCHAR(100) | 否 | 部门sourcecode |
create_emp_id | INT8 | 否 | 业务员id |
create_emp_code | VARCHAR(100) | 否 | 业务员编码 |
create_emp_name | VARCHAR(100) | 否 | 业务员名称 |
emp_source_code | VARCHAR(100) | 否 | 业务员sourcecode |
cm_id | INT8 | 是 | 客户id |
cm_code | VARCHAR(100) | 是 | 客户编码 |
cm_name | VARCHAR(100) | 是 | 客户名称 |
cm_source_code | VARCHAR(100) | 否 | 客户sourcecode |
total_amount | numeric(10,2) | 否 | 合计金额 |
discount_amount | numeric(10,2) | 否 | 优惠掉的金额 |
deal_amount | numeric(10,2) | 否 | 成交金额 |
receive_amount | numeric(10,2) | 否 | 收款金额 |
sale_amount | numeric(10,2) | 否 | 优惠前销售金额合计 |
sale_tax_amount | numeric(10,2) | 否 | 销售商品税额合计 |
sale_cost_amount | numeric(10,2) | 否 | 销售商品成本金额合计 |
return_amount | numeric(10,2) | 否 | 退货金额合计 |
return_tax_amount | numeric(10,2) | 否 | 退货税额合计 |
return_cost_amount | numeric(10,2) | 否 | 退货成本金额合计 |
gift_cost_amount | numeric(10,2) | 否 | 赠品成本金额合计 |
gift_amount | numeric(10,2) | 否 | 赠品金额合计 |
change_cost_amount | numeric(10,2) | 否 | 换货成本金额合计 |
change_amount | numeric(10,2) | 否 | 换货金额合计 |
debt_amount | numeric(10,2) | 否 | 欠款金额 |
write_off_status | VARCHAR(2) | 否 | 收款款核销状。0:未收款,1:已收款,2:部分收款 |
write_off_amount | numeric(10,2) | 否 | 核销收款金额 |
write_off_time | VARCHAR(32) | 否 | 最后一次核销时间。格式:yyyy-mm-dd hh24:mi:ss |
remark | varchar(4000) | 否 | 备注 |
visit_implement_id | INT8 | 否 | 高级拜访id |
bill_check_status | VARCHAR(2) | 否 | 账单对账状态。0:待确认,1:已确认(交款交账用) |
print_count | varchar(2) | 否 | 打印次数 |
back_amount | numeric(10,2) | 否 | 还货金额合计 |
back_tax_amount | numeric(10,2) | 否 | 还货商品税额合计 |
back_cost_amount | numeric(10,2) | 否 | 还货商品成本金额合计 |
return_gift_cost_amount | numeric(10,2) | 否 | 退货赠品成本金额 |
return_gift_amount | numeric(10,2) | 否 | 退货赠品金额 |
hc_status | VARCHAR(2) | 否 | 红冲状态。1:被红冲,2:红冲 |
hc_id | int8 | 否 | 只有hc_status是1的单据,此字段才会填值关联自己的红冲 |
hc_no | VARCHAR(10) | 否 | 红冲单号 |
prods | List | 列表 | |
prods.type | VARCHAR(2) | 是 | 车销类型。1:销售,2:退货,3:换货(废弃),4:还货,5:换入,6:换出 |
prods.sale_type | int8 | 否 | 销售类型id |
prods.sale_type_name | VARCHAR(1000) | 否 | 销售类型名称 |
prods.product_id | int8 | 是 | 商品id |
prods.product_name | varchar(4000) | 是 | 商品名称 |
prods.product_code | varchar(4000) | 是 | 商品编码 |
prods.product_source_code | varchar(4000) | 否 | 商品对应sourcecode |
prods.product_pictures | varchar(4000) | 否 | 商品图片(多个用逗号分割) |
prods.product_spec | varchar(1000) | 否 | 商品规格属性 |
prods.num | numeric(10,8) | 是 | 录入数量 |
prods.input_unit | INT8 | 是 | 录入单位id |
prods.input_unit_name | VARCHAR(100) | 是 | 录入单位名称 |
prods.base_unit | INT8 | 是 | 商品基本单位id |
prods.base_unit_name | VARCHAR(100) | 是 | 商品基本单位名称 |
prods.base_unit_num | numeric(10,8) | 是 | 录入数量转化成基本单位以后的数量 |
prods.amount | numeric(10,2) | 否 | 金额 |
prods.cost_price | numeric(10,8) | 否 | 成本价 |
prods.price | numeric(10,8) | 否 | 实际价格 |
prods.discount_amount | numeric(10,2) | 否 | 优惠掉的金额 |
prods.tax | numeric(10,2) | 否 | 商品税率 |
prods.tax_amount | numeric(10,2) | 否 | 商品税额 |
prods.cost_amount | numeric(10,2) | 否 | 商品成本金额 |
prods.sys_amount | numeric(10,2) | 否 | 系统金额 |
prods.sys_price | numeric(10,8) | 否 | 商品对应录入单位的系统价格 |
prods.remark | varchar(4000) | 否 | 子表行备注 |
prods.is_gift | varchar(2) | 否 | 是否是赠品。1:是,0:否 |
prods.seq | varchar(2) | 是 | 下单时的排序 |
prods.promotion_code | varchar(200) | 否 | 促销编码 |
prods.promotion_name | varchar(200) | 否 | 促销名称 |
prods.promotion_id | INT8 | 否 | 促销组id |
prods.book_id | numeric(10,2) | 否 | 订货会主表id |
prods.book_no | numeric(10,2) | 否 | 订货会单号 |
# 销货单红冲
请求方式: POST(HTTPS)
请求地址: https://openapi.waiqin365.com/api/stdorder/v1/salesBillRevoke/{openid}/{timestamp}/{digest}/{msg_id}
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
id | VARCHAR(32) | 否 | 单据ID。单据编码和单据ID不能同时为空 |
order_no | VARCHAR(32) | 否 | 单据编码 |
响应示例:
{
"return_code": "",
"return_msg": "",
"msg_id": ""
}
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
msg_id | VARCHAR(32) | 是 | 消息ID |
return_code | CHAR(1) | 是 | 响应编码。0:成功,1:失败 |
return_msg | VARCHAR(100) | 是 | 响应说明 |
# 新增销货单数据
请求方式: POST(HTTPS)
请求地址: https://openapi.waiqin365.com/api/stdorder/v1/salesBillAdd/{openid}/{timestamp}/{digest}/{msg_id}
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
order_no | VARCHAR(32) | 否 | 订单编码,不传时自动生成 |
cm_id | VARCHAR(32) | 否 | 客户id,客户id和客户编码、名称必须传一个 |
cm_code | VARCHAR(100) | 否 | 客户编码,客户id和客户编码、名称必须传一个 |
cm_name | VARCHAR(100) | 否 | 客户名称,客户id和客户编码、名称必须传一个 |
emp_id | VARCHAR(32) | 否 | 业务员Id,业务员id和业务员编码、名称必须传一个 |
emp_code | VARCHAR(32) | 否 | 业务员编码,业务员id和业务员编码、名称必须传一个 |
emp_name | VARCHAR(32) | 否 | 业务员名称,业务员id和业务员编码、名称必须传一个 |
creator_id | VARCHAR(32) | 否 | 提交人Id |
creator_code | VARCHAR(32) | 否 | 提交人编码 |
creator_name | VARCHAR(32) | 否 | 提交人名称 |
storehouse_id | VARCHAR(32) | 否 | 发货仓库id,发货仓库id和发货仓库编码、名称必须传一个 |
storehouse_code | VARCHAR(32) | 否 | 发货仓库编码,发货仓库id和发货仓库编码、名称必须传一个 |
storehouse_name | VARCHAR(32) | 否 | 发货仓库名称,发货仓库id和发货仓库编码、名称必须传一个 |
submit_date | CHAR(10) | 是 | 下单日期。格式:yyyy-MM-dd HH:mm:ss |
receive_name | VARCHAR(32) | 否 | 收货人姓名 |
receive_addr | VARCHAR(1000) | 否 | 收货人地址 |
receive_phone | varchar(32) | 否 | 收货人手机 |
receive_tel | varchar(32) | 否 | 收货人电话 |
bill_discount | varchar(32) | 否 | 整单优惠,默认0,没有优惠金额 |
receive_amount | varchar(32) | 否 | 收款金额 |
account_from | varchar(32) | 否 | 收款方式 |
account_id | varchar(32) | 否 | 结算账户 |
remarks | varchar(4000) | 否 | 订单备注 |
prods | List | 列表 | |
prods.product_id | VARCHAR(100) | 否 | 商品id,商品id和商品编码、名称必须传一个 |
prods.product_code | VARCHAR(100) | 否 | 商品编码,商品id和商品编码、名称必须传一个 |
prods.product_name | VARCHAR(100) | 否 | 商品名称,商品id和商品编码、名称必须传一个 |
prods.input_price | numeric(20,8) | 是 | 商品的订货价,赠品价格为0 |
prods.input_count | numeric(20,8) | 是 | 商品数量 |
prods.input_unit | VARCHAR(32) | 否 | 录入单位id和录入单位名称传一个即可,不传使用基本单位 |
prods.input_unit_name | varchar(100) | 否 | 录入单位id和录入单位名称传一个即可,不传使用基本单位 |
prods.is_gift | VARCHAR(10) | 否 | 是否是赠品。1:是,0:否,不传就是非赠品 |
prods.remark | VARCHAR(4000) | 否 | 订单子表的备注 |
接口说明:是否是赠品is_gift不传默认为非赠品。如果该商品是赠品,price传0,is_gift传1。未免出错,这二个字段建议必填
响应示例:
{
"return_code": "0",
"return_msg": "响应信息",
"msg_id": "{ msg_id }",
"response_data": "<<DATA>>"
}
数据DATA示例:
[
{
"orderNo":"1234",
"id":"5555"
}
]
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
id | VARCHAR(32) | 否 | 单据ID |
order_no | VARCHAR(32) | 否 | 单据编码 |
# 销售订单自定义字段修改
请求方式: POST(HTTPS)
请求地址: https://openapi.waiqin365.com/api/stdorder/v1/modifyCustomFields/{openid}/{timestamp}/{digest}/{msg_id}
在线调试
请求示例:
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
order_id | VARCHAR(32) | 否 | 订单id |
order_no | VARCHAR(100) | 否 | 订单单号,订单id与订单号选填一个 |
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) | 是 | 订单明细数据扩展字段数据值 |
响应示例:
{
"return_code": "0",
"return_msg": null,
"msg_id": "KAIKAI123456",
"response_data": null
}
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
msg_id | VARCHAR(32) | 是 | 消息ID |
return_code | CHAR(1) | 是 | 响应编码。0:成功,1:失败 |
return_msg | VARCHAR(100) | 是 | 响应说明 |