TIP
# 直营或分销退货单相关数据同步
请求方式: POST(HTTPS)
请求地址: 第三方服务接口URL
请求示例:
{
"msg_id":"X000001",
"return_code":"0",
"return_msg":"",
"response_data": [
{
"id": "",
"supply_id": 6975322184779002302,
"remark": "",
"confirm_emp_name": "",
"create_time_str": "",
"modify_time_str": "",
"create_name": "",
"date_str1": "",
"date_str2": "",
"date_str3": "",
"emp_dept_id": "",
"emp_dept_name": "",
"emp_dept_code": "",
"emp_dept_source_code": "",
"emp_id": "",
"emp_name": "",
"emp_code": "",
"emp_source_code": "",
"emp_phone": "",
"cm_dept_id": "",
"cm_dept_name": "",
"cm_dept_code": "",
"cm_dept_source_code": "",
"cm_id": "",
"cm_name": "",
"cm_code": "",
"cm_source_code": "",
"cm_linkman_id": "",
"linkman_name": "",
"linkman_phone": "",
"order_status": "",
"change_back_reason_id": "",
"change_back_reason": "",
"order_business_status": "",
"sent_id": "",
"sent_no": "",
"visit_implement_id": "",
"order_out_id": "",
"order_out_no": "",
"dms_order_detail_ids": "",
"pictures": "",
"location_type": "",
"location_a": "",
"location_c": "",
"location": "",
"supply_name": "",
"supply_code": "",
"supply_source_code": "",
"order_type": "",
"order_source": "",
"terminal_type": "",
"consignment_date_str": "",
"receive_name": "",
"receive_phone": "",
"receive_tel": "",
"receive_addr": "",
"confirm_emp_id": "",
"confirm_emp_name": "",
"confirm_time_str": "",
"confirm_reason": "",
"order_shenqing_num": "",
"order_shenqing_amount": "",
"order_shenqing_baseunit_num": "",
"order_confirm_num": "",
"order_confirm_amount": "",
"order_confirm_baseunit_num": "",
"order_shouhuo_num": "",
"order_shouhuo_amount": "",
"order_shouhuo_baseunit_num": "",
"under_out_time_str1": "",
"under_out_time_str2": "",
"under_out_emp_id": "",
"under_out_emp": "",
"upper_shouhuo_time_str1": "",
"upper_shouhuo_time_str2": "",
"upper_shouhuo_emp_id": "",
"upper_shouhuo_emp": "",
"under_ruzhang_time_str1": "",
"under_ruzhang_time_str2": "",
"under_ruzhang_emp_id": "",
"under_ruzhang_emp": "",
"supply_tenant_id": "",
"cm_tenant_id": "",
"product_count": "",
"change_order_id": "",
"order_out_id": "",
"dd_order_id": "",
"dd_order_no": "",
"flow_approval": "",
"return_order_type": "",
"details": [{
"id": "",
"product_id": 6692513571119135747,
"product_name": "海之蓝1L",
"product_code": "1010000097",
"product_spec": "",
"product_pictures": "",
"product_source_code": "",
"sent_detail_id": "",
"shenqing_price": "1200.00",
"shenqing_count": "1.0",
"shenqing_input_unit": 1,
"shenqing_input_unit_name": "盒",
"base_unit": 1,
"base_unit_name": "盒",
"shenqing_base_unit_count": "1.0",
"shenqing_amount": "1200.00",
"confirm_count": "0.0",
"confirm_input_unit": -1,
"confirm_input_unit_name": "",
"confirm_base_unit_count": "0.0",
"confirm_amount": "0.00",
"outstock_count": "0.0",
"outstock_input_unit": -1,
"outstock_input_unit_name": "",
"outstock_base_unit_count": "0.0",
"shouhuo_count": "0.0",
"shouhuo_input_unit": -1,
"shouhuo_input_unit_name": "",
"shouhuo_base_unit_count": "0.0",
"shouhuo_amount": "0.00",
"ruzhang_count": "0.0",
"ruzhang_input_unit": -1,
"ruzhang_input_unit_name": "",
"ruzhang_base_unit_count": "0.0",
"remark": "",
"master_id": "",
"posnr": 1,
"product_type": "",
"is_gift": "N",
"promotion_id": -1,
"promotion_code": "",
"promotion_name": "",
"promotion_tag": "",
"promotion_type": "",
"promotion_calc_mode": "MODE_MZ",
"promotion_calc_type": "TYPE_NUM",
"superposition_promotion_id": -1,
"superposition_promotion_code": "",
"superposition_promotion_name": "",
"superposition_promotion_type": "",
"superposition_promotion_tag": "",
"superposition_promotion_calc_mode": "",
"superposition_promotion_calc_type": "",
"shenqing_input_unit_ratio": "",
"confirm_input_unit_ratio": "",
"outstock_input_unit_ratio": "",
"shouhuo_input_unit_ratio": "",
"ruzhang_input_unit_ratio": "",
"return_order_detail_type": ""
}],
"exts": [{
"ext_key": "级别",
"ext_value": "四星"
}]
}
]
}
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
id | VARCHAR(32) | 是 | 单据ID |
order_no | VARCHAR(100) | 否 | 退货单号 |
supply_id | INT8 | 否 | 供货商id。默认值是-1,-1就是厂家 |
remark | VARCHAR(4000) | 否 | 备注 |
confirm_emp_name | VARCHAR(100) | 否 | 确认人名称 |
create_time_str | VARCHAR(32) | 否 | 单据提交时间。格式:yyyy-mm-dd hh24:mi:ss.us |
modify_time_str | VARCHAR(32) | 否 | 单据最近一次变更时间。格式:yyyy-mm-dd hh24:mi:ss.us |
create_name | VARCHAR(100) | 否 | 单据创建人名称 |
date_str1 | VARCHAR(32) | 否 | 业务日期。格式:yyyy-mm-dd hh24:mi:ss |
date_str2 | VARCHAR(32) | 否 | 业务日期。格式:yyyy-mm-dd hh24:mi |
date_str3 | VARCHAR(32) | 否 | 业务日期。格式:yyyy-mm-dd |
emp_dept_id | INT8 | 否 | 业务员当时下单所在的部门id |
emp_dept_code | VARCHAR(100) | 否 | 业务员当时下单所在的部门编码 |
emp_dept_name | VARCHAR(100) | 否 | 业务员当时下单所在的部门名 |
emp_dept_source_code | VARCHAR(100) | 否 | 业务员下单时候所在的部门对应外部数据id |
emp_id | INT8 | 否 | 经办人ID |
emp_code | VARCHAR(100) | 否 | 经办人编码 |
emp_source_code | VARCHAR(100) | 否 | 员工关联的第三方id |
emp_name | VARCHAR(100) | 否 | 经办人名称 |
emp_phone | 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) | 否 | 客户名称 |
cm_linkman_id | VARCHAR(32) | 否 | 门店联系人ID |
linkman_name | VARCHAR(100) | 否 | 收货人 |
linkman_phone | 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 | VARCHAR(100) | 否 | 退换货原因名称 |
order_business_status | VRACHAR(100) | 否 | 订单业务状态 |
sent_id | VARCHAR(32) | 否 | 发货单据ID |
sent_no | VARCHAR(100) | 否 | 发货单编号 |
visit_implement_id | VARCHAR(100) | 否 | 关联的高级拜访id |
order_out_id | VARCHAR(32) | 否 | 关联换出订单ID |
order_out_no | VARCHAR(32) | 否 | 关联换出订单号 |
dms_order_detail_ids | VARCHAR(1000) | 否 | 关联订单的订单明细ID(多个用逗号分隔) |
pictures | VARCHAR(100) | 否 | 订单图片,全路径(多张逗号分隔) |
location_type | VARCHAR(32) | 否 | 定位类型 |
location_a | VARCHAR(1000) | 否 | 定位的地址信息 |
location_c | VARCHAR(4000) | 否 | 纠偏后的坐标 |
location | VARCHAR(4000) | 否 | 纠偏前坐标 |
supply_name | VARCHAR(100) | 否 | 供货商名 |
supply_code | VARCHAR(100) | 否 | 供货商编码 |
supply_source_code | VARCHAR(100) | 否 | 供货商源编码 |
order_type | VARCHAR(100) | 否 | 订单类型。ZY:直营,FX:分销 |
order_source | VARCHAR(100) | 否 | 订单来源。NBZHSJ:内部账号手机(业代手机),NBZHWB:内部账号web(业代web),WBZHSJ:外部账号手机(经销商手机),WBZHWB:外部账号web(经销商web),MDWXXD:门店微信 |
terminal_type | VARCHAR(32) | 否 | 下单的时候使用的终端类型 |
consignment_date_str | VARCHAR(32) | 否 | 交货日期。格式:yyyy-mm-dd |
receive_name | VARCHAR(100) | 否 | 收货人名称。 注:此处收货人信息是由业务员在下单时选择或手工输入 |
receive_phone | VARCHAR(100) | 否 | 收货人手机号码 |
receive_tel | VARCHAR(100) | 否 | 收货人电话 |
receive_addr | VARCHAR(100) | 否 | 收货地址 |
confirm_emp_id | VARCHAR(32) | 否 | 确认人id |
confirm_emp_name | VARCHAR(100) | 否 | 确认人名称 |
confirm_time_str | TIMESTAMP | 否 | 确认时间。格式:yyyy-mm-dd hh24:mi |
confirm_reason | VARCHAR(4000) | 否 | 审批意见 |
order_shenqing_num | numeric(20,8) | 否 | 合计申请数量 |
order_shenqing_amount | numeric(20,8) | 否 | 合计申请金额 |
order_shenqing_baseunit_num | numeric(20,8) | 否 | 合计申请基本单位数量 |
order_confirm_num | numeric(20,8) | 否 | 合计确认数量 |
order_confirm_amount | numeric(20,8) | 否 | 合计确认金额 |
order_confirm_baseunit_num | numeric(20,8) | 否 | 合计确认基本单位数量 |
order_shouhuo_num | numeric(20,8) | 否 | 合计收货数量 |
order_shouhuo_amount | numeric(20,8) | 否 | 合计收货金额 |
order_shouhuo_baseunit_num | numeric(20,8) | 否 | 合计收货基本单位数量 |
under_out_time_str1 | VARCHAR(32) | 否 | 下游出货时间。格式:yyyy-mm-dd hh24:mi:ss |
under_out_time_str2 | VARCHAR(32) | 否 | 下游出货时间。格式:yyyy-mm-dd hh24:mi |
under_out_emp_id | VARCHAR(64) | 否 | 下游出库操作人id |
under_out_emp | VARCHAR(100) | 否 | 下游出库操作人名称 |
upper_shouhuo_time_str1 | VARCHAR(32) | 否 | 上游收货时间。格式:yyyy-mm-dd hh24:mi:ss |
upper_shouhuo_time_str2 | VARCHAR(32) | 否 | 上游收货时间。格式:yyyy-mm-dd hh24:mi |
upper_shouhuo_emp_id | VARCHAR(64) | 否 | 上游收货操作人id |
upper_shouhuo_emp | VARCHAR(100) | 否 | 上游收货操作人名称 |
under_ruzhang_time_str1 | VARCHAR(32) | 否 | 上游入账时间。格式:yyyy-mm-dd hh24:mi:ss |
under_ruzhang_time_str2 | VARCHAR(32) | 否 | 上游入账时间。格式:yyyy-mm-dd hh24:mi |
under_ruzhang_emp_id | VARCHAR(64) | 否 | 上游入账操作人id |
under_ruzhang_emp | VARCHAR(100) | 否 | 上游入账操作人名称 |
supply_tenant_id | VARCHAR(32) | 否 | 供应商互联企业id |
cm_tenant_id | VARCHAR(32) | 否 | 客户互联企业id |
product_count | NUMERIC(15) | 否 | 品种数 |
change_order_id | VARCHAR(32) | 否 | 换货单id |
order_out_id | VARCHAR(64) | 否 | 分销订单id(换出) |
dd_order_no | VARCHAR(64) | 否 | 订单单号 |
flow_approval | VARCHAR(32) | 否 | 单据整个审批流程阶段 |
return_order_type | VARCHAR(32) | 否 | 退货单类型。1:标准,2:签收 |
details | List | ||
details.id | INT8 | 是 | 子表id |
details.product_id | varchar(32) | 否 | 商品ID |
details.product_code | VARCHAR(100) | 否 | 商品编码 |
details.product_source_code | VARCHAR(100) | 否 | 商品源编码 |
details.product_spec | varchar(4000) | 否 | 商品规格属性 |
details.product_pictures | varchar(4000) | 否 | 商品图片 |
details.sent_detail_id | VARCHAR(32) | 否 | 发货子表id |
details.product_name | VARCHAR(100) | 否 | 商品名称 |
details.shenqing_price | NUMERIC(28,8) | 否 | 申请价格 |
details.shenqing_count | numeric(28,8) | 否 | 申请数量 |
details.shenqing_input_unit | VARCHAR(32) | 否 | 申请单位id |
details.shenqing_input_unit_name | VARCHAR(100) | 否 | 申请单位名称 |
details.base_unit | INT8 | 否 | 商品的基本单位id |
details.base_unit_name | VARCHAR(100) | 否 | 商品的基本单位名 |
details.shenqing_base_unit_count | NUMERIC(28,8) | 否 | 申请数量转化成基本单位的数量 |
details.shenqing_amount | NUMERIC(20,2) | 否 | 申请金额 |
details.confirm_count | NUMERIC(28,8) | 否 | 确认数量 |
details.confirm_input_unit | VARCHAR(32) | 否 | 确认单位id |
details.confirm_input_unit_name | VARCHAR(100) | 否 | 确认单位名称 |
details.confirm_base_unit_count | NUMERIC(28,8) | 否 | 确认基本单位数量 |
details.confirm_amount | NUMERIC(20,2) | 否 | 确认金额 |
details.outstock_count | NUMERIC(28,8) | 否 | 出库数量 |
details.outstock_input_unit | VARCHAR(32) | 否 | 出库单位id |
details.outstock_input_unit_name | VARCHAR(100) | 否 | 出库单位名称 |
details.outstock_base_unit_count | NUMERIC(28,8) | 否 | 出库基本单位数量 |
details.shouhuo_count | NUMERIC(28,8) | 否 | 收货数量 |
details.shouhuo_input_unit | VARCHAR(32) | 否 | 收货单位id |
details.shouhuo_input_unit_name | VARCHAR(100) | 否 | 收货单位名称 |
details.shouhuo_base_unit_count | NUMERIC(28,8) | 否 | 收货基本单位数量 |
details.shouhuo_amount | NUMERIC(20,2) | 否 | 收货金额 |
details.ruzhang_count | NUMERIC(28,8) | 否 | 入账数量 |
details.ruzhang_input_unit | VARCHAR(32) | 否 | 入账单位id |
details.ruzhang_input_unit_name | VARCHAR(100) | 否 | 入账单位名称 |
details.ruzhang_base_unit_count | NUMERIC(28,8) | 否 | 入账基本单位数量 |
details.remark | VARCHAR(200) | 否 | 备注 |
details.master_id | INT8 | 否 | 盘点单ID |
details.posnr | NUMERIC(20) | 否 | 项目号。如10、20、30,查询排序时候也可使用 |
details.product_type | VARCHAR(32) | 否 | 销售类型。赠(Z)、兑(D)、返(F) |
details.promotion_id | VARCHAR(32) | 否 | 促销组ID,是促销组中的商品才会有促销组id(是-1就不是促销组中的商品信息)默认-1 |
details.promotion_code | varchar(200) | 否 | 促销编码 |
details.promotion_name | varchar(200) | 否 | 促销名称 |
details.promotion_type | varchar(200) | 否 | 促销类型:BASE:基本策略,OVERLAP:叠加策略。默认BASE |
details.promotion_tag | varchar(200) | 否 | 促销力度:TAG_CHG:常规,TAG_TJ:特别推荐。默认TAG_CHG |
details.promotion_calc_mode | varchar(200) | 否 | 促销模式。MODE_MZ:满赠,MODE_JT:阶梯 |
details.promotion_calc_type | varchar(200) | 否 | 搭赠方式。TYPE_NUM:按订购量,TYPE_MONEY:按订购额 |
details.superposition_promotion_id | VARCHAR(32) | 否 | 叠加促销ID |
details.superposition_promotion_name | VARCHAR(100) | 否 | 叠加促销名称 |
details.superposition_promotion_code | varchar(200) | 否 | 叠加促销编码 |
details.superposition_promotion_type | VARCHAR(100) | 否 | 叠加促销类型 |
details.superposition_promotion_tag | VARCHAR(32) | 否 | 叠加促销力度 |
details.superposition_promotion_calc_mode | VARCHAR(100) | 否 | 叠加促销模式 |
details.superposition_promotion_calc_type | VARCHAR(100) | 否 | 叠加促销搭赠方式 |
exts | List | 退货单主信息扩展字段列表 | |
exts.ext_key | varchar(4000) | 否 | 退货单主信息扩展字段key值扩展字段需先在我方系统中创建 |
exts.ext_value | varchar(4000) | 否 | 扩展字段value值对多个选项值,以“,”分隔拼接 |
响应示例:
{
"return_code": 0,
"return_msg": "",
"msg_id": "X0001"
}
参数说明:
参数 | 说明 |
---|---|
return_code | 响应编码 |
return_msg | 响应消息内容 |
msg_id | 消息ID |