锐思WMS和金蝶云星辰V1单据接口对接
锐思WMS和金蝶云星辰V1单据接口对接
数据源平台:金蝶云星辰V1
金蝶云·星辰基于金蝶云·苍穹云原生PaaS平台构建，聚焦小型企业在线经营和数字化管理，提供财务云、税务云、进销存云、零售云、订货商城等SaaS服务，支持企业拓客开源、智能管理、实时决策；金蝶云·星辰还提供轻量级PaaS平台和全面的API接口，广泛连接生态伙伴，为小微企业提供一站式服务，助力企业快速成长
对接目标系统:锐思WMS
利用物联网、大数据等技术为多货多仓的企业实现智能化库房管理、系统化仓储管理、透明化备料管理，细化库内作业流程。系统支持多业态、多模式、多仓库的企业个性化需求，以数据信息自动采集分析、无缝连接上下游软件，为管理者提供完备的仓储信息，提升库存周转效率、提高库存准确性、优化仓库作业标准，打造实时化、透明化、可视化的仓储管理体系。————————————————版权声明：本文为CSDN博主「大连豪森智源」的原创文章，遵循CC4.0BY-SA版权协议，转载请附上原文出处链接及本声明。原文链接：https://blog.csdn.net/hszy123456/article/details/127684773
数据集成方案配置
系统对接前期需要通过调研公司的业务，规划出最便捷，效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地，轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台：金蝶云星辰V1的接口参数设置，以及设定好目标平台：锐思WMS的映射，即可启动方案进行测试
金蝶云星辰V1接口明细
- 接口：jdy/sal/sal_order_list
- 接口名称：销售订单（列表+明细）
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
| billstatus | 单据状态 | string | （所有：“”，已审核：“C”，未审核：“Z”） |
| billclosestate | 单据关闭状态 | string | （所有：“”，未关闭：“C”，已关闭：“S”,手动关闭: H） |
| startbilldate | 开始日期 | string | （格式：“yyyy-MM-dd”，为空表示不过滤），单据日期 |
| endbilldate | 结束日期 | string | （格式：“yyyy-MM-dd”，为空表示不过滤），单据日期 |
| startdate | 开始日期 | string | （格式：“yyyy-MM-dd”，为空表示不过滤），创建日期 |
| enddate | 结束日期 | string | （格式：“yyyy-MM-dd”，为空表示不过滤），创建日期 |
| begintime | 开始日期 | string | （格式：“yyyy-MM-dd”，为空表示不过滤），修改日期 |
| expiretime | 结束日期 | string | （格式：“yyyy-MM-dd”，为空表示不过滤），修改日期 |
| search | 模糊搜索 | string | 支持客户名称、职员名称、商品名称、单据编码 |
| billsource | 单据来源 | string | 与单据新增保持一致 |
| realiostatus | 出库状态 | string | （所有：“”，全部出库：“C”，部分出库：“Z”，未出库：“A”，待出库（=部分出库+未出库）：“B”） |
| iostatus | 执行状态 | string | （所有：“”，全部执行：“C”，部分执行：“Z”，未执行：“A”，待执行（=部分执行+未执行）：“B”） |
| page | 当前页 | string | （默认1） |
| pagesize | 每页显示条数 | string | （默认10，最大值100） |
| orderby | 排序说明 | string | [下面解析](# orderby排序说明) |
| showmaterialtotal | 是否统计商品种类和数量到单据 | string | 默认false |
| detailAPI | 详情API | string |
响应参数
| 字段 | 名称 | 类型 | 描述 |
| id | 单据ID | string | 单据ID |
| billno | 单据编码 | string | 单据编码 |
| contact_phone | 客户联系电话 | string | 客户联系电话 |
| contact_country_id | 客户国家id | string | 客户国家id |
| contact_country_name | 客户国家名称 | string | 客户国家名称 |
| contact_country_number | 客户国家编码 | string | 客户国家编码 |
| contact_province_id | 客户省份id | string | 客户省份id |
| contact_province_name | 客户省份名称 | string | 客户省份名称 |
| contact_province_number | 客户省份编码 | string | 客户省份编码 |
| contact_city_id | 客户市区id | string | 客户市区id |
| contact_city_name | 客户市区名称 | string | 客户市区名称 |
| contact_city_number | 客户市区编码 | string | 客户市区编码 |
| contact_district_id | 客户区县id | string | 客户区县id |
| contact_district_name | 客户区县名称 | string | 客户区县名称 |
| contact_district_number | 客户区县编码 | string | 客户区县编码 |
| contact_linkman | 客户联系人 | string | 客户联系人 |
| contact_info | 联系信息 | string | 联系信息 |
| contact_address | 联系地址 | string | 联系地址 |
| dispatcher_country_id | 发货国家id | string | 发货国家id |
| dispatcher_country_name | 发货国家名称 | string | 发货国家名称 |
| dispatcher_country_number | 发货国家编码 | string | 发货国家编码 |
| dispatcher_province_id | 发货省份id | string | 发货省份id |
| dispatcher_province_name | 发货省份名称 | string | 发货省份名称 |
| dispatcher_province_number | 发货省份编码 | string | 发货省份编码 |
| dispatcher_city_id | 发货市区id | string | 发货市区id |
| dispatcher_city_name | 发货市区名称 | string | 发货市区名称 |
| dispatcher_city_number | 发货市区编码 | string | 发货市区编码 |
| dispatcher_district_id | 发货区县id | string | 发货区县id |
| dispatcher_district_name | 发货区县名称 | string | 发货区县名称 |
| dispatcher_district_number | 发货区县编码 | string | 发货区县编码 |
| dispatcher_address | 发货详细地址 | string | 发货详细地址 |
| dispatcher_linkman | 发货人 | string | 发货人 |
| dispatcher_phone | 发货联系电话 | string | 发货联系电话 |
| recevice_delivery | 发货地址 | string | 发货地址 |
| payment_entry | 付款信息单据体 | string | 付款信息单据体 |
| deduction_balance | 抵扣预收款 | string | 抵扣预收款 |
| totalunsettleamount | 未核销金额 | string | 未核销金额 |
| attachments | 附件个数 | string | 附件个数 |
| attachments_url | 附件地址 | string | 附件地址 |
| auditorid_id | 审核人id | string | 审核人id |
| auditorid_name | 审核人名称 | string | 审核人名称 |
| auditorid_number | 审核人编码 | string | 审核人编码 |
| audittime | 审核时间 | string | 审核时间 |
| alldebt | 应收款余额 | string | 应收款余额 |
| flogisticsid | 物流公司内码 | string | 物流公司内码 |
| cost_fee | 销售费用 | string | 销售费用 |
| empid_id | 业务员id | string | 业务员id |
| empid_name | 业务员名称 | string | 业务员名称 |
| empid_number | 业务员编码 | string | 业务员编码 |
| subsist_info | 预收款金额 | string | 预收款金额 |
| lastdebt | 上次欠款 | string | 上次欠款 |
| billstatus | 单据状态（已审核：“C”，未审核：“Z”） | string | 单据状态（已审核：“C”，未审核：“Z”） |
| billclosestate | 关闭状态（未关闭：“C”，已关闭：“S”，手动关闭:“H”） | string | 关闭状态（未关闭：“C”，已关闭：“S”，手动关闭:“H”） |
| transtype | 业务类型，现销：1，赊销：2，委托销售：3 | string | 业务类型，现销：1，赊销：2，委托销售：3 |
| material_entity | 商品分录 | array | 商品分录 |
| material_entity.picture | 图片url | string | 图片url |
| material_entity.materialid_id | 商品id | string | 商品id |
| 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.materialid_helpcode | 商品助记码 | string | 商品助记码 |
| material_entity.stockid_id | 仓库id | string | 仓库id |
| material_entity.stockid_name | 仓库名称 | string | 仓库名称 |
| material_entity.stockid_number | 仓库编码 | string | 仓库编码 |
| material_entity.stockid_isallowfreight | 仓库启用仓位管理 | string | 仓库启用仓位管理 |
| material_entity.spid_id | 仓位id | string | 仓位id |
| material_entity.spid_name | 仓位名称 | string | 仓位名称 |
| material_entity.spid_number | 仓位编码 | string | 仓位编码 |
| material_entity.auxpropid_id | 辅助属性id | string | 辅助属性id |
| material_entity.auxpropid_name | 辅助属性名称 | string | 辅助属性名称 |
| material_entity.auxpropid_number | 辅助属性编码 | string | 辅助属性编码 |
| material_entity.auxid1_id | 辅助属性1id | string | 辅助属性1id |
| material_entity.auxid1_name | 辅助属性1名称 | string | 辅助属性1名称 |
| material_entity.auxid1_number | 辅助属性1编码 | string | 辅助属性1编码 |
| material_entity.auxid2_id | 辅助属性2id | string | 辅助属性2id |
| material_entity.auxid2_name | 辅助属性2名称 | string | 辅助属性2名称 |
| material_entity.auxid2_number | 辅助属性2编码 | string | 辅助属性2编码 |
| material_entity.auxid3_id | 辅助属性3id | string | 辅助属性3id |
| material_entity.auxid3_name | 辅助属性3名称 | string | 辅助属性3名称 |
| material_entity.auxid3_number | 辅助属性3编码 | string | 辅助属性3编码 |
| material_entity.barcode | 条形码 | string | 条形码 |
| material_entity.price | 单价 | string | 单价 |
| material_entity.taxprice | 含税单价 | string | 含税单价 |
| material_entity.acttaxprice | 实际含税单价 | string | 实际含税单价 |
| material_entity.baseunit_id | 基本单位id | string | 基本单位id |
| material_entity.baseunit_name | 基本单位名称 | string | 基本单位名称 |
| material_entity.baseunit_number | 基本单位编码 | string | 基本单位编码 |
| material_entity.unit_id | 单位id | string | 单位id |
| material_entity.unit_name | 单位名称 | string | 单位名称 |
| material_entity.unit_number | 单位编码 | string | 单位编码 |
| material_entity.coefficient | 换算率 | string | 换算率 |
| material_entity.conversionrate | 换算公式 | string | 换算公式 |
| material_entity.qty | 数量 | string | 数量 |
| material_entity.inv_qty | 库存数量 | string | 库存数量 |
| material_entity.inv_baseqty | 基本库存数量 | string | 基本库存数量 |
| material_entity.return_qty_unit | 退货数量 | string | 退货数量 |
| material_entity.return_qty | 退货基本数量 | string | 退货基本数量 |
| material_entity.allamount | 价税合计 | string | 价税合计 |
| material_entity.taxamount | 税额 | string | 税额 |
| material_entity.billdisdistribution | 整单折扣分配额 | string | 整单折扣分配额 |
| material_entity.discount | 折扣 | string | 折扣 |
| material_entity.fee | 销售费用分摊 | string | 销售费用分摊 |
| material_entity.dividediffamount | 优惠分摊金额 | string | 优惠分摊金额 |
| material_entity.disrate | 折算率 | string | 折算率 |
| material_entity.amount | 金额 | string | 金额 |
| material_entity.predisamount | 折前金额 | string | 折前金额 |
| material_entity.actnontaxamount | 实际不含税金额 | string | 实际不含税金额 |
| material_entity.unitcost | 单位成本 | string | 单位成本 |
| material_entity.cost | 成本 | string | 成本 |
| material_entity.cursettleamount | 本次核销金额 | string | 本次核销金额 |
| material_entity.disamount | 折扣额 | string | 折扣额 |
| material_entity.disprice | 折扣单价 | 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 | 保质期类型，1：天，2：月，3：年 |
| material_entity.kfperiod | 保质期天数 | string | 保质期天数 |
| material_entity.sn | 序列号 | string | 序列号 |
| material_entity.snlistid | 序列号流转ID | string | 序列号流转ID |
| material_entity.auxunitid_id | 辅助单位id | string | 辅助单位id |
| material_entity.auxunitid_name | 辅助单位名称 | string | 辅助单位名称 |
| material_entity.auxunitid_number | 辅助单位编码 | string | 辅助单位编码 |
| material_entity.auxcoefficient | 辅助换算率 | string | 辅助换算率 |
| material_entity.auxqty | 辅助单位数量 | string | 辅助单位数量 |
| material_entity.cess | 增值税率 | string | 增值税率 |
| material_entity.seq | 分录序号 | string | 分录序号 |
| material_entity.entrystatus | 分录状态 | string | 分录状态 |
| material_entity.entrysettlestatus | 分录核销状态，未收款：A，部分收款：B，全部收款：C | string | 分录核销状态，未收款：A，部分收款：B，全部收款：C |
| material_entity.is_free | 是否赠品 | string | 是否赠品 |
| material_entity.comment | 行备注 | string | 行备注 |
| material_entity.srcorderid | 源单id | string | 源单id |
| material_entity.srcbillno | 源单编码 | string | 源单编码 |
| material_entity.srcbilltypeid_id | 源单类型id | string | 源单类型id |
| 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.custmaterialid_number | 客户商品编码（外部商品编码） | string | 客户商品编码（外部商品编码） |
| material_entity.custmaterialid_name | 客户商品名称（外部商品名称） | string | 客户商品名称（外部商品名称） |
| material_entity.outside_number | 外部商品编码 | string | 外部商品编码 |
| material_entity.outside_name | 外部商品名称 | string | 外部商品名称 |
| material_entity.outside_unit | 外部单位 | string | 外部单位 |
| material_entity.outside_barcode | 外部条码 | string | 外部条码 |
| material_entity.totalamount | 总金额 | string | 总金额 |
| material_entity.billdate | 单据日期 | string | 单据日期 |
| material_entity.customerid | 客户ID | string | 客户ID |
| material_entity.bill_dis_amount | 整单折扣额 | string | 整单折扣额 |
| material_entity.deptid_id | 部门id | string | 部门id |
| material_entity.deptid_name | 部门名称 | string | 部门名称 |
| material_entity.deptid_number | 部门编码 | string | 部门编码 |
| material_entity.remark | 单据备注 | string | 单据备注 |
| material_entity.bill_dis_rate | 折扣率 | string | 折扣率 |
| material_entity.createtime | 创建时间 | string | 创建时间 |
| material_entity.modifytime | 修改时间 | string | 修改时间 |
| material_entity.iostatus | 出入库状态,全部出库：“C”，部分出库：“Z”，未出库：“A”，待出库（=部分出库+未出库）：“B” | string | 出入库状态,全部出库：“C”，部分出库：“Z”，未出库：“A”，待出库（=部分出库+未出库）：“B” |
| material_entity.creatorid_id | 创建人id | string | 创建人id |
| material_entity.creatorid_name | 创建人名称 | string | 创建人名称 |
| material_entity.creatorid_number | 创建人编码 | string | 创建人编码 |
| material_entity.modifierid_id | 修改人id | string | 修改人id |
| material_entity.modifierid_name | 修改人名称 | string | 修改人名称 |
| material_entity.modifierid_number | 修改人编码 | string | 修改人编码 |
锐思WMS接口明细
- 接口：/reserves/add
- 接口名称：出库预定
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
| orderNo | 销售订单编号 | string | |
| noticeNo | 发货通知单号 | string | 星辰没有 |
| billType | 单据类型 | string | 110：销售出库120：退货出库140：其他出库141：领料出库144：调拨出库145：委外入库030：其他入库 |
| owBussType | 业务类型 | string | （仓发，直发[云仓直发采购订单云仓直发大客户采购订单]）默认：仓发 |
| bizDate | 业务日期 | Datetime | YYYY-MM-DD |
| createUser | 制单人 | string | |
| customerNo | 供应商（客户）ID | string | 销售出库时是客户，退货出库时是供应商 |
| deliveryType | 配送方式 | string | 01:送达 02：自提 |
| address | 客户地址 | string | |
| contactName | 客户联系人 | string | |
| contactTel | 客户电话 | string | |
| memo | 备注 | string | |
| srcBillType | 源单类型 | string | 01：销售订单02：发货通知单03：采购退料申请单 |
| erpWharehoseNo | ERP仓库编码 | string | |
| items | 分录(LIST) | array | |
| items.erpEntryId | ERP分录内码 | string | 对接ERP时必需 |
| items.materialNo | 物料ID | string | 物料编码或ID |
| items.qty | 数量 | int | 最小数量 |
| items.unit | 单位 | string | |
| items.lot | 批号 | string | |
| items.productDate | 生产日期 | string | YYYY-MM-DD |
| items.isFcl | 是否整箱 | string | 0：否 1：是 2：不控制 |
| items.isGift | 搭赠 | string | 0：否 1：是 |
| items.price | 单价 | string | |
| items.entryMemo | 明细行备注 | string |
数据对接效果
数据集成中台设计中心Web界面以“拖拽”式交互设计，使用鼠标即可构建设计多异构系统数据集成流程，低代码平台大大降低流程设计者上手门槛。还有丰富的组件库快速满足复杂业务需求，结合不同模块即可生成不同业务流程，提升流程设计效率。平台支持多种高度灵活部署，高并发、高性能、高可用，可以通过多节点组成集群实现性能的横向扩展。适度集群配置其数据集成处理能力可达GB级/秒，为业务流提供更高数据吞吐量。平台已集成数据回压、优先级队列等能力，保障运行稳定性。完善的企业API运营管理机制帮助您构建“API生产者、API管理者、API消费者”三者结合的统一API数字化生态。支持市面上主流厂家软件如：金蝶、用友、SAP、泛微、蓝凌、旺店通、聚水潭、马帮、小满CRM等等。
Copyright Notice
The article "锐思WMS和金蝶云星辰V1单据接口对接" is original content owned by 广东轻亿云软件科技有限公司. Reposting is welcome, provided the source (including the original link) is credited in a prominent position.