---
# API: Customer Return (A2X)
# File: API_CUSTOMER_RETURN_SRV.md
# Version: 1.1.0
# Status: ACTIVE
# Protocol: OData V2
# Source URL: https://api.sap.com/api/API_CUSTOMER_RETURN_SRV/overview
# Generated: 2026-07-23 14:17:02
---

# Customer Return (A2X) / 客户退货 API

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

## 概述 / Overview

该服务支持对客户退货单（退货请求）进行创建、读取、更新和删除操作。客户退货单用于处理客户退回的商品，包含退货单抬头、行项目、合作伙伴、定价信息及文本数据。

This synchronous inbound OData V2 service enables CRUD operations on customer returns (returns requests). A customer return document handles returned goods from customers, including header data, line items, partners, pricing elements, and text data.

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

---

## 实体列表 / Entity List

| # | 实体名称 | 描述 (EN) | 描述 (CN) | 主键 |
|---|----------|-----------|-----------|------|
| 1 | `A_CustomerReturn` | Customer Return Header | 客户退货单抬头 | `CustomerReturn` |
| 2 | `A_CustomerReturnItem` | Customer Return Item | 客户退货单项 | `CustomerReturn`, `CustomerReturnItem` |
| 3 | `A_CustomerReturnPartner` | Customer Return Partner | 客户退货单合作伙伴 | `CustomerReturn`, `PartnerFunction` |
| 4 | `A_CustomerReturnHeaderText` | Customer Return Header Text | 客户退货单抬头文本 | `CustomerReturn`, `Language` |
| 5 | `A_CustomerReturnItemText` | Customer Return Item Text | 客户退货单项文本 | `CustomerReturn`, `CustomerReturnItem`, `Language` |
| 6 | `A_CustomerReturnPrcgElmnt` | Customer Return Header Pricing | 客户退货单抬头定价 | `CustomerReturn`, `PricingDocument`, `ConditionType`, `PricingConditionProcedureStep`, `PricingConditionCounter` |
| 7 | `A_CustomerReturnItemPrcgElmnt` | Customer Return Item Pricing | 客户退货单项定价 | `CustomerReturn`, `CustomerReturnItem`, `PricingDocument`, `ConditionType`, `PricingConditionProcedureStep`, `PricingConditionCounter` |
| 8 | `A_CustomerReturnItemPartner` | Customer Return Item Partner | 客户退货单项合作伙伴 | `CustomerReturn`, `CustomerReturnItem`, `PartnerFunction` |

---

## 1. A_CustomerReturn — 客户退货单抬头

**实体集合路径:** `A_CustomerReturn`  
**主键 (Key):** `CustomerReturn` (CHAR 10)  
**ETag:** 支持 (`ETag` 字段)

### 字段列表 / Field List

