管易云·奇门和金蝶云星空接口打通对接实战

源系统:管易云·奇门
管易云是金蝶旗下专注提供电商企业管理软件服务的子品牌,先后开发了C-ERP、EC-OMS、EC-WMS、E店管家、BBC、B2B、B2C商城网站建设等产品和服务,涵盖电商业务全流程。
接入系统:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践,面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司,提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于:集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
多系统对接方案配置
通过轻易云系统数据集成平台新增创建集成方案,通过轻易云的方案市场可以一键复制,并且可以借鉴其他的方案配置完成方案制作,方案制作只需要两步,第一步先确定好对应的数据来源;源系统:管易云·奇门接口:订单查询通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统:金蝶云星空接口:销售出库新增,通过写入调度者匹配获取到的数据和写入的映射关系,即可自动生成符合目标系统:金蝶云星空写入的数据自动产生写入队列,通过运行概况,系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况



管易云·奇门接口明细
- 调用接口:gy.erp.trade.deliverys.get
- 接口名称:订单查询
- 方法:POST
请求参数
字段 | 字段名称 | 类型 | 配置值 |
start_delivery_date | 开始时间 | string | {{LAST_SYNC_TIME datetime}} |
end_delivery_date | 结束时间 | string | {{CURRENT_TIME datetime}} |
delivery | 发货状态 | string | 1 |
order_state | 订单类型 | string | |
warehouse_code | 仓库代码 | string | |
shop_code | 店铺代码 | string | HUKE163 |
vip_name | 会员名称 | string | |
platform_code | 平台单号 | string | |
receiver_mobile | 收件手机 | string | |
code | 单据编号 | string | |
has_cancel_data | 是否附带返回已取消与已删除的订单数据 | string | |
page_no | 页号 | string | {{PAGINATION_START_PAGE}} |
page_size | 分页大小 | string | 10 |
响应参数
字段 | 字段名称 | 类型 | 配置值 |
id | id | string | |
hold_info | 拦截信息 | string | |
code | 单据编号 | string | |
tax_amount | 税额 | string | |
payment | 支付金额 | string | |
approve | 是否审核 | string | |
cod | 是否货到付款 | string | |
vipIdCard | 身份证号 | string | |
vipEmail | 电子邮箱 | string | |
vipRealName | 真实姓名 | string | |
accountStatus | 到账状态 | string | |
accountAmount | 到账金额 | string | |
assignState | 配货状态 | string | |
platform_code | 平台单号 | string | |
createtime | 创建时间 | string | |
modifytime | 修改时间 | string | |
dealtime | 拍单时间 | string | |
paytime | 支付时间 | string | |
shop_name | 店铺名称 | string | |
shop_code | 店铺代码 | string | |
warehouse_name | 仓库名称 | string | |
warehouse_code | 仓库代码 | string | |
express_name | 快递公司名称 | string | |
express_code | 快递公司代码 | string | |
vip_name | 会员名称 | string | |
vip_code | 会员代码 | string | |
receiver_name | 收货人姓名 | string | |
receiver_phone | 收货人电话 | string | |
receiver_mobile | 收货人手机 | string | |
receiver_zip | 收货邮编 | string | |
receiver_address | 收货地址 | string | |
receiver_area | 地区信息 | string | |
buyer_memo | 买家留言 | string | |
seller_memo | 卖家备注 | string | |
seller_memo_late | 二次备注 | string | |
cod_fee | 货到付款服务费 | string | |
post_cost | 物流成本 | string | |
weight_origin | 标准重量 | string | |
payment_amount | 商品总金额 | string | |
business_man | 业务员 | string | |
extend_memo | 附加信息 | string | |
delivery_state | 发货状态 | string | |
order_type_name | 订单类型 | string | |
platform_flag | 平台旗帜 | string | |
approveDate | 审核时间 | string | |
accountDate | 到账时间 | string | |
trade_tag_code | 订单标记代码 | string | |
trade_tag_name | 订单标记名称 | string | |
plan_delivery_date | 预计发货时间 | string | |
platform_trading_state | 平台交易状态 | string | |
substitut_order | 非代发 | string | |
details | 商品列表 | array | |
details.oid | 子订单号 | string | |
details.qty | 数量 | string | |
details.price | 实际单价 | string | |
details.amount | 实际金额 | string | |
details.note | 备注 | string | |
details.cancel | 是否取消 | string | |
details.item_code | 商品代码 | string | |
details.item_name | 商品名称 | string | |
details.item_simple_name | 商品简称 | string | |
details.sku_name | 规格名称 | string | |
details.sku_code | 规格代码 | string | |
details.post_fee | 物流费用 | string | |
details.discount_fee | 让利金额 | string | |
details.amount_after | 让利后金额 | string | |
details.refund | 退款状态 | string | |
details.platform_item_name | 平台规格名称 | string | |
details.platform_sku_name | 平台规格代码 | string | |
details.sku_note | 商品备注 | string | |
金蝶云星空接口明细
- API:batchSave
- NAME:销售出库新增
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
FBillTypeID | 单据类型 | XSCKD01_SYS | 单据类型 |
FBillNo | 单据编号 | {{platform_code}} | 单据编号 |
FDate | 日期 | {{modify_date}} | 日期 |
FSaleOrgId | 销售组织 | 100 | 组织 |
FCustomerID | 客户 | findCollection find buyerCid from 9deeb3b8-afc0-3cbd-a450-7eb3abdba108 where buyerNick={{receiver_name}} | 基础资料 |
FStockOrgId | 发货组织 | 100 | 组织 |
FNote | 备注 | {{extend_memo}} | 多行文本 |
F_mhgj_Assistant | 管易订单类型 | {{order_type_name}} | 多行文本 |
SubHeadEntity | 财务信息 | | |
SubHeadEntity.FSettleOrgID | 结算组织 | 100 | 组织 |
SubHeadEntity.FSETTLECURRID | 结算币别 | PRE001 | 基础资料 |
SubHeadEntity.FEntity | 明细信息 | details | |
SubHeadEntity.FEntity.FMaterialID | 物料编码 | {{details.item_code}} | 基础资料 |
SubHeadEntity.FEntity.FRealQty | 实发数量 | {{details.qty}} | 数量 |
SubHeadEntity.FEntity.FTaxPrice | 含税单价 | {{details.price}} | 单价 |
SubHeadEntity.FEntity.FIsFree | 是否赠品 | _function case '{{details.price}}' when '0.0' then true else false end | 复选框 |
SubHeadEntity.FEntity.FLot | 批号 | | 批次 |
SubHeadEntity.FEntity.FStockID | 仓库 | 01 | 基础资料 |
SubHeadEntity.FEntity.FOwnerTypeId | 货主类型 | BD_OwnerOrg | |
SubHeadEntity.FEntity.FOwnerId | 货主 | 100 | |
SubHeadEntity.FEntity.FEntrynote | 备注 | {{seller_memo}} | 文本 |
SubHeadEntity.FEntity.FSRCTYPE | 源单类型 | SAL_SaleOrder | |
SubHeadEntity.FEntity.FSRCBillNo | 源单编号 | findCollection find FBillNo from 3aabbca2-e544-3a94-9b21-7fc60c89a796 where FBillNo={{platform_code}} | |
SubHeadEntity.FEntity.FEntity_Link | 关联关系表 | | |
SubHeadEntity.FEntity.FEntity_Link.FEntity_Link_FRuleId | 转换规则 | SaleOrder-OutStock | SaleOrder-OutStock T_SAL_ORDERENTRY DeliveryNotice-OutStock T_SAL_DELIVERYNOTICEENTRY |
SubHeadEntity.FEntity.FEntity_Link.FEntity_Link_FSTableName | 源单表 | T_SAL_ORDERENTRY | |
SubHeadEntity.FEntity.FEntity_Link.FEntity_Link_FSBillId | 源单内码 | _findCollection find FID from 3aabbca2-e544-3a94-9b21-7fc60c89a796 where FBillNo={{platform_code}} | |
SubHeadEntity.FEntity.FEntity_Link.FEntity_Link_FSId | 源单分录内码 | _findCollection find FSaleOrderEntry_FEntryID from 3aabbca2-e544-3a94-9b21-7fc60c89a796 where FBillNo={{platform_code}} FMaterialId_Fnumber={{details.item_code}} | |
SubHeadEntity.FEntity.F_UROZ_Text | 物流单号 | {{express_no}} | 多行文本 |
SubHeadEntity.FEntity.FormId | 业务对象表单Id | SAL_OUTSTOCK | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
SubHeadEntity.FEntity.Operation | 执行的操作 | Save | |
SubHeadEntity.FEntity.IsAutoSubmitAndAudit | 提交并审核 | true | |
SubHeadEntity.FEntity.IsVerifyBaseDataField | 验证基础资料 | false | 是否验证所有的基础资料有效性,布尔类,默认false(非必录) |
SubHeadEntity.FEntity.SubSystemId | 系统模块 | 21 | 默认仓库模块 |
系统对接概况
从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通管易云·奇门到金蝶云星空之间数据集成;通过API连接各业务系统,复用已有的业务系统能力,让集成架构、服务关系更清晰。使用统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升复用率和价值。全面管控企业的API资产,梳理现有业务系统的API。实现API文档的统一管理,建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+,快速对接各种API接口,实现云上云下的互联互通。将SaaS和本地业务系统联接起来,打破时间与空间界限,打通原有核心数据及SaaS应用,构建可平滑演进的企业IT架构。


