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

数据源系统:管易云·奇门

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

对接系统：金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

系统对接接口配置

通过轻易云系统数据集成平台新增创建集成方案，通过轻易云的方案市场可以一键复制，并且可以借鉴其他的方案配置完成方案制作，方案制作只需要两步，第一步先确定好对应的数据来源；源系统：管易云·奇门接口：历史订单查询通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统：金蝶云星空接口：新增付款单，通过写入调度者匹配获取到的数据和写入的映射关系，即可自动生成符合目标系统：金蝶云星空写入的数据自动产生写入队列，通过运行概况，系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况

管易云·奇门接口明细

调用接口：gy.erp.trade.history.get
接口名称：历史订单查询
方法：POST

请求参数

字段字段名称类型配置值 start_date开始时间string2022-03-30 00:00:00 end_date结束时间string2022-03-31 00:00:00 date_type时间类型string3 order_state订单类型string2 warehouse_code仓库代码string shop_code店铺代码string vip_name会员名称string platform_code平台单号string receiver_mobile收件手机string code单据编号string retrun_total是否返回总量string page_no页号string{{PAGINATION_START_PAGE}} page_size分页大小string{{PAGINATION_PAGE_SIZE}}

响应参数

字段字段名称类型配置值 code单据编号string qty商品数量string tax_amount税额string amount订单金额string payment支付金额string approve是否审核string cod是否货到付款string cancle是否取消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 post_fee物流费用string cod_fee货到付款服务费string discount_fee让利金额string post_cost物流成本string weight_origin标准重量string payment_amount商品总金额string delivery_state发货状态string order_type_name订单类型string business_man业务员string platform_flag平台旗帜string extend_memo附加信息string approveDate审核时间string accountDate到账时间string details商品列表array details.oid子订单号string details.qty数量string details.price商品实际单价string details.amount商品实际金额string details.note备注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

金蝶云星空接口明细

接口：batchSave
接口名称：新增付款单
接口方法：POST

请求参数

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

数据对接效果

使用全界面可视化配置集成流，快速应对企业的集成需求使得管易云·奇门与金蝶云星空之间的数据接口一站式的快速集成能力，构建企业数据通道，解决数据孤岛问题。快速构建企业元数据标准、主数据标准、业财数据标准，完成数据的采集、统一、分发、清洗、归集等，帮助企业建立高质量的数据中台。目前轻易云平台已经支持300+系统，同时具备快速适配新系统的能力，集成海量接口数据。无论是对接ERP还是MES、OA、CRM、WMS、OMS等等系统，都可以通过接口相互集成。

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