| 字段名 | 类型 | 长度 | 描述 (EN) | 描述 (CN) |
|--------|------|------|-----------|-----------|
| `CustomerReturn` | String | 10 | Customer Return Document Number | 客户退货单编号 (主键) |
| `SalesOrganization` | String | 4 | Sales Organization | 销售组织 |
| `DistributionChannel` | String | 2 | Distribution Channel | 分销渠道 |
| `Division` | String | 2 | Division | 产品组 |
| `SoldToParty` | String | 10 | Sold-to Party | 售达方 |
| `ShipToParty` | String | 10 | Ship-to Party | 送达方 |
| `BillToParty` | String | 10 | Bill-to Party | 收票方 |
| `Payer` | String | 10 | Payer | 付款方 |
| `CustomerReturnType` | String | 4 | Customer Return Document Type | 客户退货单类型 |
| `CustomerReturnReason` | String | 3 | Customer Return Reason | 退货原因 |
| `DocumentDate` | DateTime | - | Document Date | 凭证日期 |
| `PostingDate` | DateTime | - | Posting Date | 过账日期 |
| `RequestedDeliveryDate` | DateTime | - | Requested Delivery Date | 要求交货日期 |
| `CustomerReference` | String | 35 | Customer Reference | 客户参考号 |
| `ReferenceDocument` | String | 35 | Reference Document | 参考凭证 |
| `CompanyCode` | String | 4 | Company Code | 公司代码 |
| `Plant` | String | 4 | Plant | 工厂 |
| `TotalNetAmount` | Decimal | - | Total Net Amount | 总净金额 |
| `TransactionCurrency` | String | 5 | Transaction Currency | 交易货币 |
| `TaxAmount` | Decimal | - | Tax Amount | 税额 |
| `GrossWeight` | Decimal | - | Gross Weight | 毛重 |
| `NetWeight` | Decimal | - | Net Weight | 净重 |
| `WeightUnit` | String | 3 | Weight Unit | 重量单位 |
| `Volume` | Decimal | - | Volume | 体积 |
| `VolumeUnit` | String | 3 | Volume Unit | 体积单位 |
| `IncotermsClassification` | String | 3 | Incoterms | 国际贸易条款 |
| `IncotermsLocation1` | String | 70 | Incoterms Location 1 | 国际贸易条款地点1 |
| `IncotermsLocation2` | String | 70 | Incoterms Location 2 | 国际贸易条款地点2 |
| `CustomerPaymentTerms` | String | 4 | Payment Terms | 付款条件 |
| `PaymentMethod` | String | 1 | Payment Method | 付款方式 |
| `PricingProcedure` | String | 6 | Pricing Procedure | 定价过程 |
| `BillingBlock` | String | 2 | Billing Block | 开票冻结 |
| `DeliveryBlock` | String | 2 | Delivery Block | 交货冻结 |
| `OverallStatus` | String | 1 | Overall Processing Status | 总处理状态 |
| `OverallRejectionStatus` | String | 1 | Overall Rejection Status | 总体拒绝状态 |
| `CreatedByUser` | String | 12 | Created By | 创建人 |
| `CreationDate` | DateTime | - | Creation Date | 创建日期 |
| `CreationTime` | Time | - | Creation Time | 创建时间 |
| `LastChangedByUser` | String | 12 | Last Changed By | 最后更改人 |
| `LastChangeDate` | DateTime | - | Last Change Date | 最后更改日期 |
| `LastChangeTime` | Time | - | Last Change Time | 最后更改时间 |
| `ETag` | String | - | ETag for Concurrency | 并发控制ETag |

### 导航属性 / Navigation Properties

| 属性名 | 目标实体 | 基数 | 描述 |
|--------|----------|------|------|
| `to_Item` | A_CustomerReturnItem | 0..* | 退货单项 |
| `to_Partner` | A_CustomerReturnPartner | 0..* | 退货单合作伙伴 |
| `to_Text` | A_CustomerReturnHeaderText | 0..* | 退货单抬头文本 |
| `to_PricingElement` | A_CustomerReturnPrcgElmnt | 0..* | 退货单抬头定价 |

---

## 2. A_CustomerReturnItem — 客户退货单项

**实体集合路径:** `A_CustomerReturnItem`  
**主键 (Key):** `CustomerReturn` (CHAR 10), `CustomerReturnItem` (CHAR 6)  
**ETag:** 支持

### 字段列表 / Field List

