---
# API: Class Data for Classification (A2X)
# File: API_CLFN_CLASS_SRV.md
# Version: 1.1.1
# Status: ACTIVE
# Protocol: OData V2
# Source URL: https://api.sap.com/api/API_CLFN_CLASS_SRV/overview
# Generated: 2026-07-23 14:17:02
---

# Class Data for Classification / 分类类别数据 API

> **API 版本:** 1.1.1 | **状态:** ACTIVE | **协议:** OData V2  
> **技术名称:** `API_CLFN_CLASS_SRV`  
> **服务根路径:** `/sap/opu/odata/sap/API_CLFN_CLASS_SRV`  
> **SAP 通信场景:** `SAP_COM_0163`

## 概述 / Overview

该服务支持对分类系统使用的类别主数据进行创建、读取、更新和删除操作。类别用于对具有相似属性的对象进行分组，并关联特征以进行描述。

This synchronous inbound OData V2 service enables you to create, read, update, and delete class master data for classification. Classes are used to group objects with similar attributes and link characteristics for description purposes.

**API 业务加速器中心:** [https://api.sap.com/api/API_CLFN_CLASS_SRV/overview](https://api.sap.com/api/API_CLFN_CLASS_SRV/overview)

---

## 实体列表 / Entity List

| # | 实体名称 | 描述 (EN) | 描述 (CN) | 主键 |
|---|----------|-----------|-----------|------|
| 1 | `A_ClfnClass` | Class Header | 类别抬头 | `ClassType`, `ClassName` |
| 2 | `A_ClfnClassCharc` | Class Characteristic Assignment | 类别特征分配 | `ClassType`, `ClassName`, `CharacteristicName` |
| 3 | `A_ClfnClassDescription` | Class Description | 类别描述 | `ClassType`, `ClassName`, `Language` |
| 4 | `A_ClfnClassKeyword` | Class Keyword | 类别关键字 | `ClassType`, `ClassName`, `Keyword` |
| 5 | `A_ClfnClassText` | Class Text | 类别文本 | `ClassType`, `ClassName`, `Language`, `TextID` |

---

## 1. A_ClfnClass — 类别抬头

**实体集合路径:** `A_ClfnClass`  
**主键 (Key):** `ClassType` (CHAR 3), `ClassName` (CHAR 18)  
**ETag:** 支持

### 字段列表 / Field List

| 字段名 | 类型 | 长度 | 描述 (EN) | 描述 (CN) |
|--------|------|------|-----------|-----------|
| `ClassType` | String | 3 | Class Type (001=Material Class, 023=Batch Class, 300=Vendor Class) | 类别类型 (主键) |
| `ClassName` | String | 18 | Class Name | 类别名称 (主键) |
| `ClassStatus` | String | 1 | Status (1=Released, 2=In Preparation, 3=Locked) | 类别状态 |
| `ClassDescription` | String | 40 | Class Description | 类别描述 |
| `ClassificationStatus` | String | 1 | Classification Status | 分类状态 |
| `ClassGroup` | String | 10 | Class Group | 类别组 |
| `ClassSearchAuthGrp` | String | 4 | Search Authorization Group | 搜索授权组 |
| `ClassClassfctnAuthGrp` | String | 4 | Classification Authorization Group | 分类授权组 |
| `ClassMaintAuthGrp` | String | 4 | Maintenance Authorization Group | 维护授权组 |
| `DocNumber` | String | 25 | Document Number | 文档编号 |
| `DocumentType` | String | 3 | Document Type | 文档类型 |
| `DocumentPart` | String | 3 | Document Part | 文档部件 |
| `DocumentVersion` | String | 2 | Document Version | 文档版本 |
| `SameClassfctnReaction` | String | 1 | Reaction for Same Classification (X=Allow) | 相同分类反应 |
| `ClassStandardOrgName` | String | 10 | Standard Organization | 标准组织机构 |
| `ClassStandardNumber` | String | 20 | Standard Number | 标准编号 |
| `ClassStandardStartDate` | DateTime | - | Standard Validity Start | 标准有效起始日期 |
| `ClassStandardVersionStartDate` | DateTime | - | Standard Version Start | 标准版本起始日期 |
| `ClassStandardVersion` | String | 4 | Standard Version | 标准版本 |
| `ClassStandardCharcTable` | String | 30 | Standard Characteristic Table | 标准特征表 |
| `ClassIsLocal` | Boolean | - | Local Class | 本地类别标识 |
| `CreatedByUser` | String | 12 | Created By | 创建人 |
| `CreationDate` | DateTime | - | Created On | 创建日期 |
| `LastChangedByUser` | String | 12 | Last Changed By | 最后更改人 |
| `LastChangeDate` | DateTime | - | Last Changed On | 最后更改日期 |
| `ValidityStartDate` | DateTime | - | Validity Start Date | 有效起始日期 |
| `ValidityEndDate` | DateTime | - | Validity End Date | 有效截止日期 |

### 导航属性 / Navigation Properties

| 属性名 | 目标实体 | 基数 | 描述 |
|--------|----------|------|------|
| `to_ClassCharacteristic` | A_ClfnClassCharc | 0..* | 类别特征分配 |
| `to_ClassDescription` | A_ClfnClassDescription | 0..* | 类别描述 |
| `to_ClassKeyword` | A_ClfnClassKeyword | 0..* | 类别关键字 |
| `to_ClassText` | A_ClfnClassText | 0..* | 类别文本 |

---

## 2. A_ClfnClassCharc — 类别特征分配

**实体集合路径:** `A_ClfnClassCharc`  
**主键 (Key):** `ClassType` (CHAR 3), `ClassName` (CHAR 18), `CharacteristicName` (CHAR 30)

### 字段列表 / Field List

| 字段名 | 类型 | 长度 | 描述 (EN) | 描述 (CN) |
|--------|------|------|-----------|-----------|
| `ClassType` | String | 3 | Class Type | 类别类型 (主键) |
| `ClassName` | String | 18 | Class Name | 类别名称 (主键) |
| `CharacteristicName` | String | 30 | Characteristic Name | 特征名称 (主键) |
| `CharcIsOptional` | Boolean | - | Characteristic is Optional | 特征可选标识 |
| `CharcIsRequired` | Boolean | - | Characteristic is Required | 特征必填标识 |
| `CharcSortOrder` | Int16 | - | Sort Order | 排序顺序 |
| `ValueEntryDataType` | String | 1 | Value Entry Type | 值输入类型 |
| `CharcValueIsInterval` | Boolean | - | Characteristic Value is Interval | 特征值为区间标识 |
| `CharcValueIsDefault` | Boolean | - | Default Value Exists | 存在默认值标识 |

### 导航属性 / Navigation Properties

| 属性名 | 目标实体 | 基数 | 描述 |
|--------|----------|------|------|
| `to_Class` | A_ClfnClass | 1 | 所属类别 |

---

## 3. A_ClfnClassDescription — 类别描述

**实体集合路径:** `A_ClfnClassDescription`  
**主键 (Key):** `ClassType` (CHAR 3), `ClassName` (CHAR 18), `Language` (CHAR 2)

### 字段列表 / Field List

| 字段名 | 类型 | 长度 | 描述 (EN) | 描述 (CN) |
|--------|------|------|-----------|-----------|
| `ClassType` | String | 3 | Class Type | 类别类型 (主键) |
| `ClassName` | String | 18 | Class Name | 类别名称 (主键) |
| `Language` | String | 2 | Language Key | 语言代码 (主键) |
| `ClassDescription` | String | 40 | Class Description | 类别描述文本 |

---

## 4. A_ClfnClassKeyword — 类别关键字

**实体集合路径:** `A_ClfnClassKeyword`  
**主键 (Key):** `ClassType` (CHAR 3), `ClassName` (CHAR 18), `Keyword` (CHAR 20)

### 字段列表 / Field List

| 字段名 | 类型 | 长度 | 描述 (EN) | 描述 (CN) |
|--------|------|------|-----------|-----------|
| `ClassType` | String | 3 | Class Type | 类别类型 (主键) |
| `ClassName` | String | 18 | Class Name | 类别名称 (主键) |
| `Keyword` | String | 20 | Keyword | 关键字 (主键) |

---

## 5. A_ClfnClassText — 类别文本

**实体集合路径:** `A_ClfnClassText`  
**主键 (Key):** `ClassType` (CHAR 3), `ClassName` (CHAR 18), `Language` (CHAR 2), `TextID` (CHAR 4)

### 字段列表 / Field List

| 字段名 | 类型 | 长度 | 描述 (EN) | 描述 (CN) |
|--------|------|------|-----------|-----------|
| `ClassType` | String | 3 | Class Type | 类别类型 (主键) |
| `ClassName` | String | 18 | Class Name | 类别名称 (主键) |
| `Language` | String | 2 | Language Key | 语言代码 (主键) |
| `TextID` | String | 4 | Text ID | 文本ID (主键) |
| `LongText` | String | - | Long Text | 长文本 |

---

## CRUD 端点 / CRUD Endpoints

| 操作 | HTTP 方法 | 端点路径 |
|------|-----------|---------|
| 读取集合 | GET | `/{EntityCollection}` |
| 读取单个 | GET | `/{EntityCollection}(...key...)` |
| 创建 | POST | `/{EntityCollection}` |
| 更新 | PATCH | `/{EntityCollection}(...key...)` |
| 删除 | DELETE | `/{EntityCollection}(...key...)` |

各实体集合路径与实体名称一致。

---

## 认证 / Authentication

### OAuth 2.0 (推荐)
```
Authorization: Bearer <access_token>
```

### 基本认证 (Basic Auth)
```
Authorization: Basic <base64(username:password)>
```

### CSRF Token 处理
```http
GET /sap/opu/odata/sap/API_CLFN_CLASS_SRV/A_ClfnClass
X-CSRF-Token: Fetch
```

---

## 错误码 / Error Codes

| HTTP 状态码 | 描述 (EN) | 描述 (CN) |
|-------------|-----------|-----------|
| 200 | OK | 请求成功 |
| 201 | Created | 创建成功 |
| 204 | No Content | 无返回内容 |
| 400 | Bad Request | 请求参数错误 |
| 401 | Unauthorized | 未授权 |
| 403 | Forbidden | 禁止访问 |
| 404 | Not Found | 资源不存在 |
| 405 | Method Not Allowed | 方法不允许 (某些实体不支持 CUD) |
| 500 | Internal Server Error | 服务器内部错误 |

---

## 相关资源 / References

| 资源 | 链接 |
|------|------|
| SAP API Business Hub | [https://api.sap.com/api/API_CLFN_CLASS_SRV/overview](https://api.sap.com/api/API_CLFN_CLASS_SRV/overview) |
| SAP Help Portal (Cloud) | [https://help.sap.com/docs/SAP_S4HANA_CLOUD/7489fa08cede494cbdf08fa3651598af/34f342df989544e3913eda5bf42c4bc3.html](https://help.sap.com/docs/SAP_S4HANA_CLOUD/7489fa08cede494cbdf08fa3651598af/34f342df989544e3913eda5bf42c4bc3.html) |
| SAP Community | [https://community.sap.com/t5/technology-q-a/standard-api-odata-v2-class-data-for-classification/qaq-p/13759090](https://community.sap.com/t5/technology-q-a/standard-api-odata-v2-class-data-for-classification/qaq-p/13759090) |
