I_PaymentAdvice

DDL: I_PAYMENTADVICE SQL: IPAYTADVC Type: view BASIC Package: ODATA_PAYMENTADVICES

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

CategoryCDS Views for Receivables Management
Purpose
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

View on SAP Help Portal →

SAP API Hub

CategoryBasic
StateC1
Line of BusinessCross Applications
Application ComponentCA-GTF-FXU-FI-AR
CapabilitiesAssociation 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
PackageCross 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

Data Sources (1)

SourceAliasJoin Type
avik avik from

Associations (12)

CardinalityTargetAliasCondition
[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)

NameValueLevelField
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)

ServiceBindingVersionContractRelease
ASQL_F2626 ASQL_F2626 C2 NOT_RELEASED

Fields (57)

KeyFieldSource TableSource FieldDescription
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]
;