金蝶云星空和旺店通·企业奇门单据接口集成

接入系统:旺店通·企业奇门
旺店通是北京掌上先机网络科技有限公司旗下品牌,国内的零售云服务提供商,基于云计算SaaS服务模式,以体系化解决方案,助力零售企业数字化智能化管理升级。为零售电商企业的订单管理及仓储管理提供解决方案,致力于帮助企业实现数字化转型,企业规模化发展
对接目标系统:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践,面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司,提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于:集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
配置集成方案
通过数据集成平台新增创建集成方案,然后在数据源平台中选择对应的源平台为:旺店通·企业奇门,并且选择对应的连接器(关于旺店通·企业奇门的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息)。选择对应的查询采购入库单接口作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空,并且选择对应连接器。选择对应的采购入库新增接口作为数据写入动作,既可以完成第一步的数据对接配置;打破跨系统连接,让数据轻易互通成为现实。

旺店通·企业奇门接口明细
- 接口:wdt.stockin.order.query.purchase
- 接口名称:查询采购入库单
- 接口方法:POST
请求参数
字段 | 名称 | 类型 |
src_order_no | 上层单据编号 | string |
end_time | 结束时间 | datetime |
status | 状态 | string |
warehouse_no | 仓库编号 | string |
start_time | 开始时间 | datetime |
page_no | 页号 | string |
page_size | 分页大小 | string |
响应参数
字段 | 名称 | 类型 | 描述 |
stockin_id | 入库单主键id | string | 入库单主键id |
order_no | 入库单号 | string | 入库单号 |
status | 状态 | string | 10已取消20编辑中25待价格确认30待审核60待结算80已完成 |
warehouse_no | 仓库编号 | string | 代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置) |
warehouse_name | 仓库 | string | 仓库 |
stockin_time | 修改时间 | string | 修改时间,格式:yyyy-MM-dd HH:mm:ss |
check_time | 审核时间 | string | 审核时间,格式:yyyy-MM-dd HH:mm:ss |
created_time | 创建时间 | string | 创建时间,格式:yyyy-MM-dd HH:mm:ss |
src_order_no | 采购单号 | string | 采购单号 |
remark | 备注 | string | 备注 |
stockin_reason | 入库原因 | string | 入库原因 |
order_type | 入库类型 | string | 入库类型(该接口只返回采购入库类型) |
order_type_name | 入库类型名称 | string | 入库类型名称(默认为采购入库) |
goods_amount | 货款总额 | string | 货款总额 |
total_price | 总成本 | string | 总成本 |
discount | 优惠 | string | 优惠 |
tax_amount | 税后金额 | string | 税后金额 |
post_fee | 邮费 | string | 邮费 |
other_fee | 其他费用 | string | 其他费用 |
logistics_type | 物流类型 | string | 物流方式,详情介绍,单击这里 |
logistics_code | 物流公司编号 | string | 旺店通系统内物流公司编号 |
logistics_name | 物流公司名称 | string | 旺店通系统内物流公司名称 |
logistics_no | 物流单号 | string | 物流单号 |
purchase_no | 采购单编号 | string | 采购单编号 |
provider_no | 供应商编号 | string | 供应商编号 |
provider_name | 供应商名称 | string | 供应商名称 |
outer_no | 外部单号 | string | 上层单据的采购单号可做该入库单的外部单号 |
goods_count | 货品总数量 | string | 货品总数量 |
adjust_num | 纠错数量 | string | 调整量,正数或者负数 |
adjust_price | 纠错金额 | string | 纠错金额 |
right_nums | 调整后数量 | string | 调整后数量 |
right_price | 调整后总金额 | string | 调整后总金额 |
stockin_no | 入库单号 | string | 入库单号 |
wms_outer_no | 仓储外部编号 | string | 默认为'',仓储外部编号 |
wms_status | 外部状态 | string | 默认为'0',外部状态,与wms对接使用 0初始化 1失败 2成功 |
wms_result | 外部结果 | string | 默认为'',外部结果,与wms对接使用 |
warehouse_id | 仓库id | string | 默认为'0',仓库id |
src_order_type | 源单据类型 | string | 1采购入库, 2调拨入库, 3退货入库, 4盘盈入库, 5生产入库, 6其他入库, 7保修入库, 8纠错入库, 9初始化入库 10 预入库 11 JIT退货入库 12 委外入库 |
src_order_id | 源单据id | string | 默认为'0',源单据id |
reason_id | 原因 | string | 默认为'0',原因 |
fa_status | 财务同步状态 | string | 默认为'0',财务同步状态 |
logistics_id | 物流公司 | string | 默认为'0',物流公司 |
post_share_type | 邮费分摊类型 | string | 默认为'0',邮费分摊类型0,不分摊 1,按数量分摊2,按照金额分摊 |
operator_id | 操作员id | string | 操作员id |
check_operator_id | 审核人id | string | 默认为'0',审核人id |
goods_type_count | 货品种类数 | string | 默认为'0',货品种类数 |
note_count | 便签数量 | string | 默认为'0',便签数量 |
flag_id | 标记 | string | 默认为'0',标记 |
modified | 最后修改时间 | string | 最后修改时间 |
details_list | 明细节点 | array | 响应参数的2级数据节点,包含采购入库货品明细属性信息,节点下数据字段详见下述“details_list” |
details_list.stockin_id | 入库单主键id | string | 入库单主键id |
details_list.rec_id | 入库明细主键 | string | 入库明细主键 |
details_list.src_order_detail_id | 上层单据明细主键 | string | 上层单据明细主键 |
details_list.spec_no | 商家编码 | string | 代表单品(sku)所有属性的编码,SKU概念介绍,单击这里 |
details_list.goods_count | 货品数量 | string | 货品数量 |
details_list.discount | 优惠金额 | string | 优惠金额 |
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.right_num | 调整后数量 | string | 调整后数量 |
details_list.right_price | 调整后单价 | string | 调整后单价 |
details_list.right_cost | 调整后总金额 | 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 | 自定义属性 | string | 自定义属性 |
details_list.goods_unit | 单位名称 | string | 单位名称 |
details_list.batch_no | 批次号 | string | 批次号 |
details_list.batch_remark | 批次备注 | string | 批次备注 |
details_list.position_no | 货位编号 | string | 货位编号 |
details_list.src_order_type | 源单据类型 | string | 1采购入库, 2调拨入库, 3退货入库, 4盘盈入库, 5生产入库, 6其他入库, 7保修入库, 8纠错入库, 9初始化入库 10 预入库 11 JIT退货入库 12 委外入库 |
details_list.org_stockin_detail_id | 原始入库单明细 | string | 默认为'0',原始入库单明细 |
details_list.spec_id | 规格id | string | 规格id |
details_list.batch_id | 批次 | string | 默认为'0',批次 |
details_list.position_id | 货位id | string | 默认为'0',货位ID,入库时默认ID |
details_list.num | 数量 | string | 默认为'0.0000',数量 |
details_list.num2 | 数量2 | string | 默认为'0.0000',辅助数量 |
details_list.unit_id | 辅助单位 | string | 默认为'0',辅助单位 |
details_list.base_unit_id | 基本单位 | string | 默认为'0',基本单位 |
details_list.unit_ratio | 单位换算关系 | string | 默认为'1.0000',单位换算关系 |
details_list.expect_num | 预期入库数量 | string | 默认为'0.0000',预期入库数量 |
details_list.cost_price2 | 辅助成本价 | string | 默认为'0.0000',辅助成本价 |
details_list.share_post_cost | 邮资分摊成本 | string | 默认为'0.0000',邮资分摊成本 |
details_list.share_post_total | 邮资分摊总成本 | string | 默认为'0.0000',邮资分摊总成本 |
details_list.modified | 最后修改时间 | string | 最后修改时间 |
details_list.created | 创建时间 | string | 创建时间 |
金蝶云星空接口明细
- API:batchSave
- NAME:采购入库新增
- METHOD:POST
请求参数
接口字段 | 名称 | 预设值 |
FBillTypeID | 单据类型 | RKD01_SYS |
FBusinessType | 业务类型 | CG |
FBillNo | 单据编号 | {{order_no}} |
FDate | 入库日期 | {{check_time}} |
FStockOrgId | 收料组织 | 101 |
FStockDeptId | 收料部门 | |
FPurchaseOrgId | 采购组织 | 101 |
FSupplierId | 供应商 | {{provider_no}} |
F_wyg_Text | 采购单号 | {{src_order_no}} |
F_wyg_LargeText | 备注 | {{remark}} |
FInStockFin | 财务信息 | |
FInStockFin.FSettleOrgId | 结算组织 | 101 |
FInStockFin.FPayOrgId | 付款组织 | 101 |
FInStockFin.FInStockEntry | 明细信息 | details_list |
FInStockFin.FInStockEntry.FMaterialId | 物料编码 | {{details_list.spec_no}} |
FInStockFin.FInStockEntry.FUnitID | 库存单位 | Pcs |
FInStockFin.FInStockEntry.FPriceUnitID | 计价单位 | Pcs |
FInStockFin.FInStockEntry.FRemainInStockUnitId | 采购单位 | Pcs |
FInStockFin.FInStockEntry.FRealQty | 实收数量 | {{details_list.right_num}} |
FInStockFin.FInStockEntry.FPrice | 单价 | |
FInStockFin.FInStockEntry.FStockId | 仓库 | {{warehouse_no}} |
FInStockFin.FInStockEntry.FMtoNo | 计划跟踪号 | |
FInStockFin.FInStockEntry.FGiveAway | 是否赠品 | |
FInStockFin.FInStockEntry.FNote | 备注 | |
FInStockFin.FInStockEntry.FTaxPrice | 含税单价 | {{details_list.cost_price}} |
FInStockFin.FInStockEntry.FEntryTaxRate | 税率(%) | |
FInStockFin.FInStockEntry.FDiscountRate | 折扣率(%) | |
FInStockFin.FInStockEntry.FOWNERID | 货主 | 101 |
FInStockFin.FInStockEntry.FormId | 业务对象表单Id | STK_InStock |
FInStockFin.FInStockEntry.IsAutoSubmitAndAudit | 提交并审核 | true |
FInStockFin.FInStockEntry.Operation | 执行的操作 | Save |
FInStockFin.FInStockEntry.IsVerifyBaseDataField | 验证基础资料 | false |
FInStockFin.FInStockEntry.SubSystemId | 系统模块 | 21 |
系统打通概况
当企业规模逐渐增大时,作为支撑业务运营的IT建设也变得越来越重要,不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程,这样的结果就是,企业上的IT系统很多很全,从ERP到HR、CRM、PDM、OA等,貌似所有的业务都覆盖到了,但实际上因为这些系统的不集成,而形成了企业很多新的信息孤岛,非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看,也不可避免会遇到上述问题,毕竟企业经营的多样化,并不是所有的业务都能在一个系统中完成,所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升API利用率,发挥业务系统价值,实现企业IT资产的可插拔、可复用、可组成。
