# 直营或分销退货单相关数据同步

请求方式: 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