金蝶云星辰V1和锐思WMS接口打通对接实战

数据源系统:金蝶云星辰V1

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

接入系统：锐思WMS

WMS是仓库管理系统(WarehouseManagementSystem)的缩写，wms仓储物流管理系统是通过入库业务、出库业务、仓库调拨、库存调拨和虚仓管理等功能，综合批次管理、物料对应、库存盘点、质检管理、虚仓管理和即时库存管理等功能综合运用的管理系统

数据接口配置

异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则，例如取数就要根据查询接口获取金蝶云星辰V1的数据，并且根据对应的条件进行取数，目标系统就必须根据目标系统的格式，以及获取的数据进行加工处理后进行写入到锐思WMS中。轻易云集成平台的可视化配置轻松实现。系统数据集成平台更加专注于数据集成与流程自动化的应用连接器，通过自研引擎，与各个平台或者服务完成对接，从而打通数据孤岛，实现数据的跨系统自由流转，让数据真正成为企业的核心生产力。

金蝶云星辰V1接口明细

API：/jdy/v2/scm/sal_order
NAME：销售订单（列表+明细）
METHOD：GET

请求参数

接口字段名称预设值 bill_status单据状态C bill_close_state单据关闭状态S start_bill_date开始日期 end_bill_date结束日期 create_start_time开始日期 create_end_time结束日期 modify_start_time开始日期 modify_end_time结束日期 search模糊搜索 bill_source单据来源 real_io_status出库状态 io_status执行状态 page当前页1 page_size每页显示条数100 order_by排序说明 show_material_total是否统计商品种类和数量到单据 detailAPI详情API/jdy/v2/scm/sal_order_detail

响应参数

