旺店通·企业奇门和用友BIP接口打通对接实战

旺店通·企业奇门和用友BIP接口打通对接实战

数据源平台:旺店通·企业奇门

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

写入目标:用友BIP

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

系统对接接口配置

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

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

• API：wdt.refund.query
• NAME：查询退换管理
• METHOD：POST

请求参数

接口字段字段名称预设值描述 process_status退换单处理状态退换单处理状态 5 补款 10已取消 20待审核 30已同意 40已拒绝 50待财审 60待收货 63待推送 64推送失败 65委外待收货 69待收货(已结算) 70部分到货 71部分到货(已结算) 80待结算 90已完成 time_type时间类型0，最后更新时间，1，结算时间。默认值0 start_time开始时间{{LAST_SYNC_TIME datetime}}按最后修改（结算）时间增量获取数据,start_time作为开始时间，格式：yyyy-MM-dd HH:mm:ss end_time结束时间{{CURRENT_TIME datetime}}按最后修改时间（结算）增量获取数据,end_time作为结束时间，格式：yyyy-MM-dd HH:mm:ss page_size分页大小{{PAGINATION_PAGE_SIZE}}每页返回的数据条数，输入值范围1_{40，不传本参数，输入值默认为40，使用举例单击这里} shop_no店铺编号店铺编号 page_no页号不传值默认从0页开始 refund_noErp内退换单编号Erp内退换单编号，传该字段可以不传时间 src_refund_no平台原始退换单号平台原始退换单号，传该字段可以不传时间 trade_no系统订单编号系统订单编号，传该字段可以不传时间 tid原始单号原始单号，传该字段可以不传时间

响应参数

