金蝶云星辰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
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.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组织及交付能力。