| 字段名 | 类型 | 长度 | 描述 (EN) | 描述 (CN) |
|--------|------|------|-----------|-----------|
| `CustomerReturn` | String | 10 | Customer Return Document Number | 客户退货单编号 |
| `CustomerReturnItem` | String | 6 | Customer Return Item Number | 客户退货单项编号 |
| `Material` | String | 40 | Material Number | 物料编号 |
| `MaterialByCustomer` | String | 35 | Material Number by Customer | 客户物料号 |
| `MaterialGroup` | String | 9 | Material Group | 物料组 |
| `Batch` | String | 10 | Batch Number | 批次号 |
| `Plant` | String | 4 | Plant | 工厂 |
| `StorageLocation` | String | 4 | Storage Location | 库位 |
| `SalesOrder` | String | 10 | Sales Order | 销售订单 |
| `SalesOrderItem` | String | 6 | Sales Order Item | 销售订单项 |
| `RequestedQuantity` | Decimal | - | Requested Quantity | 请求数量 |
| `RequestedQuantityUnit` | String | 3 | Requested Quantity Unit | 请求数量单位 |
| `ConfirmedQuantity` | Decimal | - | Confirmed Quantity | 已确认数量 |
| `QuantityUnit` | String | 3 | Quantity Unit | 数量单位 |
| `ItemDescription` | String | 40 | Item Description | 项目描述 |
| `NetAmount` | Decimal | - | Net Amount | 净额 |
| `TaxAmount` | Decimal | - | Tax Amount | 税额 |
| `TransactionCurrency` | String | 5 | Transaction Currency | 交易货币 |
| `CustomerReturnReason` | String | 3 | Return Reason | 退货原因 |
| `ItemRejectionStatus` | String | 1 | Item Rejection Status | 项目拒绝状态 |
| `DeliveryGroup` | String | 6 | Delivery Group | 交货组 |
| `ShippingPoint` | String | 4 | Shipping Point | 发运点 |
| `Route` | String | 6 | Route | 路线 |
| `IncotermsClassification` | String | 3 | Incoterms | 国际贸易条款 |
| `MaterialPricingGroup` | String | 2 | Material Pricing Group | 物料定价组 |
| `ReturnItemType` | String | 1 | Return Item Type | 退货项类型 |
| `CreatedByUser` | String | 12 | Created By | 创建人 |
| `CreationDate` | DateTime | - | Creation Date | 创建日期 |
| `LastChangeDate` | DateTime | - | Last Change Date | 最后更改日期 |
| `ETag` | String | - | ETag for Concurrency | 并发控制ETag |

### 导航属性 / Navigation Properties

| 属性名 | 目标实体 | 基数 | 描述 |
|--------|----------|------|------|
| `to_Text` | A_CustomerReturnItemText | 0..* | 退货单项文本 |
| `to_Partner` | A_CustomerReturnItemPartner | 0..* | 退货单项合作伙伴 |
| `to_PricingElement` | A_CustomerReturnItemPrcgElmnt | 0..* | 退货单项定价 |
| `to_Header` | A_CustomerReturn | 1 | 退货单抬头 |

---

## 3. A_CustomerReturnPartner — 客户退货单合作伙伴

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

### 字段列表 / Field List

| 字段名 | 类型 | 长度 | 描述 (EN) | 描述 (CN) |
|--------|------|------|-----------|-----------|
| `CustomerReturn` | String | 10 | Customer Return Document Number | 客户退货单编号 |
| `PartnerFunction` | String | 2 | Partner Function | 合作伙伴功能 |
| `Customer` | String | 10 | Customer Number | 客户编号 |
| `Supplier` | String | 10 | Supplier Number | 供应商编号 |
| `PersonnelNumber` | String | 8 | Personnel Number | 人员编号 |
| `ContactPerson` | String | 10 | Contact Person | 联系人 |
| `AddressID` | String | 10 | Address Number | 地址编号 |
| `VATRegistration` | String | 20 | VAT Registration Number | 增值税注册号 |

### 导航属性 / Navigation Properties

| 属性名 | 目标实体 | 基数 | 描述 |
|--------|----------|------|------|
| `to_Header` | A_CustomerReturn | 1 | 退货单抬头 |

---

## 4. A_CustomerReturnHeaderText — 客户退货单抬头文本

**实体集合路径:** `A_CustomerReturnHeaderText`  
**主键 (Key):** `CustomerReturn` (CHAR 10), `Language` (CHAR 2)

### 字段列表 / Field List

| 字段名 | 类型 | 长度 | 描述 (EN) | 描述 (CN) |
|--------|------|------|-----------|-----------|
| `CustomerReturn` | String | 10 | Customer Return Document Number | 客户退货单编号 |
| `Language` | String | 2 | Language Key | 语言代码 |
| `LongTextID` | String | 4 | Long Text ID | 长文本ID |
| `LongText` | String | - | Long Text | 长文本内容 |

### 导航属性 / Navigation Properties

