---
# API: Plant Substitution / 工厂替代
# File: CE_PLANTSUBSTITUTION_0002.md
# Version: 2.0.0
# Status: ACTIVE
# Protocol: OData V4
# Source Service: /sap/opu/odata4/sap/ce_plantsubstitution/srvd_a2x/sap/plantsubstitution/0001/
# Generated: 2026-07-23 14:17:02
---

# Plant Substitution / 工厂替代 API

> **API 版本:** 2.0.0 | **状态:** ACTIVE | **协议:** OData V4  
> **技术名称:** `CE_PLANTSUBSTITUTION_0002`  
> **服务根路径:** `/sap/opu/odata4/sap/ce_plantsubstitution/srvd_a2x/sap/plantsubstitution/0001/`  
> **SAP 通信场景:** SAP_COM_0009

## 概述 / Overview

该服务用于管理工厂替代规则，属于 aATP 位置替代框架。当某个工厂无法满足需求时，系统根据定义的自动分配到替代工厂。

This synchronous inbound OData V4 service manages plant substitution master data within aATP Location Substitution. Alternate plants used when default cannot satisfy.

---

## 实体列表 / Entity List

| # | 实体名称 | 描述 (EN) | 描述 (CN) | 主键 |
|---|----------|-----------|-----------|------|
| 1 | `A_PlantSubstitution` | Plant Substitution | 工厂替代 | `Material`, `Plant`, `SubstitutePlant` |

---

## 1. A_PlantSubstitution — 工厂替代

**实体集合路径:** `A_PlantSubstitution`  
**主键 (Key):** `Material` + `Plant` + `SubstitutePlant`  
**ETag:** 支持

### 字段列表 / Field List

| 字段名 | 类型 | 长度 | 描述 (EN) | 描述 (CN) |
|--------|------|------|-----------|-----------|
| `Material` | String | 40 | Material Number | 物料编号 (主键) |
| `Plant` | String | 4 | Original Plant | 原始工厂 (主键) |
| `SubstitutePlant` | String | 4 | Substitute Plant | 替代工厂 (主键) |
| `SubstitutionReason` | String | 2 | Reason for Substitution | 替代原因 |
| `SequenceNumber` | Integer | - | Sequence of Substitution | 替代顺序 |
| `Leadlndicator` | Boolean | - | Lead substitute | 首要替代 |
| `Exitlndicator` | Boolean | - | Exit substitute | 终止替代 |
| `Validlndicator` | String | 1 | Validity period type | 有效期类型 |
| `ValidFrom` | DateTimeOffset | - | Validity Start | 有效期起 |
| `ValidTo` | DateTimeOffset | - | Validity End | 有效期止 |
| `IsActive` | Boolean | - | Active Status | 激活状态 |
| `CreationDate` | DateTime | - | Record Created On | 创建日期 |
| `CreatedByUser` | String | 12 | Created By | 创建人 |
| `LastChangeDate` | DateTime | - | Last Changed | 最后更改 |
| `LastChangedByUser` | String | 12 | Last Changed By | 最后更改人 |

### 导航属性 / Navigation Properties

| 导航属性 | 关联实体 | 描述 (EN) | 描述 (CN) |
|----------|----------|-----------|-----------|
| `to_Material` | A_Product | Material master | 物料主数据 |
| `to_Plant` | A_Plant | Original Plant | 原始工厂 |
| `to_Substitute` | A_Plant | Substitute Plant | 替代工厂 |

---

## 使用示例 / Usage Examples

### 读取 GET

```
GET /sap/opu/odata4/sap/ce_plantsubstitution/srvd_a2x/sap/plantsubstitution/0001/A_PlantSubstitution?$filter=Material eq '\''M-100'\''&$format=json
```

### 创建 POST

```json
{
  "Material": "M-100",
  "Plant": "PL01",
  "SubstitutePlant": "PL02",
  "SequenceNumber": 1,
  "ValidFrom": "2026-01-01T00:00:00Z",
  "ValidTo": "2027-01-01T00:00:00Z",
  "IsActive": true
}
```
