---
# API: Sales Area - Read (A2X) / 销售区域读取 API
# File: SALESAREA_0001.md
# Version: 1.0.0
# Status: ACTIVE
# Protocol: OData V4
# Source URL: https://api.sap.com/api/SALESAREA_0001/overview
# Generated: 2026-07-23 14:17:02
---

# Sales Area - Read (A2X) / 销售区域读取 API

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

## 概述 / Overview

该服务允许外部系统读取 SAP S/4HANA 中的销售区域数据。销售区域是销售组织、分销渠道和产品组的组合，是销售和分销（SD）模块的核心组织单元，用于控制销售事务。

This inbound synchronous service enables external systems and other consumers to retrieve sales area data in your system. A sales area is the combination of Sales Organization, Distribution Channel, and Division — the core organizational unit in SAP S/4HANA Sales and Distribution.

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

---

## 实体列表 / Entity List

| # | 实体名称 | 描述 (EN) | 描述 (CN) | 主键 |
|---|----------|-----------|-----------|------|
| 1 | `A_SalesArea` | Sales Area | 销售区域 | `SalesOrganization`, `DistributionChannel`, `Division` |

---

## 1. A_SalesArea — 销售区域

**实体集合路径:** `A_SalesArea`  
**主键 (Key):** `SalesOrganization` (STRING 4), `DistributionChannel` (STRING 2), `Division` (STRING 2)

### 字段列表 / Field List

| 字段名 | 类型 | 长度 | 描述 (EN) | 描述 (CN) |
|--------|------|------|-----------|-----------|
| `SalesOrganization` | String | 4 | Sales Organization | 销售组织 (主键) |
| `DistributionChannel` | String | 2 | Distribution Channel | 分销渠道 (主键) |
| `Division` | String | 2 | Division | 产品组 (主键) |
| `SalesOrganizationName` | String | 20 | Sales Organization Name | 销售组织名称 |
| `DistributionChannelName` | String | 20 | Distribution Channel Name | 分销渠道名称 |
| `DivisionName` | String | 20 | Division Name | 产品组名称 |
| `SalesOrganizationCurrency` | String | 5 | Currency of Sales Organization | 销售组织货币 |

### 关键说明 / Key Notes

- 销售区域是 SD 模块的核心组织单元，定义了销售组织+分销渠道+产品组的唯一组合
- 该 API 为**只读**，仅支持 GET 操作
- The sales area defines the organizational unit for sales transactions
- This API is **read-only**, supporting only GET operations

### 常见销售区域值示例

| 销售组织 | 分销渠道 | 产品组 | 描述 |
|----------|----------|--------|------|
| `1000` | `10` | `00` | Germany - Direct Sales - Cross-Division |
| `1000` | `20` | `00` | Germany - Indirect Sales - Cross-Division |
| `2000` | `10` | `00` | USA - Direct Sales - Cross-Division |
| `3000` | `30` | `00` | UK - Internet Sales - Cross-Division |

---

## CRUD 端点 / CRUD Endpoints

本服务为只读服务，仅支持 GET 操作。

### 读取所有销售区域

```
GET /sap/opu/odata4/sap/salesarea/srvd_a2x/sap/salesarea/0001/A_SalesArea
```

### 按主键读取

```
GET /sap/opu/odata4/sap/salesarea/srvd_a2x/sap/salesarea/0001/A_SalesArea(SalesOrganization='1000',DistributionChannel='10',Division='00')
```

### 查询示例

```
# Filter by sales organization
GET /sap/opu/odata4/sap/salesarea/srvd_a2x/sap/salesarea/0001/A_SalesArea?$filter=SalesOrganization eq '1000'

# Select specific fields
GET /sap/opu/odata4/sap/salesarea/srvd_a2x/sap/salesarea/0001/A_SalesArea?$select=SalesOrganization,DistributionChannel,Division,SalesOrganizationName
```

---

## OData V4 查询选项 / Query Options

| 参数 | 示例 | 说明 |
|------|------|------|
| `$filter` | `$filter=SalesOrganization eq '1000'` | 过滤 |
| `$select` | `$select=SalesOrganization,SalesOrganizationName` | 选择字段 |
| `$top` | `$top=100` | 返回前 N 条 |
| `$skip` | `$skip=50` | 跳过前 N 条 |
| `$orderby` | `$orderby=SalesOrganization asc` | 排序 |
| `$count` | `$count=true` | 返回计数 |

---

## 相关资源 / References

| 资源 | 链接 |
|------|------|
| SAP API Business Hub | [https://api.sap.com/api/SALESAREA_0001/overview](https://api.sap.com/api/SALESAREA_0001/overview) |
| SAP Help Portal | [https://help.sap.com/docs/SAP_S4HANA_CLOUD/03c04db2a7434731b7fe21dca77440da/f4ff6b854cc34b3ebd80b97e62048711.html](https://help.sap.com/docs/SAP_S4HANA_CLOUD/03c04db2a7434731b7fe21dca77440da/f4ff6b854cc34b3ebd80b97e62048711.html) |
| WSO2 Connector | [https://github.com/wso2/docs-integrator/blob/main/en/docs/connectors/catalog/erp-business/sap.s4hana.salesarea_0001/](https://github.com/wso2/docs-integrator/blob/main/en/docs/connectors/catalog/erp-business/sap.s4hana.salesarea_0001/) |
