系统数据集成方案

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

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

集成系统:用友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/morphologyconversion/save
• 接口名称：形态转换单新增
• 接口方法：POST

请求参数

字段	名称	类型	描述
org	库存组织ID或者code	string	例：1900568695608832
businesstypeId	业务类型Id或者code	string	物料转换，A70002表
conversionType	转换类型	string	1表，1对1转换，2表
mcType	转换纬度	string	1表，物料转换，2表
code	单据编号	string	例：XTZH20210604000001
vouchdate	单据日期	string	例：2021-06-04 00:00:00
beforeWarehouse	转换前仓库ID或code	string	；若为输入母件带出子件功能，必输 例：2098549054656768
afterWarehouse	转换后仓库ID或code	string	；若为输入母件带出子件功能，必输 例：2117194568421632
department	部门id或者编码	string
operator	业务员id或者code	string
remark	表头备注	string	例：test01
creator	创建人	string	例：王章宇
id	形态转换单主表id	string
morphologyconversiondetail	转换单明细表	array
morphologyconversiondetail.groupNumber	组号	string	，同一个转换，转换前和转换后组号相同 例：1
morphologyconversiondetail.lineType	行类型	string	，1表转换前，2表
morphologyconversiondetail.warehouse	仓库id或code	string	例：2098549054656768
morphologyconversiondetail.modelDescription	规格说明	string
morphologyconversiondetail.product_model	型号	string
morphologyconversiondetail.batchno	批次号	string	物料为批次管理物料时必填
morphologyconversiondetail.goodsposition	货位id	string	货位管理为是时必填
morphologyconversiondetail.producedate	生产日期	string	，当物料为效期物料必填
morphologyconversiondetail.invaliddate	失效日期	string	，当物料为效期物料必填
morphologyconversiondetail.productsku	物料SKUid	string	当物料存在sku时，必填；若为输入母件带出子件功能，必输 例：2039290938478848
morphologyconversiondetail.product	物料id或者编码	string	例：2039290921636096
morphologyconversiondetail.mainUnitId	主计量id	string	或者code
morphologyconversiondetail.unit_Precision	主计量精度	string	例：4
morphologyconversiondetail.stockUnitId	库存单位id或者编码	string	例：1910505265844480
morphologyconversiondetail.invExchRate	换算率	string	例：2
morphologyconversiondetail.stockUnitId_Precision	库存单位精度	string	例：2
morphologyconversiondetail.unitExchangeType	库存换算率换算方式	string	，0固定换算，1浮动换算 例：0
morphologyconversiondetail.stockStatusDoc	库存状态id	string	若为输入母件带出子件功能，必输 例：2006555827382257
morphologyconversiondetail.qty	数量	string	可填01或02，若为母件带子件功能，必输，01表例：6
morphologyconversiondetail.mainBOM	BOM类型	string	主BOM
morphologyconversiondetail.fixedQuantity	固定用量	string	当业务类型为组装或者拆卸，行类型为散件时，可填；其他情况不填
morphologyconversiondetail.numeratorQuantity	分子用量	string	，当业务类型为组装或者拆卸，行类型为散件时，可填；其他情况不填
morphologyconversiondetail.denominatorQuantity	分母用量	string	当业务类型为组装或者拆卸，行类型为散件时，可填；其他情况不填
morphologyconversiondetail.scrap	损耗率	string	当业务类型为组装或者拆卸，可填；其他情况不填
morphologyconversiondetail.unitUseQuantity	单位使用量	string	当业务类型为组装或者拆卸，行类型为散件时，可填；其他情况不填
morphologyconversiondetail.proratadistribution	分摊比率	string	，当业务类型为组装或者拆卸，行类型为散件时，可填；其他情况不填
morphologyconversiondetail.subQty	件数	string	例：3
morphologyconversiondetail.remark	表体备注	string	例：test01
morphologyconversiondetail.id	形态转换单子表id	string
morphologyconversiondetail._status	操作标识	string	Insert:新增、 Update:更新

数据对接价值

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

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