旺店通·企业奇门与用友BIP对接集成查询采购退货单连通采购入库来源生单保存(采购退货单=>采购入库单(下推)-p)
接入系统：旺店通·企业奇门
旺店通是北京掌上先机网络科技有限公司旗下品牌，国内的零售云服务提供商，基于云计算SaaS服务模式，以体系化解决方案，助力零售企业数字化智能化管理升级。为零售电商企业的订单管理及仓储管理提供解决方案，致力于帮助企业实现数字化转型，企业规模化发展
集成系统:用友BIP
面向数智化市场，用友倾力打造了全球领先的数智商业创新平台——用友BIP，定位为数智商业的应用级基础设施、企业服务产业的共创平台，服务企业数智化转型和商业创新，让企业云服务随需而用，让数智价值无处不在，让商业创新如此便捷。
接口方案配置
通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：旺店通·企业奇门，并且选择对应的连接器（关于旺店通·企业奇门的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的查询采购退货单接口作为数据对接来源。然后再通过写入目标平台配置目标系统为用友BIP，并且选择对应连接器。选择对应的采购入库来源生单保存接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。
旺店通·企业奇门接口明细
- 调用接口：wdt.stockout.order.query.return
- 接口名称：查询采购退货单
- 方法：POST
请求参数
字段字段名称类型配置值
start_time开始时间string{{LAST_SYNC_TIME datetime}}
end_time结束时间string{{CURRENT_TIME datetime}}
warehouse_no仓库编号string
status出库单状态string
page_no页号string{{PAGINATION_START_PAGE}}
page_size分页大小string{{PAGINATION_PAGE_SIZE}}
src_order_no上层单据编号string
响应参数
字段字段名称类型配置值
stockout_id出库单主键idstring
order_no出库单号string
src_order_no源单号string
warehouse_no仓库编号string
status状态string
consign_time出库时间string
order_type源单据类别string
order_type_name源单据类型名称string
subtype出库子类型string
goods_total_amount货品总售价string
goods_total_cost货品总成本string
post_fee邮费string
logistics_no物流编号string
package_fee包装费string
receiver_name收件人string
receiver_country国家string
receiver_province省份string
receiver_city城市string
receiver_district地区string
receiver_address详细地址string
receiver_mobile收件人移动电话string
receiver_telno收件人固定电话string
receiver_zip邮编string
stockout_reason出库原因string
outer_no外部单号string
operator_name操作人string
receiver_area省市区string
return_no采购退货单号string
provider_no供应商编号string
provider_name供应商名称string
pr_api_outer_no采购退货单外部单号string
last_load_purchase_no最后引用采购单号string
picklist_print_status分拣单打印状态string
logistics_print_status物流单打印状态string
sendbill_print_status发货单打印状态string
stockout_no出库单号string
src_order_id源单据idstring
wms_status处理状态string
error_info错误信息string
warehouse_type仓库类别string
warehouse_id出库的仓库idstring
customer_id客户idstring
freeze_reason冻结原因string
is_allocated是否分配string
consign_status出库状态string
ebill_status面单状态string
operator_id制单人string
goods_type_count货品种类数量string
md5_strMD5字符串值string
raw_goods_count预留字段string
custom_type出库类别string
receiver_ring接收环string
to_deliver_time配送时间string
pre_charge_time配送中心string
logistics_id物流公司idstring
unknown_goods_amount未知成本销售总额string
calc_post_cost预估邮费成本string
post_cost邮费成本string
calc_weight预估重量string
post_weight快递给的重量string
package_id包装string
package_cost包装成本string
has_invoice是否包含发票string
printer_id打单员string
pick_error_count拣货出错次数string
picker_id拣货操作员idstring
sorter_id包裹分拣员idstring
examiner_id验货操作员idstring
consigner_id发货人idstring
packager_id打包员string
pack_score打包积分string
pick_score拣货积分string
checkouter_id签出员工idstring
watcher_id监视员string
picklist_no分拣单编号string
picklist_seq分拣单中序号string
invoice_print_status发票打印状态string
flag_id颜色标记string
logistics_template_id物流单模板idstring
sendbill_template_id发货单模板idstring
pos_allocate_mode货位分配方式string
note_count便签条数string
reason_id出库原因string
lock_id锁定策略idstring
reserve保留string
block_reason截停原因string
stock_check_time出库单审核时间string
details_list货品列表节点array
details_list.stockout_id出库单主键idstring
details_list.goods_count货品数量string
details_list.weight重量string
details_list.remark备注string
details_list.modified最后修改时间string
details_list.src_order_type源单据类别string
details_list.batch_no批次号string
details_list.rec_id出库明细主键idstring
details_list.spec_no商家编码string
details_list.sell_price销售价string
details_list.brand_no品牌编号string
details_list.brand_name品牌名称string
details_list.goods_name货品名称string
details_list.goods_no货品编号string
details_list.spec_name规格名称string
details_list.spec_code规格编号string
details_list.cost_price成本价string
details_list.total_amount总货款string
details_list.goods_type货品类别string
details_list.goods_unit单位名称string
details_list.batch_remark批次备注string
details_list.expire_date有效期string
details_list.goods_id货品idstring
details_list.spec_id规格idstring
details_list.src_order_detail_id源单据细节idstring
details_list.base_unit_id基本单位string
details_list.unit_id辅助单位string
details_list.unit_ratio单位换算string
details_list.num2辅助数量string
details_list.num货品数量string
details_list.price价格string
details_list.batch_id出库批次string
details_list.is_examined是否验货string
details_list.is_package是否包装string
details_list.is_zero_cost是否允许0成本string
details_list.scan_type类型string
details_list.created创建时间string
details_list.position_list货位列表节点array
details_list.position_list.position_id货位IDstring
details_list.position_list.position_no货位编号string
details_list.position_list.position_goods_count货位出库数量string
用友BIP接口明细
- 接口：/yonbip/scm/purinrecord/mergeSourceData/save
- 接口名称：采购入库来源生单保存
- 接口方法：POST
请求参数
字段名称类型描述
resubmitCheckKey保证请求的幂等性string该值由客户端生成,并且必须是全局唯一的长度不能超过32位。更多信息,请参见«MDD幂等性»
mergeSourceData合并上游数据string固定值传入true。
needCalcLines表体行计算标识string固定值传入true。
calcLinesKey表体行计算依据string固定值传入true。
code单据编号string以系统编码规则配置为准：系统设置为手工编号时必输。系统设置为自动编号时非必输
vouchdate单据日期string日期格式:YYYYMMDD
bustype交易类型idstring或交易类型code；业务流中未配置交易类型且未设置默认交易类型时必输。
warehouse仓库idstring或仓库code；上游单据未指定仓库时必输
memo备注string
status操作标识stringInsert:新增
purInRecords采购入库单子表array
purInRecords.makeRuleCode生单规则编码string固定值。订单入库：st_purchaseorder订单退库：st_purchaseorder3，退货入库：st_purchaseorder_return，到货入库：pu_arrivalorder
purInRecords.sourceid上游单据主表idstring
purInRecords.sourceautoid上游单据子表idstring
purInRecords.qty数量string默认上游带入，若传入数量请确保表体行计算标识needCalcLines=true，并确认calcLinesKey是否符合实际业务场景
purInRecords.oriUnitPrice无税单价string仅在表头参数表体行计算标识needCalcLines=true，且calcLinesKey指定当前字段为计算依据时生效。
purInRecords.oriTaxUnitPrice含税单价string仅在表头参数表体行计算标识needCalcLines=true，且calcLinesKey指定当前字段为计算依据时生效。
purInRecords.memo备注string
purInRecords._status操作标识stringInsert:新增
系统集成总览
当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。
