# API: Joint Operating Agreement (A2X)
# File: API_JNTOPGAGRMT_0001.md
# Version: 1.1.0
# Status: ACTIVE
# Protocol: OData V4
# Source URL: https://api.sap.com/api/API_JNTOPGAGRMT_0001/overview
# Generated: 2026-07-23 14:17:02
---

# Joint Operating Agreement (A2X) / 联合作业协议 API

> **API 版本:** 1.1.0 | **状态:** ACTIVE | **协议:** OData V4  
> **技术名称:** `API_JNTOPGAGRMT`  
> **服务根路径:** `/sap/opu/odata4/sap/api_jntopgagrmt/srvd_a2x/sap/jointoperatingagreement/0001/`  
> **SAP 通信场景:** `SAP_COM_0012`

## 概述 / Overview

该服务提供联合作业协议（Joint Operating Agreement, JOA）主数据的创建、读取、更新和删除（CRUD）操作。适用于石油天然气行业中的联合作业协议管理，包括权益组和权益份额等子实体。

This synchronous inbound OData V4 service enables CRUD operations on Joint Operating Agreement (JOA) master data for the oil and gas industry. It includes management of equity groups, equity shares, and penalty category recovery percentages.

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

---

## 实体列表 / Entity List

| # | 实体名称 | 描述 (EN) | 描述 (CN) | 主键 |
|---|----------|-----------|-----------|------|
| 1 | `A_JointOperatingAgreement` | Joint Operating Agreement | 联合作业协议 | `JointOperatingAgreement` |
| 2 | `A_JntOpgAgrmtText` | Joint Operating Agreement Text | 联合作业协议文本 | `JointOperatingAgreement`, `Language` |
| 3 | `A_EquityGroup` | Equity Group | 权益组 | `JointOperatingAgreement`, `EquityGroup` |
| 4 | `A_EquityShare` | Equity Share | 权益份额 | `JointOperatingAgreement`, `EquityGroup`, `EquityShare` |
| 5 | `A_PenaltyCategoryRecovery` | Penalty Category Recovery % | 罚金类别回收率 | `JointOperatingAgreement`, `PenaltyCategory` |

---

## 1. A_JointOperatingAgreement — 联合作业协议

**实体集合路径:** `A_JointOperatingAgreement`  
**主键 (Key):** `JointOperatingAgreement` (CHAR 6)  
**ETag:** 支持 (`LastModifiedDateTime` 字段)

### 字段列表 / Field List

| 字段名 | 类型 | 长度 | 描述 (EN) | 描述 (CN) |
|--------|------|------|-----------|-----------|
| `JointOperatingAgreement` | CHAR | 6 | Joint Operating Agreement | 联合作业协议 |
| `JointOperatingAgreementName` | CHAR | 35 | Name of Joint Operating Agreement | 联合作业协议名称 |
| `CompanyCode` | CHAR | 4 | Company Code | 公司代码 |
| `ValidFrom` | DATS | 8 | Valid From | 有效期起始日期 |
| `ValidTo` | DATS | 8 | Valid To | 有效期截止日期 |
| `JointVenture` | CHAR | 6 | Joint Venture | 合资企业 |
| `EquityGrouping` | CHAR | 6 | Equity Grouping | 权益分组 |
| `CashCallFrequency` | CHAR | 2 | Cash Call Frequency | 催缴频率 |
| `CashCallLeadDays` | NUMC | 3 | Cash Call Lead Days | 催缴提前天数 |
| `SuspenseAccount` | CHAR | 10 | Suspense Account | 暂记账户 |
| `JointOperatingAgreementCurrency` | CUKY | 5 | Currency of JOA | 联合作业协议货币 |
| `CreationDate` | DATS | 8 | Creation Date | 创建日期 |
| `LastModifiedDateTime` | DEC | 15 | Last Modified Timestamp | 最后修改时间戳 |

### 导航属性 / Navigation Properties

| 导航属性 | 目标实体 | 描述 (EN) | 描述 (CN) |
|----------|----------|-----------|-----------|
| `to_JntOpgAgrmtText` | A_JntOpgAgrmtText | JOA Text | 联合作业协议文本 |
| `to_EquityGroup` | A_EquityGroup | Equity Group | 权益组 |