金蝶云星辰V1与锐思WMS对接集成销售订单（列表+明细）打通出库预定

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

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

目标系统:锐思WMS

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

数据对接方案

使用轻易云系统数据集成平台对应的模块：数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统：金蝶云星辰V1，然后选择对应的连接器。选择对应的销售订单（列表+明细）作为数据对接来源。然后再通过写入目标平台配置目标系统为锐思WMS,并且选择对应连接器（关于锐思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

系统对接总览

随着企业数字化业务的深入发展，对于企业的 IT 或者 CIO 来讲，正在面临一个愈发重要的问题——系统的结构太复杂了，尤其是头部企业，至少有十多套系统，这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统，如何整合企业的现有IT资源，使企业中计算机孤岛式的应用向集体协作的方向发展，发挥资源效益的最大化，降低企业成本，正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上，操作统一，以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中，轻易云应用集成平台负责实现异构、分布式系统之间互联互通，实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件，连接现有各孤立应用系统，以图形化、拖拽方式构建集成流程和服务，提高应用系统集成工作效率，降低异构系统集成风险。针对未来可能出现的业务需求变更，在应用集成平台上进行动态调整，实现各应用系统之间的集成策略平滑升级。

金蝶云星辰V1与锐思WMS对接集成销售订单（列表+明细）打通出库预定