Сначала задайте вопрос о данных#

В Transaction Manager одна финансовая сделка может иметь несколько активностей, денежных потоков, позиций по valuation area и бухгалтерских документов. Поэтому технический объект нельзя выбирать только по похожему названию. Сначала установите, нужно ли получить состояние сделки, график потоков, остаток позиции на дату, мастер-данные настройки или событие, которое требует внимания пользователя.

В SAP S/4HANA On-Premise 2025 FPS01 документация описывает разные CDS-представления для разных задач. Ниже приведены конкретные примеры и их границы, а не полный каталог объектов.

Потоки текущей активности сделки#

CDS I_FinTransFlow показывает cash flow текущей активности финансовых сделок с датами, суммами и платежными сведениями. Документация выделяет вопросы о потоках текущей активности и о том, какой payment request использовал поток. В качестве основных фильтров названы company code, financial transaction и financial instrument activity.

Такое представление удобно для сверки графика сделки с платежной заявкой. Но перед использованием зафиксируйте все три значения фильтра, activity или ревизию сделки и ключевую дату анализа. Текущая activity не равна неизменяемой истории всех версий сделки; поток не равен созданному FI-документу или подтверждению исполнения платежа. Для статуса фактического платежа переходите к соответствующей платёжной и банковской цепочке.

Документация указывает ограничения авторизации по company code, product/transaction type, portfolio и securities account. Если часть потоков отсутствует, проверяйте не только фильтр и валютные данные, но и полномочия чтения. Отсутствие строки при ограниченной авторизации нельзя трактовать как отсутствие бизнес-события.

Позиция и стоимость на ключевую дату#

I_FinancialPositionCube предназначен для анализа финансового статуса на указанную key date. SAP перечисляет номинал и book value финансовых позиций, а также измерения, среди которых company code, financial position, valuation area, ledger, валюта, counterparty и accounting document.

Это объект позиционного и аналитического уровня. Его нельзя подменять I_FinTransFlow: поток описывает отдельные предусмотренные договором денежные события, а куб показывает значения позиции на дату. Нельзя также предполагать, что каждая позиция в кубе происходит только из TRM: набор содержит финансовые позиции с различными источниками данных. Для сопоставления результата запишите key date, валюту представления, data source, valuation area и ledger.

Справочник групп продуктов#

I_FinTransProductGroup читает определённые в системе группы финансовых продуктов. Это измерение для классификации и поиска допустимых продуктовых групп, а не факт сделки и не список потоков. Значение справочника само по себе не раскрывает все правила конкретного product type, transaction type или процесса обработки.

В отчетной модели соединяйте справочник с бизнес-данными только по документированным полям и кардинальности. Не используйте один идентификатор группы как ключ финансовой сделки или как замену её product type.

API торгового запроса#

В API-документации SAP S/4HANA On-Premise 2025 FPS01 приведён технический объект TreasuryTradeRequest. Он относится к запросу на сделку и процессу обработки trade requests. Обязательность полей зависит от выбранного действия и категории инструмента, то есть единый короткий payload не подходит для каждого сценария.

Не следует считать, что API trade request тождественен созданию, подтверждению, изменению или проведению финансовой сделки. До интеграции проверьте назначение операции, разрешённые методы и свойства, правила конкретной категории, возвратные статусы, поведение повторного запроса, полномочия и доступность сервиса в целевом ландшафте. Эти свойства должны подтверждаться документацией точного API и его release/status, а затем испытанием в тестовой системе.

Как проверять контракт технического объекта#

Для выбранного CDS или API запишите:

1. продукт, edition, release и feature level;
2. точное техническое имя и статус релиза объекта для этого уровня;
3. назначение и data category: справочник, текущая активность, поток, позиция, snapshot или команда изменения;
4. фильтры, ключевые измерения, дату и правила агрегации;
5. единицу, валюту, направление и смысл суммы;
6. authorization objects, бизнес-роли и доступность для интеграционного пользователя;
7. правила обновления, физического удаления и повторной обработки;
8. связь с транзакцией, activity, payment request и FI-документом;
9. контрольные строки и суммы, по которым результат сверяется с приложением и исходными документами.

Проверяйте доступность и поддерживаемые сценарии конкретного CDS в View Browser и документации установленного релиза. У одного SAP-объекта могут различаться status, supported capabilities и роль в ключевой пользовательской или аналитической extensibility. Название Released также не означает, что объект доступен для произвольной транзакционной записи.

Почему не начинать с прямого чтения таблиц#

Таблица хранения, CDS-контракт и интеграционный API отвечают на разные вопросы. Здесь перечислены документированные CDS и один API; таблицы базы данных, их ключи, append-структуры, внутренняя версия записи и прямые SQL-соединения не исследовались. Поэтому статья не рекомендует имена внутренних таблиц и не описывает прямое чтение как поддерживаемый интерфейс.

Для отчетности сначала ищите релизный CDS с нужной семантикой, доступом и гранулярностью. Для изменения бизнес-объекта используйте документированный API или процесс приложения. Для проверки интеграции сохраняйте ID операции, исходный запрос, ответ, объект SAP и связанный документ. Доступность и правила проверки данных подтвердите в тестовом контуре до эксплуатации.

Применимость#

