---
# API: China VAT Invoice (A2X)
# File: API_CN_VAT_INVOICE_SRV.md
# Version: 1.0.0
# Status: ACTIVE
# Protocol: OData V4
# Source URL: https://api.sap.com/api/API_CN_VAT_INVOICE_SRV/overview
# Generated: 2026-07-23 14:17:02
---

# China VAT Invoice / 中国增值税发票 API

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

## 概述 / Overview

该服务用于管理中国本地化的增值税发票流程，支持发票信息的创建、查询和更新，涵盖发票金额、税额、税率及发票状态等核心财务数据。

This synchronous inbound OData V4 service enables management of China localization VAT invoice processes, supporting create, query, and update of invoice information including invoice amount, tax amount, tax rate, and invoice status.

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

---

## 实体列表 / Entity List

| # | 实体名称 | 描述 (EN) | 描述 (CN) | 主键 |
|---|----------|-----------|-----------|------|
| 1 | `A_VATInvoice` | VAT Invoice | 增值税发票 | `VATInvoiceID` |
| 2 | `A_VATInvoiceItem` | VAT Invoice Item | 增值税发票行项目 | `VATInvoiceID`, `ItemNumber` |
| 3 | `A_VATInvoiceTax` | VAT Invoice Tax Breakdown | 增值税发票税额明细 | `VATInvoiceID`, `TaxCode` |

---

## 1. A_VATInvoice — 增值税发票

**实体集合路径:** `A_VATInvoice`  
**主键 (Key):** `VATInvoiceID` (CHAR 20)

### 字段列表 / Field List

| 字段名 | 类型 | 长度 | 描述 (EN) | 描述 (CN) |
|--------|------|------|-----------|-----------|
| `VATInvoiceID` | CHAR | 20 | VAT Invoice ID | 增值税发票标识 |
| `CompanyCode` | CHAR | 4 | Company Code | 公司代码 |
| `Supplier` | CHAR | 10 | Supplier | 供应商 |
| `Customer` | CHAR | 10 | Customer | 客户 |
| `InvoiceAmount` | DEC | 15.2 | Invoice Amount (gross) | 发票总金额（含税） |
| `NetAmount` | DEC | 15.2 | Net Amount | 发票净金额 |
| `TaxAmount` | DEC | 15.2 | Tax Amount | 税额 |
| `TaxRate` | DEC | 5.2 | Tax Rate (percentage) | 税率（百分比） |
| `TaxCode` | CHAR | 2 | Tax Code | 税码 |
| `InvoiceDate` | DATS | 8 | Invoice Date | 发票日期 |
| `InvoiceType` | CHAR | 2 | Invoice Type (Blue/Credit) | 发票类型（蓝票/红票） |
| `InvoiceStatus` | CHAR | 1 | Invoice Status | 发票状态 |
| `InvoiceNumber` | CHAR | 20 | Official Invoice Number | 发票号码 |
| `InvoiceCode` | CHAR | 12 | Official Invoice Code | 发票代码 |
| `PostingDate` | DATS | 8 | Posting Date | 过账日期 |
| `FiscalYear` | NUMC | 4 | Fiscal Year | 会计年度 |
| `AccountingDocument` | CHAR | 10 | Accounting Document | 会计凭证号 |
| `CreatedByUser` | CHAR | 12 | Created By | 创建者 |
| `CreationDateTime` | DATS | 8 | Creation Date/Time | 创建日期时间 |
| `LastChangedByUser` | CHAR | 12 | Last Changed By | 最后更改者 |
| `LastChangeDateTime` | DATS | 8 | Last Change Date/Time | 最后更改日期时间 |

### 导航属性 / Navigation Properties

| 导航属性 | 目标实体 | 描述 (EN) | 描述 (CN) |
|----------|----------|-----------|-----------|
| `To_Item` | `A_VATInvoiceItem` | Invoice Items | 发票行项目 |
| `To_TaxBreakdown` | `A_VATInvoiceTax` | Tax Breakdown | 税额明细 |
| `To_Supplier` | `A_Supplier` | Supplier (via Navigation) | 供应商信息 |
| `To_Customer` | `A_Customer` | Customer (via Navigation) | 客户信息 |

### 功能选项 / Function Imports

| 功能名称 | 参数 | 描述 (EN) | 描述 (CN) |
|----------|------|-----------|-----------|
| `CancelVATInvoice` | `VATInvoiceID` | Cancel a VAT Invoice | 取消增值税发票 |
| `CheckVATInvoiceStatus` | `VATInvoiceID`, `TaxAuthorityCode` | Check with Tax Authority | 向税务机关查验发票状态 |
| `RetrieveOfficialInvoice` | `VATInvoiceID` | Retrieve Official Invoice Data | 获取电子发票数据 |

### 示例请求 / Sample Request

```http
GET /sap/opu/odata4/sap/API_CN_VAT_INVOICE_SRV/A_VATInvoice?$top=20
Accept: application/json
```

### 示例响应 / Sample Response

```json
{
  "@odata.context": "/sap/opu/odata4/sap/API_CN_VAT_INVOICE_SRV/$metadata#A_VATInvoice",
  "value": [
    {
      "@odata.id": "/sap/opu/odata4/sap/API_CN_VAT_INVOICE_SRV/A_VATInvoice('INV00000001')",
      "VATInvoiceID": "INV00000001",
      "CompanyCode": "CN01",
      "Supplier": "0010000003",
      "Customer": "",
      "InvoiceAmount": "113000.00",
      "NetAmount": "100000.00",
      "TaxAmount": "13000.00",
      "TaxRate": 13.00,
      "TaxCode": "J1",
      "InvoiceDate": "2026-07-15",
      "InvoiceType": "01",
      "InvoiceStatus": "P",
      "InvoiceNumber": "3100154321",
      "InvoiceCode": "3100012345",
      "PostingDate": "2026-07-15",
      "FiscalYear": "2026",
      "AccountingDocument": "1900000001",
      "CreatedByUser": "USER001",
      "CreationDateTime": "2026-07-15T14:30:00",
      "LastChangedByUser": "USER001",
      "LastChangeDateTime": "2026-07-15T14:30:00"
    }
  ]
}
```