| 属性名 | 目标实体 | 基数 | 描述 |
|--------|----------|------|------|
| `to_Header` | A_CustomerReturn | 1 | 退货单抬头 |

---

## 5. A_CustomerReturnItemText — 客户退货单项文本

**实体集合路径:** `A_CustomerReturnItemText`  
**主键 (Key):** `CustomerReturn` (CHAR 10), `CustomerReturnItem` (CHAR 6), `Language` (CHAR 2)

### 字段列表 / Field List

| 字段名 | 类型 | 长度 | 描述 (EN) | 描述 (CN) |
|--------|------|------|-----------|-----------|
| `CustomerReturn` | String | 10 | Customer Return Document Number | 客户退货单编号 |
| `CustomerReturnItem` | String | 6 | Customer Return Item Number | 客户退货单项编号 |
| `Language` | String | 2 | Language Key | 语言代码 |
| `LongTextID` | String | 4 | Long Text ID | 长文本ID |
| `LongText` | String | - | Long Text | 长文本内容 |

### 导航属性 / Navigation Properties

| 属性名 | 目标实体 | 基数 | 描述 |
|--------|----------|------|------|
| `to_Item` | A_CustomerReturnItem | 1 | 退货单项 |

---

## 6. A_CustomerReturnPrcgElmnt — 客户退货单抬头定价

**实体集合路径:** `A_CustomerReturnPrcgElmnt`  
**主键 (Key):** `CustomerReturn` (CHAR 10), `PricingDocument` (CHAR 10), `ConditionType` (CHAR 4), `PricingConditionProcedureStep` (CHAR 3), `PricingConditionCounter` (CHAR 3)

### 字段列表 / Field List

| 字段名 | 类型 | 长度 | 描述 (EN) | 描述 (CN) |
|--------|------|------|-----------|-----------|
| `CustomerReturn` | String | 10 | Customer Return Document Number | 客户退货单编号 |
| `PricingDocument` | String | 10 | Pricing Document Number | 定价凭证编号 |
| `ConditionType` | String | 4 | Condition Type | 条件类型 |
| `PricingConditionProcedureStep` | String | 3 | Procedure Step | 过程步骤 |
| `PricingConditionCounter` | String | 3 | Condition Counter | 条件计数 |
| `ConditionRateValue` | Decimal | - | Condition Rate | 条件费率 |
| `ConditionCurrency` | String | 5 | Condition Currency | 条件货币 |
| `ConditionQuantity` | Decimal | - | Condition Quantity | 条件数量 |
| `ConditionQuantityUnit` | String | 3 | Condition Quantity Unit | 条件数量单位 |
| `ConditionAmount` | Decimal | - | Condition Amount | 条件金额 |
| `ConditionCalculationType` | String | 3 | Calculation Type | 计算类型 |
| `ConditionBaseValue` | Decimal | - | Condition Base Value | 条件基值 |
| `ConditionOrigin` | String | 1 | Condition Origin | 条件来源 |
| `ConditionIsDeleted` | Boolean | - | Condition Deletion Indicator | 条件删除标识 |
| `SupplementsComponentID` | String | 10 | Supplement Component | 附加组件ID |

### 导航属性 / Navigation Properties

| 属性名 | 目标实体 | 基数 | 描述 |
|--------|----------|------|------|
| `to_Header` | A_CustomerReturn | 1 | 退货单抬头 |

---

## 7. A_CustomerReturnItemPrcgElmnt — 客户退货单项定价

**实体集合路径:** `A_CustomerReturnItemPrcgElmnt`  
**主键 (Key):** `CustomerReturn` (CHAR 10), `CustomerReturnItem` (CHAR 6), `PricingDocument` (CHAR 10), `ConditionType` (CHAR 4), `PricingConditionProcedureStep` (CHAR 3), `PricingConditionCounter` (CHAR 3)

### 字段列表 / Field List

