---
# API: Advanced ATP Check (A2X) / 高级 ATP 检查 API
# File: CE_APIAVAILTOPROMISECHECK_0001.md
# Version: 1.0.0
# Status: ACTIVE
# Protocol: OData V4
# Source URL: https://api.sap.com/api/CE_APIAVAILTOPROMISECHECK_0001/overview
# Generated: 2026-07-23 14:17:02
---

# Advanced ATP Check (A2X) / 高级 ATP 检查 API

> **API 版本:** 1.0.0 | **状态:** ACTIVE | **协议:** OData V4  
> **技术名称:** `CE_APIAVAILTOPROMISECHECK_0001`  
> **服务根路径:** `/sap/opu/odata4/sap/ce_apiavailtopromisecheck/srvd_a2x/sap/advancedatpcheck/0001/`  
> **SAP 通信场景:** `SAP_COM_0173`

## 概述 / Overview

该服务基于高级可用性承诺（Advanced ATP / aATP）技术，模拟真实需求文档的可用性检查。考虑了供应保护（Supply Protection）和产品分配（Product Allocation）等基本方法，支持基本排程。该 API 模拟类似于销售订单的请求，并返回可用性结果。

This API enables you to perform a product availability check considering advanced ATP (aATP) basic methods such as product allocation (PAL) and supply protection (SUP). The API takes the sequence of the demand elements into account and considers their respective consumption within the request. It simulates a request like a sales order and returns availability results.

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

---

## 操作 / Operations

该服务通过 Action 提供高级 ATP 检查，通过实体提供检查结果。

| # | 名称 | 类型 | 描述 (EN) | 描述 (CN) |
|---|------|------|-----------|-----------|
| 1 | `AdvancedATPCheck` | Action | Perform Advanced ATP Check | 执行高级 ATP 检查 |
| 2 | `A_AdvancedATPResult` | Entity | Advanced ATP Check Result | 高级 ATP 检查结果 |

---

## 1. AdvancedATPCheck Action — 执行高级 ATP 检查

通过 POST 请求调用此 Action 执行可用性模拟检查。

### 请求端点

```
POST /sap/opu/odata4/sap/ce_apiavailtopromisecheck/srvd_a2x/sap/advancedatpcheck/0001/AdvancedATPCheck
Content-Type: application/json
```

### 输入参数 / Input Parameters

| 参数名 | 类型 | 长度 | 描述 (EN) | 描述 (CN) |
|--------|------|------|-----------|-----------|
| `SalesOrder` | String | 10 | Sales Order | 销售订单号 |
| `SalesOrderItem` | String | 6 | Sales Order Item | 销售订单行项目 |
| `Product` | String | 40 | Product Number | 产品编号 |
| `Plant` | String | 4 | Plant | 工厂 |
| `StorageLocation` | String | 4 | Storage Location | 库存地点 |
| `Batch` | String | 10 | Batch Number | 批次号 |
| `RequestedQuantity` | Decimal | - | Requested Quantity | 请求数量 |
| `RequestedQuantityUnit` | String | 3 | Requested Quantity Unit | 请求数量单位 |
| `RequestedDate` | DateTimeOffset | - | Requested Delivery Date | 请求交货日期 |
| `ATPCheckingRule` | String | 1 | ATP Checking Rule | ATP 检查规则 |
| `BusinessPartner` | String | 10 | Business Partner | 业务伙伴 (用于供应保护) |
| `DocumentPurpose` | String | 3 | Document Purpose (SLS/STO/DEL) | 单据用途 |

### 供应保护特性 / Supply Protection Characteristics

通过 `_DocumentAttributes._Characteristics` 传递：

```json
"_DocumentAttributes": {
  "ATPRelevantDocumentPurpose": "SLS",
  "_Characteristics": [
    {
      "CharcCatalogCharacteristicName": "SD-DISTRIBUTIONCHANNEL",
      "CharcCatalogCharcValue": "10"
    }
  ]
}
```

### 响应 / Response

Action 返回集合 `A_AdvancedATPResult`。

---

## 2. A_AdvancedATPResult — 高级 ATP 检查结果

**实体集合路径:** `A_AdvancedATPResult`  
**主键 (Key):** `ATPCheckUUID` (GUID)

### 字段列表 / Field List

