---
# API: Product Exclusion (A2X)
# File: CE_PRODUCTEXCLUSION_0003.md
# Version: 3.0.0
# Status: ACTIVE
# Protocol: OData V4
# Source Service: /sap/opu/odata4/sap/ce_productexclusion/srvd_a2x/sap/productsubstitutionexclusion/0001/
# Generated: 2026-07-23 14:17:02
---

# Product Exclusion / 产品排除 API

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

## 概述 / Overview

该服务用于管理产品替代排除规则。定义在 aATP 替代流程中哪些产品被排除，确保排除的产品不会在推荐列表中出现。排除可基于时间范围生效。

This synchronous inbound OData V4 service manages product exclusion master data for the aATP substitution process. It defines which products are excluded from being considered as substitutes. Exclusions can be time-bound with validity dates.

**SAP 加速器中心:** `https://api.sap.com/api/CE_PRODUCTEXCLUSION_0003/overview`

---

## 实体列表 / Entity List

| # | 实体名称 | 描述 (EN) | 描述 (CN) | 主键 |
|---|----------|-----------|-----------|------|
| 1 | `A_ProductExclusion` | Product Exclusion | 产品排除 | `Product`, `Plant`, `ExcludedProduct` |

---

## 1. A_ProductExclusion — 产品排除

**实体集合路径:** `A_ProductExclusion`  
**主键 (Key):** `Product` (CHAR 40) + `Plant` (CHAR 4) + `ExcludedProduct` (CHAR 40)  
**ETag:** 支持

### 字段列表 / Field List

| 字段名 | 类型 | 长度 | 描述 (EN) | 描述 (CN) |
|--------|------|------|-----------|-----------|
| `Product` | String | 40 | Original Product | 原始产品编号 (主键) |
| `Plant` | String | 4 | Plant | 工厂 (主键) |
| `ExcludedProduct` | String | 40 | Excluded Product | 被排除产品编号 (主键) |
| `ExclusionReason` | String | 2 | Exclusion Reason | 排除原因 |
| `ExclusionReasonText` | String | 40 | Exclusion Reason Description | 排除原因描述 |
| `ValidFrom` | DateTimeOffset | - | Validity Start Date | 有效期起始日期 |
| `ValidTo` | DateTimeOffset | - | Validity End Date | 有效期截止日期 |
| `ValidityStartDate` | DateTime | - | Validity Start Date (Date only) | 有效期起始日 |
| `ValidityEndDate` | DateTime | - | Validity End Date (Date only) | 有效期截止日 |
| `IsActive` | Boolean | - | Extension Active Status | 排除激活状态 |
| `CreationDate` | DateTime | - | Record Created On | 创建日期 |
| `CreatedByUser` | String | 12 | Created By | 创建人 |
| `LastChangeDate` | DateTime | - | Last Changed On | 最后更改日期 |
| `LastChangedByUser` | String | 12 | Last Changed By | 最后更改人 |

### 导航属性 / Navigation Properties

| 导航属性 | 关联实体 | 描述 (EN) | 描述 (CN) |
|----------|----------|-----------|-----------|
| `to_Product` | A_Product | Original Product master data | 原始产品主数据 |
| `to_ExcludedProduct` | A_Product | Excluded product master data | 已排除产品主数据 |

---

## 使用示例 / Usage Examples

### 读取产品排除 GET

```
GET /sap/opu/odata4/sap/ce_productexclusion/srvd_a2x/sap/productsubstitutionexclusion/0001/A_ProductExclusion
  ?$filter=Product eq '\''M-100'\'' and Plant eq '\''PL01'\''
  &$format=json
```

### 创建产品排除 POST

```json
{
  "Product": "M-100",
  "Plant": "PL01",
  "ExcludedProduct": "M-300",
  "ExclusionReason": "01",
  "ValidFrom": "2026-01-01T00:00:00Z",
  "ValidTo": "2026-12-31T00:00:00Z",
  "IsActive": true
}
```
