旺店通·企业版对接打通金蝶云星空查询入库单管理接口与其他入库新增接口

对接源平台:旺店通·企业版

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

目标系统:金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

数据接口配置方案

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

旺店通·企业版接口明细

接口：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	货位编号

金蝶云星空接口明细

接口：batchSave
接口名称：其他入库新增
接口方法：POST

请求参数

字段	名称	类型	描述
FBillNo	单据编号	string	单据编号
FBillTypeID	单据类型	string	单据类型
FStockOrgId	库存组织	string	组织
FStockDirect	库存方向	string	下拉列表
FDate	日期	string	日期
FSUPPLIERID	供应商	string	基础资料
FDEPTID	部门	string	基础资料
FOwnerTypeIdHead	货主类型	string	多类别基础资料列表
FOwnerIdHead	货主	string	多类别基础资料
FNOTE	备注	string	多行文本
FEntity	明细信息	array
FEntity.FInStockType	入库类型	string	下拉列表
FEntity.FMATERIALID	物料编码	string	基础资料
FEntity.FCMKBarCode	零售条形码	string	文本
FEntity.FSTOCKID	收货仓库	string	基础资料
FEntity.FStockLocId	仓位	string	维度关联字段
FEntity.FLOT	批号	string	批次
FEntity.FQty	实收数量	string	数量
FEntity.FPrice	成本价	string	单价
FEntity.FEntryNote	备注	string	多行文本
FEntity.FSRCBILLNO	源单编号	string	源单编号
FEntity.FSRCBILLTYPEID	源单类型	string	源单类型
FEntity.FormId	业务对象表单Id	string	必须填写金蝶的表单ID如:PUR_PurchaseOrder
FEntity.IsVerifyBaseDataField	验证基础资料	bool	是否验证所有的基础资料有效性，布尔类，默认false（非必录）
FEntity.Operation	执行的操作	string
FEntity.IsAutoSubmitAndAudit	提交并审核	bool

数据对接价值

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

旺店通·企业版对接打通金蝶云星空查询入库单管理接口与其他入库新增接口