管易云和金蝶云星空集成接口设计

管易云和金蝶云星空集成接口设计

对接源平台:管易云

管易云是金蝶旗下专注提供电商企业管理软件服务的子品牌，先后开发了C-ERP、EC-OMS、EC-WMS、E店管家、BBC、B2B、B2C商城网站建设等产品和服务，涵盖电商业务全流程。

集成系统:金蝶云星空

金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。

数据集成方案配置

轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线，所以对接方案的配置极其重要，方案可以选择一键复制，轻易云有海量的对接方案可支持一键复制，复制后直接启动使用（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置，配置只要确认源平台：管易云的取数逻辑，例如什么时间取什么样的数据。即可完成配置，目标平台：金蝶云星空，把获取的数据组装成目标系统需要的格式进行写入。通过该系统数据集成平台的能力，可以集成的应用系统包括CRM、ERP、钉钉、企业微信、MES、飞书、用友、金蝶等 177 个不同应用系统之间的无代码接口集成，并且每周都在增加新的应用系统接入。

管易云接口明细

• 接口：gy.erp.trade.get
• 接口名称：订单查询
• 接口方法：POST

请求参数

字段名称类型 date_type时间类型string order_state订单类型string platform_code平台单号string vip_name会员名称string page_size分页大小string shop_code店铺代码string warehouse_code仓库代码string page_no页号string end_date结束时间string code单据编号string receiver_mobile收件手机string start_date开始时间string has_cancel_data是否附带返回已取消与已删除的订单数据string

响应参数

字段名称类型描述 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

请求参数

