旺店通·企业奇门与用友BIP对接集成查询入库单管理连通形态转换单新增(形态转换单-v)|轻易云数据集成平台

旺店通·企业奇门与用友BIP对接集成查询入库单管理连通形态转换单新增(形态转换单-v)

接入系统：旺店通·企业奇门

旺店通是北京掌上先机网络科技有限公司旗下品牌，国内的零售云服务提供商，基于云计算SaaS服务模式，以体系化解决方案，助力零售企业数字化智能化管理升级。为零售电商企业的订单管理及仓储管理提供解决方案，致力于帮助企业实现数字化转型，企业规模化发展

对接目标平台:用友BIP

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

数据接口配置方案

数据集成平台对应的配置旺店通·企业奇门与用友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:更新

系统集成总览

通过数据集成平台可视化的快速配置调用接口打通旺店通·企业奇门与用友BIP之间的数据接口，使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具，基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎，通过可视化配置，快速实现客户灵活多变的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。