接口字段名称预设值 id单据ID billno单据编码 contact_phone客户联系电话 contact_country_id客户国家id contact_country_name客户国家名称 contact_country_number客户国家编码 contact_province_id客户省份id contact_province_name客户省份名称 contact_province_number客户省份编码 contact_city_id客户市区id contact_city_name客户市区名称 contact_city_number客户市区编码 contact_district_id客户区县id contact_district_name客户区县名称 contact_district_number客户区县编码 contact_linkman客户联系人 contact_info联系信息 contact_address联系地址 dispatcher_country_id发货国家id dispatcher_country_name发货国家名称 dispatcher_country_number发货国家编码 dispatcher_province_id发货省份id dispatcher_province_name发货省份名称 dispatcher_province_number发货省份编码 dispatcher_city_id发货市区id dispatcher_city_name发货市区名称 dispatcher_city_number发货市区编码 dispatcher_district_id发货区县id dispatcher_district_name发货区县名称 dispatcher_district_number发货区县编码 dispatcher_address发货详细地址 dispatcher_linkman发货人 dispatcher_phone发货联系电话 recevice_delivery发货地址 payment_entry付款信息单据体 deduction_balance抵扣预收款 totalunsettleamount未核销金额 attachments附件个数 attachments_url附件地址 auditorid_id审核人id auditorid_name审核人名称 auditorid_number审核人编码 audittime审核时间 alldebt应收款余额 flogisticsid物流公司内码 cost_fee销售费用 empid_id业务员id empid_name业务员名称 empid_number业务员编码 subsist_info预收款金额 lastdebt上次欠款 billstatus单据状态（已审核：“C”，未审核：“Z”） billclosestate关闭状态（未关闭：“C”，已关闭：“S”，手动关闭:“H”） transtype业务类型，现销：1，赊销：2，委托销售：3 material_entity商品分录 material_entity.picture图片url material_entity.materialid_id商品id material_entity.materialid_name商品名称 material_entity.materialid_number商品编码 material_entity.materialid_ismulti_unit商品是否多单位 material_entity.materialid_isserial商品是否序列号 material_entity.materialid_isasstattr商品是否启用辅助属性 material_entity.materialid_iskfperiod商品是否开启保质期 material_entity.materialid_isbatch商品是否开启批次 material_entity.materialid_model商品规格 material_entity.materialid_helpcode商品助记码 material_entity.stockid_id仓库id material_entity.stockid_name仓库名称 material_entity.stockid_number仓库编码 material_entity.stockid_isallowfreight仓库启用仓位管理 material_entity.spid_id仓位id material_entity.spid_name仓位名称 material_entity.spid_number仓位编码 material_entity.auxpropid_id辅助属性id material_entity.auxpropid_name辅助属性名称 material_entity.auxpropid_number辅助属性编码 material_entity.auxid1_id辅助属性1id material_entity.auxid1_name辅助属性1名称 material_entity.auxid1_number辅助属性1编码 material_entity.auxid2_id辅助属性2id material_entity.auxid2_name辅助属性2名称 material_entity.auxid2_number辅助属性2编码 material_entity.auxid3_id辅助属性3id material_entity.auxid3_name辅助属性3名称 material_entity.auxid3_number辅助属性3编码 material_entity.barcode条形码 material_entity.price单价 material_entity.taxprice含税单价 material_entity.acttaxprice实际含税单价 material_entity.baseunit_id基本单位id material_entity.baseunit_name基本单位名称 material_entity.baseunit_number基本单位编码 material_entity.unit_id单位id material_entity.unit_name单位名称 material_entity.unit_number单位编码 material_entity.coefficient换算率 material_entity.conversionrate换算公式 material_entity.qty数量 material_entity.inv_qty库存数量 material_entity.inv_baseqty基本库存数量 material_entity.return_qty_unit退货数量 material_entity.return_qty退货基本数量 material_entity.allamount价税合计 material_entity.taxamount税额 material_entity.billdisdistribution整单折扣分配额 material_entity.discount折扣 material_entity.fee销售费用分摊 material_entity.dividediffamount优惠分摊金额 material_entity.disrate折算率 material_entity.amount金额 material_entity.predisamount折前金额 material_entity.actnontaxamount实际不含税金额 material_entity.unitcost单位成本 material_entity.cost成本 material_entity.cursettleamount本次核销金额 material_entity.disamount折扣额 material_entity.disprice折扣单价 material_entity.batchno批次号 material_entity.proplace产地 material_entity.proregno注册证号 material_entity.prolicense生产许可证号 material_entity.kfdate生产日期 material_entity.validdate有效日期 material_entity.kftype保质期类型，1：天，2：月，3：年 material_entity.kfperiod保质期天数 material_entity.sn序列号 material_entity.snlistid序列号流转ID material_entity.auxunitid_id辅助单位id material_entity.auxunitid_name辅助单位名称 material_entity.auxunitid_number辅助单位编码 material_entity.auxcoefficient辅助换算率 material_entity.auxqty辅助单位数量 material_entity.cess增值税率 material_entity.seq分录序号 material_entity.entrystatus分录状态 material_entity.entrysettlestatus分录核销状态，未收款：A，部分收款：B，全部收款：C material_entity.is_free是否赠品 material_entity.comment行备注 material_entity.srcorderid源单id material_entity.srcbillno源单编码 material_entity.srcbilltypeid_id源单类型id material_entity.srcbilltypeid_name源单类型名称 material_entity.srcbilltypeid_number源单类型编码 material_entity.srcinterid源单内码 material_entity.src_billdate源单日期 material_entity.srcseq源单行号 material_entity.srcentryid源单分录内码 material_entity.custmaterialid_number客户商品编码（外部商品编码） material_entity.custmaterialid_name客户商品名称（外部商品名称） material_entity.outside_number外部商品编码 material_entity.outside_name外部商品名称 material_entity.outside_unit外部单位 material_entity.outside_barcode外部条码 material_entity.totalamount总金额 material_entity.billdate单据日期 material_entity.customerid客户ID material_entity.bill_dis_amount整单折扣额 material_entity.deptid_id部门id material_entity.deptid_name部门名称 material_entity.deptid_number部门编码 material_entity.remark单据备注 material_entity.bill_dis_rate折扣率 material_entity.createtime创建时间 material_entity.modifytime修改时间 material_entity.iostatus出入库状态,全部出库：“C”，部分出库：“Z”，未出库：“A”，待出库（=部分出库+未出库）：“B” material_entity.creatorid_id创建人id material_entity.creatorid_name创建人名称 material_entity.creatorid_number创建人编码 material_entity.modifierid_id修改人id material_entity.modifierid_name修改人名称 material_entity.modifierid_number修改人编码

锐思WMS接口明细

调用接口：/reserves/add
接口名称：出库预定
方法：POST

请求参数

字段字段名称类型配置值 orderNo销售订单编号string{{bill_no}} noticeNo发货通知单号string billType单据类型string110 bizDate业务日期Datetime{{bill_date}} createUser制单人string customerNo供应商（客户）IDstringmongoQuery b21744fd-c4b8-3ae5-a694-8ee8e92f3aa1 findField=content.number where={"content.id":{"$eq":"{{customer_id}}"}} deliveryType配送方式string01 address客户地址string{{custom_field12xb7c97yjojial}} contactName客户联系人string_function substring_index(substring_index('{{custom_field12xdyh73xiee3jiajsh}}',' ',-2),' ',1) contactTel客户电话string_function substring_index('{{custom_field12xdyh73xiee3jiajsh}}',' ',-1) memo备注string{{remark}} srcBillType源单类型string01 erpWharehoseNoERP仓库编码string items分录(LIST)arraymaterial_entity items.erpEntryIdERP分录内码string{{material_entity.material_id}} items.materialNo物料IDstring{{material_entity.material_number}} items.qty数量int{{material_entity.qty}} items.unit单位string{{material_entity.unit_number}} items.lot批号string items.productDate生产日期string items.isFcl是否整箱string2 items.isGift搭赠string items.price单价string{{material_entity.tax_price}} items.entryMemo明细行备注string{{material_entity.comment}}

系统对接总览

从API服务总线层面解决企业烟囱式业务系统集成现状相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。