金蝶云星空和吉客云单据接口对接

对接系统:吉客云
吉客云是基于“网店管家”十五年电商ERP行业和技术积累基础上顺应产业发展需求,重新定位、全新设计推出的换代产品,从业务数字化和组织数字化两个方向出发,以构建流程的闭环为依归,致力于为企业的数字化升级提供落地工具。
集成系统:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上,提供了标准的管理模式;通过标准的业务架构:多会计准则、多币别、多地点、多组织、多税制应用框架等,有效支持企业的运营管理;K/3Cloud提供了标准的业务建模:35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合,288个业务服务构件,让企业及伙伴可快速构建出行业化及个性化的应用。
系统对接接口配置
系统对接前期需要通过调研公司的业务,规划出最便捷,效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地,轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台:吉客云的接口参数设置,以及设定好目标平台:金蝶云星空的映射,即可启动方案进行测试
  


吉客云接口明细
- 调用接口:erp.storage.goodsdocin
 - 接口名称:调拨查询
 - 方法:POST
 
请求参数
| 字段 | 字段名称 | 类型 | 配置值 | 
|---|---|---|---|
| pageIndex | 分页页码 | string | |
| pageSize | 分页页数 | string | 50 | 
| goodsDocNo | 入库单号 | string | |
| startDate | 创建时间的起始时间 | string | 2021-11-01 00:00:00 | 
| endDate | 创建时间的结束时间 | string | 2025-10-31 23:59:59 | 
| inouttype | 入库类型 | string | 105 | 
| warehouseId | 仓库ID | string | |
| warehouseCode | 仓库编号 | string | |
| vendId | 供应商ID(往来单位) | string | |
| vendCode | 供应商编号(往来单位) | string | |
| billNo | 上游单据号(关联单号) | string | |
| userName | 创建人名称 | 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-否 1-是 | 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 | 
金蝶云星空接口明细
- API:batchSave
 - NAME:其他入库新增
 - METHOD:POST
 
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 | 
|---|---|---|---|
| FBillNo | 单据编号 | ||
| FStockOrgId | 库存组织 | findCollection find textField_kvgbyy6b from ba7b4c50-b81c-315d-835f-9e07995df2a1 where textField_kvja2xf9={{warehouseId}} | |
| FDate | 日期 | _function FROM_UNIXTIME( ( {{stocktakeDate}} / 1000 ) ,'%Y-%m-%d %T' ) | |
| FBillTypeID | 单据类型 | PY01_SYS | |
| FOwnerTypeIdHead | 货主类型 | BD_OwnerOrg | |
| FBillEntry | 明细信息 | stockCountGain | |
| FBillEntry.FMaterialId | 物料编码 | {{stockCountGain.goodsNo}} | |
| FBillEntry.FUnitID | 单位 | ||
| FBillEntry.FStockId | 仓库 | _findCollection find textField_kvgbyy68 from ba7b4c50-b81c-315d-835f-9e07995df2a1 where textField_kvja2xf9={{warehouseId}} | |
| FBillEntry.FCountQty | 盘点数量 | {{stockCountGain.takeQuan intval}} | |
| FBillEntry.FAcctQty | 账存数量 | {{stockCountGain.stockQuan intval}} | |
| FBillEntry.FormId | 业务对象表单Id | STK_StockCountGain | 必须填写金蝶的表单ID如UR_PurchaseOrder | 
| FBillEntry.IsVerifyBaseDataField | 验证基础资料 | false | 是否验证所有的基础资料有效性,布尔类,默认false(非必录) | 
| FBillEntry.Operation | 执行的操作 | Save | |
| FBillEntry.IsAutoSubmitAndAudit | 提交并审核 | false | 
系统对接概况
随着企业数字化业务的深入发展,对于企业的 IT 或者 CIO 来讲,正在面临一个愈发重要的问题——系统的结构太复杂了,尤其是头部企业,至少有十多套系统,这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统,如何整合企业的现有IT资源,使企业中计算机孤岛式的应用向集体协作的方向发展,发挥资源效益的最大化,降低企业成本,正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上,操作统一,以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中,轻易云应用集成平台负责实现异构、分布式系统之间互联互通,实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件,连接现有各孤立应用系统,以图形化、拖拽方式构建集成流程和服务,提高应用系统集成工作效率,降低异构系统集成风险。针对未来可能出现的业务需求变更,在应用集成平台上进行动态调整,实现各应用系统之间的集成策略平滑升级。
