---
# API: Billing Document - Read, Cancel, GetPDF (A2X)
# File: API_BILLING_DOCUMENT_SRV.md
# Version: 1.1.0
# Status: ACTIVE
# Protocol: OData V2
# Source URL: https://api.sap.com/api/API_BILLING_DOCUMENT_SRV/overview
# Generated: 2026-07-23 14:17:02
---

# Billing Document - Read, Cancel, GetPDF / 开票凭证 - 读取、取消、获取PDF API

> **API 版本:** 1.1.0 | **状态:** ACTIVE | **协议:** OData V2  
> **技术名称:** `API_BILLING_DOCUMENT_SRV`  
> **服务根路径:** `/sap/opu/odata/sap/API_BILLING_DOCUMENT_SRV`  
> **SAP 通信场景:** `SAP_COM_0109`

## 概述 / Overview

该服务支持读取 SAP S/4HANA 系统的开票凭证数据、取消开票凭证以及获取 PDF 格式的开票凭证。涵盖发票、贷项凭证、借项凭证等。

This synchronous inbound OData V2 service enables external systems to read billing document data, cancel billing documents, and retrieve billing documents in PDF format. Covers invoices, credit memos, debit memos, and more.

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

---

## 实体列表 / Entity List

| # | 实体名称 | 描述 (EN) | 描述 (CN) | 主键 |
|---|----------|-----------|-----------|------|
| 1 | `A_BillingDocument` | Billing Document Header | 开票凭证抬头 | `BillingDocument` |
| 2 | `A_BillingDocumentItem` | Billing Document Item | 开票凭证行项目 | `BillingDocument`, `BillingDocumentItem` |
| 3 | `A_BillingDocumentPartner` | Billing Document Partner | 开票凭证合作伙伴 | `BillingDocument`, `PartnerFunction` |
| 4 | `A_BillingDocumentText` | Billing Document Text | 开票凭证文本 | `BillingDocument`, `Language`, `LongTextID` |
| 5 | `A_BillingDocumentItemText` | Billing Document Item Text | 开票凭证行项目文本 | `BillingDocument`, `BillingDocumentItem`, `Language`, `LongTextID` |

---

## 1. A_BillingDocument — 开票凭证抬头

**实体集合路径:** `A_BillingDocument`  
**主键 (Key):** `BillingDocument` (CHAR 10)  
**ETag:** 支持

### 字段列表 / Field List

| 字段名 | 类型 | 长度 | 描述 (EN) | 描述 (CN) |
|--------|------|------|-----------|-----------|
| `BillingDocument` | String | 10 | Billing Document | 开票凭证编号 (主键) |
| `BillingDocumentType` | String | 4 | Billing Document Type (F2=Invoice, G2=Credit Memo, L2=Debit Memo) | 开票凭证类型 |
| `BillingDocumentCategory` | String | 1 | Billing Document Category | 开票凭证类别 |
| `SDDocumentCategory` | String | 4 | SD Document Category | SD 凭证类别 |
| `BillingDocumentDate` | DateTime | - | Billing Date | 开票日期 |
| `CreationDate` | DateTime | - | Date the Document was Created | 凭证创建日期 |
| `LastChangeDate` | DateTime | - | Date of Last Change | 最后更改日期 |
| `CreatedByUser` | String | 12 | Created By | 创建人 |
| `SalesOrganization` | String | 4 | Sales Organization | 销售组织 |
| `DistributionChannel` | String | 2 | Distribution Channel | 分销渠道 |
| `Division` | String | 2 | Division | 产品组 |
| `SoldToParty` | String | 10 | Sold-to Party | 售达方 |
| `PayerParty` | String | 10 | Payer | 付款方 |
| `BillToParty` | String | 10 | Bill-to Party | 收票方 |
| `ShipToParty` | String | 10 | Ship-to Party | 收货方 |
| `CompanyCode` | String | 4 | Company Code | 公司代码 |
| `TransactionCurrency` | String | 5 | SD Document Currency | 凭证货币 |
| `TotalNetAmount` | Decimal | 16,3 | Net Value in Document Currency | 净价值 (凭证货币) |
| `TotalGrossAmount` | Decimal | 16,3 | Gross Value in Document Currency | 总价值 (凭证货币) |
| `TotalTaxAmount` | Decimal | 16,3 | Tax Amount in Document Currency | 税额 (凭证货币) |
| `PaymentTerms` | String | 4 | Payment Terms | 付款条件 |
| `BillingDocumentIsCancelled` | Boolean | - | Billing Document is Cancelled | 开票凭证已取消标识 |
| `CancelledBillingDocument` | String | 10 | Cancelled Billing Document | 已取消的开票凭证编号 |
| `AccountingDocument` | String | 10 | Accounting Document Number | 会计凭证编号 |
| `FiscalYear` | String | 4 | Fiscal Year | 会计年度 |
| `OverallSDProcessStatus` | String | 1 | Overall SD Process Status | SD 整体处理状态 |
| `OverallBillingStatus` | String | 1 | Overall Billing Status | 整体开票状态 |
| `CustomerPriceGroup` | String | 2 | Customer Price Group | 客户价格组 |
| `CustomerGroup` | String | 2 | Customer Group | 客户组 |
| `ExchangeRateDate` | DateTime | - | Exchange Rate Date | 汇率日期 |
| `IncotermsClassification` | String | 3 | Incoterms (Part 1) | 国际贸易术语 |
| `IncotermsLocation1` | String | 70 | Incoterms Location 1 | 国际贸易术语地点 1 |
| `IncotermsLocation2` | String | 70 | Incoterms Location 2 | 国际贸易术语地点 2 |
| `ReferenceSDDocument` | String | 10 | Reference SD Document | 参考 SD 凭证 |

