金蝶云星辰V1和管易云单据接口对接

金蝶云星辰V1和管易云单据接口对接

源系统:管易云

管易云是上海管易云计算软件有限公司旗下的专注提供电商企业管理软件服务的品牌，总部位于中国上海张江高科技产业园区。管易云旗下拥有管易云C-ERP、EC-OMS、EC-WMS、B2C/B2B/BBC/微商城开发、PDA无纸化仓储解决方案、新零售一体化解决方案等产品

对接目标平台:金蝶云星辰V1

金蝶云星辰是金蝶集团公司为小微型工商贸企业定制的一款集财务、进销存、订货商城和税务管理为一体的SAAS云平台，有标准版和专业版两个版本，标准版适用于小型企业(10-50人)业财一体化管理，专业版面向小型(10-100人)企业管理需求。金蝶云星辰聚焦小型企业在线经营和数字化管理，赋能小型企业拓客开源、智能管理和实时决策。

数据对接方案

集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：管易云，源系统 API：商品查询，目标系统：金蝶云星辰V1，目标系统 API商品新增。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。

管易云接口明细

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

请求参数

字段字段名称类型配置值 start_date修改时间开始段string{{LAST_SYNC_TIME datetime}} end_date修改时间结束段string{{CURRENT_TIME datetime}} code商品代码string page_size分页大小string{{PAGINATION_PAGE_SIZE}} page_no页号string{{PAGINATION_START_PAGE}}

响应参数

字段字段名称类型配置值 create_date创建时间string modify_date修改时间string combine是否为组合商品string del是否已停用string length长string width宽string height高string simple_name商品简称string category_code分类代码string category_name分类名称string supplier_code供应商代码string item_unit_code商品单位代码string item_unit_name商品单位名称string pic_url图片地址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 skusskuarray skus.id规格IDstring 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.tax_no税号string skus.tax_rate税率string skus.origin_area原产地string skus.supplier_outerid供应商货号string skus.bar_code商品条码string

金蝶云星辰V1接口明细

• API：jdy/basedata/material_batch_save
• NAME：商品新增
• METHOD：POST

请求参数

接口字段字段名称预设值描述 id商品id商品id（修改商品时必填） number商品编码{{code}}商品编码,不传递则由后台生成（不设置有编码规则和更新时必传） name商品名称{{name}}商品名称 baseunitid_id计量单位id计量单位id parent_id商品类别id商品类别id mullabel_number商品标签编码商品标签编码，多个标签使用英文逗号分隔 barcode条形码条形码 model规格型号规格型号 brandid_id品牌品牌 producingpace产地产地 helpcode助记码助记码 remark商品描述商品描述 ismulti_unit是否启用多单位是否启用多单位，不启用 fixunit1_id辅助单位辅助单位1,启动多单位，才需要传递 coefficient1换算率1换算率1 conversionunitid1_id换算单位1换算单位1 fixunit2_id辅助单位2辅助单位2 coefficient2换算率2换算率2 conversionunitid2_id换算单位2换算单位2 fixunit3_id辅助单位3辅助单位3 coefficient3换算率3换算率3 conversionunitid3_id换算单位3换算单位3 purchaseunitid_id采购单位采购单位,单单位时传递计量单位 saleunitid_id销售单位销售单位,单单位时传递计量单位 storeunitid_id库存单位库存单位,单单位时传递计量单位 auxunitid_id报表辅助单位报表辅助单位,单单位时传递计量单位 isweight是否启用称重是否启用称重 isserial是否启用序列号管理是否启用序列号管理 isbatch是否启用批次管理是否启用批次管理 issale是否可销售是否可销售 ispurchase是否可采购是否可采购 issubpart是否可为子件是否可为子件 isassembly是否可为组件是否可为组件 iskfperiod是否启用保质期是否启用保质期 kfperiodtype保质期单位保质期单位，1：天，2：月，3：年 kfperiod保质期保质期 alarmday预警天数预警天数 isasstattr是否启用辅助属性是否启用辅助属性 auxentity辅助属性辅助属性 barcodeentity商品条码商品条码 priceentity商品价格商品价格 inv_mgr_type库存管理方式库存管理方式,0：统一库存，1：分仓库存,默认统一库存 mininventoryqty最低库存最低库存 maxinventoryqty最高库存最高库存 secinventoryqty预警库存预警库存 costmethod成本计算方法成本计算方法,默认为移动平均法,1：移动平均法，2：加权平均法，3：先进先出法 fetchcategoryid_id税收分类编码税收分类编码 taxrate税率税率 stockid_id默认仓库默认仓库 spaceid_id默认仓位默认仓位 venderid_id默认供应商默认供应商 purchaseid_id采购员采购员 refistrationnumber注册证号注册证号 prolicense生产许可证生产许可证 gross_weight毛重毛重 net_weight净重净重 weight_unit_id重量单位重量单位 length长长 wide宽宽 high高高 volume体积体积 volume_unit_id体积单位体积单位 images商品图片商品图片,商品图片服务器连接(上传图片接口的返回值)的集合，多个用英文逗号分隔 removeimages删除的商品图片删除的商品图片 ignorewarn是否忽略告警信息是否忽略告警信息(如：商品名称已存在)保存商品，true:忽略

系统打通概况

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