金蝶云星空与旺店通·企业奇门对接集成组装拆卸单查询连通创建其他入库单(拆卸单(入库部分))

对接源平台:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
目标系统:旺店通·企业奇门
旺店通是北京掌上先机网络科技有限公司旗下品牌,国内的零售云服务提供商,基于云计算SaaS服务模式,以体系化解决方案,助力零售企业数字化智能化管理升级。为零售电商企业的订单管理及仓储管理提供解决方案,致力于帮助企业实现数字化转型,企业规模化发展
数据接口配置
轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线,所以对接方案的配置极其重要,方案可以选择一键复制,轻易云有海量的对接方案可支持一键复制,复制后直接启动使用(对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置,配置只要确认源平台:金蝶云星空的取数逻辑,例如什么时间取什么样的数据。即可完成配置,目标平台:旺店通·企业奇门,把获取的数据组装成目标系统需要的格式进行写入。

金蝶云星空接口明细
- 调用接口:executeBillQuery
- 接口名称:组装拆卸单查询
- 方法:POST
请求参数
字段 | 字段名称 | 类型 | 配置值 |
FID | 实体主键 | string | FID |
FBillNo | 单据编号 | string | FBillNo |
FDocumentStatus | 单据状态 | string | FDocumentStatus |
FStockOrgId_FNumber | 库存组织 | string | FStockOrgId.FNumber |
FDate | 日期 | string | FDate |
FBillTypeID | 单据类型 | string | FBillTypeID |
FOwnerTypeIdHead | 成品货主类型 | string | FOwnerTypeIdHead |
FOwnerIdHead_FNumber | 成品货主 | string | FOwnerIdHead.FNumber |
FAffairType | 事务类型 | string | FAffairType |
FEE | 费用 | string | FEE |
FDeptID_FNumber | 部门 | string | FDeptID.FNumber |
FNote | 备注 | string | FNote |
FCreateDate | 创建日期 | string | FCreateDate |
FModifyDate | 最后修改日期 | string | FModifyDate |
FAPPROVEDATE | 审核日期 | string | FAPPROVEDATE |
FCANCELDATE | 作废日期 | string | FCANCELDATE |
FCANCELSTATUS | 作废状态 | string | FCANCELSTATUS |
FSubProOwnTypeIdH | 子件货主类型 | string | FSubProOwnTypeIdH |
FSubProOwnerIdH_FNumber | 子件货主 | string | FSubProOwnerIdH.FNumber |
FMaterialIDSETY_FNumber | 物料编码 | string | FMaterialIDSETY.FNumber |
FMaterialIDSETY_FBARCODE | 物料条码 | string | FMaterialIDSETY.FBARCODE |
FUnitIDSETY_FNumber | 单位 | string | FUnitIDSETY.FNumber |
FQtySETY | 数量 | string | FQtySETY |
FCostProportion | 成本拆分比例 | string | FCostProportion |
FStockIDSETY_FNumber | 仓库 | string | FStockIDSETY.FNumber |
FStockStatusIDSETY | 库存状态 | string | FStockStatusIDSETY |
FDescriptionSETY | 备注 | string | FDescriptionSETY |
FMTONOSETY | 计划跟踪号 | string | FMTONOSETY |
FProjectNoSETY | 项目编号 | string | FProjectNoSETY |
FOwnerTypeIDSETY | 货主类型 | string | FOwnerTypeIDSETY |
FOwnerIDSETY_FNumber | 货主 | string | FOwnerIDSETY.FNumber |
FKeeperTypeIDSETY | 保管者类型 | string | FKeeperTypeIDSETY |
FKeeperIDSETY | 保管者 | string | FKeeperIDSETY |
FPriceSETY | 成本价 | string | FPriceSETY |
FAmountSETY | 总成本 | string | FAmountSETY |
FLOTSETY | 批号 | string | FLOTSETY |
FSubEntity_FDETAILID | FSubEntity_FDETAILID | string | FSubEntity_FDETAILID |
Limit | 最大行数 | string | {{PAGINATION_PAGE_SIZE}} |
StartRow | 开始行索引 | string | {{PAGINATION_START_ROW}} |
TopRowCount | 返回总行数 | int | |
FilterString | 过滤条件 | string | FApproveDate>='{{LAST_SYNC_TIME dateTime}}' AND FDocumentStatus = 'C' AND FMaterialId.FBARCODE IS NOT NULL AND FMaterialId.FBARCODE <> '' AND FStockIDSETY.FNumber IN ( '02.02','03','06.01','02.01','02','01','04.01','15.04','06' ) AND FMaterialId.FBARCODE NOT LIKE '%LSBM%' AND FMaterialId.FBARCODE NOT LIKE '%lsbm%' AND FMaterialIDSETY.FBARCODE IS NOT NULL AND FMaterialIDSETY.FBARCODE <> '' AND FMaterialIDSETY.FBARCODE NOT LIKE '%LSBM%' AND FMaterialIDSETY.FBARCODE NOT LIKE '%lsbm%' and FAFFAIRTYPE = 'Dassembly' |
FieldKeys | 需查询的字段key集合 | array | |
FormId | 业务对象表单Id | string | STK_AssembledApp |
响应参数
字段 | 字段名称 | 类型 | 配置值 |
FID | 实体主键 | string | |
FBillNo | 单据编号 | string | |
FDocumentStatus | 单据状态 | string | |
FStockOrgId_FNumber | 库存组织 | string | |
FDate | 日期 | string | |
FBillTypeID | 单据类型 | string | |
FOwnerTypeIdHead | 成品货主类型 | string | |
FOwnerIdHead_FNumber | 成品货主 | string | |
FAffairType | 事务类型 | string | |
FEE | 费用 | string | |
FDeptID_FNumber | 部门 | string | |
FNote | 备注 | string | |
FCreateDate | 创建日期 | string | |
FModifyDate | 最后修改日期 | string | |
FAPPROVEDATE | 审核日期 | string | |
FCANCELDATE | 作废日期 | string | |
FCANCELSTATUS | 作废状态 | string | |
FSubProOwnTypeIdH | 子件货主类型 | string | |
FSubProOwnerIdH_FNumber | 子件货主 | string | |
FMaterialIDSETY_FNumber | 物料编码 | string | |
FMaterialIDSETY_FBARCODE | 物料条码 | string | |
FUnitIDSETY_FNumber | 单位 | string | |
FQtySETY | 数量 | string | |
FCostProportion | 成本拆分比例 | string | |
FStockIDSETY_FNumber | 仓库 | string | |
FStockStatusIDSETY | 库存状态 | string | |
FDescriptionSETY | 备注 | string | |
FMTONOSETY | 计划跟踪号 | string | |
FProjectNoSETY | 项目编号 | string | |
FOwnerTypeIDSETY | 货主类型 | string | |
FOwnerIDSETY_FNumber | 货主 | string | |
FKeeperTypeIDSETY | 保管者类型 | string | |
FKeeperIDSETY | 保管者 | string | |
FPriceSETY | 成本价 | string | |
FAmountSETY | 总成本 | string | |
FLOTSETY | 批号 | string | |
FSubEntity_FDETAILID | FSubEntity_FDETAILID | string | |
旺店通·企业奇门接口明细
- API:wdt.stockin.order.push
- NAME:创建其他入库单
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
outer_no | 外部单号 | {{FBillNo}}-cin{{FStockIDSETY_FNumber}}{{CURRENT_TIME}} | 外部系统的唯一单据编号,避免重复推送数据 |
warehouse_no | 仓库编号 | {{FStockIDSETY_FNumber}} | 代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置) |
logistics_code | 物流编号 | | 代表物流所有属性的唯一编码,用于物流区分,ERP内支持自定义(ERP物流界面设置) |
logistics_no | 物流单号 | | 物流公司的运单号,用于追踪物流、快递流转信息(路由)的数字编码 |
is_check | 是否审核 | 1 | 1:审核 0:不审核 默认0 |
is_create_batch | 是否创建批次 | | 0:否;1:是,默认是0。ERP“批次管理”不存在推送的批次号,是否允许单据创建成功,并创建新的“批次号”。 |
post_fee | 邮资 | | 物流或者快递运输货物产生的费用 |
other_fee | 其他费用 | | 其他费用 |
remark | 备注 | assembly-拆卸单(入库部分) | 其他入库单备注 |
reason | 入库原因 | | 入库原因(需要在客户端维护好该原因,如客户端无该原因或者原因停用,则推送失败,路径:设置—>基本设置—>原因列表) |
goods_list | 货品明细节点 | FSubEntity | 入库单货品列表节点 |
goods_list.spec_no | 商家编码 | {{FSubEntity.FMaterialIDSETY_FBARCODE}} | ERP内单品唯一编码(SKU),代表单品(SKU)所有属性,并且为库存量出入计算最小单元。SKU概念介绍,单击这里 |
goods_list.stockin_num | 入库数量 | {{FSubEntity.FQtySETY}} | 入库数量 |
goods_list.position_no | 货位编号 | | 商品在仓库内的位置编号,不传此参数,读ERP配置【入库开单货位优先级配置】,来决定取默认货位、上一次入库货位、ZANCUN货位其中一个货位。 |
goods_list.batch_no | 批次 | | 货品批次编号 |
goods_list.batch_remark | 批次备注 | | 货品批次备注 |
goods_list.production_date | 生产日期 | | 货品生产日期,格式:yyyy-MM-dd HH:mm:ss |
goods_list.validity_days | 有效期天数 | | 商品有效期,单位:天 |
goods_list.src_price | 原价 | | 上层单据的的货品价格,例如采购单的税前折后单价为采购入库的原价,原价减去入库价得出货品优惠。其他入库没有上层单据,根据业务情况自行传值。无特殊业务建议同入库价一致。 |
goods_list.stockin_price | 入库价 | | 入库价格,如推送为0默认取成本价。 |
goods_list.tax | 税率 | | 对征税对象的征收比例或征收额度。例如税率为16%,请求时填值为0.16 |
goods_list.is_enable_sn | 是否开启序列号 | | 是否开启序列号: 0代表不开启序列号 1代表开启序列号 默认为不开启 |
goods_list.sn_list | 序列号列表 | | 序列号列表,多个序列号通过","隔开字符串区分,例如"xxx1,xxx2,xxx3" |
goods_list.stockin_info | stockin_info | | |
数据对接价值
全新的API数据集成模式,赋能企业业务创新 传统企业集成主要采用点对点或ESB集成方式,基于全新API战略中台的API新型集成方式通过解耦系统资源,降低系统间对接难度,实现快速业务需求响应,提升对接效率,助力企业满足快速业务交付需求,实现业务创新。通过构建API生态,助力能力开放与共享 基于API战略中台梳理并整合内部API资源与IT资产,可实现内部资源共享,满足内部开发人员资源使用需求,例如:旺店通·企业奇门与金蝶云星空之间数据集成;并将API资源对外可控开放,打造面向开发者的生态服务,为您打通自身和上下游合作伙伴,创造共赢价值链。开展API战略中台,重塑IT 帮助您基于内部资源构建不同业务能力中心,打造企业统一API战略中台,赋能企业发展,实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时,无需从“零”组建各业务模块,提升开发效率,重塑IT组织及交付能力。

