---
# API: Payment Release List Approval (A2X)
# File: API_CN_PAYMENTRELEASELIST_APPR_SRV.md
# Version: 1.0.0
# Status: ACTIVE
# Protocol: OData V2
# Source URL: https://api.sap.com/api/API_CN_PAYMENTRELEASELIST_APPR_SRV/overview
# Generated: 2026-07-23 15:00:00
---

# Payment Release List Approval / 付款放行清单审批 API

> **API 版本:** 1.0.0 | **状态:** ACTIVE | **协议:** OData V2  
> **技术名称:** `API_CN_PAYMENTRELEASELIST_APPR_SRV`  
> **服务根路径:** `/sap/opu/odata/sap/API_CN_PAYMENTRELEASELIST_APPR_SRV`  
> **SAP 通信场景:** `SAP_COM_0711` (Finance - China Payment Approval Integration)

## 概述 / Overview

该服务支持对付款放行清单的抬头和项目进行读取操作，以及更新付款项目的审批状态。此 API 是 SAP S/4HANA 中国本地化付款审批集成的一部分，适用于应付账款（J60）范围。

This synchronous OData V2 service enables reading payment release list headers and items, and updating the approval status of payment items. It is part of the China Payment Approval Integration for SAP S/4HANA, under the Accounts Payable (J60) scope item.

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

---

## 实体列表 / Entity List

| # | 实体名称 | 描述 (EN) | 描述 (CN) | 主键 |
|---|----------|-----------|-----------|------|
| 1 | `A_PaymentHeader` | Payment Release List Header | 付款放行清单抬头 | `PaymentHeader` |
| 2 | `A_PaymentItem` | Payment Release List Item | 付款放行清单项目 | `PaymentHeader`, `PaymentItem` |

### 动作 (Action)

| 动作名称 | 描述 (EN) | 描述 (CN) |
|----------|-----------|-----------|
| `SetApprovalStatus` | Set approval status for payment items | 设置付款项目审批状态 |

---

## 1. A_PaymentHeader — 付款放行清单抬头

**实体集合路径:** `A_PaymentHeader`  
**主键 (Key):** `PaymentHeader` (CHAR 10)  
**ETag:** 不支持

### 字段列表 / Field List

| 字段名 | 类型 | 长度 | 描述 (EN) | 描述 (CN) |
|--------|------|------|-----------|-----------|
| `PaymentHeader` | String | 10 | Payment Header Number | 付款抬头编号 (主键) |
| `CompanyCode` | String | 4 | Company Code | 公司代码 |
| `Supplier` | String | 10 | Supplier Account Number | 供应商账户号 |
| `PaymentDocument` | String | 10 | Payment Document Number | 付款凭证编号 |
| `PaymentDocumentDate` | DateTime | - | Payment Document Date | 付款凭证日期 |
| `PaymentMethod` | String | 1 | Payment Method | 付款方式 |
| `PaymentCurrency` | String | 5 | Payment Currency | 付款货币 |
| `HeaderPaymentAmount` | Decimal | 23 | Payment Amount in Header Currency | 抬头付款金额 |
| `PaymentDocIntegrationStatus` | String | 1 | Integration Status of Payment Document | 付款凭证集成状态 |
| `PaymentDocumentReference` | String | 10 | Payment Document Reference | 付款凭证参考 |
| `PaymentDocIntegrationApprStatus` | String | 1 | Approval Status of Payment Document | 付款凭证审批状态 |
| `PaymentHeaderIsBlocked` | Boolean | - | Blocking Indicator for Payment Header | 付款抬头锁定标识 |
| `CreationDate` | DateTime | - | Date on Which Record Was Created | 创建日期 |
| `CreatedByUser` | String | 12 | Name of Person Who Created the Object | 创建人 |
| `LastChangedByUser` | String | 12 | Name of Person Who Last Changed the Object | 最后更改人 |
| `LastChangeDate` | DateTime | - | Date of Last Change | 最后更改日期 |

---

## 2. A_PaymentItem — 付款放行清单项目

**实体集合路径:** `A_PaymentItem`  
**主键 (Key):** `PaymentHeader` (CHAR 10), `PaymentItem` (CHAR 6)  
**ETag:** 不支持