接口字段字段名称预设值描述 modified最后修改时间最后修改时间  格式：yyyy-MM-dd HH:mm:ss refund_id退换单主键退换单主键 refund_noerp退换单号erp退换单号，默认TK开头 finish_time结算时间旺店通内操作结算的时间  格式：yyyy-MM-dd HH:mm:ss customer_no客户档案编号客户档案编号 api_outer_noAPI单号接口创建退换单的外部单号 platform_id平台类型平台类型，响应值为代表平台的ID数字，ID对应的平台名称单击这里 customer_name收件人姓名收件人姓名（如需唯一值，以receiver_name为准） src_no平台退款单号平台退款单号 swap_zip收件人邮编收件人邮编 swap_logistics_type换货新订单物流公司类别响应值为代表换货新订单物流公司类别的数字，数字对应的物流公司类别名称单击这里 type类型1退款(未发货，退款申请)2退货3换货4退款不退货5订单补款 process_status处理状态5补款10已取消20待审核30已同意40已拒绝50待财审60待收货63待推送64推送失败65委外待收货69待收货(已结算)70部分到货71部分到货(已结算)80待结算90已完成 swap_logistics_name换货新订单物流公司名称换货新订单物流公司名称 creator_name建单员姓名建单员姓名 status平台状态平台状态0表示为空，1取消退款，2已申请退款，3等待退货，4等待收货，5退款成功，10换货待处理，20待买家退货，30买家已退货待收货，40待买家修改，50待发出换货商品，55待买家收货，60换货改退货，70换货关闭，80换货成功 guarantee_mode担保方式担保方式1担保交易2非担保交易3非担保在线交易（ecshop） error_msg逆向物流错误信息逆向物流错误信息 cs_status退款阶段退款阶段  0售中 1售后 created创建时间创建时间 shop_no店铺编号代表店铺所有属性的唯一编码，用于店铺区分，ERP内支持自定义（ERP店铺界面设置） outer_no外部编号默认为''，外部编号,与wms对接使用 shop_name店铺名称店铺名称 swap_trade_id换出原始单id换出原始单id warehouse_id仓库id默认为'0'，期望退回的仓库 pay_account买家支付帐号买家支付帐号 shop_id店铺id店铺id pay_no支付订单号支付订单号 advance_status预先状态 goods_amount退货金额退货金额 refund_amount买家申请退款金额买家申请退款金额 is_goods_received是否收到货品默认为'0'，买家是否收到货 customer_id客户id默认为'0'，客户id direct_refund_amount线下退款金额订单确认收货之后的退款金额 guarante_refund_amount平台退款金额平台退款金额 swap_warehouse_id换出仓库id默认为'0'，换出货品出库仓库 actual_refund_amount实际退款/收款金额实际退款/收款金额 swap_logistics_id换出物流id默认为'0'，换货新订单物流公司ID warehouse_type仓库类型 exchange_amount换货金额换货金额 post_amount邮费金额邮费金额 wms_statuswms状态默认为'0'，外部状态,与wms对接使用0初始化1失败2成功 other_amount其它金额其它金额 wms_resultwms结果默认为''，外部结果,与wms对接使用 wms_outer_no外部仓库的单号默认为''，对应外部仓库的单号 paid已退款/已收款已退款/已收款 from_type建立方式默认为'1'，建立方式1api抓单2手式建单3外部导入4天猫换货5菜鸟回传自动创建 tid订单的原始单号订单的原始单号 sales_trade_id系统订单ID系统订单ID return_goods_count退回货品数量默认为'0'，退回货品数量 sales_tid系统订单号系统订单编号，默认单号为JY开头，ERP内支持自定义（设置路径：设置——编码设置） op_constraint约束默认为'0'，1不允许拒绝2需要到网页版操作 buyer_nick昵称昵称 refund_version退款版本默认为''，退款版本,大于0后表明已经从平台下载完成，退款单不可修改 receiver_name收件人姓名收件人姓名 consign_mode发货方式默认为'0'，发货方式：0默认1审核退款单后立即生成换货订单2退货完成后生成换货订单 receiver_address收件人地址收件人地址 logistics_name物流公司名称默认为''，物流公司名称 receiver_telno收件人电话收件人电话 logistics_no物流单号默认为''，物流单号 push_no物流递交单号默认为''，物流递交单号 return_name退货人姓名退货人姓名 return_mobile退货人手机号退货人手机号 logistics_style物流形式默认为'0'，取件方式:0客户取件，1顺丰取件，2拒收退回 reason_id原因默认为'0'，原因 return_telno退货人电话退货人电话 revert_reason驳回原因默认为'0'，驳回原因 return_address退回仓库地址退回仓库地址 return_logistics_name退回物流公司名称退回物流公司名称 bad_reason错误原因默认为'0'，错误原因 return_mask返回标志 return_logistics_no退回物流单号退回物流单号 swap_receiver换货收件人姓名换货收件人姓名 is_trade_charged是否结算后生成订单默认为'0'，是否结算后生成订单 swap_mobile换收发件人姓名手机换收发件人姓名手机 stockin_pre_no预入库单默认为''，预入库单 swap_telno换货收件人姓名电话换货收件人姓名电话 revert_reason_info驳回原因名称驳回原因名称 refund_order_list退款子订单信息退款子订单信息,refund_order_list结构 refund_order_list.order_id货品明细主键退换单退回货品明细主键 refund_order_list.refund_id退换单主键退换单主键 refund_order_list.oid原始子订单id原始子订单编号 refund_order_list.tid订单子订单的原始单号订单子订单的原始单号 refund_order_list.src_no平台退款单号平台退款单号 refund_order_list.process_status处理状态处理状态0已取消10待递交20待审核30已同意40已拒绝50待财审60待收货70部分到货80已完成 refund_order_list.sales_tid销售订单编号销售订单编号 refund_order_list.order_num实际数量实际数量 refund_order_list.price价格价格 refund_order_list.platform_id平台类型平台类型，响应值为代表平台的ID数字，ID对应的平台名称单击这里 refund_order_list.cost_price成本价成本价 refund_order_list.original_price原价原价 refund_order_list.discount优惠优惠 refund_order_list.paid已付金额已付金额 refund_order_list.market_price单品市场价单品市场价 refund_order_list.refund_num退款数量退款数量 refund_order_list.refund_order_amount明细退款金额明细退款金额，由主单退款金额分摊 refund_order_list.total_amount退货金额退货金额 refund_order_list.spec_iderp商品主键erp商品主键 refund_order_list.spec_no商家编码代表单品(sku)所有属性的唯一编码，用于系统单品区分，SKU概念介绍,单击这里 refund_order_list.goods_name货品名称货品名称 refund_order_list.goods_no货品编号代表货品(spu)所有属性的唯一编号，用于系统货品区分，，SPU概念介绍,单击这里 refund_order_list.spec_name规格名称规格名称 refund_order_list.spec_code规格编码规格编码 refund_order_list.suite_no组合装编号组合装编号 refund_order_list.suite_name组合装名称组合装名称 refund_order_list.suite_num组合装数量组合装数量 refund_order_list.stockin_num退货入库数量退货入库数量 refund_order_list.remark退款说明退换明细的备注 refund_order_list.is_sn_enable是否启用序列号默认为'0'，0不启用序列号1强序列号2弱序列号 refund_order_list.position_no货位编号货位编号 refund_order_list.position_id货位ID货位ID，入库时默认ID refund_order_list.sales_trade_id系统订单ID系统订单ID refund_order_list.sales_order_id销售订单ID默认为'0' refund_order_list.goods_id平台货品ID平台货品ID refund_order_list.suite_id组合装ID默认为'0'，组合装ID refund_order_list.stockin_amount退货入库总额默认为'0.0000'，退货入库总额 refund_order_list.modified最后修改时间最后修改时间  格式：yyyy-MM-dd HH:mm:ss refund_order_list.created创建时间创建时间 refund_order_list.swap_province换货收件人省份换货收件人省份 refund_order_list.refund_out_goods_list换出货品信息列表换出货品信息列表,refund_out_goods_list结构 refund_order_list.swap_city换货收件人城市换货收件人城市 refund_order_list.swap_district换货收件人区县换货收件人区县 refund_order_list.swap_area换货收件人省市区换货收件人省市区 refund_order_list.swap_warehouse_no换出货品出库仓库编号换出货品出库仓库编号 refund_order_list.swap_address换货收件人姓名地址换货收件人姓名地址 refund_order_list.warehouse_no期望退回的仓库编号期望退回的仓库编号 refund_order_list.refund_time退款创建时间退款创建时间  格式：yyyy-MM-dd HH:mm:ss refund_order_list.remark退款说明退款说明 refund_order_list.refund_reason退款原因退款的具体原因说明 refund_order_list.swap_trade_no换出原始单号ERP生成的换出订单的原始订单编号

