吉客云与金蝶云星空对接集成接口开发

吉客云与金蝶云星空对接集成入库单查询打通采购退货新增

对接系统：吉客云

“吉客云”是一站式企业数字化解决方案系统，可实现业务、财务、办公、人事等一体化管理。相对于传统多套软件系统的集成方案，“吉客云”具有业务流程更流畅，数据共享更充分，使用成本更低廉等优势。不仅如此，通过“吉链”，可以快捷的与您的合作伙伴进行系统对接。同时“吉客云”还打造了供销关系、仓储委托关系、生产委外加工关系、物流代发关系等多种企业间数字化协作通道，数据对接就像加微信好友一样方便！

对接目标平台:金蝶云星空

金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。

接口方案配置

数据集成平台对应的配置吉客云与金蝶云星空的对接只要三步就能完成两个系统之间的数据对接。第一步根据吉客云的接口参数要求记录在轻易云集成平台。第二步配置吉客云与金蝶云星空之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。

吉客云接口明细

• 调用接口：_erp.storage.goodsdocout_
• 接口名称：_入库单查询_
• 方法：_POST_

请求参数

字段	字段名称	类型	配置值
pageIndex	分页页码	string
pageSize	分页页数	string	50
goodsDocNo	入库单号	string
gmtModifiedStart	修改时间的起始时间	string	_function from_unixtime(({{LAST_SYNC_TIME}}-86400),'%Y-%m-%d %H:%i:%s')
gmtModifiedEnd	修改时间的结束时间	string	_function from_unixtime(({{CURRENT_TIME}}-86400),'%Y-%m-%d %H:%i:%s')
inouttype	入库类型	string	205
warehouseId	仓库ID	string
warehouseCode	仓库编号	string
vendId	供应商ID(往来单位)	string
vendCode	供应商编号(往来单位)	string
billNo	上游单据号(关联单号)	string
userName	创建人名称	string

响应参数

