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

本文介绍了金蝶云星空,一款基于WEB2.0和云技术的ERP系统,重点讲述了如何通过接口对接实现与其他系统的无缝协作,包括执行单据查询和批量保存操作,以及利用数据集成中台设计中心进行低代码集成,降低开发难度并提升效率。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

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

数据集成配置

接入系统:金蝶云星空

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

目标系统:金蝶云星空

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

系统对接接口配置

系统对接前期需要通过调研公司的业务,规划出最便捷,效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地,轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台:金蝶云星空的接口参数设置,以及设定好目标平台:金蝶云星空的映射,即可启动方案进行测试

MES系统集成

金蝶云星空接口明细

  • 接口:executeBillQuery
  • 接口名称:其他入库查询
  • 接口方法:POST
请求参数
字段名称类型描述
FEntity_FEntryIDFEntryIDstring
FID实体主键string
FBillNo单据编号string
FDocumentStatus单据状态string
FStockOrgId_FNumber库存组织string
FDate日期string
FBillTypeID单据类型string
FSUPPLIERID_FNumber供应商string
FNOTE备注string
FMATERIALID_FNumber物料编码string
FSTOCKID收货仓库string
FQty实收数量string
FPrice成本价string
FAmount总成本string
FBOMIDBOM版本string
FPRODUCEDATE生产日期string
FEXPIRYDATE有效期至string
FMTONO计划跟踪号string
FProjectNo项目编号string
FSTOCKSTATUSID库存状态string
FOWNERID货主string
FSTOCKFLAG库存更新标志string
FJoinQty关联数量string
FExpperiod保质期string
FExpUnit保质期单位string
FSRCBILLTYPEID源单类型string
FSRCBILLNO源单编号string
FLOT批号string
FEntryNote备注string
FStockLocId仓位string
FCMKBarCode零售条形码string
FInStockType入库类型string
Limit最大行数string金蝶的查询分页参数
StartRow开始行索引string金蝶的查询分页参数
TopRowCount返回总行数int金蝶的查询分页参数
FilterString过滤条件string示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>=
FieldKeys需查询的字段key集合array金蝶分录主键ID格式:FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber
FormId业务对象表单Idstring必须填写金蝶的表单ID如UR_PurchaseOrder
响应参数
字段名称类型描述
FEntity_FEntryIDFEntryIDstring
FID实体主键string
FBillNo单据编号string
FDocumentStatus单据状态string
FStockOrgId_FNumber库存组织string
FDate日期string
FBillTypeID单据类型string
FSUPPLIERID_FNumber供应商string
FNOTE备注string
FMATERIALID_FNumber物料编码string
FSTOCKID收货仓库string
FQty实收数量string
FPrice成本价string
FAmount总成本string
FBOMIDBOM版本string
FPRODUCEDATE生产日期string
FEXPIRYDATE有效期至string
FMTONO计划跟踪号string
FProjectNo项目编号string
FSTOCKSTATUSID库存状态string
FOWNERID货主string
FSTOCKFLAG库存更新标志string
FJoinQty关联数量string
FExpperiod保质期string
FExpUnit保质期单位string
FSRCBILLTYPEID源单类型string
FSRCBILLNO源单编号string
FLOT批号string
FEntryNote备注string
FStockLocId仓位string
FCMKBarCode零售条形码string
FInStockType入库类型string

金蝶云星空接口明细

  • 接口:batchSave
  • 接口名称:其他入库新增
  • 接口方法:POST
请求参数
字段名称类型描述
FBillNo单据编号string单据编号
FBillTypeID单据类型string单据类型
FStockOrgId库存组织string组织
FStockDirect库存方向string下拉列表
FDate日期string日期
FOwnerTypeIdHead货主类型string多类别基础资料列表
FOwnerIdHead货主string多类别基础资料
FNOTE备注string多行文本
FEntity明细信息array
FEntity.FInStockType入库类型string下拉列表
FEntity.FMATERIALID物料编码string基础资料
FEntity.FSTOCKID收货仓库string基础资料
FEntity.FQty实收数量string数量
FEntity.FPrice成本价string单价
FEntity.FUnitID单位string
FEntity.FOWNERID货主string
FEntity.FSTOCKSTATUSID库存状态string
FEntity.FSUPPLIERID供应商string
FEntity.FormId业务对象表单Idstring必须填写金蝶的表单ID如