用友BIP接口明细

• API：/yonbip/fi/paybill/save
• NAME：客户退款保存
• METHOD：POST

请求参数

接口字段字段名称预设值描述 code单据编号{{refund_no}}新增时无需填写，修改时必填 exchangeRateType_code汇率类型档案编码01 vouchdate单据日期 格式为:yyyy-MM-dd HH:mm:ss{{modified}} accentity会计主体findCollection find mapping_sale_org from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}} oriSum付款金额_function round({{refund_amount}},2) natSum本币金额function round({{refund_amount}},2) balance余额 settlemode_code结算方式system_0001 operator_name业务员{{creator_name}} dept_code部门 customer客户id_findCollection find mapping_customer from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}} natCurrency本币币种id1480261131563434007 currency_name币种人民币 natCurrency_priceDigit本币币种单价精度2 currency_moneyDigit币种金额精度2 natCurrency_moneyDigit本币币种金额精度2 exchangeRateType_name汇率类型名称基准汇率 exchRate汇率1 description备注{{remark}} tradetype交易类型id2742928410236975 tradetype_name交易类型名称销售退款 tradetype_code交易类型编码arap_payment_sale org_code销售组织编码findCollection find maping_sale_orgnumber from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}} basebilltype_name事项类型名称basebilltype_name basebilltypecode事项类型编码arap_payment caobject收付款对象类型11:客户 billtype单据类型 固定为991:销售发票、2:其它应收事项、3:销售发票(红字)、4:其它应收事项(红字)、5:订单日报、6:内部交易结算单、7:收款单、8:其它应付事项、9:客户退款单、10:付款单、11:供应商退款单、12:转账单、13:汇率损益单、14:外币兑换单、id period_code会计期间编码2022-07 period会计期间id2742928426767367 returncount返回次数 orderno订单编号{{sales_tid}} pubts时间戳{{CURRENT_TIME datetime}}格式为:yyyy-MM-dd HH:mm:ss _status操作标识InsertInsert:新增、Update:更新 PayBillb客户退款明细 PayBillb.quickType_code款项类型编码11:预收款 PayBillb.expenseitem_code费用项目编码01 PayBillb.oriSum金额function round({{actual_refund_amount}},2) PayBillb.natSum本币金额_function round({{actual_refund_amount}},2) PayBillb.customer客户idfindCollection find mapping_customer from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}} PayBillb.customer_name客户名称 PayBillb.org_code销售组织编码_findCollection find maping_sale_orgnumber from 4769a428-14c4-33b8-91fd-e8da3b39d5cb where shop_no={{shop_no}} PayBillb.description备注{{refund_order_list.remark}} PayBillb._status操作标识InsertInsert:新增、Update:更新、Unchanged:不变

系统数据集成价值

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