Примеры основаны на официальной документации SAP S/4HANA On-Premise 2025 FPS01. Это не инвентаризация CDS, таблиц или API в установленной системе и не тест подключения. Public Edition, Private Edition, ECC и другие релизы могут иметь иной каталог и контракт. В проекте не проверялись реальные авторизации, данные, API-вызовы, расширения и результат отчетов.

Путь сделки и версий рассмотрен в статье о жизненном цикле TRM. Для потока и оплаты см. платёжные заявки и расчёты по сделкам, а для позиции на дату и ledger - области оценки и параллельный учёт TRM. Документированные точки расширения ABAP описаны отдельно в статье о BAdI для TRM.

TRM: Data and Technical Interfaces#

Start with a question about the data#

In Transaction Manager, one financial transaction can have several activities, cash flows, positions by valuation area, and accounting documents. A technical object should therefore not be selected by a similar-sounding name alone. First determine whether the requirement is to read transaction state, cash flows, a position as of a date, configuration master data, or an event that requires user attention.

SAP S/4HANA On-Premise 2025 FPS01 documents different CDS representations for different purposes. The examples below show specific uses and boundaries, not a complete object catalogue.

Cash flows of the current transaction activity#

CDS I_FinTransFlow shows the cash flow of the current activity of financial transactions, with dates, amounts, and payment details. SAP highlights questions about cash flows for the current activity and which payment request paid a flow. Its main filters are company code, financial transaction, and financial instrument activity.

This view can help reconcile a transaction schedule with a payment request. Before using it, record all three filter values, the activity or revision, and the analysis date. The current activity is not the immutable history of all transaction versions; a flow is not the same as an FI document or proof that a payment was executed. For actual payment status, follow the relevant payment and bank-processing chain.

The documentation identifies authorization limits for company code, product and transaction types, portfolio, and securities account. If flows are missing, check both filters and currency inputs, as well as read permissions. An absent row under restricted authorization must not be interpreted as proof that no business event exists.

Position value as of a key date#

I_FinancialPositionCube is intended to analyze financial status as of a specified key date. SAP lists nominal amount and book value of financial positions, with dimensions including company code, financial position, valuation area, ledger, currency, counterparty, and accounting document.

This is a position-level analytical object. It must not be substituted for I_FinTransFlow: a flow represents a contract cash-flow event, while the cube shows position values as of a date. Do not assume that every position in the cube originates only from TRM; it includes financial positions from different data sources. To reconcile a result, record the key date, display currency, data source, valuation area, and ledger.

Product-group reference data#

I_FinTransProductGroup reads the financial transaction product groups defined in the system. It is a dimension for classification and finding available product groups, not a transaction fact or cash-flow list. A reference value alone does not reveal all rules for a particular product type, transaction type, or processing flow.

In a reporting model, join reference data to business data only through documented fields and cardinality. Do not use a product-group identifier as the financial-transaction key or as a substitute for its product type.

Trade request API#

SAP's API documentation for SAP S/4HANA On-Premise 2025 FPS01 lists the technical object TreasuryTradeRequest. It relates to trade requests and their processing. Field necessity depends on the selected action and instrument category, so one short payload cannot be assumed to work for every scenario.

Do not assume the trade-request API is equivalent to creating, confirming, changing, or posting a financial transaction. Before integration, check the operation's purpose, permitted methods and properties, category-specific rules, returned statuses, retry behavior, authorizations, and service availability in the target landscape. Confirm these details in the exact API documentation and release status, then test in a non-production system.

How to verify a technical contract#

For a selected CDS view or API, record:

1. Product, edition, release, and feature level.
2. Exact technical name and release status for that level.
3. Purpose and data category: reference, current activity, flow, position, snapshot, or change command.
4. Filters, key dimensions, date, and aggregation rules.
5. Unit, currency, direction, and meaning of amounts.
6. Authorization objects, business roles, and access for the integration user.
7. Update and physical deletion behavior, and retry handling.
8. Relationship to transaction, activity, payment request, and FI document.
9. Control records and totals for reconciliation with the application and source documents.

Check availability and supported use cases for a CDS view in View Browser and the documentation for the installed release. A SAP object can have different status, supported capabilities, and roles in key-user or analytical extensibility. A Released status also does not mean that the object supports arbitrary transactional writes.

Why not start with direct table reads#

A storage table, CDS contract, and integration API answer different questions. This article lists documented CDS views and one API; database tables, keys, append structures, internal record versions, and direct SQL joins have not been investigated. It therefore does not recommend internal table names or describe direct reads as a supported interface.

For reporting, first find a release-specific CDS view with the required semantics, access, and granularity. To change a business object, use a documented API or application process. When testing an integration, retain the operation ID, request, response, SAP object, and related document. Verify availability and data-validation rules in a test system before production use.

Applicability#

These examples are based on SAP S/4HANA On-Premise 2025 FPS01 official documentation. This is not an inventory of the CDS views, tables, or APIs in an installed system, and no connection was tested. Public Edition, Private Edition, ECC, and other releases can expose different catalogues and contracts. Actual authorizations, data, API calls, extensions, and report results were not checked in this project.

The transaction lifecycle and versioning are covered in TRM Transaction Lifecycle. For flows and settlement, see TRM Payment Requests and Settlement; for position values by date and ledger, see TRM Valuation Areas and Parallel Accounting.

Documented ABAP extension points are covered separately in TRM BAdIs.