😛

UR_PurchaseOrder
FEntity.IsVerifyBaseDataField验证基础资料bool是否验证所有的基础资料有效性,布尔类,默认false(非必录)
FEntity.Operation执行的操作string
FEntity.IsAutoSubmitAndAudit提交并审核bool

系统数据对接

数据集成中台设计中心Web界面以“拖拽”式交互设计,使用鼠标即可构建设计多异构系统数据集成流程,低代码平台大大降低流程设计者上手门槛。还有丰富的组件库快速满足复杂业务需求,结合不同模块即可生成不同业务流程,提升流程设计效率。平台支持多种高度灵活部署,高并发、高性能、高可用,可以通过多节点组成集群实现性能的横向扩展。适度集群配置其数据集成处理能力可达GB级/秒,为业务流提供更高数据吞吐量。平台已集成数据回压、优先级队列等能力,保障运行稳定性。完善的企业API运营管理机制帮助您构建“API生产者、API管理者、API消费者”三者结合的统一API数字化生态。支持市面上主流厂家软件如:金蝶、用友、SAP、泛微、蓝凌、旺店通、聚水潭、马帮、小满CRM等等。

轻易云数据集成中台

<think>好的,用户现在想要获取关于泛微OA系统与金蝶云星空对接时处理单据的Java代码示例。我需要结合之前提供的引用信息用户的历史问题来构建一个合适的回答。首先,回顾之前的引用内容,特别是引用[1]到[4],里面提到了数据同步、字段映射、格式转换以及异常处理等关键步骤。用户之前的问题也涉及数据重复录入、数据一致性第三方工具替代方案,但现在他们更关注具体的Java代码示例。我需要确定用户可能需要哪些代码示例。根据引用[3]提到的字段映射、格式转换数据筛选,以及引用[2]中的业务单据集成,比如差旅费报销单等,代码应该涵盖从OA获取数据,转换后传给金蝶云星空的流程。同时,用户可能希望看到如何处理认证、异常重试机制,这在引用[3][4]中都有提及。 接下来,我需要确保代码示例符合Java标准,使用常见的库如ApacheHttpClient或Spring的RestTemplate。同时,要包括数据转换的具体例子,比如日期格式转换。此外,异常处理重试机制部分,可以考虑使用try-catch块或SpringRetry等库。 还要注意引用标记,在适当的地方添加[^1]、[^2]等,确保用户知道信息来源于之前的引用内容。例如,在提到数据同步步骤时,引用[1][2]可能相关;字段映射部分对应引用[3]。此外,用户提到需要生成相关问题,我需要准备几个与代码示例相关的问题,比如异常处理、性能优化、数据校验等。最后,检查代码的正确性格式,确保没有语法错误,并且注释清晰。同时,保持回答结构清晰,分步骤解释每个部分的作用,帮助用户理解整个流程。</think>### 泛微OA与金蝶云星空单据对接Java代码示例 以下代码示例展示了如何通过Java实现泛微OA与金蝶云星空单据对接,包含数据提取、转换、加载等核心环节,并遵循金蝶云星空REST API规范[^2][^3]。 --- #### 1. 基础配置与认证 ```java // 泛微OA接口配置 public class OaConfig { public static final String OA_API_URL = "https://oa.example.com/api/workflow/request"; public static final String OA_TOKEN = "Bearer YOUR_OA_ACCESS_TOKEN"; } // 金蝶云星空接口配置 public class KingdeeConfig { public static final String KD_API_URL = "https://kd.example.com/api/v1/payment"; public static final String KD_APP_KEY = "YOUR_APP_KEY"; public static final String KD_APP_SECRET = "YOUR_APP_SECRET"; } ``` --- #### 2. 单据数据提取(泛微OA → Java) ```java import org.apache.http.client.methods.HttpGet; import org.apache.http.impl.client.CloseableHttpClient; import org.apache.http.impl.client.HttpClients; import org.apache.http.util.EntityUtils; public class OaDataFetcher { public String fetchPaymentRequests() throws Exception { try (CloseableHttpClient client = HttpClients.createDefault()) { HttpGet request = new HttpGet(OaConfig.OA_API_URL); request.setHeader("Authorization", OaConfig.OA_TOKEN); return EntityUtils.toString(client.execute(request).getEntity()); } } } ``` --- #### 3. 数据转换与映射 ```java import com.alibaba.fastjson.JSON; import com.alibaba.fastjson.JSONArray; import com.alibaba.fastjson.JSONObject; import java.text.SimpleDateFormat; public class DataTransformer { public JSONArray transformToKingdeeFormat(String oaData) { JSONArray transformed = new JSONArray(); JSONArray oaItems = JSON.parseArray(oaData); for (Object item : oaItems) { JSONObject oaItem = (JSONObject) item; JSONObject kingdeeItem = new JSONObject(); // 字段映射(示例:非生产付款申请单) kingdeeItem.put("FRequestID", oaItem.getString("requestId")); // [^3] kingdeeItem.put("FAmount", oaItem.getDouble("amount")); // 日期格式转换(YYYY-MM-DD → YYYYMMDD) SimpleDateFormat sdf = new SimpleDateFormat("yyyyMMdd"); kingdeeItem.put("FDate", sdf.format(oaItem.getDate("applyDate"))); // [^3] // 数据筛选(仅同步已审核单据) if ("APPROVED".equals(oaItem.getString("status"))) { // [^3] transformed.add(kingdeeItem); } } return transformed; } } ``` --- #### 4. 数据写入金蝶云星空 ```java import org.apache.http.client.methods.HttpPost; import org.apache.http.entity.StringEntity; import org.apache.http.impl.client.CloseableHttpClient; import org.apache.http.impl.client.HttpClients; public class KingdeeDataWriter { public void syncDataToKingdee(JSONArray data) throws Exception { try (CloseableHttpClient client = HttpClients.createDefault()) { HttpPost post = new HttpPost(KingdeeConfig.KD_API_URL); post.setHeader("Content-Type", "application/json"); post.setHeader("appKey", KingdeeConfig.KD_APP_KEY); post.setHeader("appSecret", KingdeeConfig.KD_APP_SECRET); // 异常重试机制(示例) for (int retry = 0; retry < 3; retry++) { try { post.setEntity(new StringEntity(data.toJSONString())); client.execute(post); break; // 成功则退出重试 } catch (Exception e) { if (retry == 2) throw e; Thread.sleep(1000); // [^3] } } } } } ``` --- #### 5. 主流程调用 ```java public class MainIntegration { public static void main(String[] args) { try { // 数据获取 String oaData = new OaDataFetcher().fetchPaymentRequests(); // 数据转换 JSONArray transformedData = new DataTransformer().transformToKingdeeFormat(oaData); // 数据写入 if (!transformedData.isEmpty()) { new KingdeeDataWriter().syncDataToKingdee(transformedData); } } catch (Exception e) { e.printStackTrace(); // 此处应添加日志记录告警通知[^2] } } } ``` --- ### 关键实现说明 1. **字段映射**:通过`FRequestID`等字段实现系统间标识符对应,需根据实际业务单据结构调整映射关系[^3] 2. **格式转换**:日期格式需统一为金蝶云星空要求的`YYYYMMDD`格式[^3] 3. **异常处理**:采用重试机制提高接口调用的可靠性,重试间隔可配置为指数退避策略[^2] 4. **性能优化**:批量处理建议使用金蝶云星空提供的`/batch`接口,减少API调用次数[^1] ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值