### 字段列表 / Field List

| 字段名 | 类型 | 长度 | 描述 (EN) | 描述 (CN) |
|--------|------|------|-----------|-----------|
| `PaymentHeader` | String | 10 | Payment Header Number | 付款抬头编号 |
| `PaymentItem` | String | 6 | Payment Item Number | 付款项目编号 |
| `InvoiceReference` | String | 10 | Invoice Reference Number | 发票参考编号 |
| `InvoiceReferenceFiscalYear` | String | 4 | Fiscal Year of Invoice Reference | 发票参考会计年度 |
| `InvoiceDocument` | String | 10 | Invoice Document Number | 发票凭证编号 |
| `InvoiceFiscalYear` | String | 4 | Fiscal Year of Invoice Document | 发票凭证会计年度 |
| `InvoiceItem` | String | 6 | Invoice Item Number | 发票行项目编号 |
| `ReferenceDocument` | String | 10 | Reference Document Number | 参考凭证编号 |
| `ReferenceDocumentFiscalYear` | String | 4 | Fiscal Year of Reference Document | 参考凭证会计年度 |
| `Supplier` | String | 10 | Supplier Account Number | 供应商账户号 |
| `InvoiceAmount` | Decimal | 23 | Invoice Amount in Document Currency | 发票金额 |
| `PaymentAmount` | Decimal | 23 | Payment Amount in Payment Currency | 付款金额 |
| `CashDiscountAmount` | Decimal | 23 | Cash Discount Amount | 现金折扣金额 |
| `PaymentAdviceAccount` | String | 10 | Payment Advice Account | 付款通知账户 |
| `ApprovalStatus` | String | 2 | Approval Status | 审批状态 |
| `PaymentItemIsBlocked` | Boolean | - | Blocking Indicator for Payment Item | 付款项目锁定标识 |
| `PaymentItemText` | String | 50 | Payment Item Text | 付款项目文本 |
| `PaymentMethod` | String | 1 | Payment Method | 付款方式 |
| `PaymentCurrency` | String | 5 | Payment Currency | 付款货币 |
| `BaselineDate` | DateTime | - | Baseline Date for Due Calculation | 起算日期 |
| `CashDiscountDays1` | Decimal | 3 | Cash Discount Days 1 | 现金折扣天数1 |
| `CashDiscountDays2` | Decimal | 3 | Cash Discount Days 2 | 现金折扣天数2 |
| `CashDiscountPercent1` | Decimal | 5 | Cash Discount Percentage 1 | 现金折扣百分比1 |
| `CashDiscountPercent2` | Decimal | 5 | Cash Discount Percentage 2 | 现金折扣百分比2 |
| `NetPaymentDays` | Decimal | 3 | Net Payment Days | 净付款天数 |
| `PaymentTerms` | String | 4 | Payment Terms Key | 付款条件代码 |
| `SupplierName` | String | 80 | Supplier Name | 供应商名称 |
| `ClearingDate` | DateTime | - | Clearing Date | 清账日期 |
| `AssignmentReference` | String | 18 | Assignment Reference | 分配参考 |
| `CreationDate` | DateTime | - | Date on Which Record Was Created | 创建日期 |
| `CreatedByUser` | String | 12 | Name of Person Who Created the Object | 创建人 |
| `LastChangedByUser` | String | 12 | Name of Person Who Last Changed the Object | 最后更改人 |
| `LastChangeDate` | DateTime | - | Date of Last Change | 最后更改日期 |

---

## 动作 / Actions

### SetApprovalStatus — 设置审批状态

为指定的付款项目设置审批状态。此操作支持三种状态：审批中、批准付款、拒绝。

Sets the approval status for specified payment items. Supports three states: Approval In Progress, Approved for Payment, Rejected.

**端点:**

```
POST /sap/opu/odata/sap/API_CN_PAYMENTRELEASELIST_APPR_SRV/A_PaymentItem(PaymentHeader='<header>',PaymentItem='<item>')/SetApprovalStatus
Content-Type: application/json
```

**参数:**

| 参数名 | 类型 | 描述 (EN) | 描述 (CN) |
|--------|------|-----------|-----------|
| `ApprovalStatus` | Enum | Approval Status | 审批状态 |

