吉客云与金蝶云星空对接集成分页查询出库单打通其他出库新增

吉客云与金蝶云星空对接集成分页查询出库单打通其他出库新增

来源系统:吉客云

吉客云是基于“网店管家”十五年电商ERP行业和技术积累基础上顺应产业发展需求，重新定位、全新设计推出的换代产品，从业务数字化和组织数字化两个方向出发，以构建流程的闭环为依归，致力于为企业的数字化升级提供落地工具。

集成系统:金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

数据接口配置

集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：吉客云，源系统 API：分页查询出库单，目标系统：金蝶云星空，目标系统 API其他出库新增。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。

 

吉客云接口明细

• 接口：erp.storage.goodsdocout
• 接口名称：分页查询出库单
• 接口方法：POST

请求参数

字段	名称	类型	描述
pageIndex	分页页码	string
pageSize	分页页数	string
goodsDocNo	出库单号	string
startDate	创建时间的起始时间	string
endDate	创建时间的结束时间	string
inouttype	类型	string	201-销售出库 202调拨出库 203 = 盘亏出库 204-其他出库 205采购退货 206生产领料 207组装拆卸出库 208翻新出库 209报废出库 210残次品出库 211倒冲出库 212 包材出库 215维修还厂 231成本调整出库
sourceBillNo	来源单号	string
warehouseCode	仓库编号	string
vendCode	供应商编号(往来单位)	string
billNo	上游单据号(关联单号)	string
userName	创建人名称	string

响应参数

字段	名称	类型	描述
goodsdocNo	出库单号	string
billNo	上游单据号(关联单号)	string
inOutDate	出库时间	string
gmtCreate	创建时间	string
inouttype	出入库类型	string	出入库类型(201-销售出库 202调拨出库 204-其他出库 205采购退货 206生产领料 207组装拆卸出库 208翻新出库 209报废出库 210残次品出库 211倒冲出库 212 包材出库 215维修还厂 299可用库存修正 231成本调整出库)
inouttypeName	出入库类型	string	出入库类型(201-销售出库 202调拨出库 204-其他出库 205采购退货 206生产领料 207组装拆卸出库 208翻新出库 209报废出库 210残次品出库 211倒冲出库 212 包材出库 215维修还厂 299可用库存修正 231成本调整出库)
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	物流类型1-普通快递 2-上门自提 3-门店配送5-无需配送 6-线下配送	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	财务状态：1：未成本计算；11部分成本计算；21：已成本计算；25已财务记账；31不成本计算
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-否 1-是	string
goodsDocDetailList.registrationNumber	批准文号	string
goodsDocDetailList.approvalDate	批文有效期	string
goodsDocDetailList.productionDepart	生产单位	string
goodsDocDetailList.batchNumber	生产批号	string
goodsDocDetailList.quantity	数量	string
goodsDocDetailList.vendCustomerId	往来单位的id	string
goodsDocDetailList.applyDepartId	申请人部门id	string
goodsDocDetailList.applyDepartName	申请人部门名称	string
goodsDocDetailList.outBillNo	外部单号	string

金蝶云星空接口明细

• API：batchSave
• NAME：其他出库新增
• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
FBillNo	单据编号	{{goodsdocNo}}	单据编号
FBillTypeID	单据类型	TLD01_SYS	单据类型
FMRTYPE	退料类型	B	下拉列表
FMRMODE	退料方式	A	下拉列表
FStockOrgId	退料组织	findCollection find textField_kvgbyy6b from ba7b4c50-b81c-315d-835f-9e07995df2a1 where textField_kvgbyy68={{warehouseCode}}	组织
FDate	退料日期	_function FROM_UNIXTIME( ( {{inOutDate}} / 1000 ) ,'%Y-%m-%d %T' )	日期
FSupplierID	供应商	findCollection find code from 93f2ba96-c8a8-39b2-8445-35de3e908822 where vendId={{vendCustomerId}}	基础资料
FDESCRIPTION	备注	{{comment}}	多行文本
FSettleOrgId	结算组织	_findCollection find textField_kvgbyy6b from ba7b4c50-b81c-315d-835f-9e07995df2a1 where textField_kvgbyy68={{warehouseCode}}	组织
FOwnerTypeIdHead	货主类型	BD_OwnerOrg	多类别基础资料列表
FOwnerIdHead	货主	findCollection find textField_kvgbyy6b from ba7b4c50-b81c-315d-835f-9e07995df2a1 where textField_kvgbyy68={{warehouseCode}}	多类别基础资料
FPURMRBENTRY	明细信息	goodsDocDetailList
FPURMRBENTRY.FMATERIALID	物料编码	{{goodsDocDetailList.goodsNo}}	基础资料
FPURMRBENTRY.FRMREALQTY	实发数量	{{goodsDocDetailList.quantity}}	数量
FPURMRBENTRY.FSTOCKID	发货仓库	{{warehouseCode}}	基础资料
FPURMRBENTRY.FPrice	单价	{{goodsDocDetailList.cuPrice}}	单价
FPURMRBENTRY.FOWNERTYPEID	货主类型	BD_OwnerOrg	多类别基础资料列表
FPURMRBENTRY.FOwnerId	货主	_findCollection find textField_kvgbyy6b from ba7b4c50-b81c-315d-835f-9e07995df2a1 where textField_kvgbyy68={{warehouseCode}}	多类别基础资料
FPURMRBENTRY.FNOTE	备注	{{goodsDocDetailList.rowRemark}}	多行文本
FPURMRBENTRY.FTAXPRICE	含税单价	{{goodsDocDetailList.cuPrice}}
FPURMRBENTRY.F_JKBillNo	吉客云单据编号	{{goodsdocNo}}
FPURMRBENTRY.FormId	业务对象表单Id	PUR_MRB	必须填写金蝶的表单ID如 UR_PurchaseOrder
FPURMRBENTRY.IsAutoSubmitAndAudit	提交并审核	true
FPURMRBENTRY.IsVerifyBaseDataField	验证基础资料	false	是否验证所有的基础资料有效性，布尔类，默认false（非必录）
FPURMRBENTRY.Operation	执行的操作	Save

系统对接总览

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