系统数据集成方案

从旺店通·企业奇门到用友BIP通过接口配置打通数据

来源系统:旺店通·企业奇门

接通系统：用友BIP

多系统对接方案配置

通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：旺店通·企业奇门，并且选择对应的连接器（关于旺店通·企业奇门的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的查询入库单管理接口作为数据对接来源。然后再通过写入目标平台配置目标系统为用友BIP，并且选择对应连接器。选择对应的其他入库单个保存接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。

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

• 接口：wdt.stockin.order.query
• 接口名称：查询入库单管理
• 接口方法：POST

请求参数

字段	名称	类型	描述
start_time	开始时间	string	按最后修改时间增量获取数据,start_time作为开始时间，格式：yyyy-MM-dd HH:mm:ss
end_time	结束时间	string	按最后修改时间增量获取数据,end_time作为结束时间，格式：yyyy-MM-dd HH:mm:ss
order_type	源单据类别	string	源单据类别 1采购入库, 2调拨入库, 4盘盈入库, 5生产入库, 6其他入库, 7保修入库, 8纠错入库, 9初始化入库 10 预入库 11 JIT退货入库 12 委外入库
status	入库单状态	string	入库单状态 10已取消20编辑中25待价格确认30待审核32待推送33推送失败35委外待入库60待结算80已完成（按照状态查询时必须传原单据类别，如果未传status则默认查询80已完成单据）
warehouse_no	仓库编号	string	代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置），用于获取指定仓库单据信息(不支持一次推送多个仓库编号)
src_order_no	上层单据编号	string	上层单据编号，传该字段可以不传开始时间和结束时间
stockin_no	入库单号	string	入库单号，传该字段可以不传开始时间和结束时间
page_size	分页大小	string	每页返回的数据条数，输入值范围1~100，不传本参数，输入值默认为40，使用举例单击这里
page_no	页号	string	不传值默认从0页开始

响应参数

字段	名称	类型	描述
stockin_id	入库单主键id	string	入库单主键id
order_no	入库单号	string	系统入库单号，默认为RK开头
stockin_no	入库单号	string	入库单号
wms_status	委外状态	string	委外状态
wms_result	错误信息	string	错误信息
warehouse_id	仓库ID	string	仓库id
src_order_type	入库类型	string	1采购入库,2调拨入库,3退货入库,4盘盈入库,5生产入库,6其他入库,7保修入库,8纠错入库,9初始化入库10预入库11JIT退货入库12委外入库'
src_order_id	入库id	string	入库id
reason_id	其他入库原因	string	其他入库原因
fa_status	财务同步状态	string	财务同步状态
logistics_id	物流公司	string	物流公司
post_share_type	邮费分摊类型	string	邮费分摊类型0,不分摊1,按数量分摊2,按照金额分摊
operator_id	经办人	string	经办人
note_count	便签条数	string	便签条数
flag_id	标记颜色	string	标记颜色
modified	最后修改时间	string	最后修改时间
warehouse_no	仓库编号	string	代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置)
warehouse_name	仓库名称	string	ERP内系统仓库名称
status	状态	string	10已取消20编辑中25待价格确认30待审核32待推送33推送失败35委外待入库60待结算80已完成
stockin_time	入库时间	string	入库时间，格式：YYYY-MM-DDHH:MM:SS
created_time	创建时间	string	创建时间，格式：yyyy-MM-dd HH:mm:ss
remark	备注	string	备注
stockin_reason	入库原因	string	入库原因
order_type	订单类别	string	订单类别
order_type_name	订单类别名称	string	订单类别名称
goods_count	货品数量	string	货品数量
goods_amount	货款总额	string	货款总额
total_price	扣除优惠后货款总额	string	扣除优惠后货款总额
discount	优惠金额	string	优惠金额
tax_amount	税后金额	string	税后金额
post_fee	邮费	string	邮费
other_fee	其他费用	string	其他费用
logistics_type	物流类型	string	物流方式，详情介绍，单击这里
check_time	审核时间	string	审核时间，格式：YYYY-MM-DDHH:MM:SS
src_order_no	源单号	string	上层单据编号，如果是采购入库就是采购单号，调拨入库就是调拨号，以此类推
outer_no	外部单号	string	外部单号
logistics_no	物流单号	string	物流单号,获取此字段前需将版本升级至V2.3.9.1及以上的稳定版本
operator_name	操作员姓名	string	操作员姓名
details_list	货品列表节点	array	响应参数的2级数据节点，包含单个入库单所有货品属性信息的数据节点，节点下数据字段详见下述“stockin_list”列表
details_list.stockin_id	入库单主键id	string	入库单主键id
details_list.rec_id	主键	string	主键（与业务无关）
details_list.src_order_detail_id	上层单据明细主键	string	上层单据明细主键
details_list.src_order_type	入库类型	string	1采购入库,2调拨入库,3退货入库,4盘盈入库,5生产入库,6其他入库,7保修入库,8纠错入库,9初始化入库10预入库11JIT退货入库12委外入库'
details_list.org_stockin_detail_id	原始入库单明细	string	原始入库单明细
details_list.spec_id	规格ID	string	规格ID
details_list.batch_id	批次	string	批次
details_list.position_id	货位ID	string	货位ID，入库时默认ID，后来做货位调拨不再修改
details_list.num	库存单位	string	库存单位
details_list.num2	辅助单位量	string	辅助单位量
details_list.unit_id	辅助单位	string	辅助单位
details_list.base_unit_id	基本单位	string	基本单位
details_list.unit_ratio	单位换算关系	string	单位换算关系
details_list.expect_num	预期入库数量	string	预期入库数量（基本单位数量，显示可自动转换成辅助单位）
details_list.cost_price2	辅助成本价	string	辅助成本价
details_list.share_post_cost	邮资分摊成本	string	邮资分摊成本
details_list.share_post_total	邮资分摊总成本	string	邮资分摊总成本
details_list.modified	最后修改时间	string	最后修改时间
details_list.created	创建时间	string	创建时间
details_list.spec_no	商家编码	string	代表单品(sku)所有属性的编码，SKU概念介绍,单击这里
details_list.goods_count	货品数量	string	货品数量
details_list.discount	优惠金额	string	入库单管理的“优惠”
details_list.right_num	调整后数量	string	货品数量+纠错数量
details_list.right_price	调整后单价	string	调整后单价
details_list.right_cost	调整后总金额	string	扣除优惠后货款总额+入库后续调整价格,right_num*right_price
details_list.cost_price	成本价	string	入库单管理的“入库价”
details_list.production_date	生产日期	string	生产日期，格式：yyyy-MM-dd HH:mm:ss
details_list.validity_days	有效期天数	string	生产日期
details_list.expire_date	有效期	string	有效期，格式：yyyy-MM-dd HH:mm:ss
details_list.src_price	原价	string	原价
details_list.tax_price	税后单价	string	税后单价
details_list.tax_amount	税后金额	string	税后金额
details_list.tax	税率	string	税率
details_list.total_cost	总成本	string	总成本
details_list.remark	备注	string	入库单备注
details_list.adjust_num	调整数量	string	调整数量，计算方式为调整后数量-原数量
details_list.adjust_price	调整单价金额	string	调整单价金额，计算方式为调整后价格-原价
details_list.brand_no	品牌编号	string	品牌编号
details_list.brand_name	品牌名称	string	品牌名称
details_list.goods_name	货品名称	string	货品名称
details_list.goods_no	货品编号	string	代表货品(spu)所有属性的编号，SPU概念介绍,单击这里
details_list.spec_name	规格名称	string	规格名称
details_list.spec_code	规格码	string	规格码
details_list.prop2	自定义属性2	string	单品列表的自定义属性2
details_list.goods_unit	单位	string	货品单位
details_list.batch_no	批次号	string	批次号
details_list.batch_remark	批次备注	string	批次备注
details_list.position_no	货位编号	string	货位编号