**可选值:**

| 值 | 描述 (EN) | 描述 (CN) |
|----|-----------|-----------|
| `ApprovalInProgress` | Approval In Progress | 审批中 |
| `ApprovedForPayment` | Approved for Payment | 批准付款 |
| `Rejected` | Rejected | 拒绝 |

**请求示例:**

```json
{
  "ApprovalStatus": "ApprovedForPayment"
}
```

---

## 使用示例 / Usage Examples

### 查询付款放行清单 (含项目)

```
GET /sap/opu/odata/sap/API_CN_PAYMENTRELEASELIST_APPR_SRV/A_PaymentHeader?$expand=to_PaymentItem&$top=10
```

### 按供应商过滤

```
GET /sap/opu/odata/sap/API_CN_PAYMENTRELEASELIST_APPR_SRV/A_PaymentItem?$filter=Supplier eq '0010001234' and ApprovalStatus eq 'ApprovalInProgress'
```

### 批量审批

```http
--batch_001
Content-Type: application/http
Content-Transfer-Encoding: binary

POST A_PaymentItem(PaymentHeader='HDR0000001',PaymentItem='000001')/SetApprovalStatus HTTP/1.1
Content-Type: application/json

{ "ApprovalStatus": "ApprovedForPayment" }

--batch_001
Content-Type: application/http
Content-Transfer-Encoding: binary

POST A_PaymentItem(PaymentHeader='HDR0000001',PaymentItem='000002')/SetApprovalStatus HTTP/1.1
Content-Type: application/json

{ "ApprovalStatus": "Rejected" }

--batch_001--
```

---

## CRUD 端点 / CRUD Endpoints

| 实体 | 创建 (POST) | 读取 (GET) | 更新 (PATCH) | 删除 (DELETE) |
|------|-------------|------------|-------------|---------------|
| A_PaymentHeader | — | ✓ | — | — |
| A_PaymentItem | — | ✓ | ✓ | — |

---

## OData 查询选项 / Query Options

| 参数 | 示例 | 说明 |
|------|------|------|
| `$filter` | `$filter=Supplier eq '0010001234'` | 过滤 |
| `$select` | `$select=PaymentHeader,Supplier,PaymentAmount` | 选择字段 |
| `$expand` | `$expand=to_PaymentItem` | 展开导航属性 |
| `$top` | `$top=100` | 返回前 N 条 |
| `$skip` | `$skip=50` | 跳过前 N 条 |
| `$orderby` | `$orderby=PaymentHeader desc` | 排序 |
| `$count` | `$count=true` | 返回计数 |

---

## 认证 / Authentication

### OAuth 2.0 (推荐)

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

### 基本认证 (Basic Auth)

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

### CSRF Token 处理

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

```http
# 步骤 1: 获取 CSRF Token
GET /sap/opu/odata/sap/API_CN_PAYMENTRELEASELIST_APPR_SRV/A_PaymentItem
X-CSRF-Token: Fetch

# 步骤 2: 使用 Token 执行写操作
POST /sap/opu/odata/sap/API_CN_PAYMENTRELEASELIST_APPR_SRV/A_PaymentItem(PaymentHeader='HDR0000001',PaymentItem='000001')/SetApprovalStatus
X-CSRF-Token: <token_value>
Content-Type: application/json

{ "ApprovalStatus": "ApprovedForPayment" }
```

---

## 错误码 / Error Codes

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

---

## 相关资源 / References

| 资源 | 链接 |
|------|------|
| SAP API Business Hub | [https://api.sap.com/api/API_CN_PAYMENTRELEASELIST_APPR_SRV/overview](https://api.sap.com/api/API_CN_PAYMENTRELEASELIST_APPR_SRV/overview) |
| SAP Help Portal (Cloud) | [https://help.sap.com/docs/SAP_S4HANA_CLOUD](https://help.sap.com/docs/SAP_S4HANA_CLOUD) |
| SAP KBA 3569467 | [https://userapps.support.sap.com/sap/support/knowledge/en/3569467](https://userapps.support.sap.com/sap/support/knowledge/en/3569467) |