字段	字段名称	类型	配置值
recId	入库单ID	string
goodsdocNo	入库单号	string
billNo	上游单据号(关联单号)	string
inOutDate	入库时间	string
gmtCreate	创建时间	string
inouttype	入库类型	string
inouttypeName	入库类型	string
vendCustomerCode	往来单位编号	string
vendCustomerName	往来单位名称	string
currencyCode	币种编号	string
currencyRate	币种汇率	string
userName	业务员名字	string
warehouseCode	仓库编号	string
warehouseName	仓库名字	string
comment	备注	string
memo	收货备注	string
logisticName	物流公司	string
logisticNo	物流单号	string
companyId	公司id	string
companyName	公司名称	string
logisticType	物流类型	string
logisticCode	物流公司编码	string
inOutReason	入库原因	string
sourceBillNo	来源单号	string
channelId	渠道ID	string
channelCode	渠道编号	string
channelName	渠道名称	string
redStatus	红冲状态：1蓝单（未红冲）；2被冲蓝单；9红冲单	string
field1	自定义字段1	string
field2	自定义字段2	string
field3	自定义字段3	string
field4	自定义字段4	string
field5	自定义字段5	string
financeBillStatus	财务状态	string
goodsDocDetailList	入库单详情	array
goodsDocDetailList.recId	入库单明细ID	string
goodsDocDetailList.goodsId	货品ID	string
goodsDocDetailList.goodsNo	货品编号	string
goodsDocDetailList.goodsName	货品名称	string
goodsDocDetailList.skuId	规格ID	string
goodsDocDetailList.skuName	规格名称	string
goodsDocDetailList.skuBarcode	条码	string
goodsDocDetailList.unitName	单位	string
goodsDocDetailList.cuPrice	单价	string
goodsDocDetailList.cuValue	金额	string
goodsDocDetailList.caseNumber	箱号	string
goodsDocDetailList.rowRemark	明细备注	string
goodsDocDetailList.assistUnit	辅助单位显示	string
goodsDocDetailList.estCost	含税金额	string
goodsDocDetailList.estTax	税额	string
goodsDocDetailList.estPrice	含税单价	string
goodsDocDetailList.estPriceNoTax	含税单价	string
goodsDocDetailList.estCostNoTax	无税金额	string
goodsDocDetailList.taxRate	税率	string
goodsDocDetailList.batchNo	批次编号	string
goodsDocDetailList.serialNo	序列号	string
goodsDocDetailList.productionDate	生产日期	string
goodsDocDetailList.expirationDate	到期日期	string
goodsDocDetailList.shelfLife	质保期	string
goodsDocDetailList.shelfLiftUnit	质保期单位	string
goodsDocDetailList.sourceDetailId	来源单据明细Id	string
goodsDocDetailList.transNoTaxPrice	无税单价（原币种）	string
goodsDocDetailList.transNoTaxAmount	无税金额（原币种）	string
goodsDocDetailList.transHasTaxPrice	含税单价（原币种）	string
goodsDocDetailList.transHasTaxAmount	含税金额（原币种）	string
goodsDocDetailList.transTaxAmount	税额（原币种）	string
goodsDocDetailList.detailField1	自定义字段1	string
goodsDocDetailList.detailField2	自定义字段2	string
goodsDocDetailList.detailField3	自定义字段3	string
goodsDocDetailList.detailField4	自定义字段4	string
goodsDocDetailList.detailField5	自定义字段5	string
goodsDocDetailList.isCertified	是否正品0	string
goodsDocDetailList.registrationNumber	批准文号	string
goodsDocDetailList.approvalDate	批文有效期	string
goodsDocDetailList.productionDepart	生产单位	string
goodsDocDetailList.batchNumber	生产批号	string
goodsDocDetailList.quantity	数量	string
goodsDocDetailList.applyCompanyId	申请人公司ID	string
goodsDocDetailList.applyCompanyName	申请人公司名称	string
goodsDocDetailList.applyCompanyCode	申请人公司编号	string
goodsDocDetailList.applyDepartId	申请人部门id	string
goodsDocDetailList.applyDepartName	申请人部门名称	string
goodsDocDetailList.outBillNo	外部单号	string

金蝶云星空接口明细

• 接口：_batchSave_
• 接口名称：_采购退货新增_
• 接口方法：_POST_

请求参数

字段	名称	类型	描述
FBillNo	单据编号	string	单据编号
FDate	退料日期	string	日期
FSupplierID	供应商	string	基础资料
FStockOrgId	退料组织	string	组织
FSettleOrgId	结算组织	string	组织
FPayOrgId	付款组织	string	组织
FPURMRBENTRY	明细信息	array	明细信息
FPURMRBENTRY.FMATERIALID	物料编码	string	基础资料
FPURMRBENTRY.FRMREALQTY	实退数量	string	数量
FPURMRBENTRY.FSTOCKID	仓库	string	基础资料
FPURMRBENTRY.FPrice	单价	string	单价
FPURMRBENTRY.FLot	批号	string	批次
FPURMRBENTRY.FTAXPRICE	含税单价	string	单价
FPURMRBENTRY.F_LSJC_Text3	条码	string	条码
FPURMRBENTRY.FCostPrice	成本价	string	成本价
FPURMRBENTRY.FENTRYCOSTAMOUNT	总成本	string	总成本
FPURMRBENTRY.F_LSJC_Decimal	总成本（网店）	string	单价
FPURMRBENTRY.F_LSJC_Decimal1	销售成本价（网店）	string	单价
FPURMRBENTRY.FormId	业务对象表单Id	string	必须填写金蝶的表单ID如:PUR_PurchaseOrder
FPURMRBENTRY.Operation	执行的操作	string
FPURMRBENTRY.IsAutoSubmitAndAudit	提交并审核	bool
FPURMRBENTRY.IsVerifyBaseDataField	验证基础资料	bool	是否验证所有的基础资料有效性，布尔类，默认false（非必录）
FPURMRBENTRY.SubSystemId	系统模块	string	默认仓库模块

系统对接总览

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