接口字段名称预设值 FID实体主键 FBillNo单据编号 FDOCUMENTSTATUS单据状态 FCreatorId创建人 FAPPROVERID审核人 FCreateDate创建日期 FSETTLEORGID结算组织 FApproveDate审核日期 FPURCHASEORGID采购组织 FPAYTOTALAMOUNTFOR_H表头-应付金额 FCURRENCYID币别 FDATE业务日期 FModifyDate修改日期 FModifierId修改人 FWRITTENOFFSTATUS核销状态 FBillTypeID单据类型 FPURCHASERID采购员 FPURCHASERGROUPID采购组 FPURCHASEDEPTID采购部门 FREALPAYAMOUNTFOR_H表头-实付金额 FACCOUNTSYSTEM会计核算体系 FCancellerId作废人 FCancelStatus作废状态 FCancelDate作废日期 FCONTACTUNITTYPE往来单位类型 FCONTACTUNIT往来单位 FRECTUNITTYPE收款单位类型 FRECTUNIT收款单位 FSOURCESYSTEM来源系统 FBUSINESSTYPE业务类型 FISINIT是否期初单据 FDepartment部门 FPAYORGID付款组织 FISSAMEORG是否相同组织 FIsCredit是否信贷业务 FSETTLERATE结算汇率 FPAYAMOUNTFOR付款金额 FEXCHANGETYPE汇率类型 FMAINBOOKID本位币 FSETTLECUR结算币别 FPAYTOTALAMOUNT_H表头-应付金额本位币 FPAYAMOUNT表头-付款金额本位币 FREALPAYAMOUNT_H表头-实付金额本位币 FEXCHANGERATE汇率 FScanPoint扫描点 FIsWriteOff是否转销 FMatchMethodID核销方式 FREALPAY实报实付 FREMARK备注 FBookingDate期望付款日期 FTHIRDBILLNO第三方单据编号 FWBSETTLENO流水号 FSETTLEMAINBOOKID结算本位币 FSETTLEEXCHANGETYPE结算汇率类型 FISCASHPURCHASE现购 FOUTCONTACTID转出往来单位 FOUTCONTACTTYPE转出往来单位类型 FIsBorrow是否其他预付 FISFROMTRADEBANK来源交易明细 FGYACCOUNTWATERID管易财务流水内码 FISCARRYRATE是否下推携带汇率到结算汇率 FGYSHOPNAME管易对应店铺 FGYCUSTOMERID管易对应客户 FMoreReceive多收款人 FPRESETASSISTANT1预设辅助资料字段1 FPRESETASSISTANT2预设辅助资料字段2 FPRESETTEXT1预设文本字段1 FPRESETTEXT2预设文本字段2 FPRESETBASE1预设基础资料字段1 FPRESETBASE2预设基础资料字段2 F_amount合同金额 Fsht_payment_per1第一期付款比例% Fsht_payment_per2第二期付款比例% Fsht_payment_per3第三期付款比例% Fsht_payment_per4第四期付款比例% Fsht_payment_per5第五期付款比例% F_sht_Decimal第一期付款金额 F_sht_Decimal1第二期付款金额 F_sht_Decimal2第三期付款金额 F_sht_Decimal3第四期付款金额 F_sht_Decimal4第五期付款金额 F_sht_FKYT付款用途 F_billreceipt发票i情况 FPAYBILLENTRY付款单明细 FPAYBILLENTRY.FEntryID实体主键 FPAYBILLENTRY.FSETTLETYPEID结算方式 FPAYBILLENTRY.FSETTLEPAYAMOUNTFOR折后金额 FPAYBILLENTRY.FSETTLEDISTAMOUNTFOR现金折扣 FPAYBILLENTRY.FPAYTOTALAMOUNTFOR表体-应付金额 FPAYBILLENTRY.FSETTLEPAYAMOUNT折后金额本位币 FPAYBILLENTRY.FSETTLEDISTAMOUNT现金折扣本位币 FPAYBILLENTRY.FPAYTOTALAMOUNT表体-应付金额本位币 FPAYBILLENTRY.FWRITTENOFFSTATUS_D表体明细-核销状态 FPAYBILLENTRY.FWRITTENOFFAMOUNTFOR_D表体明细-已核销金额 FPAYBILLENTRY.FOPPOSITEBANKACCOUNT对方银行账号 FPAYBILLENTRY.FCOMMENT备注 FPAYBILLENTRY.FOPPOSITECCOUNTNAME对方账户名称 FPAYBILLENTRY.FPAYITEM采购订单 FPAYBILLENTRY.FHANDLINGCHARGEFOR手续费 FPAYBILLENTRY.FHANDLINGCHARGE手续费本位币 FPAYBILLENTRY.FREALPAYAMOUNTFOR_D表体-实付金额 FPAYBILLENTRY.FREALPAYAMOUNT_D表体-实付金额本位币 FPAYBILLENTRY.FASSTOTALAMOUNTFOR关联金额 FPAYBILLENTRY.FPAYITEMTYPE预付项目类型 FPAYBILLENTRY.FPURCHASEORDERID采购订单ID FPAYBILLENTRY.FACCOUNTID我方银行账号 FPAYBILLENTRY.FPAYACCOUNTNAME我方账户名称 FPAYBILLENTRY.FPAYBANKID我方开户行 FPAYBILLENTRY.FOPPOSITEBANKNAME对方开户行 FPAYBILLENTRY.FSETTLENO结算号 FPAYBILLENTRY.FBLEND勾对 FPAYBILLENTRY.FPURPOSEID付款用途 FPAYBILLENTRY.FOpenAddressRec开户行地址 FPAYBILLENTRY.FRecType收款类型 FPAYBILLENTRY.FCNAPS联行号 FPAYBILLENTRY.FBankTypeRec收款银行 FPAYBILLENTRY.FProvince省 FPAYBILLENTRY.FCity城市 FPAYBILLENTRY.FDistrict地区 FPAYBILLENTRY.FUrgent加急 FPAYBILLENTRY.FSubmitStatus提交银行状态 FPAYBILLENTRY.FSubmitUser提交/撤销银行人 FPAYBILLENTRY.FSubmitBankTime提交/撤销银行时间 FPAYBILLENTRY.FBankStatus银行处理状态 FPAYBILLENTRY.FBankCode银行状态码 FPAYBILLENTRY.FINNERACCOUNTID内部账号 FPAYBILLENTRY.FINNERACCOUNTNAME内部账户名称 FPAYBILLENTRY.FCOSTID费用项目 FPAYBILLENTRY.FRefundAmount退款关联金额 FPAYBILLENTRY.FCashAccount现金账号 FPAYBILLENTRY.FPAYAMOUNTFOR_E付款金额 FPAYBILLENTRY.FPAYAMOUNT_E付款金额本位币 FPAYBILLENTRY.FISPOST是否登账 FPAYBILLENTRY.FPOSTDATE登账日期 FPAYBILLENTRY.FMATERIALID物料编码 FPAYBILLENTRY.FMATERIALNAME物料名称 FPAYBILLENTRY.FPURCHASEORDERNO采购订单号 FPAYBILLENTRY.FMATERIALSEQ采购订单行号 FPAYBILLENTRY.FORDERENTRYID采购订单明细内码 FPAYBILLENTRY.FRuZhangType入账类型 FPAYBILLENTRY.FEBMSG银企处理详细信息 FPAYBILLENTRY.FOVERSHORTAGEFOR长短款 FPAYBILLENTRY.FOVERSHORTAGE长短款本位币 FPAYBILLENTRY.FEXPENSEDEPTID_E费用承担部门 FPAYBILLENTRY.FPayType支付类型 FPAYBILLENTRY.FPRICEUNITID计价单位 FPAYBILLENTRY.FPRICE含税单价 FPAYBILLENTRY.FQTY数量 FPAYBILLENTRY.FREFUNDQTY退款关联数量 FPAYBILLENTRY.FSwiftCodeSwiftCode FPAYBILLENTRY.FWRITTENOFFAMOUNT已核销金额本位币 FPAYBILLENTRY.FCHECKCODE流水号/对账码 FPAYBILLENTRY.FTOPAYMENTAMOUNTFOR保证金转货款金额 FPAYBILLENTRY.FTaxAmt税额 FPAYBILLENTRY.FNProvince省 FPAYBILLENTRY.FNCity城市 FPAYBILLENTRY.FNDistrict地区 FPAYBILLENTRY.FBankDetail银行网点 FPAYBILLENTRY.FCountry国别 FPAYBILLENTRY.FSignature签名 FPAYBILLENTRY.FGYSALEORDERNO管易销售订单号 FPAYBILLENTRY.FReturnMsg错误码 FPAYBILLENTRY.FFinishTime付款完成时间 FPAYBILLENTRY.FDistrictCode地区码 FPAYBILLENTRY.FBANKMSG银行状态描述 FPAYBILLENTRY.FResponseTme付款回调时间 FPAYBILLENTRY.FRequestTime请求时间 FPAYBILLENTRY.FCertType收款人证件类型 FPAYBILLENTRY.FCertNum收款人证件号码 FPAYBILLENTRY.FBankInvoice银企开票 FPAYBILLENTRY.FNoteStatus电票状态 FPAYBILLENTRY.FNOTVERIFICATEAMOUNT未核销金额 FPAYBILLENTRY.FENTRYPREPAYORDERNO预付采购订单号 FPAYBILLENTRY.FIsInvoice已电票开票 FPAYBILLENTRY.FUnique行唯一标志 FPAYBILLENTRY.FTransacType交易类型 FPAYBILLENTRY.FMessageInstruct电文指示 FPAYBILLENTRY.FServiceLevel服务级别 FPAYBILLENTRY.FPayMethod付款方式 FPAYBILLENTRY.FCNYPayMethodCNY付款方式 FPAYBILLENTRY.FExContractNo兑换合约号 FPAYBILLENTRY.FCollectionCurr收款币别 FPAYBILLENTRY.FCollectionAmount收款金额 FPAYBILLENTRY.FReceiveBankBIC收款银行BIC FPAYBILLENTRY.FReceiveBankCode收款银行代码 FPAYBILLENTRY.FReceiveBranchCode收款支行代码 FPAYBILLENTRY.FServiceChargeBear手续费承担方 FPAYBILLENTRY.FServiceChargeNo手续费账号 FPAYBILLENTRY.FServiceChargeBank手续费账号银行 FPAYBILLENTRY.FServiceChargeCurr手续费币别 FPAYBILLENTRY.FCNAPSNumCNAPSNum FPAYBILLENTRY.FCNYTransactType人民币交易种类 FPAYBILLENTRY.FRMBPayMethod人民币付款方式 FPAYBILLENTRY.FByAgentBank通过代理行完成 FPAYBILLENTRY.FAgentBankAcnt代理行账号 FPAYBILLENTRY.FAgentBankName代理行名称 FPAYBILLENTRY.FAgentBankArea代理行国家\地区 FPAYBILLENTRY.FAgentSWIFTCodeSWIFT Code(代理行) FPAYBILLENTRY.FAgentBankAddress代理行地址 FPAYBILLENTRY.FReceiveBankClear收款银行本地清算码 FPAYBILLENTRY.FReceiveBranchClear收款人本地清算分行代码 FPAYBILLENTRY.FClearParameter清算要求参数 FPAYBILLENTRY.FOtherPartyAdress对方地址 FPAYBILLENTRY.FOtherPartyEmail对方邮箱 FPAYBILLENTRY.FOverseaPay境外支付 FPAYBILLENTRY.FormId业务对象表单IdAP_PAYBILL FPAYBILLENTRY.Operation执行的操作BatchSave FPAYBILLENTRY.IsAutoSubmitAndAudit提交并审核true FPAYBILLENTRY.IsVerifyBaseDataField验证基础资料false

系统集成总览

全新的API数据集成模式，赋能企业业务创新 传统企业集成主要采用点对点或ESB集成方式，基于全新API战略中台的API新型集成方式通过解耦系统资源，降低系统间对接难度，实现快速业务需求响应，提升对接效率，助力企业满足快速业务交付需求，实现业务创新。通过构建API生态，助力能力开放与共享 基于API战略中台梳理并整合内部API资源与IT资产，可实现内部资源共享，满足内部开发人员资源使用需求，例如：金蝶云星空与管易云之间数据集成；并将API资源对外可控开放，打造面向开发者的生态服务，为您打通自身和上下游合作伙伴，创造共赢价值链。开展API战略中台，重塑IT 帮助您基于内部资源构建不同业务能力中心，打造企业统一API战略中台，赋能企业发展，实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时，无需从“零”组建各业务模块，提升开发效率，重塑IT组织及交付能力。