旺店通·企业奇门对接打通金蝶云星空查询调拨单接口与调拨单新增接口

对接源平台:旺店通·企业奇门
慧策(原旺店通)是一家技术驱动型智能零售服务商,基于云计算PaaS、SaaS模式,以一体化智能零售解决方案,帮助零售企业数字化智能化升级,实现企业规模化发展。
接通系统:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上,提供了标准的管理模式;通过标准的业务架构:多会计准则、多币别、多地点、多组织、多税制应用框架等,有效支持企业的运营管理;K/3Cloud提供了标准的业务建模:35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合,288个业务服务构件,让企业及伙伴可快速构建出行业化及个性化的应用。
配置集成方案
系统对接前期需要通过调研公司的业务,规划出最便捷,效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地,轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台:旺店通·企业奇门的接口参数设置,以及设定好目标平台:金蝶云星空的映射,即可启动方案进行测试


旺店通·企业奇门接口明细
- API:wdt.stock.transfer.query
- NAME:查询调拨单
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
start_time | 开始时间 | {{LAST_SYNC_TIME datetime}} | 增量获取数据,start_time作为开始时间,格式:yyyy-MM-dd HH:mm:ss |
end_time | 结束时间 | {{CURRENT_TIME datetime}} | 增量获取数据,end_time作为结束时间,格式:yyyy-MM-dd HH:mm:ss |
from_warehouse_no | 源仓库 | | 代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置),用于获取指定仓库单据数据信息(不支持一次推送多个仓库编号) |
to_warehouse_no | 目标仓库 | | 代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置),用于获取指定仓库单据数据信息(不支持一次推送多个仓库编号) |
status | 调拨单状态 | 90 | 调拨单状态10已取消 20编辑中 30待审核 40已审核 42出库单待推送 44出库单推送失败 46待出库 50部分出库 60全部出库 62入库单待推送 64入库单推送失败 66待入库 70部分入库 80待结算 90调拨完成 (不传该字段默认返回全部状态的单据) |
type | 调拨类型 | type | |
mode | 调拨模式 | mode | |
page_size | 分页大小 | {{PAGINATION_PAGE_SIZE}} | 每页返回的数据条数,输入值范围1100,不传本参数,输入值默认为40,使用举例单击这里 |
page_no | 页号 | {{PAGINATION_START_PAGE}} | 不传值默认从0页开始 |
响应参数
接口字段 | 字段名称 | 预设值 | 描述 |
transfer_id | 调拨主键id | | 调拨主键id |
transfer_no | 调拨单号 | | 系统调拨单的编号,默认TF开头 |
type | 调拨类型 | 1 | 调拨类型(0:分步调拨,1:快速调拨) |
mode | 调拨模式 | 0,2 | 调拨模式(0单品调拨 1货位调拨 2明细调拨) |
from_warehouse_no | 源仓库 | | 源仓库编号,代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置) |
to_warehouse_no | 目标仓库 | | 目标仓库编号,代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置) |
rec_id | 主键 | | 主键 |
lock_id | 锁定策略ID | | 锁定策略ID |
api_outer_no | 接口外部单号 | | 接口外部单号 |
from_wms_order_no | 递交的出库仓库内的单号 | | 递交的出库仓库内的单号 |
outer_no2 | 递交的入库委外单号 | | 递交的入库委外单号 |
to_wms_order_no | 递交的入库仓库内的单号 | | 递交的入库仓库内的单号 |
error_info | 仓储错误信息 | | 仓储错误信息 |
wms_status | 操作状态 | | 操作状态 |
from_warehouse_id | 调出仓库 | | 调出仓库 |
to_warehouse_id | 目标仓库 | | 目标仓库,货位调拨时,与from_warehouse_id相等 |
address | 目标仓库地址 | | 目标仓库地址 |
logistics_id | 物流方式 | | 物流方式 |
out_goods_amount | 调出货品金额 | | 调出货品金额(成本价之和) |
in_goods_amount | 调入货品金额( | | 调入货品金额(成本价之和) |
note_count | 便签条数 | | 便签条数 |
flag_id | 标记 | | 标记 |
status | 调拨单状态 | | 调拨单状态10已取消 20编辑中 30待审核 40已审核 42出库单待推送 44出库单推送失败 46待出库 50部分出库 60全部出库 62入库单待推送 64入库单推送失败 66待入库 70部分入库 80待结算 90调拨完成 |
outer_no | 外部单号 | | 外部单号 |
creator_id | 制单员ID | | 制单员ID |
creator_name | 制单人姓名 | | 调拨单管理的“创建者”字段 |
contact | 联系人 | | 联系人 |
telno | 联系电话 | | 联系电话 |
logistics_type | 物流类型 | | 物流类型 |
logistics_no | 物流编号 | | 代表物流所有属性的唯一编码,用于物流区分,ERP内支持自定义(ERP物流界面设置) |
logistics_name | 物流名称 | | 旺店通里设置的物流公司名称 |
logistics_code | 物流单号 | | 物流公司的运单号 |
goods_count | 货品数量 | | 货品数量 |
goods_type_count | 货品种类数量 | | 调拨单管理界面的“货品种类”字段 |
goods_in_count | 入库数量 | | 入库数量 |
goods_out_count | 出库数量 | | 出库数量 |
modified | 最后修改时间 | | 最后修改时间,格式:YYYY-MM-DD HH:MM:SS |
created | 创建时间 | | 创建时间,格式:YYYY-MM-DD HH:MM:SS |
remark | 备注 | | 备注 |
to_warehouse_address | 目标仓库地址 | | 目标仓库地址 |
details_list | sku详情节点 | | sku详情节点 |
details_list.transfer_id | 调拨主键id | | 调拨主键id |
details_list.rec_id | 调拨明细主键id | | 调拨明细主键id |
details_list.goods_no | 货品编号 | | 代表SPU所有属性的唯一编号,用于系统货品的区分,SPU概念介绍,单击这里 |
details_list.spec_no | 商家编码 | | 代表所单品(sku)所有属性的唯一编码,用于获取系统单品的数据,SKU概念介绍,单击这里 |
details_list.spec_code | 规格码 | | 规格码 |
details_list.spec_name | 规格名称 | | 规格名称 |
details_list.unit | 单位 | | 单位 |
details_list.num2 | 辅助数量 | | 辅助数量 |
details_list.spec_id | 货品规格 | | 货品规格 |
details_list.cost_diff | 计算平均成本价时的精度丢失 | | 计算平均成本价时的精度丢失 |
details_list.flag_id | 标记 | | 标记 |
details_list.modified | 最后修改时间 | | 最后修改时间 |
details_list.created | 创建时间 | | 创建时间 |
details_list.barcode | 条码 | | 条码 |
details_list.out_cost_total | 调出总成本 | | 调出总成本 |
details_list.batch_id | 批次ID | | 批次ID |
details_list.batch_no | 货品批次 | | 货品批次 |
details_list.batch_remark | 批次备注 | | 批次备注 |
details_list.from_position | 源货位 | | 源货位 |
details_list.to_position | 目标货位 | | 目标货位 |
details_list.expire_date | 有效期 | | 有效期 |
details_list.stock_num | 库存 | | 调拨时的库存(显示用,不做依据) |
details_list.num | 调拨数量 | | 调拨数量 |
details_list.out_num | 出库数量 | | 出库数量 |
details_list.in_num | 入库数量 | | 入库数量 |
details_list.unit_name | 基本单位 | | 基本单位 |
details_list.aux_unit_name | 辅助单位 | | 辅助单位 |
details_list.aux_num | 辅助数量 | | 辅助数量 |
details_list.remark | 备注 | | 备注 |
金蝶云星空接口明细
- 调用接口:batchSave
- 接口名称:调拨单新增
- 方法:POST
请求参数
字段 | 字段名称 | 类型 | 配置值 |
FBillNo | 单据编号 | string | {{transfer_no}} |
FBillTypeID | 单据类型 | string | {{mode}} |
FBizType | 业务类型 | string | NORMAL |
FTransferDirect | 调拨方向 | string | GENERAL |
FTransferBizType | 调拨类型 | string | InnerOrgTransfer |
FSaleOrgId | 销售组织 | string | |
FSettleOrgId | 结算组织 | string | |
FStockOutOrgId | 调出库存组织 | string | 100 |
FOwnerTypeOutIdHead | 调出货主类型 | string | BD_OwnerOrg |
FOwnerOutIdHead | 调出货主 | string | 100 |
FStockOrgId | 调入库存组织 | string | 100 |
FSETTLECURRID | 结算币别 | string | |
FDate | 日期 | string | {{created}} |
FNote | 备注 | string | |
FBillEntry | 明细信息 | array | |
FBillEntry.FMaterialId | 物料编码 | string | {{details_list.spec_no}} |
FBillEntry.FCMKBarCode | 零售条形码 | string | |
FBillEntry.FQty | 调拨数量 | string | {{details_list.num}} |
FBillEntry.FLot | 调出批号 | string | |
FBillEntry.FSrcStockId | 调出仓库 | string | {{from_warehouse_no}} |
FBillEntry.FSrcStockLocId | 调出仓位 | string | |
FBillEntry.FDestStockId | 调入仓库 | string | {{to_warehouse_no}} |
FBillEntry.FDestStockLocId | 调入仓位 | string | |
FBillEntry.FNoteEntry | 备注 | string | |
FBillEntry.FISFREE | 赠品 | string | |
FBillEntry.F_wk_WDTDH | 旺店通调拨单号 | string | {{transfer_no}} |
FBillEntry.FormId | 业务对象表单Id | string | STK_TransferDirect |
FBillEntry.IsAutoSubmitAndAudit | 提交并审核 | bool | true |
FBillEntry.IsVerifyBaseDataField | 验证基础资料 | bool | false |
FBillEntry.Operation | 执行的操作 | string | Save |
系统对接概况
随着企业数字化业务的深入发展,对于企业的 IT 或者 CIO 来讲,正在面临一个愈发重要的问题——系统的结构太复杂了,尤其是头部企业,至少有十多套系统,这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统,如何整合企业的现有IT资源,使企业中计算机孤岛式的应用向集体协作的方向发展,发挥资源效益的最大化,降低企业成本,正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上,操作统一,以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中,轻易云应用集成平台负责实现异构、分布式系统之间互联互通,实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件,连接现有各孤立应用系统,以图形化、拖拽方式构建集成流程和服务,提高应用系统集成工作效率,降低异构系统集成风险。针对未来可能出现的业务需求变更,在应用集成平台上进行动态调整,实现各应用系统之间的集成策略平滑升级。