| 字段名 | 类型 | 长度 | 描述 (EN) | 描述 (CN) |
|--------|------|------|-----------|-----------|
| `CustomerReturn` | String | 10 | Customer Return Document Number | 客户退货单编号 |
| `CustomerReturnItem` | String | 6 | Customer Return Item Number | 客户退货单项编号 |
| `PricingDocument` | String | 10 | Pricing Document Number | 定价凭证编号 |
| `ConditionType` | String | 4 | Condition Type | 条件类型 |
| `PricingConditionProcedureStep` | String | 3 | Procedure Step | 过程步骤 |
| `PricingConditionCounter` | String | 3 | Condition Counter | 条件计数 |
| `ConditionRateValue` | Decimal | - | Condition Rate | 条件费率 |
| `ConditionCurrency` | String | 5 | Condition Currency | 条件货币 |
| `ConditionQuantity` | Decimal | - | Condition Quantity | 条件数量 |
| `ConditionQuantityUnit` | String | 3 | Condition Quantity Unit | 条件数量单位 |
| `ConditionAmount` | Decimal | - | Condition Amount | 条件金额 |
| `ConditionCalculationType` | String | 3 | Calculation Type | 计算类型 |
| `ConditionBaseValue` | Decimal | - | Condition Base Value | 条件基值 |
| `ConditionOrigin` | String | 1 | Condition Origin | 条件来源 |
| `ConditionIsDeleted` | Boolean | - | Condition Deletion Indicator | 条件删除标识 |
| `SupplementsComponentID` | String | 10 | Supplement Component | 附加组件ID |

### 导航属性 / Navigation Properties

| 属性名 | 目标实体 | 基数 | 描述 |
|--------|----------|------|------|
| `to_Item` | A_CustomerReturnItem | 1 | 退货单项 |

---

## 8. A_CustomerReturnItemPartner — 客户退货单项合作伙伴

**实体集合路径:** `A_CustomerReturnItemPartner`  
**主键 (Key):** `CustomerReturn` (CHAR 10), `CustomerReturnItem` (CHAR 6), `PartnerFunction` (CHAR 2)

### 字段列表 / Field List

| 字段名 | 类型 | 长度 | 描述 (EN) | 描述 (CN) |
|--------|------|------|-----------|-----------|
| `CustomerReturn` | String | 10 | Customer Return Document Number | 客户退货单编号 |
| `CustomerReturnItem` | String | 6 | Customer Return Item Number | 客户退货单项编号 |
| `PartnerFunction` | String | 2 | Partner Function | 合作伙伴功能 |
| `Customer` | String | 10 | Customer Number | 客户编号 |
| `Supplier` | String | 10 | Supplier Number | 供应商编号 |
| `PersonnelNumber` | String | 8 | Personnel Number | 人员编号 |
| `ContactPerson` | String | 10 | Contact Person | 联系人 |
| `AddressID` | String | 10 | Address Number | 地址编号 |
| `VATRegistration` | String | 20 | VAT Registration Number | 增值税注册号 |

### 导航属性 / Navigation Properties

| 属性名 | 目标实体 | 基数 | 描述 |
|--------|----------|------|------|
| `to_Item` | A_CustomerReturnItem | 1 | 退货单项 |

---

## 常见退货原因 / Common Return Reasons

| 原因代码 | 描述 (EN) | 描述 (CN) |
|----------|-----------|-----------|
| `001` | Defective Product | 产品缺陷 |
| `002` | Wrong Product Delivered | 交货错误 |
| `003` | Product Not Ordered | 非订购产品 |
| `004` | Product Damaged in Transit | 运输途中损坏 |
| `005` | Customer No Longer Needs Item | 客户不再需要 |
| `006` | Product Expired | 产品过期 |
| `007` | Quality Issue | 质量问题 |
| `008` | Under Warranty Return | 保修期内退货 |
| `009` | Commercial Complaint | 商务投诉 |
| `010` | Overdelivery | 过量交货 |

---

## 退货单类型 / Return Document Types

| 类型值 | 描述 (EN) | 描述 (CN) |
|--------|-----------|-----------|
| `RE` | Standard Return | 标准退货 |
| `CR` | Credit Memo Request | 贷项凭证请求 |
| `SRE` | Subsequent Return | 后续退货 |
| `GRE` | Goods Return | 货物退货 |