### 导航属性 / Navigation Properties

| 属性名 | 目标实体 | 基数 | 描述 |
|--------|----------|------|------|
| `to_Item` | A_BillingDocumentItem | 0..* | 行项目 |
| `to_Partner` | A_BillingDocumentPartner | 0..* | 合作伙伴 |
| `to_Text` | A_BillingDocumentText | 0..* | 文本 |

---

## 2. A_BillingDocumentItem — 开票凭证行项目

**实体集合路径:** `A_BillingDocumentItem`  
**主键 (Key):** `BillingDocument` (CHAR 10), `BillingDocumentItem` (CHAR 6)  
**ETag:** 支持

### 字段列表 / Field List

| 字段名 | 类型 | 长度 | 描述 (EN) | 描述 (CN) |
|--------|------|------|-----------|-----------|
| `BillingDocument` | String | 10 | Billing Document | 开票凭证编号 (主键) |
| `BillingDocumentItem` | String | 6 | Billing Item | 开票行项目编号 (主键) |
| `Material` | String | 40 | Material Number | 物料编号 |
| `MaterialGroup` | String | 9 | Material Group | 物料组 |
| `BillingDocumentItemText` | String | 40 | Item Description | 行项目描述 |
| `BillingQuantity` | Decimal | 13,3 | Billing Quantity | 开票数量 |
| `BillingQuantityUnit` | String | 3 | Unit of Measurement | 计量单位 |
| `NetAmount` | Decimal | 16,3 | Net Amount | 净金额 |
| `TaxAmount` | Decimal | 16,3 | Tax Amount | 税额 |
| `GrossAmount` | Decimal | 16,3 | Gross Amount | 总金额 |
| `ItemNetWeight` | Decimal | 13,3 | Net Weight | 净重 |
| `ItemGrossWeight` | Decimal | 13,3 | Gross Weight | 毛重 |
| `WeightUnit` | String | 3 | Weight Unit | 重量单位 |
| `ProductBatch` | String | 10 | Batch Number | 批次号 |
| `Plant` | String | 4 | Plant | 工厂 |
| `StorageLocation` | String | 4 | Storage Location | 存储地点 |
| `SalesDocument` | String | 10 | Sales Document | 销售凭证 |
| `SalesDocumentItem` | String | 6 | Sales Document Item | 销售凭证行项目 |
| `SDProcessStatus` | String | 1 | SD Document Processing Status | SD 凭证处理状态 |
| `ConditionRateValue` | Decimal | 16,3 | Condition Rate Value | 条件费率值 |

### 导航属性 / Navigation Properties

| 属性名 | 目标实体 | 基数 | 描述 |
|--------|----------|------|------|
| `to_Text` | A_BillingDocumentItemText | 0..* | 行项目文本 |

---

## 3. A_BillingDocumentPartner — 开票凭证合作伙伴

**实体集合路径:** `A_BillingDocumentPartner`  
**主键 (Key):** `BillingDocument` (CHAR 10), `PartnerFunction` (CHAR 2)

### 字段列表 / Field List

| 字段名 | 类型 | 长度 | 描述 (EN) | 描述 (CN) |
|--------|------|------|-----------|-----------|
| `BillingDocument` | String | 10 | Billing Document | 开票凭证编号 (主键) |
| `PartnerFunction` | String | 2 | Partner Function | 合作伙伴功能 (主键) |
| `Customer` | String | 10 | Customer Number | 客户编号 |
| `Supplier` | String | 10 | Supplier Number | 供应商编号 |
| `ContactPerson` | String | 10 | Contact Person | 联系人编号 |
| `AddressID` | String | 10 | Address Number | 地址编号 |

---

## 4. A_BillingDocumentText — 开票凭证文本

**实体集合路径:** `A_BillingDocumentText`  
**主键 (Key):** `BillingDocument` (CHAR 10), `Language` (CHAR 2), `LongTextID` (CHAR 4)

### 字段列表 / Field List

