I_PaymentAdvice
Payment Advice Header
I_PaymentAdvice (Basic)
Package: Explore, extend and adapt the SAP S/4HANA Cloud Public Edition with built-in and side-by-side extension capabilities.
Cross Applications
I_PaymentAdvice is a Basic CDS View that provides data about "Payment Advice Header" in SAP S/4HANA. It reads from 1 data source (avik) and exposes 57 fields with key fields CompanyCode, PaymentAdviceAccountType, PaymentAdviceAccount, PaymentAdvice. It has 12 associations to related views. It is exposed through 1 OData service (ASQL_F2626). Part of development package ODATA_PAYMENTADVICES.
SAP Help Documentation
| Category | CDS Views for Receivables Management |
|---|
This CDS view helps to retrieve payment advice header data. For payment advice item data, use the I_PaymentAdviceItem view instead. To help you decide which CDS view to use for your purposes, SAP has introduced the annotation ObjectModel.supportedCapabilities that indicates the most appropriate use cases for each CDS view. To find out what use cases are best supported by this CDS view, access the entry of the CDS view in the View Browser app and find the values for this annotation under the Annotation tab. For more information, see Supported Capabilities for CDS Views .
Prerequisites
Authorizations Users who want to use this CDS view must have a role with the following restriction types set to read access: RLTYP (BP Role) BEGRU_BKPF_BEK (Authorization Group for Supplier-Related Journal Entries) BEGRU_BKPF_BED (Authorization Group for Customer Related Journal Entries) BEGRU_KNA1 (Authorization Group for Customers) BEGRU_LFA1 (Authorization Group for Suppliers) BEGRU_BUPA_GRP (Authorization Group for Business Partners) BUKRS (Company Code) You can use the Display Restriction Types app to find out in which business catalogs these restriction types are included.
Structure
Important Fields Important fields in this view include the following: Field Name Description CompanyCode Company Code PaymentAdviceAccountType Payment Advice Account Type PaymentAdviceAccount Account Number PaymentAdvice Payment Advice Number
SAP API Hub
| Category | Basic |
|---|---|
| State | C1 |
| Line of Business | Cross Applications |
| Application Component | CA-GTF-FXU-FI-AR |
| Capabilities | Association Target for Defining CDS Entities,Data Source in SQL Select,Data Source for Defining CDS Entities |
| Extensible (Key User) | No |
| Extensible (Developer) | No |
| Release State (Key User) | Released |
| Release State (Developer) | Released |
| Package | Cross Applications for SAP S/4HANA Cloud Public Edition |
| Description | <p>This CDS view helps to retrieve payment advice header data.</p> <p>For payment advice item data, use the I_PaymentAdviceItem view instead.</p> <p>To help you decide which CDS view to use for your purposes, SAP has introduced the annotation ObjectModel.supportedCapabilities that indicates the most appropriate use cases for each CDS view. To find out what use cases are best supported by this CDS view, access the entry of the CDS view in the View Browser app and find the values for this annotation under the Annotation tab. For more information, see Supported Capabilities for CDS Views.</p> |
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 |
|---|---|---|
| avik | avik | from |
Associations (12)
| Cardinality | Target | Alias | Condition |
|---|---|---|---|
| [0..1] | I_UserContactCard | _UserContactCard | $projection.CreatedByUser = _UserContactCard.ContactCardID |
| [1..1] | I_CompanyCode | _CompanyCode | $projection.CompanyCode = _CompanyCode.CompanyCode |
| [0..1] | I_Currency | _Currency | $projection.PaymentCurrency = _Currency.Currency |
| [1..1] | I_ReasonCodeConversionVers | _PaytAdvcDiffDeterminationRule | $projection.PaytAdvcDiffDeterminationRule = _PaytAdvcDiffDeterminationRule.PaytAdvcDiffDeterminationRule |
| [1..1] | I_PaytAdviceSelRules | _PaytAdviceSelRules | $projection.PaymentAdviceSelectionRule = _PaytAdviceSelRules.PaymentAdviceSelectionRule |
| [1..1] | I_PaymentAdviceType | _PaymentAdviceType | $projection.PaymentAdviceType = _PaymentAdviceType.PaymentAdviceType |
| [1..*] | I_PaymentAdviceItem | _PaymentAdviceItem | $projection.CompanyCode = _PaymentAdviceItem.CompanyCode and $projection.PaymentAdviceAccountType = _PaymentAdviceItem.PaymentAdviceAccountType and $projection.PaymentAdviceAccount = _PaymentAdviceItem.PaymentAdviceAccount and $projection.PaymentAdvice = _PaymentAdviceItem.PaymentAdvice |
| [0..1] | I_Customer | _Customer | $projection.PaymentAdviceAccount = _Customer.Customer |
| [1..1] | I_CustomerCompany | _CustomerCompany | $projection.PaymentAdviceAccount = _CustomerCompany.Customer and $projection.CompanyCode = _CustomerCompany.CompanyCode |
| [0..1] | I_Supplier | _Supplier | $projection.PaymentAdviceAccount = _Supplier.Supplier |
| [1..1] | I_SupplierCompany | _SupplierCompany | $projection.PaymentAdviceAccount = _SupplierCompany.Supplier and $projection.CompanyCode = _SupplierCompany.CompanyCode |
| [0..1] | I_BusinessPartner | _BusinessPartner | $projection.PaymentAdviceAccount = _BusinessPartner.BusinessPartner and $projection.PaymentAdviceAccountType = 'G' |
Annotations (12)
| Name | Value | Level | Field |
|---|---|---|---|
| AbapCatalog.sqlViewName | IPAYTADVC | view | |
| AbapCatalog.compiler.compareFilter | true | view | |
| AbapCatalog.preserveKey | true | view | |
| AccessControl.authorizationCheck | #CHECK | view | |
| AccessControl.personalData.blocking | #REQUIRED | view | |
| EndUserText.label | Payment Advice Header | view | |
| VDM.viewType | #BASIC | view | |
| ObjectModel.usageType.dataClass | #MIXED | view | |
| ObjectModel.usageType.serviceQuality | #C | view | |
| ObjectModel.usageType.sizeCategory | #M | view | |
| ClientHandling.algorithm | #SESSION_VARIABLE | view | |
| Metadata.ignorePropagatedAnnotations | true | view |
OData Services (1)
| Service | Binding | Version | Contract | Release |
|---|---|---|---|---|
| ASQL_F2626 | ASQL_F2626 | C2 | NOT_RELEASED |
Fields (57)
| Key | Field | Source Table | Source Field | Description |
|---|---|---|---|---|
| KEY | CompanyCode | bukrs | Company Code | |
| KEY | PaymentAdviceAccountType | koart | Payment Advice Account Type | |
| KEY | PaymentAdviceAccount | konto | Account Number | |
| KEY | PaymentAdvice | Payment Advice Number | ||
| IsOutgoingPayment | xausg | Indicator: Outgoing Payment Using Payment Advice? | ||
| PaymentDocument | Payment Document Number | |||
| AccountByShipper | Payee's Account at the Customer | |||
| PaymentCurrency | Transaction Currency | |||
| PaymentDate | Payment Date | |||
| PaidAmountInPaytCurrency | rwbtr | Payment Amount from the Payment Advice Header | ||
| CashDiscountAmountInPaytCrcy | Cash Discount Amount | |||
| BillOfExchangeDueDate | wefae | Bill of Exchange Due Date | ||
| PaymentMethod | rzawe | Payment Method for This Payment | ||
| PartnerBank | Bank Number of the Payee | |||
| PartnerBankAccount | Bank Account Number of the Payee | |||
| PartnerBankCountry | zbnks | Country/Region Key of Partner Bank | ||
| PartnerBankSWIFTCode | zbswi | SWIFT Code of Partner Bank | ||
| CreatedByUser | ernam | Name of Person Responsible for Creating the Object | ||
| CreationDate | erdat | Record Creation Date | ||
| LastChangeDate | aedat | Last Changed On | ||
| LastChangeDateTime | lastchangedatetime | UTC Time Stamp in Long Form (YYYYMMDDhhmmssmmmuuun) | ||
| LastChangedByUser | aenam | Name of Person Who Changed Object | ||
| PaymentAdviceHeaderText | Payment Advice Header Text | |||
| PaymentAdviceType | avsrt | Payment Advice Type | ||
| CreationTime | cputm | Time of Entry | ||
| PaymentAdviceStatus | astat | Payment Advice Status | ||
| PaymentAdviceIsHeld | xkeep | Indicator: Hold Payment Advice in the System? | ||
| PaymentAdviceHasSingleAccount | xuniq | Indicator: Specific Account/Company Code in Payment Advice? | ||
| PaytAdvcDiffDeterminationRule | Reason Code Conversion Version | |||
| PaymentAdviceSelectionRule | sregl | Selection Rule for Payment Advices | ||
| OriginalReferenceDocument | xbenr | Reference Key | ||
| ReferenceDocumentType | xbtyp | Reference Transaction | ||
| BankReference | vgref | Bank Reference Number | ||
| BankPostingDate | bvdat | Posting Date at the Bank | ||
| ValueDateTime | butim | Value Date Time | ||
| FeeAmountInTransactionCrcy | spesk | Fees in Account Currency | ||
| PaymentTransaction | vorgc | Business Transaction Code | ||
| ExchangeRate | Accounting Exchange Rate | |||
| BillOfExchangeFailureDate | jpdat | Date of Failed Bills of Exchange in Japan | ||
| Cheque | chect | Check number | ||
| ValueDate | valut | Value date | ||
| BusinessPartnerName | zbprn | Business Partner | ||
| CAPaymentDocument | fica_apbel | Number of Usage Document | ||
| ContractAccount | fica_vkont | Contract Account Number | ||
| CAPaymentAdvice | fica_avkey | Payment Advice Note | ||
| _PaymentAdviceItem | _PaymentAdviceItem | |||
| _CompanyCode | _CompanyCode | |||
| _Currency | _Currency | |||
| _PaytAdvcDiffDeterminationRule | _PaytAdvcDiffDeterminationRule | |||
| _PaytAdviceSelRules | _PaytAdviceSelRules | |||
| _UserContactCard | _UserContactCard | |||
| _PaymentAdviceType | _PaymentAdviceType | |||
| _Customer | _Customer | |||
| _CustomerCompany | _CustomerCompany | |||
| _Supplier | _Supplier | |||
| _SupplierCompany | _SupplierCompany | |||
| _BusinessPartner | _BusinessPartner |
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_PaymentAdvice.
-- 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.
-- SQL view name: IPAYTADVC
CREATE VIEW I_PaymentAdvice AS
SELECT
bukrs AS CompanyCode,
koart AS PaymentAdviceAccountType,
konto AS PaymentAdviceAccount,
cast(avsid as farp_pa_avsid preserving type) AS PaymentAdvice,
xausg AS IsOutgoingPayment,
cast(vblnr as farp_pa_vblnr preserving type) AS PaymentDocument,
cast(eikto as farp_pa_eikto preserving type) AS AccountByShipper,
cast(waers as farp_fwaer preserving type) AS PaymentCurrency,
cast(zaldt as farp_payment_date preserving type) AS PaymentDate,
rwbtr AS PaidAmountInPaytCurrency,
cast(rwskt as fis_wskto) AS CashDiscountAmountInPaytCrcy,
wefae AS BillOfExchangeDueDate,
rzawe AS PaymentMethod,
cast(zbnkl as farp_pa_dzbnkl preserving type) AS PartnerBank,
cast(zbnkn as farp_pa_dzbnkn preserving type) AS PartnerBankAccount,
zbnks AS PartnerBankCountry,
zbswi AS PartnerBankSWIFTCode,
ernam AS CreatedByUser,
erdat AS CreationDate,
aedat AS LastChangeDate,
LastChangeDateTime,
aenam AS LastChangedByUser,
cast(avtxt as farp_avtxt_avik preserving type) AS PaymentAdviceHeaderText,
avsrt AS PaymentAdviceType,
cputm AS CreationTime,
astat AS PaymentAdviceStatus,
xkeep AS PaymentAdviceIsHeld,
xuniq AS PaymentAdviceHasSingleAccount,
cast(vrsdg as farp_vrsdg preserving type) AS PaytAdvcDiffDeterminationRule,
sregl AS PaymentAdviceSelectionRule,
xbenr AS OriginalReferenceDocument,
xbtyp AS ReferenceDocumentType,
vgref AS BankReference,
bvdat AS BankPostingDate,
butim AS ValueDateTime,
spesk AS FeeAmountInTransactionCrcy,
vorgc AS PaymentTransaction,
cast(kursf as farp_kursf) AS ExchangeRate,
jpdat AS BillOfExchangeFailureDate,
chect AS Cheque,
valut AS ValueDate,
zbprn AS BusinessPartnerName,
fica_apbel AS CAPaymentDocument,
fica_vkont AS ContractAccount,
fica_avkey AS CAPaymentAdvice
FROM avik
LEFT OUTER JOIN I_UserContactCard AS _UserContactCard ON CreatedByUser = _UserContactCard.ContactCardID -- association [0..1]
LEFT OUTER JOIN I_CompanyCode AS _CompanyCode ON CompanyCode = _CompanyCode.CompanyCode -- association [1..1]
LEFT OUTER JOIN I_Currency AS _Currency ON PaymentCurrency = _Currency.Currency -- association [0..1]
LEFT OUTER JOIN I_ReasonCodeConversionVers AS _PaytAdvcDiffDeterminationRule ON PaytAdvcDiffDeterminationRule = _PaytAdvcDiffDeterminationRule.PaytAdvcDiffDeterminationRule -- association [1..1]
LEFT OUTER JOIN I_PaytAdviceSelRules AS _PaytAdviceSelRules ON PaymentAdviceSelectionRule = _PaytAdviceSelRules.PaymentAdviceSelectionRule -- association [1..1]
LEFT OUTER JOIN I_PaymentAdviceType AS _PaymentAdviceType ON PaymentAdviceType = _PaymentAdviceType.PaymentAdviceType -- association [1..1]
LEFT OUTER JOIN I_PaymentAdviceItem AS _PaymentAdviceItem ON CompanyCode = _PaymentAdviceItem.CompanyCode AND PaymentAdviceAccountType = _PaymentAdviceItem.PaymentAdviceAccountType AND PaymentAdviceAccount = _PaymentAdviceItem.PaymentAdviceAccount AND PaymentAdvice = _PaymentAdviceItem.PaymentAdvice -- association [1..*]
LEFT OUTER JOIN I_Customer AS _Customer ON PaymentAdviceAccount = _Customer.Customer -- association [0..1]
LEFT OUTER JOIN I_CustomerCompany AS _CustomerCompany ON PaymentAdviceAccount = _CustomerCompany.Customer AND CompanyCode = _CustomerCompany.CompanyCode -- association [1..1]
LEFT OUTER JOIN I_Supplier AS _Supplier ON PaymentAdviceAccount = _Supplier.Supplier -- association [0..1]
LEFT OUTER JOIN I_SupplierCompany AS _SupplierCompany ON PaymentAdviceAccount = _SupplierCompany.Supplier AND CompanyCode = _SupplierCompany.CompanyCode -- association [1..1]
LEFT OUTER JOIN I_BusinessPartner AS _BusinessPartner ON PaymentAdviceAccount = _BusinessPartner.BusinessPartner AND PaymentAdviceAccountType = 'G' -- association [0..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