锐思WMS和金蝶云星辰V1单据接口对接

来源系统:金蝶云星辰V1

金蝶云·星辰基于金蝶云·苍穹云原生PaaS平台构建，聚焦小型企业在线经营和数字化管理，提供财务云、税务云、进销存云、零售云、订货商城等SaaS服务，支持企业拓客开源、智能管理、实时决策；金蝶云·星辰还提供轻量级PaaS平台和全面的API接口，广泛连接生态伙伴，为小微企业提供一站式服务，助力企业快速成长

接入系统：锐思WMS

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

系统对接接口配置

在轻易云平台进行集成方案的配置时，为了实现快速搭建，轻易云平台还提供了现有的市场方案进行复制参考。用户可以在创建集成方案的时候在第四步选择引用市场方案，参考市场主流所进行的字段配置完成集成方案的自定义化快速配置，即便是第一次使用轻易云平台的用户也能轻松搭建属于自己的数据同步方案。向导式配置，让配置更加清晰，首先确定该方方案的对接内容，第二歩获取筛选数据源平台的数据，第三步数据源与写入目标形成映射关系配置。完成配置后一键启用

金蝶云星辰V1接口明细

• 接口：/jdy/v2/scm/sal_order
• 接口名称：销售订单（列表+明细）
• 接口方法：GET

请求参数

字段	名称	类型	描述
bill_status	单据状态	string	（所有：“”，已审核：“C”，未审核：“Z”）
bill_close_state	单据关闭状态	string	（所有：“”，未关闭：“C”，已关闭：“S”,手动关闭: H）
start_bill_date	开始日期	string	（格式：“yyyy-MM-dd”，为空表示不过滤），单据日期
end_bill_date	结束日期	string	（格式：“yyyy-MM-dd”，为空表示不过滤），单据日期
create_start_time	开始日期	string	（格式：“yyyy-MM-dd”，为空表示不过滤），创建日期
create_end_time	结束日期	string	（格式：“yyyy-MM-dd”，为空表示不过滤），创建日期
modify_start_time	开始日期	string	（格式：“yyyy-MM-dd”，为空表示不过滤），修改日期
modify_end_time	结束日期	string	（格式：“yyyy-MM-dd”，为空表示不过滤），修改日期
search	模糊搜索	string	支持客户名称、职员名称、商品名称、单据编码
bill_source	单据来源	string	与单据新增保持一致
real_io_status	出库状态	string	（所有：“”，全部出库：“C”，部分出库：“Z”，未出库：“A”，待出库（=部分出库+未出库）：“B”）
io_status	执行状态	string	（所有：“”，全部执行：“C”，部分执行：“Z”，未执行：“A”，待执行（=部分执行+未执行）：“B”）
page	当前页	string	（默认1）
page_size	每页显示条数	string	（默认10，最大值100）
order_by	排序说明	string	[下面解析](# orderby排序说明)
show_material_total	是否统计商品种类和数量到单据	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接口明细

• API：/reserves/add
• NAME：出库预定
• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
orderNo	销售订单编号	{{bill_no}}
noticeNo	发货通知单号		星辰没有
billType	单据类型	110	110：销售出库120：退货出库140：其他出库141：领料出库144：调拨出库145：委外入库030：其他入库
bizDate	业务日期	{{bill_date}}	YYYY-MM-DD
createUser	制单人
customerNo	供应商（客户）ID	mongoQuery b21744fd-c4b8-3ae5-a694-8ee8e92f3aa1 findField=content.number where={"content.id":{"$eq":"{{customer_id}}"}}	销售出库时是客户，退货出库时是供应商
deliveryType	配送方式	01	01:送达 02：自提
address	客户地址	{{custom_field12xb7c97yjojial}}
contactName	客户联系人	_function substring_index(substring_index('{{custom_field12xdyh73xiee3jiajsh}}',' ',-2),' ',1)
contactTel	客户电话	_function substring_index('{{custom_field12xdyh73xiee3jiajsh}}',' ',-1)
memo	备注	{{remark}}
srcBillType	源单类型	01	01：销售订单02：发货通知单03：采购退料申请单
erpWharehoseNo	ERP仓库编码
items	分录(LIST)	material_entity
items.erpEntryId	ERP分录内码	{{material_entity.material_id}}	对接ERP时必需
items.materialNo	物料ID	{{material_entity.material_number}}	物料编码或ID
items.qty	数量	{{material_entity.qty}}	最小数量
items.unit	单位	{{material_entity.unit_number}}
items.lot	批号
items.productDate	生产日期		YYYY-MM-DD
items.isFcl	是否整箱	2	0：否 1：是 2：不控制
items.isGift	搭赠		0：否 1：是
items.price	单价	{{material_entity.tax_price}}
items.entryMemo	明细行备注	{{material_entity.comment}}

系统对接总览

通过数据集成平台可视化的快速配置调用接口打通金蝶云星辰V1与锐思WMS之间的数据接口，使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具，基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎，通过可视化配置，快速实现客户灵活多变的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。