用友BIP对接外部旺店通·企业奇门系统
用友BIP对接外部旺店通·企业奇门系统
对接源平台:旺店通·企业奇门
旺店通是北京掌上先机网络科技有限公司旗下品牌，国内的零售云服务提供商，基于云计算SaaS服务模式，以体系化解决方案，助力零售企业数字化智能化管理升级。为零售电商企业的订单管理及仓储管理提供解决方案，致力于帮助企业实现数字化转型，企业规模化发展
对接目标系统:用友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组织及交付能力。
