管易云和轻易云集成平台接口打通对接实战

对接系统：管易云

金蝶管易云是金蝶集团旗下以电商和新零售为核心业务的子公司，公司于2008年成立，拥有从事电商及新零售业务相关专业知识工作者超过1000人。为伊利、网易有道、东阿阿胶、金龙鱼、海康、科大讯飞等超过110000家企业客户提供专业服务，用户数超过100万人。金蝶管易云与淘宝、天猫、京东、拼多多、抖音等超过150+主流电商平台建立合作关系。

接入系统：轻易云集成平台

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

接口方案配置

通过轻易云系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：管易云，然后选择对应的连接器。选择对应的gy.erp.items.get作为数据对接来源。然后再写入目标平台配置目标系统为轻易云集成平台，并且选择对应连接器（关于轻易云集成平台的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息）。选择好对应的batchSave接口作为数据写入动作完成第一步的接口配置。

管易云接口明细

API：gy.erp.items.get
NAME：商品查询
METHOD：POST

请求参数

接口字段字段名称预设值描述 start_date修改时间开始段{{LAST_SYNC_TIME datetime}} end_date修改时间结束段{{CURRENT_TIME datetime}} code商品代码 page_size分页大小{{PAGINATION_PAGE_SIZE}}默认为10 page_no页号{{PAGINATION_START_PAGE}}默认1

响应参数

接口字段字段名称预设值描述 id商品D create_date创建时间 modify_date修改时间 code商品代码 name商品名称 note备注 weight重量 combine是否为组合商品 del是否已停用 length长 width宽 height高 volume体积 simple_name商品简称 category_code分类代码 category_name分类名称 supplier_code供应商代码 item_unit_code商品单位代码 item_unit_name商品单位名称 package_point打包积分 sales_point销售积分 sales_price标准售价 purchase_price标准进价 agent_price代理售价 cost_price成本价 stock_status_code库存状态代码 pic_url图片地址 tax_no税号 tax_rate税率 origin_area原产地 supplier_outerid供应商货号 shelf_life保质期 warning_days预警天数 combine_items组合明细 custom_attr自定义属性 item_add_attribute商品附加属性 item_brand_code品牌代码 item_brand_name品牌名称 skussku skus.id规格ID skus.code规格代码 skus.name规格名称 skus.note备注 skus.weight重量 skus.volume体积 skus.package_point打包积分 skus.sales_point销售积分 skus.sales_price标准售价 skus.purchase_price标准进价 skus.agent_price代理售价 skus.cost_price成本价 skus.stock_status_code库存状态代码 skus.bar_code商品条码 skus.tax_no税号 skus.tax_rate税率 skus.origin_area原产地 skus.supplier_outerid供应商货号

轻易云集成平台接口明细

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预设辅助资料字段1 FPRESETASSISTANT2预设辅助资料字段2预设辅助资料字段2 FPRESETTEXT1预设文本字段1预设文本字段1 FPRESETTEXT2预设文本字段2预设文本字段2 FPRESETBASE1预设基础资料字段1预设基础资料字段1 FPRESETBASE2预设基础资料字段2预设基础资料字段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情况发票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采购订单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.FSwiftCodeSwiftCodeSwiftCode 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付款方式CNY付款方式 FPAYBILLENTRY.FExContractNo兑换合约号兑换合约号 FPAYBILLENTRY.FCollectionCurr收款币别收款币别 FPAYBILLENTRY.FCollectionAmount收款金额收款金额 FPAYBILLENTRY.FReceiveBankBIC收款银行BIC收款银行BIC FPAYBILLENTRY.FReceiveBankCode收款银行代码收款银行代码 FPAYBILLENTRY.FReceiveBranchCode收款支行代码收款支行代码 FPAYBILLENTRY.FServiceChargeBear手续费承担方手续费承担方 FPAYBILLENTRY.FServiceChargeNo手续费账号手续费账号 FPAYBILLENTRY.FServiceChargeBank手续费账号银行手续费账号银行 FPAYBILLENTRY.FServiceChargeCurr手续费币别手续费币别 FPAYBILLENTRY.FCNAPSNumCNAPSNumCNAPSNum FPAYBILLENTRY.FCNYTransactType人民币交易种类人民币交易种类 FPAYBILLENTRY.FRMBPayMethod人民币付款方式人民币付款方式 FPAYBILLENTRY.FByAgentBank通过代理行完成通过代理行完成 FPAYBILLENTRY.FAgentBankAcnt代理行账号代理行账号 FPAYBILLENTRY.FAgentBankName代理行名称代理行名称 FPAYBILLENTRY.FAgentBankArea代理行国家\地区代理行国家\地区 FPAYBILLENTRY.FAgentSWIFTCodeSWIFT Code(代理行)SWIFT Code(代理行) FPAYBILLENTRY.FAgentBankAddress代理行地址代理行地址 FPAYBILLENTRY.FReceiveBankClear收款银行本地清算码收款银行本地清算码 FPAYBILLENTRY.FReceiveBranchClear收款人本地清算分行代码收款人本地清算分行代码 FPAYBILLENTRY.FClearParameter清算要求参数清算要求参数 FPAYBILLENTRY.FOtherPartyAdress对方地址对方地址 FPAYBILLENTRY.FOtherPartyEmail对方邮箱对方邮箱 FPAYBILLENTRY.FOverseaPay境外支付境外支付 FPAYBILLENTRY.FormId业务对象表单IdAP_PAYBILL必须填写金蝶的表单ID如😛UR_PurchaseOrder FPAYBILLENTRY.Operation执行的操作BatchSave FPAYBILLENTRY.IsAutoSubmitAndAudit提交并审核true FPAYBILLENTRY.IsVerifyBaseDataField验证基础资料false是否验证所有的基础资料有效性，布尔类，默认false（非必录）

系统集成总览

通过数据集成平台可视化的快速配置调用接口打通管易云与轻易云集成平台之间的数据接口，使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具，基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎，通过可视化配置，快速实现客户灵活多变的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。

管易云和轻易云集成平台接口打通对接实战