I_ProviderContract
Provider Contract
I_ProviderContract (Basic)
Package: Explore, extend and adapt the SAP S/4HANA Cloud Public Edition with built-in and side-by-side extension capabilities.
Contract Accounting
I_ProviderContract is a Basic CDS View that provides data about "Provider Contract" in SAP S/4HANA. It reads from 1 data source (dfkk_vt_h) and exposes 38 fields with key field ProviderContract. It has 12 associations to related views. It is exposed through 1 OData service (UI_BILLINGDOCUMENT_MANAGE). Part of development package FKK_VT.
SAP Help Documentation
| Category | CDS Views for Master Data |
|---|
This CDS view represents the header data of provider contracts where the contract category ( VTCAT ) is Contract Accounting Provider Contract ( space ) or Sales Billing Provider Contract (1). In Contract Accounting as well as in Sales Billing , the provider contract comprises all legally binding agreements regarding the provision and billing of services entered into by a customer and a company for a specified period of time. This CDS view provides the prerequisites for answering the following business questions: How many provider contracts exist for a business partner? When does the validity of the provider contract end?
Prerequisites
Authorizations The SAP_A4C_BC_DEV_TST_FICA_PC ( Development - API Test - Contract Accounting ) business catalog needs to be assigned to a user to be able to use this CDS view.
SAP API Hub
| Category | Basic |
|---|---|
| State | C1 |
| Line of Business | Contract Accounting |
| Application Component | FI-CA-2CL |
| Capabilities | Association Target for Defining CDS Entities,Data Source for Defining CDS Entities,Data Source in SQL Select |
| Extensible (Key User) | Yes |
| Extensible (Developer) | No |
| Release State (Key User) | Released |
| Release State (Developer) | Released |
| Package | Contract Accounting for SAP S/4HANA Cloud Public Edition |
Documentation
- Analytics with CDS Views — Build Analytics for S/4HANA Cloud Public Edition ABAP CDS views replicated to SAP Cloud Platform
- CDS Views on SAP Business Accelerator Hub — Explore SAP S/4HANA Cloud Public Edition CDS Views on SAP Business Accelerator Hub
- Create CDS View as API — Create CDS views in SAP S/4HANA Cloud Public Edition and consume them as APIs
- Custom CDS Views — Access data using a Custom Core Data Service view (Custom CDS view)
- Custom Communication Scenarios — Create custom communication scenarios to configure custom communication arrangement
- Key User Extensibility Tools — The Key User Extensibility Tools of S/4HANA
- SAP S/4HANA Extensibility — SAP S/4HANA Extensibility Tutorial
- VDM View Types — The Virtual Data Model in SAP S/4HANA Cloud Public Edition
- View Browser — Search, browse and tag CDS Views
Data Sources (1)
| Source | Alias | Join Type |
|---|---|---|
| dfkk_vt_h | dfkk_vt_h | from |
Associations (12)
| Cardinality | Target | Alias | Condition |
|---|---|---|---|
| [1..1] | I_BusinessPartner | _BusinessPartner | $projection.BusinessPartner = _BusinessPartner.BusinessPartner |
| [0..1] | I_CAAuthorizationGroup | _CAAuthorizationGroup | $projection.CAAuthorizationGroup = _CAAuthorizationGroup.CAAuthorizationGroup and _CAAuthorizationGroup.CAAuthorizationGroupObject = 'CA_BILLCTR' |
| [1..1] | I_CompanyCode | _CompCode | $projection.CompanyCode = _CompCode.CompanyCode |
| [1..1] | I_ProviderContractCategory | _ProviderContractCategory | $projection.CAProviderContractCategory = _ProviderContractCategory.CAProviderContractCategory |
| [0..1] | I_ProviderContractMigrtnSts | _ProviderContractMigrtnSts | $projection.CAProviderContractMigrtnStatus = _ProviderContractMigrtnSts.CAProviderContractMigrtnStatus |
| [1..1] | I_ProviderContractType | _ProviderContractType | $projection.CAProviderContractType = _ProviderContractType.CAProviderContractType |
| [1..1] | I_ProviderContractStatus | _ProviderContractStatus | $projection.CAProviderContractStatus = _ProviderContractStatus.CAProviderContractStatus |
| [0..1] | I_ProviderContractSender | _ProviderContractSender | $projection.CAProviderContractSender = _ProviderContractSender.CAProviderContractSender |
| [1..1] | I_User | _CreatedByUser | $projection.CreatedByUser = _CreatedByUser.UserID |
| [0..1] | I_User | _LastChangedByUser | $projection.LastChangedByUser = _LastChangedByUser.UserID |
| [1..1] | I_TimeZone | _TimeZone | $projection.TimeZoneID = _TimeZone.TimeZoneID |
| [1..1] | E_CAProviderContractHeader | _Extension | $projection.ProviderContract = _Extension.CAProviderContract |
Annotations (13)
| Name | Value | Level | Field |
|---|---|---|---|
| AbapCatalog.compiler.compareFilter | true | view | |
| AbapCatalog.preserveKey | true | view | |
| AbapCatalog.sqlViewName | IPRVDRCONTR | view | |
| AccessControl.authorizationCheck | #CHECK | view | |
| AccessControl.personalData.blocking | #REQUIRED | view | |
| ClientHandling.algorithm | #SESSION_VARIABLE | view | |
| EndUserText.label | Provider Contract | view | |
| Metadata.ignorePropagatedAnnotations | true | view | |
| ObjectModel.representativeKey | ProviderContract | view | |
| ObjectModel.usageType.dataClass | #MASTER | view | |
| ObjectModel.usageType.serviceQuality | #B | view | |
| ObjectModel.usageType.sizeCategory | #XL | view | |
| VDM.viewType | #BASIC | view |
OData Services (1)
| Service | Binding | Version | Contract | Release |
|---|---|---|---|---|
| UI_BILLINGDOCUMENT_MANAGE | UI_BILLINGDOCUMENT_MANAGE | V4 | C1 | NOT_RELEASED |
Fields (38)
| Key | Field | Source Table | Source Field | Description |
|---|---|---|---|---|
| KEY | ProviderContract | vtkey | Identification of a Provider Contract | |
| BusinessPartner | Business Partner Number | |||
| CreationDate | erdat | Record Creation Date | ||
| CreationTime | Creation Time | |||
| CreatedByUser | ernam | Name of Person Responsible for Creating the Object | ||
| IsMarkedForDeletion | Deletion Indicator | |||
| LastChangeDate | aedat | Last Changed On | ||
| LastChangeTime | aetim | Last Changed At | ||
| LastChangedByUser | aenam | Name of Person Who Changed Object | ||
| CAProviderContractName | vtbez | Name of Contract | ||
| CAProviderContractExtReference | vtalt | Technical Key of Provider Contract in External System | ||
| CAPrvdrContrStartDateTime | vtbeg | Contract Start | ||
| CAPrvdrContrEndDateTime | vtend | Contract End Date | ||
| AuthorizationGroup | begru | Authorization Group | ||
| CAAuthorizationGroup | begru | Authorization Group | ||
| CompanyCode | bukrs | Company Code for Authorization Check | ||
| TimeZoneID | Time Zone Difference | |||
| CAProviderContractCategory | vtcat | Contract Category | ||
| CAProviderContractMigrtnStatus | migst | Migration Status | ||
| CAProviderContractType | vtchr | Contract Specification | ||
| CAProviderContractStatus | statu | Status of Provider Contract | ||
| CAProviderContractSender | sender | Provider Contract Sender | ||
| PrvdrContrEarliestEndDateTime | vtend_min | End of Minimum Term | ||
| MinNrOfMonthsForContractPeriod | vtper_min | Min Length of Contract (Months) | ||
| NrOfMonthsForContractRenewal | vtper_rnwl | Contract Extension in Months | ||
| NrOfDaysForContrNoticePeriod | vtper_canc | Notice Period in Days | ||
| BudgetBillingPlanType | uti_bbptype | Utilities Budget Billing Plan Type | ||
| _BusinessPartner | _BusinessPartner | |||
| _CAAuthorizationGroup | _CAAuthorizationGroup | |||
| _CompCode | _CompCode | |||
| _ProviderContractCategory | _ProviderContractCategory | |||
| _ProviderContractMigrtnSts | _ProviderContractMigrtnSts | |||
| _ProviderContractType | _ProviderContractType | |||
| _ProviderContractStatus | _ProviderContractStatus | |||
| _ProviderContractSender | _ProviderContractSender | |||
| _CreatedByUser | _CreatedByUser | |||
| _LastChangedByUser | _LastChangedByUser | |||
| _TimeZone | _TimeZone |
Derived SQL interpretation, reconstructed from the parsed view metadata (data sources, associations, and field mappings). SAP annotations are omitted and the structure is reformulated as SQL — this is a functional approximation, not the verbatim SAP source.
-- Derived SQL interpretation of CDS view I_ProviderContract.
-- Reconstructed from parsed metadata (data sources, associations, fields).
-- SAP annotations are omitted and the structure is reformulated as SQL;
-- this is a functional approximation, not the verbatim SAP source. Some join
-- conditions may be unavailable and a few CDS constructs are kept as-is.
CREATE VIEW I_ProviderContract AS
SELECT
vtkey AS ProviderContract,
cast(gpart as bu_partner preserving type ) AS BusinessPartner,
erdat AS CreationDate,
cast(ertim as ttet_dt_cr_time preserving type ) AS CreationTime,
ernam AS CreatedByUser,
cast(loevm as loevm preserving type ) AS IsMarkedForDeletion,
aedat AS LastChangeDate,
aetim AS LastChangeTime,
aenam AS LastChangedByUser,
vtbez AS CAProviderContractName,
vtalt AS CAProviderContractExtReference,
vtbeg AS CAPrvdrContrStartDateTime,
vtend AS CAPrvdrContrEndDateTime,
begru AS AuthorizationGroup,
begru AS CAAuthorizationGroup,
bukrs AS CompanyCode,
cast(tzone as tznzone preserving type ) AS TimeZoneID,
vtcat AS CAProviderContractCategory,
migst AS CAProviderContractMigrtnStatus,
vtchr AS CAProviderContractType,
statu AS CAProviderContractStatus,
sender AS CAProviderContractSender,
vtend_min AS PrvdrContrEarliestEndDateTime,
vtper_min AS MinNrOfMonthsForContractPeriod,
vtper_rnwl AS NrOfMonthsForContractRenewal,
vtper_canc AS NrOfDaysForContrNoticePeriod,
uti_bbptype AS BudgetBillingPlanType
FROM dfkk_vt_h
LEFT OUTER JOIN I_BusinessPartner AS _BusinessPartner ON BusinessPartner = _BusinessPartner.BusinessPartner -- association [1..1]
LEFT OUTER JOIN I_CAAuthorizationGroup AS _CAAuthorizationGroup ON CAAuthorizationGroup = _CAAuthorizationGroup.CAAuthorizationGroup AND _CAAuthorizationGroup.CAAuthorizationGroupObject = 'CA_BILLCTR' -- association [0..1]
LEFT OUTER JOIN I_CompanyCode AS _CompCode ON CompanyCode = _CompCode.CompanyCode -- association [1..1]
LEFT OUTER JOIN I_ProviderContractCategory AS _ProviderContractCategory ON CAProviderContractCategory = _ProviderContractCategory.CAProviderContractCategory -- association [1..1]
LEFT OUTER JOIN I_ProviderContractMigrtnSts AS _ProviderContractMigrtnSts ON CAProviderContractMigrtnStatus = _ProviderContractMigrtnSts.CAProviderContractMigrtnStatus -- association [0..1]
LEFT OUTER JOIN I_ProviderContractType AS _ProviderContractType ON CAProviderContractType = _ProviderContractType.CAProviderContractType -- association [1..1]
LEFT OUTER JOIN I_ProviderContractStatus AS _ProviderContractStatus ON CAProviderContractStatus = _ProviderContractStatus.CAProviderContractStatus -- association [1..1]
LEFT OUTER JOIN I_ProviderContractSender AS _ProviderContractSender ON CAProviderContractSender = _ProviderContractSender.CAProviderContractSender -- association [0..1]
LEFT OUTER JOIN I_User AS _CreatedByUser ON CreatedByUser = _CreatedByUser.UserID -- association [1..1]
LEFT OUTER JOIN I_User AS _LastChangedByUser ON LastChangedByUser = _LastChangedByUser.UserID -- association [0..1]
LEFT OUTER JOIN I_TimeZone AS _TimeZone ON TimeZoneID = _TimeZone.TimeZoneID -- association [1..1]
LEFT OUTER JOIN E_CAProviderContractHeader AS _Extension ON ProviderContract = _Extension.CAProviderContract -- association [1..1]
;
Learn More
- VDM (Virtual Data Model) in SAP S/4HANA Explained
- Types of CDS Views: Basic, Composite, Consumption, and Transactional
- OData Services in SAP S/4HANA Explained
- Service Bindings and Service Definitions in SAP S/4HANA
- CDS View Annotations — A Complete Guide
- What Is a CDS View in SAP S/4HANA?
- SAP Tables vs CDS Views — Key Differences
- Understanding Data Lineage in SAP S/4HANA
- CDS View Field Mapping and Associations
- Understanding the SAP S/4HANA Data Model
- CDS View Extensions and Custom Fields in SAP S/4HANA
- Released APIs and Stability Contracts in SAP S/4HANA
- BSEG to ACDOCA: The Universal Journal Migration
- Business Partner Migration: KNA1/LFA1 to BUT000
- Material Document Migration: MSEG/MKPF to MATDOC
- How to Find the Right CDS View for an SAP Table
- BW Extractor to CDS View Migration Guide
- S/4HANA CDS View Deprecation: What You Need to Know
- ABAP CDS View Tutorial — From Basics to Real-World Examples
- RAP and CDS Views — Building Transactional Apps in SAP S/4HANA
- Sales Document Status Migration: VBUP/VBUK Removal in S/4HANA
- CO Tables in S/4HANA: COEP, COBK, COSS, COSP to ACDOCA