轻易云集成平台和金蝶云星辰V1单据接口对接

轻易云集成平台和金蝶云星辰V1单据接口对接

接入系统：金蝶云星辰V1

金蝶云·星辰基于金蝶云·苍穹云原生PaaS平台构建，聚焦小型企业在线经营和数字化管理，提供财务云、税务云、进销存云、零售云、订货商城等SaaS服务，支持企业拓客开源、智能管理、实时决策；金蝶云·星辰还提供轻量级PaaS平台和全面的API接口，广泛连接生态伙伴，为小微企业提供一站式服务，助力企业快速成长

对接目标平台:轻易云集成平台

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

接口方案配置

通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：金蝶云星辰V1，并且选择对应的连接器（关于金蝶云星辰V1的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的仓库查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为轻易云集成平台，并且选择对应连接器。选择对应的写入空操作接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。

金蝶云星辰V1接口明细

• API：/jdy/v2/scm/pur_inbound
• NAME：仓库查询
• METHOD：GET

请求参数

接口字段字段名称预设值描述 search模糊搜索，支持供应商名称、职员名称、商品名称、单据编码 create_start_time创建开始时间格式：“时间戳”，-1表示不过滤），创建时间 create_end_time创建结束时间格式：“时间戳”，-1表示不过滤），创建时间 modify_start_time修改开始时间{{LAST_SYNC_TIME}}000格式：“时间戳”，-1表示不过滤），修改时间 modify_end_time修改结束时间{{CURRENT_TIME}}000格式：“时间戳”，-1表示不过滤），修改时间 page当前页1默认1） page_size每页显示条数，{{PAGINATION_PAGE_SIZE}}默认10，最大值100） start_bill_date单据开始日期格式：“yyyy-MM-dd”，为空表示不过滤），单据日期 end_bill_date单据结束日期格式：“yyyy-MM-dd”，为空表示不过滤），单据日期 bill_status单据状态所有：“”，已审核：“C”，未审核：“Z”） dept_id部门ID emp_id职员ID截取单据前top个商品数据返回 supplier_id供应商ID detailAPIdetailAPI/jdy/v2/scm/pur_inbound_detail

响应参数

