---
# API: Equipment Struct List (A2X)
# File: EQUIPMENTSTRUCLIST_0001.md
# Version: 1.0.0
# Status: ACTIVE
# Protocol: OData V4
# Source URL: https://api.sap.com/api/EQUIPMENTSTRUCLIST/overview
# Generated: 2026-07-23 14:17:02
---

# Equipment Struct List / 设备结构列表 API

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

## 概述 / Overview

该服务用于查询设备结构列表，包括设备层级关系和功能位置信息。

This service enables querying of equipment structure lists, including equipment hierarchy relationships and functional location information.

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

---

## 实体列表 / Entity List

| # | 实体名称 | 描述 (EN) | 描述 (CN) | 主键 |
|---|----------|-----------|-----------|------|
| 1 | `A_EquipmentStructList` | Equipment Structure List | 设备结构列表 | `Equipment`, `ValidityDate` |

---

## 1. A_EquipmentStructList — 设备结构列表

**实体集合路径:** `A_EquipmentStructList`  
**主键 (Key):** `Equipment` (CHAR 18), `ValidityDate` (DATN 8)

### 字段列表 / Field List

| 字段名 | 类型 | 长度 | 描述 (EN) | 描述 (CN) |
|--------|------|------|-----------|-----------|
| `Equipment` | CHAR | 18 | Equipment Number | 设备编号 |
| `ValidityDate` | DATN | 8 | Validity Date | 有效日期 |
| `EquipmentName` | CHAR | 40 | Description of Equipment | 设备描述 |
| `EquipmentCategory` | CHAR | 1 | Equipment Category | 设备类别 |
| `TechnicalObjectType` | CHAR | 10 | Technical Object Type | 技术对象类型 |
| `SuperiorEquipment` | CHAR | 18 | Superior Equipment | 上级设备 |
| `FunctionalLocation` | CHAR | 40 | Functional Location | 功能位置 |
| `ValidFrom` | DATN | 8 | Valid From | 有效起始日期 |
| `ValidTo` | DATN | 8 | Valid To | 有效截止日期 |
| `ABCIndicator` | CHAR | 1 | ABC Indicator | ABC 标识 |
| `ObjectType` | CHAR | 2 | Object Type | 对象类型 |
| `Plant` | CHAR | 4 | Plant | 工厂 |
| `Location` | CHAR | 10 | Location | 位置 |
| `WorkCenter` | CHAR | 8 | Work Center | 工作中心 |
| `CostCenter` | CHAR | 10 | Cost Center | 成本中心 |
| `CatalogProfile` | CHAR | 6 | Catalog Profile | 目录概要 |
| `CatalogType` | CHAR | 1 | Catalog Type | 目录类型 |
| `CatalogGroup` | CHAR | 8 | Catalog Group | 目录组 |
| `CatalogCodeGroup` | CHAR | 2 | Code Group | 代码组 |
| `CatalogCode` | CHAR | 14 | Code | 代码 |
| `Country` | CHAR | 3 | Country | 国家 |
| `City` | CHAR | 40 | City | 城市 |
| `District` | CHAR | 40 | District | 区域 |
| `Manufacturer` | CHAR | 30 | Manufacturer | 制造商 |
| `ModelNumber` | CHAR | 30 | Model Number | 型号 |
| `SerialNumber` | CHAR | 30 | Serial Number | 序列号 |
| `ConstructionYear` | NUMC | 4 | Construction Year | 制造年份 |
| `ConstructionMonth` | NUMC | 2 | Construction Month | 制造月份 |
| `GrossWeight` | QUAN | 13 | Gross Weight | 毛重 |
| `WeightUnit` | UNIT | 3 | Weight Unit | 重量单位 |
| `AcquisitionDate` | DATN | 8 | Acquisition Date | 购置日期 |
| `AcquisitionValue` | CURR | 13 | Acquisition Value | 购置价值 |
| `Currency` | CURR | 5 | Currency | 货币 |
| `UsefulLife` | NUMC | 3 | Useful Life (Years) | 使用年限 |

---

## 示例请求 / Sample Requests

### 读取设备结构列表 (默认分页)

```http
GET /sap/opu/odata4/sap/equipmentstruclist/srvd_a2x/sap/equipmenthierarchy/0001/A_EquipmentStructList
Accept: application/json
```

### 按设备编号查询

```http
GET /sap/opu/odata4/sap/equipmentstruclist/srvd_a2x/sap/equipmenthierarchy/0001/A_EquipmentStructList(Equipment='10000001',ValidityDate=2026-01-01)
Accept: application/json
```

### 查询上级设备的所有下级设备

```http
GET /sap/opu/odata4/sap/equipmentstruclist/srvd_a2x/sap/equipmenthierarchy/0001/A_EquipmentStructList?$filter=SuperiorEquipment eq '10000000'
Accept: application/json
```
