金蝶云星辰V1对接打通锐思WMS采购退货(列表+详情)接口与出库预定接口

对接源平台:金蝶云星辰V1

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

接通系统：锐思WMS

仓库管理(WMS)解决方案通过协调和优化资源使用和物料流动，助力企业充分利用劳动力、空间和所投资的设备。具体而言，WMS系统旨在满足整个供应链的需求，包括分销、制造、资产密集型和服务业务。

系统对接接口配置

使用轻易云系统数据集成平台对应的模块：数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统：金蝶云星辰V1，然后选择对应的连接器。选择对应的采购退货(列表+详情)作为数据对接来源。然后再通过写入目标平台配置目标系统为锐思WMS,并且选择对应连接器（关于锐思WMS的接口如何配置可以在轻易云数据集成社区论坛中找到相关信息,选择好对应的出库预定接口作为数据写入动作，既可以完成第一步的数据对接配置。

金蝶云星辰V1接口明细

接口：/jdy/v2/scm/pur_ret
接口名称：采购退货(列表+详情)
接口方法：GET

请求参数

字段	名称	类型	描述
dept_id	部门ID	string
supplier_id	供应商ID	string
customeri_d	客户ID	string
bill_status	单据状态	string	所有：“”，已审核：“C”，未审核：“Z”）
create_start_time	创建开始时间	string	格式：“时间戳”，-1表示不过滤），创建时间
create_end_time	创建结束时间	string	格式：“时间戳”，-1表示不过滤），创建时间
modify_start_time	修改开始时间	string	格式：“时间戳”，-1表示不过滤），修改时间
modify_end_time	修改结束时间	string	格式：“时间戳”，-1表示不过滤），修改时间
start_bill_date	单据开始日期	string	格式：“yyyy-MM-dd”，为空表示不过滤），单据日期
end_bill_date	单据结束日期	string	格式：“yyyy-MM-dd”，为空表示不过滤），单据日期
selectfields	自定义查询字段，如	string	material_entity.materialid.id）
search	模糊搜索，支持供应商名称、职员名称、商品名称、单据编码	string
page	当前页	string	默认1）
pagesize	每页显示条数，	string	默认10，最大值100）
detailAPI	detailAPI	string

响应参数

字段	名称	类型	描述
id	单据ID	String	单据ID
billno	单据编码	String	单据编码
billdate	单据日期	String	单据日期
billstatus	单据状态，Z：未审核，C：已审核	String	单据状态，Z：未审核，C：已审核
createtime	创建时间	String	创建时间
modifytime	修改时间	String	修改时间
audittime	审核时间	String	审核时间
creatorid_id	创建人id	String	创建人id
creatorid_name	创建人名称	String	创建人名称
creatorid_number	创建人编码	String	创建人编码
modifierid_id	修改人id	String	修改人id
modifierid_name	修改人名称	String	修改人名称
modifierid_number	修改人编码	String	修改人编码
auditorid_id	审核人id	String	审核人id
auditorid_name	审核人名称	String	审核人名称
auditorid_number	审核人编码	String	审核人编码
transtype	业务类型	String	业务类型
remark	备注	String	备注
deptid_id	部门id	String	部门id
deptid_name	部门名称	String	部门名称
deptid_number	部门编码	String	部门编码
empid_id	业务员id	String	业务员id
empid_name	业务员名称	String	业务员名称
empid_number	业务员编码	String	业务员编码
customerid_id	客户id	String	客户id
customerid_name	客户名称	String	客户名称
customerid_number	客户编码	String	客户编码
supplierid_id	供应商id	String	供应商id
supplierid_name	供应商名称	String	供应商名称
supplierid_number	供应商编码	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_address	具体地址	String	具体地址
totalunsettleamount	已核销金额	String	已核销金额
totalunsettleamountfor	已核销金额（本位币）	String	已核销金额（本位币）
exchangerate	汇率	String	汇率
alldebt	应付款余额	String	应付款余额
lastdebt	上次欠款余额	String	上次欠款余额
material_entity	商品分录	array	商品分录
material_entity.picture	图片url	String	图片url
material_entity.seq	分录序号	String	分录序号
material_entity.id	分录ID	String	分录ID
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.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.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.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.auxunitid_id	辅助单位id	String	辅助单位id
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.uninqty	未入库数量	String	未入库数量
material_entity.price	单价	String	单价
material_entity.discount	折扣（小数）	String	折扣（小数）
material_entity.comment	行备注	String	行备注
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.entrysettlestatus	分录核销状态	String	分录核销状态
material_entity.cursettleamountfor	本次核销金额	String	本次核销金额
material_entity.returnable_qty	可退数量	String	可退数量
material_entity.disrate	折扣率	String	折扣率
material_entity.cess	增值税率	String	增值税率

锐思WMS接口明细

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

请求参数

字段	名称	类型	描述
orderNo	销售订单编号	string
noticeNo	发货通知单号	string	星辰没有
billType	单据类型	string	110：销售出库120：退货出库140：其他出库141：领料出库144：调拨出库145：委外入库030：其他入库
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等等。

金蝶云星辰V1对接打通锐思WMS采购退货(列表+详情)接口与出库预定接口