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

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

来源系统:管易云

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

目标系统:轻易云集成平台

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

接口方案配置

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

管易云接口明细

接口：gy.erp.items.get
接口名称：商品查询
接口方法：POST

请求参数

字段	名称	类型	描述
start_date	修改时间开始段	string
end_date	修改时间结束段	string
code	商品代码	string
page_size	分页大小	string	默认为10
page_no	页号	string	默认1

响应参数

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

轻易云集成平台接口明细

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

请求参数

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

系统对接概况

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