Extensions

Read about how to use the service's extensions.

Extensions are elements that were added to VRBL to extend UBL functionality.

For example, some are used in Routing. In this case, you must specify an ID for both the sender and receiver. See Routing Overview.

Countries also have extensions as described in the Country-Specific Extensions section of this topic.

Global extensions

The following extensions are used in all or most countries:

Country-specific extensions

The following are the country-specific Extensions:

Extensions overview

The following table summarizes the topics in the VRBL Extensions Reference Guide section:

Extension Name (Reference Topic)Country-Specific Topic(s)Description
AdditionalData (Extn)Italy: Additional Data and Italy: Tax Exemption Reason Code (Invoice Lines)Use this Extension to specify additional data for specific use cases for Italy.
AdditionalProperty (Extn)Poland B2B: Additional PropertyUsed to add additional information in Polish B2B documents.
AccountingSupplierPartyExtension (Extn)Italy: Supplier's Professional Register DetailsUsed in Italy to model the Supplier's professional registration details.
AllowanceChargeExtension (Extn)Italy: Social Security Administration Reference and Italy: Withholding Tax Type Code and Italy: Social Security Organization CodeUse this extension to model specific allowance charges for Italy.
Article73Indicator (Extn)Italy: Article 73 IndicatorUsed in Italian documents to specify whether Article 73 applies or not.
BaseCapital (Extn)Italy: Supplier's Base CapitalUsed in Italy to specify the supplier's base capital.
BelowMarketValueSupplyIndicator (Extn)Poland B2B: Below Market Value Supply IndicatorUsed to indicate if a transaction is being supplied below market value.
BillingSoftware (Extn)Portugal: Billing SoftwareUsed in Portugal to specify the software that is used for billing and is referenced in Portuguese documents.
BusinessRegistrationProvinceCode (Extn)Italy: Province for Supplier's BusinessUsed to specify the Italian province where the supplier's business is registered.
CashAccountingIndicator (Extn)Poland B2B: Supplier Cash Accounting IndicatorUsed to specify if a supplier is using cash accounting in Poland.
CorrectionReason (Extn)Taiwan: Correction ReasonUse this Extension to specify a reason for a correction in Taiwanese Documents.
Description (Extn)Portugal: Withholding Tax TotalUsed to provide a description for withheld tax in Portugal.
DigitalStampAmount (Extn)Italy: Digital StampsUsed in Italy to specify the amount for digital stamps.
DigitalStampIndicator (Extn)Italy: Digital StampsUsed in Italy to indicate whether a digital stamp applies.
DocumentReferenceExtension (Extn)Portugal: Document Reference IDUsed to reference the Commitment Document (Número do compromisso) in Portuguese documents.
IncidentalCosts (Extn)Italy: Incidental CostsUsed to specify incidental costs in Italy.
InstallationSerialNumber (Extn)Greece: Installation Serial NumberUsed to specify the Installation Serial Number in Greek documents.
InvoiceDocumentReferenceExtension (Extn)Poland B2B: Preceding Invoice ReferenceUse this extension to document the correction method and reason for Poland.
InvoicedPrepaymentAmount (Extn)Serbia: Advanced Payment InformationUse to specify advanced payments in Serbian documents.
InvoiceSeries (Extn)Greece: Invoice SeriesUse to specify the Invoice Series in Greek documents.
InvoiceSubtypeCode (Extn)Greece: Invoice Subtype CodeUsed to specify Invoice Sub-Type Codes for Greece.
LegalMonetaryTotal (Extn)Serbia: Legal Monetary Totals (for Reduced Totals)Used to specify legal monetary totals for reduced tax totals in Serbia.
LegalMonetaryTotalInTaxCurrency (Extn)Spain B2G: Document Totals in Tax CurrencyA group of elements providing the monetary totals for the invoice in tax currency.
NominalInvoiceIndicator (Extn)Saudi Arabia: Nominal Invoice IndicatorUsed to indicate if an invoice is a nominal invoice.
PayeePartyExtension (Extn)Italy: Payee DataUsed to specify Payee data in Italy.
PaymentMeansExtension (Extn)Portugal: ATM Payment EntityUsed to specify information about ATM payments in Portugal.
PaymentReasonCode (Extn)Italy: Payment Reason CodeUsed to specify a payment reason code in Italy.
PaymentTermsCode (Extn)Italy: Payment Terms CodeUse to specify the Payment Terms code in Italy.
PaymentTermsStartDate (Extn)Italy: Payment Terms Start DateUsed to specify the start date for payment terms in Italy.
PriceAmountBeforeAllowanceCharge (Extn)Poland B2B: Item Gross Price and Italy: Item Gross PriceUsed to specify gross item information in Italy.
ProfessionalRegister (Extn)Italy: Supplier's Professional Register DetailsUsed to specify a supplier's professional details in Italy.
ReducedTotals (Extn)Serbia: Reduced Tax TotalsUsed to specify reduced totals in Serbian documents.
RoundingAmount (Extn)Italy: Rounding AmountUsed in Italy to specify rounding amounts.
RoutingDetails (Extn)VRBL: Sender ID and VRBL: Receiver IDs and VRBL: Receiver DetailsUsed in all countries to specify Sender and Receiver IDs.
SdIReceiverCode (Extn)Italy: SDI Receiver CodeUsed in Italy to specify the SdI Receiver code.
SimplifiedInvoiceIndicator (Extn)Saudi Arabia: Simplified Invoice IndicatorUsed to indicate if an invoice is a simplified invoice.
SummaryInvoiceIndicator (Extn)Saudi Arabia: Summary Invoice IndicatorUsed to indicate if an invoice is a summary invoice.
ThirdPartyIndicator (Extn)Saudi Arabia: Third Party Invoice IndicatorUsed to indicate if a Document was issued by a third party.
ThirdPartyPayment (Extn)Germany B2G: Third-Party PaymentsUse this extension to model third-party payments in Germany.
TaxExemptionIndicator (Extn)Poland B2B: Supplier Tax Exemption IndicatorUse this extension to indicate if a Polish transaction is exempt from tax.
TransferOrServiceTypeCode (Extn)Italy: Transfer or Service Type CodeUse to specify the Transfer or Service Type Code that is used in Italian documents.
TransmissionFormatCode (Extn)Italy: Transmission Format CodeUse this to model the transmission format code in Italy.
TypeCode (Extn)Italy: Withholding Tax Type CodeUsed to specify the Withholding Tax Type code in Italy.
VatMechanism (Extn)Italy: VAT Mechanism and Poland B2B: VAT MechanismUsed in Italy and Poland to model VAT mechanism information.
VehicleDetails (Extn)Italy: Vehicle DetailsUse in Italy to specify details about vehicles.
WithholdingIndicator (Extn)Italy: Social Security Withholding IndicatorUsed to model information about withholding tax in Italy.