锐思WMS和金蝶云星辰V1单据接口对接
对接源平台:金蝶云星辰V1
金蝶云·星辰基于金蝶云·苍穹云原生PaaS平台构建,聚焦小型企业在线经营和数字化管理,提供财务云、税务云、进销存云、零售云、订货商城等SaaS服务,支持企业拓客开源、智能管理、实时决策;金蝶云·星辰还提供轻量级PaaS平台和全面的API接口,广泛连接生态伙伴,为小微企业提供一站式服务,助力企业快速成长
对接目标系统:锐思WMS
WMS是仓库管理系统(WarehouseManagementSystem)的缩写,wms仓储物流管理系统是通过入库业务、出库业务、仓库调拨、库存调拨和虚仓管理等功能,综合批次管理、物料对应、库存盘点、质检管理、虚仓管理和即时库存管理等功能综合运用的管理系统
数据集成方案配置
集成方案是整个轻易云集成平台的核心,每一个集成方案代表一种业务的对接策略(对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息),用户可以根据业务的不同新建多个不同规则的集成方案。比如:采购订单同步,线上销售出库同步,线下销售出库同步。一个集成方案必须要配置源系统:金蝶云星辰V1,源系统 API:采购订单(列表+详情),目标系统:锐思WMS,目标系统 API入库预定新增。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。
金蝶云星辰V1接口明细
- 调用接口:/jdy/v2/scm/pur_order
- 接口名称:采购订单(列表+详情)
- 方法:GET
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|---|---|---|
| dept_id | 部门ID | string | |
| supplier_id | 供应商ID | string | |
| bill_status | 单据状态 | string | C |
| create_start_time | 创建开始时间 | string | |
| create_end_time | 创建结束时间 | string | |
| modify_start_time | 修改开始时间 | string | {{LAST_SYNC_TIME}}000 |
| modify_end_time | 修改结束时间 | string | {{CURRENT_TIME}}000 |
| start_bill_date | 单据开始日期 | string | |
| end_bill_date | 单据结束日期 | string | |
| search | 模糊搜索,支持供应商名称、职员名称、商品名称、单据编码 | string | |
| page | 当前页 | string | 1 |
| page_size | 每页显示条数, | string | {{PAGINATION_PAGE_SIZE}} |
| top | 截取单据前top个商品数据返回 | string | |
| detailAPI | detailAPI | string | /jdy/v2/scm/pur_order_detail |
响应参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|---|---|---|
| id | 单据ID | String | |
| billno | 单据编码 | String | |
| billdate | 单据日期 | String | |
| billstatus | 单据状态,Z:未审核,C:已审核 | String | |
| createtime | 创建时间 | String | |
| modifytime | 修改时间 | String | |
| audittime | 审核时间 | String | |
| creatorid_id | 创建人id | String | |
| creatorid_name | 创建人名称 | String | |
| creatorid_number | 创建人编码 | String | |
| modifierid_id | 修改人id | String | |
| modifierid_name | 修改人名称 | String | |
| modifierid_number | 修改人编码 | String | |
| auditorid_id | 审核人id | String | |
| auditorid_name | 审核人名称 | String | |
| auditorid_number | 审核人编码 | String | |
| transtype | 业务类型 | String | |
| remark | 备注 | String | |
| deptid_id | 部门id | String | |
| deptid_name | 部门名称 | String | |
| deptid_number | 部门编码 | String | |
| empid_id | 业务员id | String | |
| empid_name | 业务员名称 | String | |
| empid_number | 业务员编码 | String | |
| customerid_id | 客户id | String | |
| customerid_name | 客户名称 | String | |
| customerid_number | 客户编码 | String | |
| supplierid_id | 供应商id | String | |
| supplierid_name | 供应商名称 | String | |
| supplierid_number | 供应商编码 | String | |
| contact_phone | 联系电话 | String | |
| contact_country_id | 客户国家id | String | |
| contact_country_name | 客户国家名称 | String | |
| contact_country_number | 客户国家编码 | String | |
| contact_province_id | 客户省份id | String | |
| contact_province_name | 客户省份名称 | String | |
| contact_province_number | 客户省份编码 | String | |
| contact_city_id | 客户市区id | String | |
| contact_city_name | 客户市区名称 | String | |
| contact_city_number | 客户市区编码 | String | |
| contact_district_id | 客户区县id | String | |
| contact_district_name | 客户区县名称 | String | |
| contact_district_number | 客户区县编码 | String | |
| contact_address | 具体地址 | String | |
| sendstatus | 发送状态 | String | |
| iostatus | 入库状态 Z部分入库,C全部入库,A未入库 | String | |
| material_entity | 商品分录 | String | |
| material_entity.seq | 分录序号 | String | |
| material_entity.id | 分录ID | String | |
| material_entity.picture | 图片url | String | |
| material_entity.materialid_id | 商品id | String | |
| material_entity.materialid_name | 商品名称 | String | |
| material_entity.materialid_number | 商品编码 | String | |
| material_entity.materialid_ismulti_unit | 商品是否多单位 | String | |
| material_entity.materialid_isserial | 商品是否序列号 | String | |
| material_entity.materialid_isasstattr | 商品是否启用辅助属性 | String | |
| material_entity.materialid_iskfperiod | 商品是否开启保质期 | String | |
| material_entity.materialid_isbatch | 商品是否开启批次 | String | |
| material_entity.materialid_model | 商品规格 | String | |
| material_entity.deliverydate | 交货日期 | String | |
| material_entity.stockid_id | 仓库id | String | |
| material_entity.stockid_name | 仓库名称 | String | |
| material_entity.stockid_number | 仓库编码 | String | |
| material_entity.stockid_isallowfreight | 仓库启用仓位管理 | String | |
| material_entity.spid_id | 仓位id | String | |
| material_entity.spid_name | 仓位名称 | String | |
| material_entity.spid_number | 仓位编码 | String | |
| material_entity.auxpropid_id | 辅助属性id | String | |
| material_entity.auxpropid_name | 辅助属性名称 | String | |
| material_entity.auxpropid_number | 辅助属性编码 | String | |
| material_entity.auxid1_id | 辅助属性1id | String | |
| material_entity.auxid1_name | 辅助属性1名称 | String | |
| material_entity.auxid1_number | 辅助属性1编码 | String | |
| material_entity.auxid2_id | 辅助属性2id | String | |
| material_entity.auxid2_name | 辅助属性2名称 | String | |
| material_entity.auxid2_number | 辅助属性2编码 | String | |
| material_entity.auxid3_id | 辅助属性3id | String | |
| material_entity.auxid3_name | 辅助属性3名称 | String | |
| material_entity.auxid3_number | 辅助属性3编码 | String | |
| material_entity.barcode | 条形码 | String | |
| material_entity.batchno | 批次号 | String | |
| material_entity.proplace | 产地 | String | |
| material_entity.proregno | 注册证号 | String | |
| material_entity.prolicense | 生产许可证号 | String | |
| material_entity.kfdate | 生产日期 | String | |
| material_entity.validdate | 有效日期 | String | |
| material_entity.kftype | 保质期类型,1:天,2:月,3:年 | String | |
| material_entity.kfperiod | 保质期天数 | String | |
| material_entity.sn | 序列号 | String | |
| material_entity.snlistid | 序列号流转ID | String | |
| material_entity.baseunit_id | 基本单位id | String | |
| material_entity.baseunit_name | 基本单位名称 | String | |
| material_entity.baseunit_number | 基本单位编码 | String | |
| material_entity.unit_id | 单位id | String | |
| material_entity.unit_name | 单位名称 | String | |
| material_entity.unit_number | 单位编码 | String | |
| material_entity.unit_precision | 单位数量小数位 | String | |
| material_entity.auxunitid_id | 辅助单位id | String | |
| material_entity.auxunitid_name | 辅助单位名称 | String | |
| material_entity.auxunitid_number | 辅助单位编码 | String | |
| material_entity.conversionrate | 换算公式 | String | |
| material_entity.qty | 数量 | String | |
| material_entity.inv_qty | 库存数量 | String | |
| material_entity.baseqty | 基本数量 | String | |
| material_entity.inv_baseqty | 基本库存数量 | String | |
| material_entity.auxqty | 辅助单位数量 | String | |
| material_entity.deffloatqty | 辅助基本数量 | String | |
| material_entity.auxcoefficient | 辅助换算率 | String | |
| material_entity.coefficient | 换算率 | String | |
| material_entity.inqty | 已入库数量 | String | |
| material_entity.uninqty | 未入库数量 | String | |
| material_entity.price | 单价 | String | |
| material_entity.cursettleamount | 本次核销金额 | String | |
| material_entity.discount | 折扣(小数) | String | |
| material_entity.disprice | 折扣单价 | String | |
| material_entity.amount | 折后金额 | String | |
| material_entity.predisamount | 折前金额 | String | |
| material_entity.actnontaxamount | 实际不含税金额 | String | |
| material_entity.billDisBeforeAmount | 整单折前价税合计 | String | |
| material_entity.acttaxprice | 实际含税单价 | String | |
| material_entity.actNonTaxPrice | 实际不含税单价 | String | |
| material_entity.billdisdistribution | 整单折扣分配额 | String | |
| material_entity.allamount | 价税合计 | String | |
| material_entity.allAmountfor | 价税合计本位币 | String | |
| material_entity.cost | 入库成本 | String | |
| material_entity.unitcost | 入库单位成本 | String | |
| material_entity.comment | 行备注 | String | |
| material_entity.srcbillno | 源单编码 | String | |
| material_entity.srcbilltypeid_id | 源单类型id | String | |
| material_entity.srcbilltypeid_name | 源单类型名称 | String | |
| material_entity.srcbilltypeid_number | 源单类型编码 | String | |
| material_entity.srcinterid | 源单内码 | String | |
| material_entity.src_billdate | 源单日期 | String | |
| material_entity.srcseq | 源单行号 | String | |
| material_entity.srcentryid | 源单分录内码 | String | |
| material_entity.cess | 增值税率% | String | |
| material_entity.taxamount | 税额 | String | |
| material_entity.taxamountfor | 税额(本位币) | String | |
| material_entity.suppmaterialid_number | 供应商商品编码(外部商品编码) | String | |
| material_entity.suppmaterialid_name | 供应商商品名称(外部商品名称) | String |
锐思WMS接口明细
- 调用接口:/inwarehousePlan/add
- 接口名称:入库预定新增
- 方法:POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|---|---|---|
| orderNo | 采购订单编号 | string | {{bill_no}} |
| noticeNo | 收料通知单号 | string | |
| billType | 单据类型 | string | 010 |
| billCloseState | 单据关闭状态 | string | |
| bizDate | 业务日期 | Datetime | {{bill_date}} |
| createUser | 制单人 | string | |
| supplierNo | 供应商(客户)ID | string | {{supplier_number}} |
| memo | 备注 | string | {{remark}} |
| srcBillType | 源单类型 | string | 01 |
| erpWharehoseNo | ERP仓库编码 | string | |
| items | 分录 | array | material_entity |
| items.erpEntryId | ERP分录内码 | string | |
| items.materialNo | 物料ID | string | {{material_entity.material_number}} |
| items.qty | 入库预定数量 | int | {{material_entity.qty}} |
| items.unit | 单位 | string | {{material_entity.unit_number}} |
| items.isGift | 搭赠 | int | |
| items.entryMemo | 明细行备注 | string | {{material_entity.comment}} |
数据对接效果
使用全界面可视化配置集成流,快速应对企业的集成需求使得金蝶云星辰V1与锐思WMS之间的数据接口一站式的快速集成能力,构建企业数据通道,解决数据孤岛问题。快速构建企业元数据标准、主数据标准、业财数据标准,完成数据的采集、统一、分发、清洗、归集等,帮助企业建立高质量的数据中台。目前轻易云平台已经支持300+系统,同时具备快速适配新系统的能力,集成海量接口数据。无论是对接ERP还是MES、OA、CRM、WMS、OMS等等系统,都可以通过接口相互集成。