旺店通·企业奇门对接打通用友BIP查询退换管理接口与销售退货单个保存接口

对接源平台:旺店通·企业奇门

慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。

对接目标平台:用友BIP

YonBIP用友商业创新平台，是用友在数字经济时代面向成长型、大型企业及巨型企业，融合了先进且高可用技术平台和公共与关键商业应用与服务，支撑和运行客户的商业创新（业务创新、管理变革），并且具有数字化、智能化、高弹性、安全可信、社会化、全球化、平台化、生态化等特征的综合型服务平台。

数据接口配置

在轻易云平台进行集成方案的配置时，为了实现快速搭建，轻易云平台还提供了现有的市场方案进行复制参考。用户可以在创建集成方案的时候在第四步选择引用市场方案，参考市场主流所进行的字段配置完成集成方案的自定义化快速配置，即便是第一次使用轻易云平台的用户也能轻松搭建属于自己的数据同步方案。向导式配置，让配置更加清晰，首先确定该方方案的对接内容，第二歩获取筛选数据源平台的数据，第三步数据源与写入目标形成映射关系配置。完成配置后一键启用

旺店通·企业奇门接口明细

调用接口：wdt.refund.query
接口名称：查询退换管理
方法：POST

请求参数

字段	字段名称	类型	配置值
process_status	退换单处理状态	string
time_type	时间类型	string
start_time	开始时间	string	{{LAST_SYNC_TIME datetime}}
end_time	结束时间	string	{{CURRENT_TIME datetime}}
page_size	分页大小	string	{{PAGINATION_PAGE_SIZE}}
shop_no	店铺编号	string
page_no	页号	string
refund_no	Erp内退换单编号	string
src_refund_no	平台原始退换单号	string
trade_no	系统订单编号	string
tid	原始单号	string

响应参数

