---
# API: Production Version (A2X)
# File: CE_PRODUCTIONVERSION_0001.md
# Version: 1.0.1
# Status: ACTIVE
# Protocol: OData V4
# Source URL: https://api.sap.com/api/CE_PRODUCTIONVERSION_0001/overview
# Generated: 2026-07-23 14:17:02
---

# Production Version / 生产版本 API

> **API 版本:** 1.0.1 | **状态:** ACTIVE | **协议:** OData V4  
> **技术名称:** `CE_PRODUCTIONVERSION_0001`  
> **服务根路径:** `/sap/opu/odata4/sap/ce_productionversion/srvd_a2x/sap/productionversion/0001/`  
> **SAP 通信场景:** `SAP_COM_0109`

## 概述 / Overview

该服务支持读取生产版本主数据，包括物料、数量、BOM 和工艺路线等关键信息。

This synchronous inbound OData V4 service enables read access to production version master data, including material, quantities, BOM, and routing information.

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

---

## 实体列表 / Entity List

| # | 实体名称 | 描述 (EN) | 描述 (CN) | 主键 |
|---|----------|-----------|-----------|------|
| 1 | `A_ProductionVersion` | Production Version | 生产版本 | `Material`, `Plant`, `ProductionVersion`, `ProductionVersionFrom` |

---

## 1. A_ProductionVersion — 生产版本

**实体集合路径:** `A_ProductionVersion`  
**主键 (Key):** `Material` (String 40), `Plant` (String 4), `ProductionVersion` (String 4), `ProductionVersionFrom` (String 8)  
**ETag:** 支持

### 字段列表 / Field List

| 字段名 | 类型 | 长度 | 描述 (EN) | 描述 (CN) |
|--------|------|------|-----------|-----------|
| `Material` | String | 40 | Material Number | 物料编号 (主键) |
| `Plant` | String | 4 | Plant | 工厂 (主键) |
| `ProductionVersion` | String | 4 | Production Version | 生产版本 (主键) |
| `ProductionVersionFrom` | String | 8 | Valid-From Date | 有效起始日期 (主键) |
| `ProductionVersionTo` | String | 8 | Valid-To Date | 有效截止日期 |
| `ProductionVersionText` | String | 40 | Production Version Text | 生产版本文本 |
| `BillOfMaterialCategory` | String | 1 | BOM Category | BOM 类别 |
| `BillOfMaterial` | String | 8 | Bill of Material | 物料清单编号 |
| `BillOfMaterialVariant` | String | 2 | BOM Variant | BOM 备选方案 |
| `BillOfMaterialUsage` | String | 1 | BOM Usage | BOM 用途 |
| `RoutingGroup` | String | 8 | Routing Group | 工艺路线组 |
| `RoutingGroupCounter` | String | 2 | Routing Group Counter | 工艺路线组计数器 |
| `TaskListType` | String | 1 | Task List Type | 任务清单类型 |
| `TaskListGroup` | String | 8 | Task List Group | 任务清单组 |
| `TaskListGroupCounter` | String | 2 | Task List Group Counter | 任务清单组计数器 |
| `ProductionRateQuantity` | Decimal | 15 | Production Rate Quantity | 生产速率数量 |
| `BaseQuantity` | Decimal | 15 | Base Quantity | 基本数量 |
| `BaseMeasureUnit` | String | 3 | Base Unit of Measure | 基本计量单位 |
| `LotSizeMinimumQuantity` | Decimal | 15 | Minimum Lot Size | 最小批量 |
| `LotSizeMaximumQuantity` | Decimal | 15 | Maximum Lot Size | 最大批量 |
| `MaximumLotSizeQuantity` | Decimal | 15 | Maximum Lot Size Qty | 最大批量数量 |
| `MinimumLotSizeQuantity` | Decimal | 15 | Minimum Lot Size Qty | 最小批量数量 |
| `ProductionVersionActive` | Boolean | - | Active Status | 激活状态 |
| `CreationDate` | DateTime | - | Created On | 创建日期 |
| `LastChangeDate` | DateTime | - | Last Changed On | 最后更改日期 |
| `CreatedByUser` | String | 12 | Created By | 创建人 |
| `LastChangedByUser` | String | 12 | Last Changed By | 最后更改人 |
| `MaterialRevisionLevel` | String | 2 | Revision Level | 物料修订级别 |
| `ProductionVersionLocked` | Boolean | - | Locked Indicator | 锁定标识 |
| `IsMarkedForDeletion` | Boolean | - | Deletion Flag | 删除标识 |
| `ProductionVersionProfile` | String | 6 | Profile | 生产版本概要 |
| `ConfiguredMaterial` | String | 40 | Configurable Material | 可配置物料 |
| `BOMAlternative` | String | 2 | BOM Alternative | BOM 备选 |
| `MRPArea` | String | 10 | MRP Area | MRP 区域 |

