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

源系统:管易云·奇门

管易云是金蝶旗下专注提供电商企业管理软件服务的子品牌，先后开发了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发货状态string1 order_state订单类型string warehouse_code仓库代码string shop_code店铺代码stringHUKE163 vip_name会员名称string platform_code平台单号string receiver_mobile收件手机string code单据编号string has_cancel_data是否附带返回已取消与已删除的订单数据string page_no页号string{{PAGINATION_START_PAGE}} page_size分页大小string10

响应参数

字段字段名称类型配置值 ididstring 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-OutStockSaleOrder-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业务对象表单IdSAL_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架构。