字段	字段名称	类型
modified	最后修改时间	string
refund_id	退换单主键	string
refund_no	erp退换单号	string
finish_time	结算时间	string
customer_no	客户档案编号	string
api_outer_no	API单号	string
platform_id	平台类型	string
customer_name	收件人姓名	string
src_no	平台退款单号	string
swap_zip	收件人邮编	string
swap_logistics_type	换货新订单物流公司类别	string
type	类型	string
process_status	处理状态	string
swap_logistics_name	换货新订单物流公司名称	string
creator_name	建单员姓名	string
status	平台状态	string
guarantee_mode	担保方式	string
error_msg	逆向物流错误信息	string
cs_status	退款阶段	string
created	创建时间	string
shop_no	店铺编号	string
outer_no	外部编号	string
shop_name	店铺名称	string
swap_trade_id	换出原始单id	string
warehouse_id	仓库id	string
pay_account	买家支付帐号	string
shop_id	店铺id	string
pay_no	支付订单号	string
advance_status	预先状态	string
goods_amount	退货金额	string
refund_amount	买家申请退款金额	string
is_goods_received	是否收到货品	string
customer_id	客户id	string
direct_refund_amount	线下退款金额	string
guarante_refund_amount	平台退款金额	string
swap_warehouse_id	换出仓库id	string
actual_refund_amount	实际退款/收款金额	string
swap_logistics_id	换出物流id	string
warehouse_type	仓库类型	string
exchange_amount	换货金额	string
post_amount	邮费金额	string
wms_status	wms状态	string
other_amount	其它金额	string
wms_result	wms结果	string
wms_outer_no	外部仓库的单号	string
paid	已退款/已收款	string
from_type	建立方式	string
tid	订单的原始单号	string
sales_trade_id	系统订单ID	string
return_goods_count	退回货品数量	string
sales_tid	系统订单号	string
op_constraint	约束	string
buyer_nick	昵称	string
refund_version	退款版本	string
receiver_name	收件人姓名	string
consign_mode	发货方式	string
receiver_address	收件人地址	string
logistics_name	物流公司名称	string
receiver_telno	收件人电话	string
logistics_no	物流单号	string
push_no	物流递交单号	string
return_name	退货人姓名	string
return_mobile	退货人手机号	string
logistics_style	物流形式	string
reason_id	原因	string
return_telno	退货人电话	string
revert_reason	驳回原因	string
return_address	退回仓库地址	string
return_logistics_name	退回物流公司名称	string
bad_reason	错误原因	string
return_mask	返回标志	string
return_logistics_no	退回物流单号	string
swap_receiver	换货收件人姓名	string
is_trade_charged	是否结算后生成订单	string
swap_mobile	换收发件人姓名手机	string
stockin_pre_no	预入库单	string
swap_telno	换货收件人姓名电话	string
revert_reason_info	驳回原因名称	string
refund_order_list	退款子订单信息	array
refund_order_list.order_id	货品明细主键	string
refund_order_list.refund_id	退换单主键	string
refund_order_list.oid	原始子订单id	string
refund_order_list.tid	订单子订单的原始单号	string
refund_order_list.src_no	平台退款单号	string
refund_order_list.process_status	处理状态	string
refund_order_list.sales_tid	销售订单编号	string
refund_order_list.order_num	实际数量	string
refund_order_list.price	价格	string
refund_order_list.platform_id	平台类型	string
refund_order_list.cost_price	成本价	string
refund_order_list.original_price	原价	string
refund_order_list.discount	优惠	string
refund_order_list.paid	已付金额	string
refund_order_list.market_price	单品市场价	string
refund_order_list.refund_num	退款数量	string
refund_order_list.refund_order_amount	明细退款金额	string
refund_order_list.total_amount	退货金额	string
refund_order_list.spec_id	erp商品主键	string
refund_order_list.spec_no	商家编码	string
refund_order_list.goods_name	货品名称	string
refund_order_list.goods_no	货品编号	string
refund_order_list.spec_name	规格名称	string
refund_order_list.spec_code	规格编码	string
refund_order_list.suite_no	组合装编号	string
refund_order_list.suite_name	组合装名称	string
refund_order_list.suite_num	组合装数量	string
refund_order_list.stockin_num	退货入库数量	string
refund_order_list.remark	退款说明	string
refund_order_list.is_sn_enable	是否启用序列号	string
refund_order_list.position_no	货位编号	string
refund_order_list.position_id	货位ID	string
refund_order_list.sales_trade_id	系统订单ID	string
refund_order_list.sales_order_id	销售订单ID	string
refund_order_list.goods_id	平台货品ID	string
refund_order_list.suite_id	组合装ID	string
refund_order_list.stockin_amount	退货入库总额	string
refund_order_list.modified	最后修改时间	string
refund_order_list.created	创建时间	string
refund_order_list.swap_province	换货收件人省份	string
refund_order_list.refund_out_goods_list	换出货品信息列表	array
refund_order_list.swap_city	换货收件人城市	string
refund_order_list.swap_district	换货收件人区县	string
refund_order_list.swap_area	换货收件人省市区	string
refund_order_list.swap_warehouse_no	换出货品出库仓库编号	string
refund_order_list.swap_address	换货收件人姓名地址	string
refund_order_list.warehouse_no	期望退回的仓库编号	string
refund_order_list.refund_time	退款创建时间	string
refund_order_list.remark	退款说明	string
refund_order_list.refund_reason	退款原因	string
refund_order_list.swap_trade_no	换出原始单号	string

用友BIP接口明细

接口：/yonbip/sd/vouchersalereturn/singleSave
接口名称：销售退货单个保存
接口方法：POST

请求参数