| 字段名 | 类型 | 长度 | 描述 (EN) | 描述 (CN) |
|--------|------|------|-----------|-----------|
| `BillingDocument` | String | 10 | Billing Document | 开票凭证编号 (主键) |
| `Language` | String | 2 | Language Key | 语言代码 (主键) |
| `LongTextID` | String | 4 | Text ID | 文本ID (主键) |
| `LongText` | String | - | Long Text | 长文本 |

---

## 5. A_BillingDocumentItemText — 开票凭证行项目文本

**实体集合路径:** `A_BillingDocumentItemText`  
**主键 (Key):** `BillingDocument` (CHAR 10), `BillingDocumentItem` (CHAR 6), `Language` (CHAR 2), `LongTextID` (CHAR 4)

### 字段列表 / Field List

| 字段名 | 类型 | 长度 | 描述 (EN) | 描述 (CN) |
|--------|------|------|-----------|-----------|
| `BillingDocument` | String | 10 | Billing Document | 开票凭证编号 (主键) |
| `BillingDocumentItem` | String | 6 | Billing Item | 开票行项目编号 (主键) |
| `Language` | String | 2 | Language Key | 语言代码 (主键) |
| `LongTextID` | String | 4 | Text ID | 文本ID (主键) |
| `LongText` | String | - | Long Text | 长文本 |

---

## 功能导入 / Function Imports

### GetPDF — 获取 PDF 格式开票凭证

```
GET /sap/opu/odata/sap/API_BILLING_DOCUMENT_SRV/GetPDF?BillingDocument='90000011'
```

**参数:**

| 参数名 | 类型 | 描述 (EN) | 描述 (CN) |
|--------|------|-----------|-----------|
| `BillingDocument` | String | Billing Document Number | 开票凭证编号 |

**返回:** `BillingDocumentBinary` (Base64 encoded PDF)

### CancelBillingDocument — 取消开票凭证

```
POST /sap/opu/odata/sap/API_BILLING_DOCUMENT_SRV/CancelBillingDocument
Content-Type: application/json

{
  "BillingDocument": "90000011"
}
```

**参数:**

| 参数名 | 类型 | 描述 (EN) | 描述 (CN) |
|--------|------|-----------|-----------|
| `BillingDocument` | String | Billing Document to Cancel | 要取消的开票凭证编号 |

---

## CRUD 端点 / CRUD Endpoints

| 操作 | HTTP 方法 | 端点路径 |
|------|-----------|---------|
| 读取集合 (所有实体) | GET | `/{EntityCollection}` |
| 读取单个 | GET | `/{EntityCollection}(...key...)` |
| 创建 | POST | `/{EntityCollection}` |
| 更新 | PATCH | `/{EntityCollection}(...key...)` |
| 删除 | DELETE | `/{EntityCollection}(...key...)` |

各实体集合路径与实体名称一致（如 `A_BillingDocument`, `A_BillingDocumentItem` 等）。

---

## 认证 / Authentication

### OAuth 2.0 (推荐)
```
Authorization: Bearer <access_token>
```

### 基本认证 (Basic Auth)
```
Authorization: Basic <base64(username:password)>
```

### CSRF Token 处理
```http
# Step 1: Fetch CSRF Token
GET /sap/opu/odata/sap/API_BILLING_DOCUMENT_SRV/A_BillingDocument
X-CSRF-Token: Fetch

# Step 2: Use Token for write operations
POST /sap/opu/odata/sap/API_BILLING_DOCUMENT_SRV/CancelBillingDocument
X-CSRF-Token: <token_value>
Content-Type: application/json
```

---

## 错误码 / Error Codes

| HTTP 状态码 | 描述 (EN) | 描述 (CN) |
|-------------|-----------|-----------|
| 200 | OK | 请求成功 |
| 201 | Created | 创建成功 |
| 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_BILLING_DOCUMENT_SRV/overview](https://api.sap.com/api/API_BILLING_DOCUMENT_SRV/overview) |
| SAP Help Portal | [https://help.sap.com/docs/SAP_S4HANA_CLOUD/c2ad75b26f7947bc80dabe5ed7de7af7/fe6f3eda2f914d81b512493fd79e9769.html](https://help.sap.com/docs/SAP_S4HANA_CLOUD/c2ad75b26f7947bc80dabe5ed7de7af7/fe6f3eda2f914d81b512493fd79e9769.html) |
| SAP Cloud SDK Java VDM | [https://javadoc.io/static/com.sap.cloud.sdk.s4hana/s4hana-api-odata/4.23.0/com/sap/cloud/sdk/s4hana/datamodel/odata/services/BillingDocumentService.html](https://javadoc.io/static/com.sap.cloud.sdk.s4hana/s4hana-api-odata/4.23.0/com/sap/cloud/sdk/s4hana/datamodel/odata/services/BillingDocumentService.html) |
