---
# API: Billing Document
# File: sap-s4-CE_BILLINGDOCUMENT_0001-v1.md
# Version: 1.3.0
# Status: ACTIVE
# Protocol: OData V4
# Source URL: https://api.sap.com/api/sap-s4-ce_billingdocument/overview
# Generated: 2026-07-23 14:17:02
---

# Billing Document / 开票凭证 API

> **API 版本:** 1.3.0 | **状态:** ACTIVE | **协议:** OData V4  
> **技术名称:** `sap-s4-ce_billingdocument`  
> **服务根路径:** `/sap/opu/odata4/sap/sap-s4-ce_billingdocument/srvd_a2x/sap/billingdocument/0001/`  
> **SAP 通信场景:** `SAP_COM_0109`

## 概述 / Overview

该服务提供开票凭证的创建、读取、更新和删除（CRUD）操作，涵盖抬头数据、行项目数据、业务伙伴数据和文本数据。

This synchronous inbound OData V4 service enables CRUD operations on Billing Documents, including header data, item data, partner data, and text data.

**API 业务加速器中心:** [https://api.sap.com/api/sap-s4-ce_billingdocument/overview](https://api.sap.com/api/sap-s4-ce_billingdocument/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`, `TextElement` |

---

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

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

### 字段列表 / Field List

| 字段名 | 类型 | 长度 | 描述 (EN) | 描述 (CN) |
|--------|------|------|-----------|-----------|
| `BillingDocument` | String | 10 | Billing Document | 开票凭证编号 |
| `BillingDocumentType` | String | 4 | Billing Document Type | 开票凭证类型 |
| `SalesOrganization` | String | 4 | Sales Organization | 销售组织 |
| `DistributionChannel` | String | 2 | Distribution Channel | 分销渠道 |
| `Division` | String | 2 | Division | 产品部门 |
| `SoldToParty` | String | 10 | Sold-To Party | 售达方 |
| `BillToParty` | String | 10 | Bill-To Party | 收票方 |
| `PayerParty` | String | 10 | Payer | 付款方 |
| `NetValue` | Decimal | 15 | Net Value | 净价值 |
| `TaxAmount` | Decimal | 15 | Tax Amount | 税金额 |
| `GrossValue` | Decimal | 15 | Gross Value | 总价值 |
| `TransactionCurrency` | String | 5 | Currency | 交易货币 |
| `BillingDocumentDate` | DateTime | - | Billing Date | 开票日期 |
| `PostingDate` | DateTime | - | Posting Date | 过账日期 |
| `AccountingDocument` | String | 10 | Accounting Document | 会计凭证编号 |
| `FiscalYear` | String | 4 | Fiscal Year | 会计年度 |
| `BillingStatus` | String | 1 | Billing Status | 开票状态 |
| `CancelledBillingDocument` | String | 10 | Cancelled Billing Document | 被取消的开票凭证 |
| `CreatedByUser` | String | 12 | Created By | 创建人 |
| `CreationDate` | DateTime | - | Created On | 创建日期 |
| `LastChangedByUser` | String | 12 | Last Changed By | 最后更改人 |
| `LastChangeDate` | DateTime | - | Last Changed On | 最后更改日期 |
| `OverallBillingStatus` | String | 2 | Overall Billing Status | 总体开票状态 |
| `IsCancelled` | Boolean | - | Cancelled | 已取消标识 |
| `TotalNetWeight` | Decimal | 13 | Total Net Weight | 总净重 |
| `TotalGrossWeight` | Decimal | 13 | Total Gross Weight | 总毛重 |
| `TotalVolume` | Decimal | 13 | Total Volume | 总体积 |
| `WeightUnit` | String | 3 | Weight Unit | 重量单位 |
| `VolumeUnit` | String | 3 | Volume Unit | 体积单位 |

### 导航属性 / Navigation Properties

| 属性名 | 目标实体 | 基数 | 描述 |
|--------|----------|------|------|
| `to_BillingDocumentItem` | A_BillingDocumentItem | 0..* | 行项目 |
| `to_BillingDocumentPartner` | A_BillingDocumentPartner | 0..* | 业务伙伴 |
| `to_BillingDocumentText` | A_BillingDocumentText | 0..* | 文本 |

---

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

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

### 字段列表 / Field List

| 字段名 | 类型 | 长度 | 描述 (EN) | 描述 (CN) |
|--------|------|------|-----------|-----------|
| `BillingDocument` | String | 10 | Billing Document | 开票凭证编号 |
| `BillingDocumentItem` | String | 6 | Billing Document Item | 行项目编号 |
| `Product` | String | 40 | Product | 产品编号 |
| `ProductDescription` | String | 40 | Product Description | 产品描述 |
| `Quantity` | Decimal | 13 | Quantity | 数量 |
| `UnitOfMeasure` | String | 3 | Unit of Measure | 计量单位 |
| `NetAmount` | Decimal | 15 | Net Amount | 净金额 |
| `TaxAmount` | Decimal | 15 | Tax Amount | 税金额 |
| `GrossAmount` | Decimal | 15 | Gross Amount | 总金额 |
| `Currency` | String | 5 | Currency | 货币 |
| `MaterialGroup` | String | 9 | Material Group | 物料组 |
| `Plant` | String | 4 | Plant | 工厂 |
| `Batch` | String | 10 | Batch | 批次 |
| `ProfitCenter` | String | 10 | Profit Center | 利润中心 |
| `CostCenter` | String | 10 | Cost Center | 成本中心 |
| `SalesOrder` | String | 10 | Sales Order | 销售订单 |
| `SalesOrderItem` | String | 6 | Sales Order Item | 销售订单行项目 |
| `ConditionRate` | Decimal | 11 | Condition Rate | 条件费率 |
| `ConditionUnit` | String | 3 | Condition Unit | 条件单位 |
| `IsMarkedForDeletion` | Boolean | - | Deletion Flag | 删除标记 |
| `ItemBillingStatus` | String | 1 | Item Billing Status | 行项目开票状态 |

---

## 3. A_BillingDocumentPartner — 开票凭证业务伙伴

**实体集合路径:** `A_BillingDocumentPartner`  
**主键 (Key):** `BillingDocument` (STRING 10), `PartnerFunction` (STRING 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 | 供应商编号 |
| `Personnel` | String | 8 | Personnel Number | 人员编号 |
| `ContactPerson` | String | 10 | Contact Person | 联系人 |

---

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

**实体集合路径:** `A_BillingDocumentText`  
**主键 (Key):** `BillingDocument` (STRING 10), `TextElement` (STRING 4)  

### 字段列表 / Field List

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

---

## CRUD 端点 / CRUD Endpoints

所有实体的 CRUD 端点遵循 OData V4 约定。以下以 `A_BillingDocument` 为例：

### 创建 (Create) — POST

```
POST /sap/opu/odata4/sap/sap-s4-ce_billingdocument/srvd_a2x/sap/billingdocument/0001/A_BillingDocument
Content-Type: application/json
```

### 读取 (Read) — GET

```
GET /sap/opu/odata4/sap/sap-s4-ce_billingdocument/srvd_a2x/sap/billingdocument/0001/A_BillingDocument(BillingDocument='12345')
GET /sap/opu/odata4/sap/sap-s4-ce_billingdocument/srvd_a2x/sap/billingdocument/0001/A_BillingDocument?$filter=...&$expand=...
```

### 更新 (Update) — PATCH

```
PATCH /sap/opu/odata4/sap/sap-s4-ce_billingdocument/srvd_a2x/sap/billingdocument/0001/A_BillingDocument(BillingDocument='12345')
Content-Type: application/json
```

### 删除 (Delete) — DELETE

```
DELETE /sap/opu/odata4/sap/sap-s4-ce_billingdocument/srvd_a2x/sap/billingdocument/0001/A_BillingDocument(BillingDocument='12345')
```

### 各实体端点路径速查表

| 实体 | 端点路径 |
|------|---------|
| A_BillingDocument | `A_BillingDocument` |
| A_BillingDocumentItem | `A_BillingDocumentItem` |
| A_BillingDocumentPartner | `A_BillingDocumentPartner` |
| A_BillingDocumentText | `A_BillingDocumentText` |