系统数据集成方案

用友BIP对接外部旺店通·企业奇门系统

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

对接目标系统:用友BIP

数据接口配置方案

异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则，例如取数就要根据查询接口获取旺店通·企业奇门的数据，并且根据对应的条件进行取数，目标系统就必须根据目标系统的格式，以及获取的数据进行加工处理后进行写入到用友BIP中。轻易云集成平台的可视化配置轻松实现。

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

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

请求参数

字段	名称	类型
process_status	退换单处理状态	string
time_type	时间类型	string
start_time	开始时间	string
end_time	结束时间	string
page_size	分页大小	string
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
code	单据编码	string
salesOrgId	销售组织	string
transactionTypeId	交易类型	string
agentId	客户	string
retailInvestors	是否散户	string
headFreeItem!define2	销售类型	string
saleDepartmentId	销售部门	string
vouchdate	单据日期	string
corpContact	销售业务员	string
settlementOrgId	开票组织	string
currency	币种	string
exchangeRateType	汇率类型	string
natCurrency	本币	string
retailAgentName	散户名称	string
saleReturnMemo	备注	object
saleReturnMemo.remark	备注	string
saleReturnMemo.refundStatus	退货单退款状态	string
saleReturnMemo.refundAmount	退款金额	string
saleReturnMemo.isWfControlled	是否受审批流控制	string
saleReturnMemo.exchRate	汇率	string
saleReturnMemo.taxInclusive	单价含税	string
saleReturnMemo.saleReturnSourceType	退货类型	string
saleReturnMemo.bizFlow_name	流程名称	string
saleReturnMemo.bizFlow_version	版本信息	string
saleReturnMemo.logisticWayId	物流公司id	string
saleReturnMemo.invoiceAgentId	开票客户	string
saleReturnMemo.realMoney	应付金额	string
saleReturnMemo.modifyInvoiceType	发票类型是否可改	string
saleReturnMemo.logisticsBillNo	物流单号	string
saleReturnMemo.logisticsUserName	司机姓名	string
saleReturnMemo.logisticsUserPhone	司机电话	string
saleReturnMemo.logisticsCarNum	车牌号	string
saleReturnMemo.receiver	收货人	string
saleReturnMemo.receiveMobile	收货人移动电话	string
saleReturnMemo.receiveTelePhone	收货人固定电话	string
saleReturnMemo.receiveAddress	收货地址	string
saleReturnMemo.receiveZipCode	收货人邮编	string
saleReturnMemo.bdInvoiceTypeId	发票类型	string
saleReturnMemo.invoiceUpcType	发票类型	string
saleReturnMemo.invoiceTitleType	抬头类型	string
saleReturnMemo.invoiceTitle	发票抬头	string
saleReturnMemo.taxNum	纳税识别号	string
saleReturnMemo.bankName	开户银行	string
saleReturnMemo.subBankName	开户支行	string
saleReturnMemo.bankAccount	账号	string
saleReturnMemo.invoiceTelephone	营业电话	string
saleReturnMemo.invoiceAddress	营业地址	string
saleReturnMemo.totalMoney	总金额	string
saleReturnMemo.payMoney	退货金额	string
saleReturnMemo.totalMoneyOrigTaxfree	无税总金额	string
saleReturnMemo.payMoneyOrigTaxfree	无税退货金额	string
saleReturnMemo.totalOriTax	税额	string
saleReturnMemo.totalMoneyDomestic	本币总金额	string
saleReturnMemo.payMoneyDomestic	本币退货金额	string
saleReturnMemo.totalMoneyDomesticTaxfree	本币无税总金额	string
saleReturnMemo.payMoneyDomesticTaxfree	本币无税退货金额	string
saleReturnMemo.totalNatTax	本币税额	string
saleReturnMemo.bizFlow	流程ID	string
saleReturnMemo.isFlowCoreBill	是否流程核心单据	string
saleReturnMemo.headFreeItem!define5	原始单号	string
saleReturnMemo._status	操作标识	string
saleReturnMemo.saleReturnDetails	退货单详情	array
saleReturnMemo.saleReturnDetails.id	表体行ID	string
saleReturnMemo.saleReturnDetails.orderDetailId	订单行id	string
saleReturnMemo.saleReturnDetails.orderDetailIdKey	订单行idkey	string
saleReturnMemo.saleReturnDetails.sourceid	来源单据ID	string
saleReturnMemo.saleReturnDetails.sourceautoid	来源单据子表ID	string
saleReturnMemo.saleReturnDetails.source	来源单据类型	string
saleReturnMemo.saleReturnDetails.makeRuleCode	生单类型编码	string
saleReturnMemo.saleReturnDetails.productId	商品	string
saleReturnMemo.saleReturnDetails.skuId	商品sku	string
saleReturnMemo.saleReturnDetails.projectId	项目	string
saleReturnMemo.saleReturnDetails.unitExchangeType	浮动换算率（销售）	string
saleReturnMemo.saleReturnDetails.unitExchangeTypePrice	浮动换算率（计价）	string
saleReturnMemo.saleReturnDetails.taxId	税目税率	string
saleReturnMemo.saleReturnDetails.stockId	仓库	string
saleReturnMemo.saleReturnDetails.stockOrgId	库存组织	string
saleReturnMemo.saleReturnDetails.saleReturnDepartmentId	退货部门id	string
saleReturnMemo.saleReturnDetails.iProductAuxUnitId	销售单位	string
saleReturnMemo.saleReturnDetails.iProductUnitId	计价单位	string
saleReturnMemo.saleReturnDetails.masterUnitId	主计量单位	string
saleReturnMemo.saleReturnDetails.orderProductType	商品类型	string
saleReturnMemo.saleReturnDetails.bizProductId	商家商品id	string
saleReturnMemo.saleReturnDetails.salesOrgId	销售组织	string
saleReturnMemo.saleReturnDetails.enable	是否有效状态	string
saleReturnMemo.saleReturnDetails.orderNo	源头订单号	string
saleReturnMemo.saleReturnDetails.upcode	来源单据号	string
saleReturnMemo.saleReturnDetails.modelDescription	规格	string
saleReturnMemo.saleReturnDetails.model	型号	string
saleReturnMemo.saleReturnDetails.specDescription	规格描述	string
saleReturnMemo.saleReturnDetails.invExchRate	销售换算率	string
saleReturnMemo.saleReturnDetails.subQty	退货销售数量	string
saleReturnMemo.saleReturnDetails.invPriceExchRate	计价换算率	string
saleReturnMemo.saleReturnDetails.priceQty	退货计价数量	string
saleReturnMemo.saleReturnDetails.qty	退货数量	string
saleReturnMemo.saleReturnDetails.batchNo	批次	string
saleReturnMemo.saleReturnDetails.isExpiryDateManage	是否有效期管理	string
saleReturnMemo.saleReturnDetails.productDate	生产日期	string
saleReturnMemo.saleReturnDetails.expireDateNo	保质期	string
saleReturnMemo.saleReturnDetails.expireDateUnit	保质期单位	string
saleReturnMemo.saleReturnDetails.invalidDate	有效期至	string
saleReturnMemo.saleReturnDetails.oriTaxUnitPrice	含税成交价	string
saleReturnMemo.saleReturnDetails.oriUnitPrice	无税单价	string
saleReturnMemo.saleReturnDetails.oriSum	含税金额	string
saleReturnMemo.saleReturnDetails.oriMoney	无税金额	string
saleReturnMemo.saleReturnDetails.oriTax	税额	string
saleReturnMemo.saleReturnDetails.natTaxUnitPrice	本币含税单价	string
saleReturnMemo.saleReturnDetails.natUnitPrice	本币无税单价	string
saleReturnMemo.saleReturnDetails.natSum	本币含税金额	string
saleReturnMemo.saleReturnDetails.natMoney	本币无税金额	string
saleReturnMemo.saleReturnDetails.natTax	本币税额	string
saleReturnMemo.saleReturnDetails.retNotNeedInvoiceQty	退货不开票数量	string
saleReturnMemo.saleReturnDetails.firstsourceid	源头单据id	string
saleReturnMemo.saleReturnDetails.firstsourceautoid	源头单据子表id	string
saleReturnMemo.saleReturnDetails.firstsource	源头单据类型	string
saleReturnMemo.saleReturnDetails.firstupcode	源头单据号	string
saleReturnMemo.saleReturnDetails.orderId	销售订单id	string
saleReturnMemo.saleReturnDetails.bodyFreeItem!define1	表体备注	string
saleReturnMemo.saleReturnDetails.bodyFreeItem!define3	子订单号	string
saleReturnMemo.saleReturnDetails.bodyFreeItem!define4	原始订单	string
saleReturnMemo.saleReturnDetails.bodyFreeItem!define5	旺店通行内码	string
saleReturnMemo.saleReturnDetails._status	操作标识, Insert:新增、Update:更新 示例：Insert	string

系统打通概况

全新的API数据集成模式，赋能企业业务创新 传统企业集成主要采用点对点或ESB集成方式，基于全新API战略中台的API新型集成方式通过解耦系统资源，降低系统间对接难度，实现快速业务需求响应，提升对接效率，助力企业满足快速业务交付需求，实现业务创新。通过构建API生态，助力能力开放与共享 基于API战略中台梳理并整合内部API资源与IT资产，可实现内部资源共享，满足内部开发人员资源使用需求，例如：用友BIP与旺店通·企业奇门之间数据集成；并将API资源对外可控开放，打造面向开发者的生态服务，为您打通自身和上下游合作伙伴，创造共赢价值链。开展API战略中台，重塑IT 帮助您基于内部资源构建不同业务能力中心，打造企业统一API战略中台，赋能企业发展，实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时，无需从“零”组建各业务模块，提升开发效率，重塑IT组织及交付能力。

系统数据对接方案元数据代码