### 导航属性 / Navigation Properties

| 属性名 | 目标实体 | 基数 | 描述 |
|--------|----------|------|------|
| `to_ProductionVersionBOM` | A_ProductionVersionBOM | 0..* | 生产版本 BOM |
| `to_ProductionVersionRouting` | A_ProductionVersionRouting | 0..* | 生产版本工艺路线 |

---

## CRUD 端点 / CRUD Endpoints

此 API 为只读 OData V4 服务，仅支持读取操作。

### 读取 (Read) — GET

```
GET /sap/opu/odata4/sap/ce_productionversion/srvd_a2x/sap/productionversion/0001/A_ProductionVersion
GET /sap/opu/odata4/sap/ce_productionversion/srvd_a2x/sap/productionversion/0001/A_ProductionVersion(Material='MAT',Plant='PLNT',ProductionVersion='0001',ProductionVersionFrom='20260101')
```

---

## OData V4 查询选项 / Query Options

| 参数 | 示例 | 说明 |
|------|------|------|
| `$filter` | `$filter=Material eq 'MAT'` | 过滤 |
| `$select` | `$select=Material,Plant,ProductionVersion` | 选择字段 |
| `$expand` | `$expand=to_ProductionVersionBOM` | 展开导航属性 |
| `$top` | `$top=100` | 返回前 N 条 |
| `$skip` | `$skip=50` | 跳过前 N 条 |
| `$orderby` | `$orderby=Material desc` | 排序 |
| `$count` | `$count=true` | 返回计数 |
| `$search` | `$search=ProductionVersionText` | 搜索 |

---

## ETag 处理 / ETag Handling

API 通过 ETag 支持乐观锁并发控制。

### 读取时使用 If-None-Match

```
GET /sap/opu/odata4/sap/ce_productionversion/srvd_a2x/sap/productionversion/0001/A_ProductionVersion(Material='MAT',Plant='PLNT',ProductionVersion='0001',ProductionVersionFrom='20260101')
If-None-Match: W/"datetime'2026-01-01T00%3A00%3A00'"
```

---

## 认证 / Authentication

### OAuth 2.0 (推荐)

```
Authorization: Bearer <access_token>
Content-Type: application/json
```

SAP S/4HANA Cloud 通常使用 OAuth 2.0 客户端凭证流。

### 基本认证 (Basic Auth)

```
Authorization: Basic <base64(username:password)>
```

用于 Service User / Communication User 场景。

### CSRF Token 处理

SAP 要求写操作必须携带有效的 CSRF Token：

```
GET /sap/opu/odata4/sap/ce_productionversion/srvd_a2x/sap/productionversion/0001/A_ProductionVersion
X-CSRF-Token: Fetch
```

---

## 错误码 / Error Codes

| HTTP 状态码 | 描述 (EN) | 描述 (CN) |
|-------------|-----------|-----------|
| 200 | OK | 请求成功 |
| 400 | Bad Request | 请求参数错误 |
| 401 | Unauthorized | 未授权 |
| 403 | Forbidden | 禁止访问 |
| 404 | Not Found | 资源不存在 |
| 412 | Precondition Failed | ETag 不匹配 |
| 500 | Internal Server Error | 服务器内部错误 |

---

## 相关资源 / References

| 资源 | 链接 |
|------|------|
| SAP API Business Hub | [https://api.sap.com/api/CE_PRODUCTIONVERSION_0001/overview](https://api.sap.com/api/CE_PRODUCTIONVERSION_0001/overview) |
| SAP Help Portal | [https://help.sap.com/docs/SAP_S4HANA_CLOUD](https://help.sap.com/docs/SAP_S4HANA_CLOUD) |