字段	名称	类型	描述
resubmitCheckKey	保证请求的幂等性	string	保证请求的幂等性,该值由客户端生成,并且必须是全局唯一的，长度不能超过32位。更多信息,请参见«MDD幂等性»
code	单据编码	string	单据编码，以系统编码规则配置为准：系统设置为手工编号时必输，系统设置为自动编号时非必输；修改时必传示例："S0T5-0000000000-20210831-000000"
salesOrgId	销售组织	string	销售组织，传id或者code 示例：2163951720681984
transactionTypeId	交易类型	string	交易类型，传id或者code 示例：2155547426656517
agentId	客户	string	客户，传id或者code 示例：2251598175195392
retailInvestors	是否散户	string	是否散户, true:是、false:否、示例：false
headFreeItem!define2	销售类型	string
saleDepartmentId	销售部门	string	销售部门，传id或者code 示例："2163953113665792"
vouchdate	单据日期	string	单据日期示例："2021-08-31 00:00:00"
corpContact	销售业务员	string	销售业务员示例："2163960865427712"
settlementOrgId	开票组织	string	开票组织，传id或者code 示例："2163951720681984"
currency	币种	string	币种，传id或者code 示例："2155547424560384"
exchangeRateType	汇率类型	string	汇率类型，传id或者code 示例："csrka3z7"
natCurrency	本币	string	本币，传id或者code 示例："2155547424560384"
retailAgentName	散户名称	string	散户名称示例："散户2"
saleReturnMemo	备注	object	备注
saleReturnMemo.remark	备注	string	备注示例："销售退货"
saleReturnMemo.refundStatus	退货单退款状态	string	退货单退款状态，由系统业务自动生成，接口无需传值。示例："NONE"
saleReturnMemo.refundAmount	退款金额	string	退款金额示例：1
saleReturnMemo.isWfControlled	是否受审批流控制	string	是否受审批流控制示例：false
saleReturnMemo.exchRate	汇率	string	汇率示例：1
saleReturnMemo.taxInclusive	单价含税	string	单价含税, true:是、false:否、示例：true
saleReturnMemo.saleReturnSourceType	退货类型	string	退货类型, NONE:无来源、DELIVERYEND:销售出库单、ORDER:销售订单示例："DELIVERYEND"
saleReturnMemo.bizFlow_name	流程名称	string	流程名称示例："001"
saleReturnMemo.bizFlow_version	版本信息	string	版本信息示例："版本1"
saleReturnMemo.logisticWayId	物流公司id	string	物流公司id 示例：321321
saleReturnMemo.invoiceAgentId	开票客户	string	开票客户，传id或者code 示例：2216247878177024
saleReturnMemo.realMoney	应付金额	string	应付金额，等于表头的退货金额示例：100
saleReturnMemo.modifyInvoiceType	发票类型是否可改	string	发票类型是否可改, true:是、false:否、示例：true
saleReturnMemo.logisticsBillNo	物流单号	string	物流单号示例："4321"
saleReturnMemo.logisticsUserName	司机姓名	string	司机姓名示例："王一"
saleReturnMemo.logisticsUserPhone	司机电话	string	司机电话示例："18888888888"
saleReturnMemo.logisticsCarNum	车牌号	string	车牌号示例："京A-ax245"
saleReturnMemo.receiver	收货人	string	收货人示例："王二"
saleReturnMemo.receiveMobile	收货人移动电话	string	收货人移动电话示例："010-12345678"
saleReturnMemo.receiveTelePhone	收货人固定电话	string	收货人固定电话示例："1555555555"
saleReturnMemo.receiveAddress	收货地址	string	收货地址示例："北京市海淀区"
saleReturnMemo.receiveZipCode	收货人邮编	string	收货人邮编示例："011"
saleReturnMemo.bdInvoiceTypeId	发票类型	string	0:收据,1:增值税电子普通发票,2:增值税电子专用发票,3:增值税普通发票,4:增值税专用发票,5:机动车销售统一发票,8:增值税电子普通发票（成品油）,10:增值税普通发票（成品油）,11:增值税专用发票（成品油）,e0:电子收购发票示例：0
saleReturnMemo.invoiceUpcType	发票类型	string	发票类型, 0:收据、1:增值税专用发票、2:增值税普通发票、3:增值税电子普通发票、4:机动车销售销售统一发票、示例：0
saleReturnMemo.invoiceTitleType	抬头类型	string	抬头类型, 0:企业、1:个人、2:非营利组织、示例：0
saleReturnMemo.invoiceTitle	发票抬头	string	发票抬头示例："中央大客户工信部"
saleReturnMemo.taxNum	纳税识别号	string	纳税识别号示例："SH999000999"
saleReturnMemo.bankName	开户银行	string	开户银行示例："中国工商银行"
saleReturnMemo.subBankName	开户支行	string	开户支行示例："中国工商银行股份有限公司天津中北支行"
saleReturnMemo.bankAccount	账号	string	账号示例："888888888888888"
saleReturnMemo.invoiceTelephone	营业电话	string	营业电话示例："012-9998893"
saleReturnMemo.invoiceAddress	营业地址	string	营业地址示例："北京市海淀区"
saleReturnMemo.totalMoney	总金额	string	总金额示例：43214
saleReturnMemo.payMoney	退货金额	string	退货金额，需等于表体含税金额的合计示例：312
saleReturnMemo.totalMoneyOrigTaxfree	无税总金额	string	无税总金额示例：321
saleReturnMemo.payMoneyOrigTaxfree	无税退货金额	string	无税退货金额示例：321
saleReturnMemo.totalOriTax	税额	string	税额示例：3
saleReturnMemo.totalMoneyDomestic	本币总金额	string	本币总金额示例：643256
saleReturnMemo.payMoneyDomestic	本币退货金额	string	本币退货金额示例：5432
saleReturnMemo.totalMoneyDomesticTaxfree	本币无税总金额	string	本币无税总金额示例：5432
saleReturnMemo.payMoneyDomesticTaxfree	本币无税退货金额	string	本币无税退货金额示例：5432
saleReturnMemo.totalNatTax	本币税额	string	本币税额示例：5421
saleReturnMemo.bizFlow	流程ID	string	流程ID 示例：213
saleReturnMemo.isFlowCoreBill	是否流程核心单据	string	是否流程核心单据示例：true
saleReturnMemo.headFreeItem!define5	原始单号	string	原始单号
saleReturnMemo.status	操作标识	string	操作标识, Insert:新增、Update:更新示例："Insert"
saleReturnMemo.saleReturnDetails	退货单详情	array	退货单详情[voucher.salereturn.SaleReturnDetail]
saleReturnMemo.saleReturnDetails.id	表体行ID	string	表体行ID 新增时无需填写，修改时必填示例：4312432
saleReturnMemo.saleReturnDetails.orderDetailId	订单行id	string	订单行id，有来源必填示例：2403153858154753
saleReturnMemo.saleReturnDetails.orderDetailIdKey	订单行idkey	string	订单行idkey 示例："6425432"
saleReturnMemo.saleReturnDetails.sourceid	来源单据ID	string	来源单据ID，有来源必填示例：2403160486547968
saleReturnMemo.saleReturnDetails.sourceautoid	来源单据子表ID	string	来源单据子表ID，有来源必填示例：2403160486547970
saleReturnMemo.saleReturnDetails.source	来源单据类型	string	来源单据类型（1.ustock.st_salesout销售出库 2.voucher_order 销售订单）有来源必填示例："ustock.st_salesout"
saleReturnMemo.saleReturnDetails.makeRuleCode	生单类型编码	string	生单类型编码（1.salesoutTosalereturn 由销售出库生单，2.order_salereturn:由销售订单生单），有来源必填示例："salesoutTosalereturn"
saleReturnMemo.saleReturnDetails.productId	商品	string	商品，传id或者code 示例：2320711092457728
saleReturnMemo.saleReturnDetails.skuId	商品sku	string	商品sku，传id或者code 示例：2313763385315584
saleReturnMemo.saleReturnDetails.projectId	项目	string	项目，传id或者code 示例："123124312"
saleReturnMemo.saleReturnDetails.unitExchangeType	浮动换算率（销售）	string	浮动换算率（销售）示例：0
saleReturnMemo.saleReturnDetails.unitExchangeTypePrice	浮动换算率（计价）	string	浮动换算率（计价）示例：0
saleReturnMemo.saleReturnDetails.taxId	税目税率	string	税目税率，传id或者code 示例："2155547427149061"
saleReturnMemo.saleReturnDetails.stockId	仓库	string	仓库，传id或者code 示例：2192242573644032
saleReturnMemo.saleReturnDetails.stockOrgId	库存组织	string	库存组织，传id或者code 示例："2163951720681984"
saleReturnMemo.saleReturnDetails.saleReturnDepartmentId	退货部门id	string	退货部门id 示例："14321"
saleReturnMemo.saleReturnDetails.iProductAuxUnitId	销售单位	string	销售单位，传id或者code 示例：2263072523178240
saleReturnMemo.saleReturnDetails.iProductUnitId	计价单位	string	计价单位，传id或者code 示例：2312582309908736
saleReturnMemo.saleReturnDetails.masterUnitId	主计量单位	string	主计量单位，传id或者code 示例：2261943548399872
saleReturnMemo.saleReturnDetails.orderProductType	商品类型	string	商品类型, SALE:销售品、GIFT:赠品、MARKUP:加价购、REBATE:返利商品、示例："SALE"
saleReturnMemo.saleReturnDetails.bizProductId	商家商品id	string	商家商品id 示例：31243141
saleReturnMemo.saleReturnDetails.salesOrgId	销售组织	string	销售组织，传id或者code 示例：6425432
saleReturnMemo.saleReturnDetails.enable	是否有效状态	string	是否有效状态示例：true
saleReturnMemo.saleReturnDetails.orderNo	源头订单号	string	源头订单号，有来源必填示例："QbOJ-000000000-20210825-000017"
saleReturnMemo.saleReturnDetails.upcode	来源单据号	string	来源单据号示例："XSCK20210825000005"
saleReturnMemo.saleReturnDetails.modelDescription	规格	string	规格示例："规格01"
saleReturnMemo.saleReturnDetails.model	型号	string	型号示例："001"
saleReturnMemo.saleReturnDetails.specDescription	规格描述	string	规格描述示例："规格"
saleReturnMemo.saleReturnDetails.invExchRate	销售换算率	string	销售换算率示例：1
saleReturnMemo.saleReturnDetails.subQty	退货销售数量	string	退货销售数量示例：100
saleReturnMemo.saleReturnDetails.invPriceExchRate	计价换算率	string	计价换算率示例：1
saleReturnMemo.saleReturnDetails.priceQty	退货计价数量	string	退货计价数量示例：100
saleReturnMemo.saleReturnDetails.qty	退货数量	string	退货数量示例：1
saleReturnMemo.saleReturnDetails.batchNo	批次	string	批次示例：2
saleReturnMemo.saleReturnDetails.isExpiryDateManage	是否有效期管理	string	是否有效期管理, true:是、false:否、示例：false
saleReturnMemo.saleReturnDetails.productDate	生产日期	string	生产日期示例：2021-08-31 00:00:00
saleReturnMemo.saleReturnDetails.expireDateNo	保质期	string	保质期示例：3
saleReturnMemo.saleReturnDetails.expireDateUnit	保质期单位	string	保质期单位, 1:年、2:月、6:天、示例：1
saleReturnMemo.saleReturnDetails.invalidDate	有效期至	string	有效期至示例：2021-08-31 00:00:00
saleReturnMemo.saleReturnDetails.oriTaxUnitPrice	含税成交价	string	含税成交价示例：500
saleReturnMemo.saleReturnDetails.oriUnitPrice	无税单价	string	无税单价示例：500
saleReturnMemo.saleReturnDetails.oriSum	含税金额	string	含税金额示例：500
saleReturnMemo.saleReturnDetails.oriMoney	无税金额	string	无税金额示例：500
saleReturnMemo.saleReturnDetails.oriTax	税额	string	税额示例：0.0
saleReturnMemo.saleReturnDetails.natTaxUnitPrice	本币含税单价	string	本币含税单价示例：500
saleReturnMemo.saleReturnDetails.natUnitPrice	本币无税单价	string	本币无税单价示例：500
saleReturnMemo.saleReturnDetails.natSum	本币含税金额	string	本币含税金额示例：500
saleReturnMemo.saleReturnDetails.natMoney	本币无税金额	string	本币无税金额示例：500
saleReturnMemo.saleReturnDetails.natTax	本币税额	string	本币税额示例：500
saleReturnMemo.saleReturnDetails.retNotNeedInvoiceQty	退货不开票数量	string	退货不开票数量示例：100
saleReturnMemo.saleReturnDetails.firstsourceid	源头单据id	string	源头单据id，有来源必填示例：2403063657222400
saleReturnMemo.saleReturnDetails.firstsourceautoid	源头单据子表id	string	源头单据子表id，有来源必填示例：2403063657238784
saleReturnMemo.saleReturnDetails.firstsource	源头单据类型	string	源头单据类型（udinghuo.voucher_order），有来源必填示例：udinghuo.voucher_order
saleReturnMemo.saleReturnDetails.firstupcode	源头单据号	string	源头单据号，有来源必填示例：QbOJ-000000000-20210825-000014
saleReturnMemo.saleReturnDetails.orderId	销售订单id	string	销售订单id，有来源必填示例：QbOJ-000000000-20210825-000014
saleReturnMemo.saleReturnDetails.bodyFreeItem!define1	表体备注	string	销售订单id，有来源必填示例：QbOJ-000000000-20210825-000014
saleReturnMemo.saleReturnDetails.bodyFreeItem!define3	子订单号	string	销售订单id，有来源必填示例：QbOJ-000000000-20210825-000014
saleReturnMemo.saleReturnDetails.bodyFreeItem!define4	原始订单	string	销售订单id，有来源必填示例：QbOJ-000000000-20210825-000014
saleReturnMemo.saleReturnDetails.bodyFreeItem!define5	旺店通行内码	string	销售订单id，有来源必填示例：QbOJ-000000000-20210825-000014
saleReturnMemo.saleReturnDetails._status	操作标识, Insert:新增、Update:更新示例：Insert	string	操作标识, Insert:新增、Update:更新示例：Insert

系统打通概况

将传统的统计分析转变为预测分析，从被动分析到主动分析，从非实时分析转变为实时分析，从结构化的数据变成多元化的数据。精准查询数据流同步状况，实时监管队列任务以及数据资产的有序管理。为业务赋能，降本增效，让企业能够更加合理的布局团队；结合业务需求实现与OA，CRM，WMS等系统之间的数据交流与同步，为企业定制自定义的数据管理方案，用技术拓展商业边界，为新业务、新部门提供成长空间。