金蝶云星空和旺店通·企业奇门接口打通对接实战

源系统:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
集成系统:旺店通·企业奇门
旺店通是北京掌上先机网络科技有限公司旗下品牌,国内的零售云服务提供商,基于云计算SaaS服务模式,以体系化解决方案,助力零售企业数字化智能化管理升级。为零售电商企业的订单管理及仓储管理提供解决方案,致力于帮助企业实现数字化转型,企业规模化发展
接口方案配置
通过可视化界面的拖、拉、拽即可轻松快速构建数据集成流程,将金蝶云星空、旺店通·企业奇门之间接口数据联通,支持数据在线预览、数据集成流程全过程调试,Web界面追踪调试日志等功能。 平台兼具实时数据处理和数据集成分发功能,用户通过可视化的拖、拽即可完成数据处理逻辑,将数据加工处理后分发到下游业务系统或其他异构存储中。



金蝶云星空接口明细
- 接口:executeBillQuery
- 接口名称:销售订单查询
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
FBillTypeID_FNumber | 单据类型 | string | 单据类型 |
FBillNo | 单据编号 | string | 单据编号 |
FDate | 日期 | string | 日期 |
FSaleOrgId_FNumber | 销售组织 | string | 组织 |
FCustomerID_FNumber | 客户编码 | string | 基础资料 |
FCustomerID_FName | 客户名称 | string | 基础资料 |
FCarriageNO | 运输单号 | string | 文本 |
FStockOrgId_FNumber | 发货组织 | string | 组织 |
FLinkPhone | 联系电话 | string | 文本 |
FLinkMan | 收货人姓名 | string | 文本 |
FReceiveAddress | 收货方地址 | string | 文本 |
FSettleTypeID_FNumber | 结算方式 | string | 基础资料 |
FReceiverAddress | 收货人地址 | string | 文本 |
FReceiverMobile | 收货人手机 | string | 文本 |
FReceiverCountry | 收货人国家 | string | 文本 |
FReceiverState | 收货人省份 | string | 文本 |
FReceiverCity | 收货人城市 | string | 文本 |
FReceiverDistrict | 收货人地区 | string | 文本 |
FReceiverPhone | 收货人电话 | string | 文本 |
FSHOPNUMBER | 网店编码 | string | 文本 |
FSALECHANNEL | 销售渠道 | string | 文本 |
FVIPCODE | 会员编码 | string | 文本 |
FCustMatID_FNumber | 客户物料编码 | string | 基础资料 |
FMaterialID_FNumber | 物料编码 | string | 基础资料 |
FBarcode | 零售条形码 | string | 文本 |
FMustQty | 应发数量 | string | 数量 |
FRealQty | 实发数量 | string | 数量 |
FPrice | 单价 | string | 单价 |
FTaxPrice | 含税单价 | string | 单价 |
FIsFree | 是否赠品 | string | 复选框 |
FLot | 批号 | string | 批次 |
FProduceDate | 生产日期 | string | 日期 |
FExpiryDate | 有效期至 | string | 日期 |
FEntryTaxRate | 税率% | string | 小数 |
FEntryTaxAmount | 税额 | string | 金额 |
FAmount | 金额 | string | 金额 |
FAllAmount | 价税合计 | string | 金额 |
FStockID_FNumber | 仓库 | string | 基础资料 |
FStockStatusID_FNumber | 库存状态 | string | 基础资料 |
FMtoNo | 计划跟踪号 | string | 文本 |
FEntrynote | 备注 | string | 文本 |
FSrcType | 源单类型 | string | 源单类型 |
FSrcBillNo | 源单编号 | string | 源单编号 |
FSoorDerno | 订单单号 | string | 文本 |
FDiscountRate | 折扣率% | string | 小数 |
FDiscount | 折扣额 | string | 折扣额 |
FPriceDiscount | 单价折扣 | string | 单价 |
FSOEntryId | 销售订单EntryId | string | 整数 |
FB2CORDERDETAILID | B2C订单明细Id | string | 整数 |
FThirdEntryId | 管易订单单号 | string | 文本 |
FETHIRDBILLID | 第三方单据ID | string | 文本 |
FETHIRDBILLNO | 第三方单据编号 | string | 文本 |
FGYFINDate | 管易到账时间 | string | 长日期 |
F_VTRK_Text10 | 是否完成同步 | string | |
F_VTRK_Text6 | 旺店通编码 | string | |
F_VTRK_Text9 | 外机物料编码 | string | |
F_VTRK_Text | 合同号 | string | |
F_VTRK_Text1 | 收货联系人 | string | |
F_VTRK_Text2 | 收货电话 | string | |
F_VTRK_Text3 | 收货地点 | string | |
F_VTRK_Text4 | 物流单号 | string | |
F_VTRK_Text5 | 旺店通出库单号 | string | |
F_VTRK_Text11 | 省 | string | |
F_VTRK_Text12 | 市 | string | |
F_VTRK_Text13 | 区 | string | |
F_VTRK_Text8 | 旺店通编码 | string | |
FMaterialName | 物料名称 | string | |
FID | 主键ID | string | |
FEntity_FENTRYID | 明细id | string | |
Limit | 最大行数 | string | 金蝶的查询分页参数 |
StartRow | 开始行索引 | string | 金蝶的查询分页参数 |
TopRowCount | 返回总行数 | int | 金蝶的查询分页参数 |
FilterString | 过滤条件 | string | 示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= |
FieldKeys | 需查询的字段key集合 | array | 金蝶分录主键ID格式:FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber |
FormId | 业务对象表单Id | string | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
响应参数
字段 | 名称 | 类型 | 描述 |
FBillTypeID_FNumber | 单据类型 | string | 单据类型 |
FBillNo | 单据编号 | string | 单据编号 |
FDate | 日期 | string | 日期 |
FSaleOrgId_FNumber | 销售组织 | string | 组织 |
FCustomerID_FNumber | 客户编码 | string | 基础资料 |
FCustomerID_FName | 客户名称 | string | 基础资料 |
FCarriageNO | 运输单号 | string | 文本 |
FStockOrgId_FNumber | 发货组织 | string | 组织 |
FLinkPhone | 联系电话 | string | 文本 |
FLinkMan | 收货人姓名 | string | 文本 |
FReceiveAddress | 收货方地址 | string | 文本 |
FSettleTypeID_FNumber | 结算方式 | string | 基础资料 |
FReceiverAddress | 收货人地址 | string | 文本 |
FReceiverMobile | 收货人手机 | string | 文本 |
FReceiverCountry | 收货人国家 | string | 文本 |
FReceiverState | 收货人省份 | string | 文本 |
FReceiverCity | 收货人城市 | string | 文本 |
FReceiverDistrict | 收货人地区 | string | 文本 |
FReceiverPhone | 收货人电话 | string | 文本 |
FSHOPNUMBER | 网店编码 | string | 文本 |
FSALECHANNEL | 销售渠道 | string | 文本 |
FVIPCODE | 会员编码 | string | 文本 |
FCustMatID_FNumber | 客户物料编码 | string | 基础资料 |
FMaterialID_FNumber | 物料编码 | string | 基础资料 |
FBarcode | 零售条形码 | string | 文本 |
FMustQty | 应发数量 | string | 数量 |
FRealQty | 实发数量 | string | 数量 |
FPrice | 单价 | string | 单价 |
FTaxPrice | 含税单价 | string | 单价 |
FIsFree | 是否赠品 | string | 复选框 |
FLot | 批号 | string | 批次 |
FProduceDate | 生产日期 | string | 日期 |
FExpiryDate | 有效期至 | string | 日期 |
FEntryTaxRate | 税率% | string | 小数 |
FEntryTaxAmount | 税额 | string | 金额 |
FAmount | 金额 | string | 金额 |
FAllAmount | 价税合计 | string | 金额 |
FStockID_FNumber | 仓库 | string | 基础资料 |
FStockStatusID_FNumber | 库存状态 | string | 基础资料 |
FMtoNo | 计划跟踪号 | string | 文本 |
FEntrynote | 备注 | string | 文本 |
FSrcType | 源单类型 | string | 源单类型 |
FSrcBillNo | 源单编号 | string | 源单编号 |
FSoorDerno | 订单单号 | string | 文本 |
FDiscountRate | 折扣率% | string | 小数 |
FDiscount | 折扣额 | string | 折扣额 |
FPriceDiscount | 单价折扣 | string | 单价 |
FSOEntryId | 销售订单EntryId | string | 整数 |
FB2CORDERDETAILID | B2C订单明细Id | string | 整数 |
FThirdEntryId | 管易订单单号 | string | 文本 |
FETHIRDBILLID | 第三方单据ID | string | 文本 |
FETHIRDBILLNO | 第三方单据编号 | string | 文本 |
FGYFINDate | 管易到账时间 | string | 长日期 |
F_VTRK_Text10 | 是否完成同步 | string | |
F_VTRK_Text6 | 旺店通编码 | string | |
F_VTRK_Text9 | 外机物料编码 | string | |
F_VTRK_Text | 合同号 | string | |
F_VTRK_Text1 | 收货联系人 | string | |
F_VTRK_Text2 | 收货电话 | string | |
F_VTRK_Text3 | 收货地点 | string | |
F_VTRK_Text4 | 物流单号 | string | |
F_VTRK_Text5 | 旺店通出库单号 | string | |
F_VTRK_Text11 | 省 | string | |
F_VTRK_Text12 | 市 | string | |
F_VTRK_Text13 | 区 | string | |
F_VTRK_Text8 | 旺店通编码 | string | |
FMaterialName | 物料名称 | string | |
FID | 主键ID | string | |
FEntity_FENTRYID | 明细id | string | |
旺店通·企业奇门接口明细
- 调用接口:wdt.trade.push
- 接口名称:创建原始订单
- 方法:POST
请求参数
字段 | 字段名称 | 类型 | 配置值 |
tid | 原始单号 | string | {{details_list.F_VTRK_Text}} |
trade_status | 平台状态 | string | 30 |
pay_status | 支付状态 | string | 2 |
delivery_term | 发货条件 | string | 1 |
trade_time | 下单时间 | string | {{FDate}} |
pay_time | 支付时间 | string | {{FDate}} |
fenxiao_type | 分销类别 | string | |
purchase_id | 采购单ID | string | |
fenxiao_nick | 分销商id | string | |
buyer_nick | 客户网名 | string | {{FCustomerID_FName}} |
buyer_email | 买家email | string | |
pay_id | 支付单号 | string | |
pay_account | 支付账号 | string | |
receiver_name | 收件人 | string | {{details_list.F_VTRK_Text1}} |
receiver_address | 地址详情 | string | {{details_list.F_VTRK_Text3}} |
receiver_province | 省份 | string | {{details_list.F_VTRK_Text11}} |
receiver_city | 城市 | string | {{details_list.F_VTRK_Text12}} |
receiver_district | 区县 | string | {{details_list.F_VTRK_Text13}} |
receiver_mobile | 手机 | string | {{details_list.F_VTRK_Text2}} |
receiver_telno | 电话 | string | {{FLINKPHONE}} |
receiver_zip | 邮编 | string | |
logistics_type | 物流方式 | string | -1 |
invoice_kind | 发票类别 | string | |
invoice_title | 发票抬头 | string | |
invoice_content | 发票内容 | string | |
remark_flag | 客户备注标旗 | string | |
buyer_message | 买家备注 | string | |
seller_memo | 客服备注 | string | 金蝶测试单据 |
seller_flag | 标旗 | string | |
post_amount | 邮费 | string | |
cod_amount | 货到付款金额 | string | |
ext_cod_fee | 货到付款买家费用 | string | |
other_amount | 其它收费 | string | |
paid | 已付 | string | |
is_auto_wms | 自动流转模式 | string | |
warehouse_no | 仓库编号 | string | {{FStockID_FNumber}} |
order_list | 订单货品明细节点 | array | details_list |
order_list.oid | 子订单编号 | string | {{FBillNo}} |
order_list.num | 数量 | string | {{details_list.FRealQty}} |
order_list.price | 单价 | string | {{details_list.FTaxPrice}} |
order_list.status | 状态 | string | 30 |
order_list.refund_status | 退款状态 | string | |
order_list.goods_id | 平台货品ID | string | {{details_list.FMaterialID_FNumber}} |
order_list.spec_id | 平台规格ID | string | {{details_list.FMaterialID_FNumber}} |
order_list.goods_no | 货品编码 | string | {{details_list.FMaterialID_FNumber}} |
order_list.spec_no | 规格编码 | string | |
order_list.goods_name | 货品名称 | string | |
order_list.spec_name | 规格名称 | string | |
order_list.adjust_amount | 调整 | string | |
order_list.discount | 优惠 | string | |
order_list.share_discount | 分摊优惠 | string | |
order_list.remark | 备注 | string | |
order_list.cid | 类目 | string | |
order_list.trade_list | trade_list | string | |
order_list.shop_no | shop_no | string | {{F_ora_Assistant}} |
order_list.switch | switch | string | 1 |
数据对接价值
当企业规模逐渐增大时,作为支撑业务运营的IT建设也变得越来越重要,不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程,这样的结果就是,企业上的IT系统很多很全,从ERP到HR、CRM、PDM、OA等,貌似所有的业务都覆盖到了,但实际上因为这些系统的不集成,而形成了企业很多新的信息孤岛,非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看,也不可避免会遇到上述问题,毕竟企业经营的多样化,并不是所有的业务都能在一个系统中完成,所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升API利用率,发挥业务系统价值,实现企业IT资产的可插拔、可复用、可组成。