用友BIP接口明细

• 接口：/yonbip/scm/othinrecord/single/save
• 接口名称：其他入库单个保存
• 接口方法：POST

请求参数

字段	名称	类型	描述
resubmitCheckKey	保证请求的幂等性	string	该值由客户端生成,并且必须是全局唯一的，长度不能超过32位。更多信息,请参见«MDD幂等性»
id	主表id	string
needCalcLines	表体行计算标识	string	不传或传入false时不对子表进行二次计算，需调用方保证数据的完整及正确性；为true时，以数量反算件数、以成本金额反算单价。 例：false
code	单据编号	string	以系统编码规则配置为准，系统设置为手工编号时必输，系统设置为自动编号时非必输；更新操作时必填 例：QTRK0000001
defines!define1	defines!define1	string	以系统编码规则配置为准，系统设置为手工编号时必输，系统设置为自动编号时非必输；更新操作时必填 例：QTRK0000001
org	库存组织	string	，传入id或code 例：wzyqzn
accountOrg	会计主体	string	传入id或code 例：wzyqzn
vouchdate	单据日期	string	例：2021-03-05
bustype	交易类型	string	传入id或code 例：A08001
warehouse	仓库	string	传入id或code 例：ck01
memo	备注	string	例：XXX
_status	操作标识,	string	Insert:新增、Update:更新 例：Insert
othInRecords	其他入库单子表	array
othInRecords.id	子表id	string
othInRecords.rowno	行号	string	例：1
othInRecords.isSerialNoManage	序列号管理	string	true:是、false:否、 例：false
othInRecords.product	物料	string	传入id或code 例：PD0817000001
othInRecords.productsku	物料SKU	string	传入id或code 例：PD08170000010004
othInRecords.batchno	批次号	string	例：SH01
othInRecords.producedate	生产日期	string	例：2020-09-24 00:00:00
othInRecords.invaliddate	有效期至	string	例：2020-09-24 00:00:00
othInRecords.contactsQuantity	应收数量	string	应收数量与实收数量不能同时为空 例：10
othInRecords.contactsPieces	应收件数	string	例：10
othInRecords.qty	数量，实收数量与应收数量不能同时为空	string	例：10
othInRecords.unit	主计量单位，传入id或code	string	例：KGM
othInRecords.invExchRate	换算率	string	例：件（精度2）
othInRecords.subQty	件数	string	例：件（精度2）
othInRecords.stockUnitId	库存单位	string	传入id或code 例：KGM
othInRecords.natUnitPrice	单价	string	例：10
othInRecords.natMoney	金额	string	例：100
othInRecords.goodsposition	货位	string	传入id或code，仓库开启货位记存量时必输 例：ck01_hw01
othInRecords.project	项目	string	传入id或code 例：2411545234969600
othInRecords.unitExchangeType	库存换算率换算方式	string	，0固定换算，1浮动换算 例：1
othInRecords.autoCalcCost	存货自动计算成本标识	string	是否由存货核算回写成本金额、成本单价 例：false
othInRecords.isBatchManage	是否批次管理	string	true:是；false:否 例：false
othInRecords.isExpiryDateManage	是否效期管理	string	true:是；false:否 例：false
othInRecords.memo	备注	string	例：XXX
othInRecords._status	操作标识	string	Insert:新增、Update:更新 例：Insert

系统数据集成价值

从API服务总线层面解决企业烟囱式业务系统集成现状 相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰 使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。

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