接口字段字段名称预设值描述 id单据ID单据ID billno单据编码单据编码 billdate单据日期单据日期 billstatus单据状态，Z：未审核，C：已审核单据状态，Z：未审核，C：已审核 createtime创建时间创建时间 modifytime修改时间修改时间 audittime审核时间审核时间 creatorid_id创建人id创建人id creatorid_name创建人名称创建人名称 creatorid_number创建人编码创建人编码 modifierid_id修改人id修改人id modifierid_name修改人名称修改人名称 modifierid_number修改人编码修改人编码 auditorid_id审核人id审核人id auditorid_name审核人名称审核人名称 auditorid_number审核人编码审核人编码 transtype业务类型业务类型 remark备注备注 deptid_id部门id部门id deptid_name部门名称部门名称 deptid_number部门编码部门编码 empid_id业务员id业务员id empid_name业务员名称业务员名称 empid_number业务员编码业务员编码 customerid_id客户id客户id customerid_name客户名称客户名称 customerid_number客户编码客户编码 supplierid_id供应商id供应商id supplierid_name供应商名称供应商名称 supplierid_number供应商编码供应商编码 contact_phone联系电话联系电话 contact_country_id客户国家id客户国家id contact_country_name客户国家名称客户国家名称 contact_country_number客户国家编码客户国家编码 contact_province_id客户省份id客户省份id contact_province_name客户省份名称客户省份名称 contact_province_number客户省份编码客户省份编码 contact_city_id客户市区id客户市区id contact_city_name客户市区名称客户市区名称 contact_city_number客户市区编码客户市区编码 contact_district_id客户区县id客户区县id contact_district_name客户区县名称客户区县名称 contact_district_number客户区县编码客户区县编码 contact_address具体地址具体地址 sendstatus发送状态发送状态 iostatus入库状态 Z部分入库，C全部入库，A未入库入库状态 Z部分入库，C全部入库，A未入库 material_entity商品分录商品分录 material_entity.seq分录序号分录序号 material_entity.id分录ID分录ID material_entity.picture图片url图片url material_entity.materialid_id商品id商品id material_entity.materialid_name商品名称商品名称 material_entity.materialid_number商品编码商品编码 material_entity.materialid_ismulti_unit商品是否多单位商品是否多单位 material_entity.materialid_isserial商品是否序列号商品是否序列号 material_entity.materialid_isasstattr商品是否启用辅助属性商品是否启用辅助属性 material_entity.materialid_iskfperiod商品是否开启保质期商品是否开启保质期 material_entity.materialid_isbatch商品是否开启批次商品是否开启批次 material_entity.materialid_model商品规格商品规格 material_entity.deliverydate交货日期交货日期 material_entity.stockid_id仓库id仓库id material_entity.stockid_name仓库名称仓库名称 material_entity.stockid_number仓库编码仓库编码 material_entity.stockid_isallowfreight仓库启用仓位管理仓库启用仓位管理 material_entity.spid_id仓位id仓位id material_entity.spid_name仓位名称仓位名称 material_entity.spid_number仓位编码仓位编码 material_entity.auxpropid_id辅助属性id辅助属性id material_entity.auxpropid_name辅助属性名称辅助属性名称 material_entity.auxpropid_number辅助属性编码辅助属性编码 material_entity.auxid1_id辅助属性1id辅助属性1id material_entity.auxid1_name辅助属性1名称辅助属性1名称 material_entity.auxid1_number辅助属性1编码辅助属性1编码 material_entity.auxid2_id辅助属性2id辅助属性2id material_entity.auxid2_name辅助属性2名称辅助属性2名称 material_entity.auxid2_number辅助属性2编码辅助属性2编码 material_entity.auxid3_id辅助属性3id辅助属性3id material_entity.auxid3_name辅助属性3名称辅助属性3名称 material_entity.auxid3_number辅助属性3编码辅助属性3编码 material_entity.barcode条形码条形码 material_entity.batchno批次号批次号 material_entity.proplace产地产地 material_entity.proregno注册证号注册证号 material_entity.prolicense生产许可证号生产许可证号 material_entity.kfdate生产日期生产日期 material_entity.validdate有效日期有效日期 material_entity.kftype保质期类型，1：天，2：月，3：年保质期类型，1：天，2：月，3：年 material_entity.kfperiod保质期天数保质期天数 material_entity.sn序列号序列号 material_entity.snlistid序列号流转ID序列号流转ID material_entity.baseunit_id基本单位id基本单位id material_entity.baseunit_name基本单位名称基本单位名称 material_entity.baseunit_number基本单位编码基本单位编码 material_entity.unit_id单位id单位id material_entity.unit_name单位名称单位名称 material_entity.unit_number单位编码单位编码 material_entity.unit_precision单位数量小数位单位数量小数位 material_entity.auxunitid_id辅助单位id辅助单位id material_entity.auxunitid_name辅助单位名称辅助单位名称 material_entity.auxunitid_number辅助单位编码辅助单位编码 material_entity.conversionrate换算公式换算公式 material_entity.qty数量数量 material_entity.inv_qty库存数量库存数量 material_entity.baseqty基本数量基本数量 material_entity.inv_baseqty基本库存数量基本库存数量 material_entity.auxqty辅助单位数量辅助单位数量 material_entity.deffloatqty辅助基本数量辅助基本数量 material_entity.auxcoefficient辅助换算率辅助换算率 material_entity.coefficient换算率换算率 material_entity.inqty已入库数量已入库数量 material_entity.uninqty未入库数量未入库数量 material_entity.price单价单价 material_entity.cursettleamount本次核销金额本次核销金额 material_entity.discount折扣（小数）折扣（小数） material_entity.disprice折扣单价折扣单价 material_entity.amount折后金额折后金额 material_entity.predisamount折前金额折前金额 material_entity.actnontaxamount实际不含税金额实际不含税金额 material_entity.billDisBeforeAmount整单折前价税合计整单折前价税合计 material_entity.acttaxprice实际含税单价实际含税单价 material_entity.actNonTaxPrice实际不含税单价实际不含税单价 material_entity.billdisdistribution整单折扣分配额整单折扣分配额 material_entity.allamount价税合计价税合计 material_entity.allAmountfor价税合计本位币价税合计本位币 material_entity.cost入库成本入库成本 material_entity.unitcost入库单位成本入库单位成本 material_entity.comment行备注行备注 material_entity.srcbillno源单编码源单编码 material_entity.srcbilltypeid_id源单类型id源单类型id material_entity.srcbilltypeid_name源单类型名称源单类型名称 material_entity.srcbilltypeid_number源单类型编码源单类型编码 material_entity.srcinterid源单内码源单内码 material_entity.src_billdate源单日期源单日期 material_entity.srcseq源单行号源单行号 material_entity.srcentryid源单分录内码源单分录内码 material_entity.cess增值税率%增值税率% material_entity.taxamount税额税额 material_entity.taxamountfor税额(本位币)税额(本位币) material_entity.suppmaterialid_number供应商商品编码（外部商品编码）供应商商品编码（外部商品编码） material_entity.suppmaterialid_name供应商商品名称（外部商品名称）供应商商品名称（外部商品名称）

轻易云集成平台接口明细

• API：写入空操作
• NAME：写入空操作
• METHOD：POST

系统数据对接

随着企业数字化业务的深入发展，对于企业的 IT 或者 CIO 来讲，正在面临一个愈发重要的问题——系统的结构太复杂了，尤其是头部企业，至少有十多套系统，这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统，如何整合企业的现有IT资源，使企业中计算机孤岛式的应用向集体协作的方向发展，发挥资源效益的最大化，降低企业成本，正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上，操作统一，以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中，轻易云应用集成平台负责实现异构、分布式系统之间互联互通，实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件，连接现有各孤立应用系统，以图形化、拖拽方式构建集成流程和服务，提高应用系统集成工作效率，降低异构系统集成风险。针对未来可能出现的业务需求变更，在应用集成平台上进行动态调整，实现各应用系统之间的集成策略平滑升级。