?---
# API: Customer Material (A2X)
# File: API_CUSTOMER_MATERIAL_SRV.md
# Version: 1.0.0
# Status: ACTIVE
# Protocol: OData V2
# Source URL: https://api.sap.com/api/API_CUSTOMER_MATERIAL_SRV/overview
# Generated: 2026-07-23
---

# Customer Material / 客户物料 API

> **API 版本:** 1.0.0 | **状** ACTIVE | **协议:** OData V2  
> **技术名** `API_CUSTOMER_MATERIAL_SRV`  
> **服务根路** `/sap/opu/odata/sap/API_CUSTOMER_MATERIAL_SRV`  
> **SAP 通信场景:** `SAP_COM_0109`

## 概述 / Overview

该服务用于管理客户物料信息记录，将客户特定的物料编号与内部物料编号关联，支持销售流程?
This service manages customer-material information records that link customer-specific material numbers to internal material numbers, supporting the sales process.

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

---

## 实体列表 / Entity List

| # | 实体名称 | 描述 (EN) | 描述 (CN) | 主键 |
|---|----------|-----------|-----------|------|
| 1 | `A_CustomerMaterial` | Customer Material Info Record | 客户物料信息记录 | `Customer`, `SalesOrganization`, `DistributionChannel`, `Material` |
| 2 | `A_CustomerMaterialSalesData` | Customer Material Sales Data | 客户物料销售数?| `Customer`, `SalesOrganization`, `DistributionChannel`, `Material` |
| 3 | `A_CustomerMaterialPlantData` | Customer Material Plant Data | 客户物料工厂数据 | `Customer`, `SalesOrganization`, `DistributionChannel`, `Material`, `Plant` |

---

## 1. A_CustomerMaterial ?客户物料信息记录

**实体集合路径:** `A_CustomerMaterial`  
**主键 (Key):** `Customer` (CHAR 10), `SalesOrganization` (CHAR 4), `DistributionChannel` (CHAR 2), `Material` (CHAR 40)  
**ETag:** 支持 (`ETag` 字段)

### 字段列表 / Field List

| 字段?| 类型 | 长度 | 描述 (EN) | 描述 (CN) |
|--------|------|------|-----------|-----------|
| `Customer` | String | 10 | Customer Number | 客户编号 (主键) |
| `SalesOrganization` | String | 4 | Sales Organization | 销售组?(主键) |
| `DistributionChannel` | String | 2 | Distribution Channel | 分销渠道 (主键) |
| `Material` | String | 40 | Material Number | 物料编号 (主键) |
| `MaterialByCustomer` | String | 35 | Customer Material Number | 客户物料编号 |
| `MaterialDescriptionByCustomer` | String | 40 | Customer Description | 客户物料描述 |
| `Plant` | String | 4 | Plant | 工厂 |
| `DeliveryPlant` | String | 4 | Delivering Plant | 发货工厂 |
| `DeliveryPriority` | String | 2 | Delivery Priority | 交货优先?|
| `MinDeliveryQtyInBaseUnit` | Decimal | 15,3 | Minimum Delivery Qty | 最小交货数?|
| `BaseUnit` | String | 3 | Base Unit of Measure | 基本计量单位 |
| `PartialDeliveryIsAllowed` | String | 1 | Partial Delivery Allowed | 允许部分交货 |
| `MaxNmbrOfPartialDelivery` | Decimal | 1,0 | Max Partial Deliveries | 最大部分交货次?|
| `UnderdelivTolrtdLmtRatioInPct` | Decimal | 3,1 | Underdelivery Tolerance | 欠交容差百分?|
| `OverdelivTolrtdLmtRatioInPct` | Decimal | 3,1 | Overdelivery Tolerance | 超交容差百分?|
| `UnlimitedOverdeliveryIsAllowed` | Boolean | - | Unlimited Overdelivery | 允许无限超交 |
| `CustomerMaterialItemUsage` | String | 1 | Item Usage | 项目用?|
| `SalesUnit` | String | 3 | Sales Unit | 销售单?|
| `SalesQtyToBaseQtyDnmntr` | Decimal | 5,0 | Denominator for Sales Unit | 销售单位分?|
| `SalesQtyToBaseQtyNmrtr` | Decimal | 5,0 | Numerator for Sales Unit | 销售单位分?|
| `Usage` | String | 1 | Usage Indicator | 用途标?|
| `ValidityStartDate` | DateTime | - | Validity Start Date | 有效起始日期 |
| `ValidityEndDate` | DateTime | - | Validity End Date | 有效截止日期 |
| `ETag` | String | - | ETag | 版本标识 |