| 字段名 | 类型 | 长度 | 描述 (EN) | 描述 (CN) |
|--------|------|------|-----------|-----------|
| `ATPCheckUUID` | Guid | - | ATP Check UUID | ATP 检查 UUID (主键) |
| `SalesOrder` | String | 10 | Sales Order | 销售订单号 |
| `SalesOrderItem` | String | 6 | Sales Order Item | 销售订单行项目 |
| `Product` | String | 40 | Product | 产品编号 |
| `ProductName` | String | 40 | Product Description | 产品描述 |
| `Plant` | String | 4 | Plant | 工厂 |
| `StorageLocation` | String | 4 | Storage Location | 库存地点 |
| `Batch` | String | 10 | Batch | 批次号 |
| `RequestedQuantity` | Decimal | - | Requested Quantity | 请求数量 |
| `RequestedQuantityUnit` | String | 3 | Requested Quantity Unit | 请求数量单位 |
| `ConfirmedQuantity` | Decimal | - | Confirmed Quantity | 已确认数量 |
| `ConfirmedQuantityUnit` | String | 3 | Confirmed Quantity Unit | 已确认数量单位 |
| `ConfirmedDate` | Date | - | Confirmed Delivery Date | 确认交货日期 |
| `ConfirmedDateTime` | DateTimeOffset | - | Confirmed Date/Time | 确认日期时间 |
| `AvailabilityStatus` | String | 1 | Availability Status | 可用性状态 |
| `AvailabilityStatusCode` | String | 1 | Status Code (A=Available, B=Partially, C=Not Available) | 状态代码 |
| `AvailabilityCheckResult` | String | 1 | ATP Check Result | ATP 检查结果 |
| `ATPCheckingRule` | String | 1 | ATP Checking Rule Used | 使用的ATP检查规则 |
| `CheckedQuantity` | Decimal | - | Checked Quantity | 检查数量 |
| `SalesMeasureUnit` | String | 3 | Sales Unit | 销售单位 |
| `BaseUnit` | String | 3 | Base Unit | 基本计量单位 |
| `AvailabilityDate` | Date | - | Availability Date | 可用日期 |
| `AvailabilityDateTime` | DateTimeOffset | - | Availability Date/Time | 可用日期时间 |
| `GoodsIssueDate` | Date | - | Goods Issue Date | 发货日期 |
| `ScheduleLineCategory` | String | 2 | Schedule Line Category | 计划行类别 |
| `RequestedDeliveryDate` | Date | - | Requested Delivery Date | 请求交货日期 |
| `ConfirmedDeliveryDate` | Date | - | Confirmed Delivery Date | 确认交货日期 |
| `MaterialAvailabilityDate` | Date | - | Material Availability Date | 物料可用日期 |
| `MaterialAvailDate` | Date | - | Mat. Availability Date (internal) | 物料可用日期内部 |
| `LoadingDate` | Date | - | Loading Date | 装货日期 |
| `TransportationDate` | Date | - | Transport. Date | 运输日期 |
| `OverallCommtsStatus` | String | 1 | Overall Commts Status | 总体承诺状态 |

### 可用性状态代码 / Availability Status Codes

| 代码 | 描述 (EN) | 描述 (CN) |
|------|-----------|-----------|
| `A` | Available / Fully Confirmed | 可用 / 全部确认 |
| `B` | Partially Confirmed | 部分确认 |
| `C` | Not Available / Not Confirmed | 不可用 / 未确认 |
| `X` | No ATP Check Performed | 未执行 ATP 检查 |

---

## 请求示例 / Request Example

### 基本 ATP 检查（不创建预留）

```json
POST /sap/opu/odata4/sap/ce_apiavailtopromisecheck/srvd_a2x/sap/advancedatpcheck/0001/AdvancedATPCheck
Content-Type: application/json

{
  "Product": "TG11",
  "Plant": "1000",
  "StorageLocation": "0001",
  "RequestedQuantity": 100,
  "RequestedQuantityUnit": "PCE",
  "RequestedDate": "2026-08-15",
  "ATPCheckingRule": "A"
}
```

### 带供应保护的 ATP 检查

```json
{
  "Product": "TG11",
  "Plant": "1000",
  "RequestedQuantity": 50,
  "RequestedQuantityUnit": "PCE",
  "RequestedDate": "2026-08-15",
  "ATPCheckingRule": "A",
  "BusinessPartner": "10100001",
  "DocumentPurpose": "SLS",
  "_DocumentAttributes": {
    "ATPRelevantDocumentPurpose": "SLS",
    "_Characteristics": [
      {
        "CharcCatalogCharacteristicName": "SD-DISTRIBUTIONCHANNEL",
        "CharcCatalogCharcValue": "10"
      },
      {
        "CharcCatalogCharacteristicName": "SD_PAR_ADR_PF.WE-COUNTRY",
        "CharcCatalogCharcValue": "DE"
      }
    ]
  }
}
```

### 带销售订单参考的 ATP 检查

```json
{
  "SalesOrder": "12345",
  "SalesOrderItem": "10",
  "Product": "TG11",
  "Plant": "1000",
  "RequestedQuantity": 50,
  "RequestedQuantityUnit": "PCE",
  "RequestedDate": "2026-08-15",
  "ATPCheckingRule": "A"
}
```

---

## 与 Product Availability Info 的区别 / Key Differences

| 特性 | Advanced ATP Check | Product Availability Info |
|------|-------------------|--------------------------|
| 场景 | 模拟需求文档检查 | 查询一般可用性快照 |
| 消耗 | 可以创建临时消耗 | 不创建消耗 |
| 产品分配 | 考虑 | 不考虑 |
| 多次调用 | 结果可能不同(消耗后) | 结果相同 |
| 排程 | 支持基本排程 | 不排程 |

---

## 相关资源 / References

| 资源 | 链接 |
|------|------|
| SAP API Business Hub | [https://api.sap.com/api/CE_APIAVAILTOPROMISECHECK_0001/overview](https://api.sap.com/api/CE_APIAVAILTOPROMISECHECK_0001/overview) |
| SAP Help Portal (Advanced ATP) | [https://help.sap.com/docs/SAP_S4HANA_ON-PREMISE/0cf4767324ae455ba9c9b5fb63a8fd5a.html](https://help.sap.com/docs/SAP_S4HANA_ON-PREMISE/0cf4767324ae455ba9c9b5fb63a8fd5a.html) |
| SAP Community Blog | [https://community.sap.com/t5/enterprise-resource-planning-blog-posts-by-sap/two-apis-to-retrieve-availability-information/ba-p/13576755](https://community.sap.com/t5/enterprise-resource-planning-blog-posts-by-sap/two-apis-to-retrieve-availability-information/ba-p/13576755) |
| SAP Cloud SDK Java | [https://sap.github.io/cloud-sdk/docs/java/features/odata/v4-vdm-client](https://sap.github.io/cloud-sdk/docs/java/features/odata/v4-vdm-client) |
