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