# kingdee-jdy

**Repository Path**: xhyplmm/kingdee-jdy

## Basic Information

- **Project Name**: kingdee-jdy
- **Description**: api对接金蝶系统 
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 0
- **Created**: 2023-07-28
- **Last Updated**: 2026-02-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Kingdee-JDY 电商平台数据同步系统

## 项目简介

Kingdee-JDY 是一个基于 Spring Boot 的电商平台与金蝶 ERP 系统之间的数据同步中间件。该项目实现了商品信息、库存数据、客户信息、订单数据等多维度数据的双向同步，支持定时自动同步与实时推送功能。

## 技术栈

- **Spring Boot 2.x** - 应用框架
- **Spring Scheduling** - 定时任务
- **OkHttp** - HTTP 客户端
- **Lombok** - 简化代码
- **Jackson** - JSON 处理

## 核心功能

### 数据同步服务
- **商品信息同步**: 实现商品基础资料、价格信息的跨系统同步
- **库存管理**: 支持批次库存、实时库存的查询与推送
- **客户数据**: 客户信息的拉取与推送
- **订单处理**: 订单信息的同步与发货状态回传

### 定时任务
| 任务名称 | 同步周期 | 功能说明 |
|---------|---------|---------|
| ProductStock | 每10分钟 | 库存数据同步 |
| ProductBatch | 每30分钟 | 批次库存同步 |
| ProductPrice | 每10分钟 | 价格信息同步 |
| orderPull | 每5分钟 | 订单数据拉取 |
| customerToErp | 每10分钟 | 客户信息推送 |
| customerToJd | 每5分钟 | 客户数据拉取 |
| orderDetail | 每30秒 | 订单详情同步 |

## 项目结构

```
src/main/java/com/xyy/kingdeejdy/
├── config/                 # 配置类
│   ├── ClientApiConfig.java
│   └── ScheduleConfig.java
├── enums/                  # 枚举定义
├── helper/                 # API 辅助类
├── param/                  # 查询参数类
├── pojo/                   # 数据传输对象
│   ├── erp/               # ERP 系统相关 DTO
│   └── pop/               # 平台系统相关 DTO
├── service/               # 服务层
│   ├── erp/              # ERP 数据获取服务
│   └── pop/              # 平台数据推送服务
├── task/                  # 定时任务
├── utils/                 # 工具类
└── KingdeeJdyApplication.java
```

## 配置说明

在 `application.properties` 中配置以下参数：

```properties
# 金蝶客户端配置
kingdee.client_id=your_client_id
kingdee.client_secret=your_client_secret
```

## API 集成

项目支持与多个电商平台的对接，通过 `PopConfig` 配置不同平台的连接信息：

```java
PopConfig popConfig = PopConfig.builder()
    .orgId("组织ID")
    .appId("应用ID")
    .appSecret("应用密钥")
    .build();
```

## 主要服务接口

### JdToPopService - ERP 数据获取服务
- `productInfoList()` - 获取商品列表
- `productStockBat()` - 批量库存查询
- `CustomerInfo()` - 客户信息查询
- `toJdOrderInfo()` - 订单推送

### PopToErpService - 平台数据推送服务
- `ProductInfoPush()` - 商品信息推送
- `ProductPricePush()` - 价格信息推送
- `ProductStockPush()` - 库存信息推送
- `orderInfoPull()` - 订单信息拉取

## 使用说明

1. 确保已配置金蝶 API 访问凭证
2. 根据业务需求调整定时任务的同步周期
3. 监控日志文件 `logs/` 观察同步状态

## 依赖管理

使用 Maven 进行依赖管理，主要依赖包括：
- Spring Boot Starter
- OkHttp
- Jackson
- Lombok

## 许可证

本项目遵循相关开源协议。