### 导航属?/ Navigation Properties

| 属性名 | 目标实体 | 基数 | 描述 |
|--------|----------|------|------|
| `to_CustomerMaterialSalesData` | A_CustomerMaterialSalesData | 0..1 | 客户物料销售数?|
| `to_CustomerMaterialPlantData` | A_CustomerMaterialPlantData | 0..* | 客户物料工厂数据 |

---

## 2. A_CustomerMaterialSalesData ?客户物料销售数?
**实体集合路径:** `A_CustomerMaterialSalesData`  
**主键 (Key):** `Customer` (CHAR 10), `SalesOrganization` (CHAR 4), `DistributionChannel` (CHAR 2), `Material` (CHAR 40)

### 字段列表 / Field List

| 字段?| 类型 | 长度 | 描述 (EN) | 描述 (CN) |
|--------|------|------|-----------|-----------|
| `Customer` | String | 10 | Customer Number | 客户编号 |
| `SalesOrganization` | String | 4 | Sales Organization | 销售组?|
| `DistributionChannel` | String | 2 | Distribution Channel | 分销渠道 |
| `Material` | String | 40 | Material Number | 物料编号 |
| `MaterialByCustomer` | String | 35 | Customer Material Number | 客户物料编号 |
| `MaterialDescriptionByCustomer` | String | 40 | Customer Description | 客户物料描述 |
| `DeliveryPriority` | String | 2 | Delivery Priority | 交货优先?|
| `MinDeliveryQtyInBaseUnit` | Decimal | 15,3 | Minimum Delivery Qty | 最小交货数?|
| `BaseUnit` | String | 3 | Base Unit of Measure | 基本计量单位 |
| `PartialDeliveryIsAllowed` | String | 1 | Partial Delivery Allowed | 允许部分交货 |
| `CustomerMaterialItemUsage` | String | 1 | Item Usage | 项目用?|
| `SalesUnit` | String | 3 | Sales Unit | 销售单?|
| `SalesQtyToBaseQtyDnmntr` | Decimal | 5,0 | Denominator | 分母 |
| `SalesQtyToBaseQtyNmrtr` | Decimal | 5,0 | Numerator | 分子 |

---

## 3. A_CustomerMaterialPlantData ?客户物料工厂数据

**实体集合路径:** `A_CustomerMaterialPlantData`  
**主键 (Key):** `Customer` (CHAR 10), `SalesOrganization` (CHAR 4), `DistributionChannel` (CHAR 2), `Material` (CHAR 40), `Plant` (CHAR 4)

### 字段列表 / Field List

| 字段?| 类型 | 长度 | 描述 (EN) | 描述 (CN) |
|--------|------|------|-----------|-----------|
| `Customer` | String | 10 | Customer Number | 客户编号 |
| `SalesOrganization` | String | 4 | Sales Organization | 销售组?|
| `DistributionChannel` | String | 2 | Distribution Channel | 分销渠道 |
| `Material` | String | 40 | Material Number | 物料编号 |
| `Plant` | String | 4 | Plant | 工厂 |
| `DeliveryPlant` | String | 4 | Delivering Plant | 发货工厂 |