Table of Contents
Get an overview of all the topics in this Guide.
The content is divided into the following sections:
- Getting Started: Topics to help get you started.
- API User Guide: A guide to using the Vertex e-Invoicing API.
- VRBL User Guide: A guide for using VRBL.
- VRBL Reference Guide: A reference for all the components of VRBL, such as Extensions.
Getting Started
Getting Started with Vertex e-Invoicing
| Topic | Description |
|---|---|
| API Authentication and Access | You use an access token to authenticate requests. Before you do, you must ensure that you have the correct user credentials to retrieve the token. |
| Supported Countries | Read about the supported countries and regions. |
| Glossary | Read about terms that are used frequently in this documentation. |
| Copyright Notice | Read this copyright notice. |
API User Guide
Using the Vertex e-Invoicing API
| Topic | Description |
|---|---|
| Document Files | Information about the Document file such as format and file size restrictions. |
| Error Handling | Information about error and status messages. |
| Send Document | The request that you use to send Documents to the service. |
| Key Parameters | These can be used to ensure a Document is only processed once. |
| Correlation IDs | This help identify Documents for bug fixing and so on. |
| Get Document Status | This request can be used to poll the processing status for a specified GUID. |
| API Reference Guide | Lists all the components of the API. |
API Reference Guide
| Topic | Description |
|---|---|
| Send Document | The request you use to send Documents to the service. |
| Key Parameters | To prevent submitting duplicate copies of the invoice, supply a key parameter. |
| Correlation IDs | Use Correlation IDs to help identify related Documents. |
| Get Document Status | The request you use to retrieve the status of the processing. |
| Document Status Fields | The messages sent back by the Get Document Status request. |
VRBL User Guide
Modelling Documents
| Topic | Description |
|---|---|
| VRBL Overview | An introduction to VRBL. |
| Routing Overview | An overview of routing relevant information. |
| Documents | Describes the various types of Documents. |
| Additional Documents | Describes how to model information about supporting documents and attachments. |
| Parties and Party Identification | Describes how to model parties such as Buyers, Suppliers, Tax Representatives and others. |
| Prices, Items and Amounts | Describes how to model prices, items, and amounts. |
| Tax | Describe how to model Tax Categories and Tax Schemes as well as other tax related information. |
| Payments | Decsribes how to model payments and things like prepaid payments, |
| Delivery Information | Descirbes how to model delivery information like Carrier information. |
VRBL Overview
| Topic | Description |
|---|---|
| VRBL Overview | Overview topic for this section. |
| Rules, Schematrons and Receivers | Get an overview of the components that help process Documents. |
| Extensions | Get an overview of Extensions. |
| Example Documents | Read the example Documents for each country. |
| Mandatory Elements | Read the elements that are mandatory in most countries. |
| Standard Values | Get an overview of standard values. |
| Attributes | Attributes are used to classify the values in elements. |
Routing Overview
| Topic | Description |
|---|---|
| Routing Overview | Overview for this section. |
| Sender ID | This helps to identify the sender. |
| Receiver ID | This helps to identify the Receiver. |
| Profile IDs | This helps to identify the Document. |
| Endpoint ID | This helps to identify the recipient |
| Customization ID | The Customization ID is used for routing. |
Documents
| Topic | Description |
|---|---|
| Documents | Overview topic for this section. |
| Invoice Types | You use the InvoiceTypeCode element to specify a value that represents the type of invoice. |
| Invoice Lines | You use the InvoiceLine element to specify details that apply to line items. |
| Credit Notes | You use the Invoice element to model credit notes. |
Additional Documents
| Topic | Description |
|---|---|
| Additional Documents | Overview topic for this section. |
| Additional Document References | You may want to model references like URLs to other documents. |
| Attachments | You can attach additional documents. |
| Order References | You may want to add a reference to an additional document. |
| Billing References | You can specify a reference to a billing related document. |
| Line Level Document Reference | You can reference an additional document on the line level. |
Tax
| Topic | Description |
|---|---|
| Tax | Overview topic for this section. |
| Tax Amounts | This topic describes how to model amounts of tax. |
| Tax Categories and Schemes | Tax Categories and Tax Schemes are used to model information about the tax being paid. |
| Tax Exchange Rates | If your Documents use foreign currency exchanges, you can capture this information. |
| Tax Exemptions | How to model exemptions. |
| Withholding Taxes | How to model withheld taxes. |
Parties and Party Identifications
| Topic | Description |
|---|---|
| Parties and Party Identification | Overview topic for this section. |
| Business Unit | You can add a reference to you Business Unit to your Documents. |
| Company Code | You may want to add your Company Code to Documents for accounting or other purposes. |
| Suppliers | Model Supplier information. |
| Buyers | Model Buyer information. |
| Company IDs | Model the IDs that represent companies. |
| Tax Representatives | Model Tax Representative information. |
| Carriers | Model information about Carriers. |
| Legal Entities and Representatives | Model information about legal entities and representatives. |
| Accounting Cost References | Model information about references to accounts. |
Prices, Items, and Amounts
| Topic | Description |
|---|---|
| Allowances | How to model Allowances. |
| Charges | How to model Charges. |
| Prices | How to model the prices of items. |
| Amounts | How to model amounts. |
| Items | How to model items. |
| Item Categorization | How to model item categorization. |
Currencies
| Topic | Description |
|---|---|
| Currencies | Read about the various ways you can specify the currency in your Documents. |
Payments
| Topic | Description |
|---|---|
| Payment Means | Model the method of payment. |
| Prepaid Payments | Model prepaid payments. |
| Legal Monetary Totals | Model the monetary totals that are submitted to the Tax Authority |
| Payers | Model information about the party making the payment. |
| Payees | Model information about the party who receives the payment. |
Delivery Information
| Topic | Description |
|---|---|
| Delivery Information | Delivery information about the delivery location and carrier can be modelled. |
Belgium
| Topic | Description |
|---|---|
| Belgium: Overview | Overview of information for this country. |
| Belgium: Receivers | The receivers used by this country. |
| Belgium: Example Documents | Example e-invoices and credit notes. |
| Belgium: Rules | The rules that govern the processing of the Documents for this country. |
Croatia
| Topic | Description |
|---|---|
| Croatia: Overview | Overview for this country. |
| Croatia: Receivers | The Receivers used by this country. |
| Croatia: Examples | Example Documents. |
| Croatia: Rules | The rules that govern the processing of the Documents for this country. |
Denmark
| Topic | Description |
|---|---|
| Denmark: Overview | Overview for this country. |
| Denmark: Receivers | The Receivers used by this country. |
| Denmark: Examples | Example Documents. |
| Denmark: Configurations | Topics describing country-specific configurations. |
| Denmark: Rules | The rules that govern the processing of the Documents for this country. |
Denmark Configurations
| Topic | Description |
|---|---|
| Denmark: Supplier Identification | Denmark requires that you specify an ID to identify sellers. |
| Denmark: Supplier's Legal Entity | If the Supplieris represented by a legal entity, you must specify it. |
| Denmark: Buyer Identification | You can specify a Buyer's ID. |
| Denmark: Allowances and Charges | You can specify Allowances and Charges at the Document or Line Level. |
| Denmark: Payment Means Code | You must specify the Payment Means Code. |
Estonia
| Topic | Description |
|---|---|
| Estonia: Overview | Overview for this country. |
| Estonia: Receivers | The Receivers used by this country. |
| Estonia: Examples | Example Documents. |
| Estonia: Rules | The rules that govern the processing of the Documents for this country. |
Finland
| Topic | Description |
|---|---|
| Finland: Overview | Overview information for this country. |
| Finland: Receivers | The Receivers used by this country. |
| Finland: Examples | Example Documents. |
| Finland: Rules | The rules that govern the processing of the Documents for this country. |
France
| Topic | Description |
|---|---|
| France: Overview | Overview information for this country. |
| France: Receivers | The Receiver used by this country. |
| France: Example | Example Documents. |
| France: Rules | The rules that govern the processing of the Documents for this country. |
Germany
| Topic | Description |
|---|---|
| Germany: Overview | Overview information for this country. |
| Germany: Receivers | The Receivers used by this country. |
| Germany: Example Documents | Example Documents. |
| Germany: Required Elements | A list of the elements that are required. |
| Germany: Extensions | Extensions used by this country. |
| Germany: Standard Values and Attributes | A list of the standard values for elements and attributes. |
| Germany: Element Hierarchies | Hierarchies of elements for this country. |
| Germany: Configuration Overview | The configurations that are specific to Germany. |
| Germany: Rules | The rules that govern the processing of the Documents for this country. |
Germany Configuration Overview
| Topic | Description |
|---|---|
| Germany: Configuration Overview | Overview of all topics. |
| Germany: Third Party Payments | You can specify information about third parties in German documents. |
| Germany: Invoice Type Codes | If a supplier is German, you must use one of the Invoice Type Codes listed here. |
| Germany: German Buyer Reference (Leitweg-ID) | You must specify the Leitweg-ID for German Buyers in B2G Documents, |
| Germany: Additional Documents | If you attach a document using the AdditionalDocumentReference element, you must specify an ID. |
| Germany: Supplier Electronic Address | You can specify an electronic address for a Supplier. |
| Germany: Supplier Postal Address | You must specify a Supplier's address in Germany. |
| Germany: Buyer Information | You must specify the Buyer's information for German buyers. |
| Germany: Delivery Information | For German Buyers, the delivery information must include a city name and valid German post code. |
| Germany: Payment Means Code | You must specify the Payment Means for German Documents. |
| Germany: Payment Card | If you specify one of the Payment Card codes (48, 54 or 55) as the Payment Means, you must specify the card information. |
| Germany: Credit Transfer | If you specify Credit Transfer as the Payment Means, you must specify the Payee's bank account. |
| Germany: Direct Debits | If you specify 59 for Direct Debit as the Payment Means, you must specify an ID for the Payment Mandate and Payer's bank account. |
| Germany: Sub-Invoice Lines | These lines are a group of recursive information elements that contains information about individual subordinate invoice line items. |
| Germany: Corrected Invoices | If you specify code 384 for a corrected invoice as the Invoice Type, you must specify an ID for the referenced document. |
| Germany: German Payees | If you specify code 58 for SEPA as the Payment Means and the Payee is a German account, you must specify a valid IBAN as the account's ID. |
| Germany: German Payers | If you specify code 59 for SEPA as the Payment Means and the Payer is a German account, you must specify a valid IBAN as the account's ID. |
Greece
| Topic | Description |
|---|---|
| Greece: Overview | Overview information for this country. |
| Greece: Receivers | Read about the Receiver used by this country. |
| Greece: Examples | Example Documents. |
| Greece: Extensions | The Extensions for this country. |
| Greece: Standard Values | The standard values for this country. |
| Greece: Configurations | Configuration topics. |
| Greece: Rules | The Rules used by this country. |
Greece Configuration Overview
| Topic | Description |
|---|---|
| Greece: Configuration Overview | Overview of the configuration topics for this country. |
| Greece: Invoice Number Patterns | Greece requires that the invoice numbers that you use follow a specific pattern. |
| Greece: Installation Serial Number | Greece requires that you include the installation serial number in your documents. |
| Greece: Invoice Sub Type Code | You must specify the type of invoice in Greece with the specified codes. |
| Greece: Invoice Series | In Greece, you must specify the Invoice Series value. |
| Greece: Additional Document Reference | You must specify the MARK number for Greek Suppliers. |
| Greece: Supplier Information | Greece requires specific information for Greek Suppliers |
| Greece: Buyer Information | You must include specific information for Greek Buyers. |
Italy
| Topic | Description |
|---|---|
| Italy: Overview | Overview information for this country. |
| Italy: Receivers | The Receiver used by this country. |
| Italy: Example Documents | Example Documents. |
| Italy: Extensions | Extensions used by this country. |
| Italy: Standard Values and Attributes | A list of the standard values for elements and attributes. |
| Italy: Element Hierarchy Examples | Example hierarchies for different types of Documents. |
| Italy: Configuration Overview | Read about the configuration for this country. |
| Italy: Rules | The Rules that govern the processing of the Documents for this country. |
Italy Configuration Overview
The following table summarizes the sections that Italian configuration topics are grouped into:
| Topic | Description |
|---|---|
| Italy: General Configuration | General configuration topics for routing details, invoice types and other topics. |
| Italy: Supplier Configurations | Configuration for Suppliers. |
| Italy: Buyer Configuration | Configurations for Buyers. |
| Italy: Additional Document Configuration | Configurations for attached and referenced Documents. |
| Italy: Social Security and Public Entity Configurations | Configurations for social security and public entities such as public investment funds. |
| Italy: Tax Configuration | Tax configuration topics. |
| Italy: Delivery and Transport Configurations | How to model information relating to delivery and the transport industry. |
| Italy: Payment and Price Configurations | How to model payment and pricing information, including allowances. |
General Configuration
| Topic | Description |
|---|---|
| Italy: Transmission Format Code | You need specify a dedicated code to represent the transaction format code. |
| Italy: Sdi Receiver Code | You must specify an SDI Receiver code. |
| Italy: Invoice Type Codes | You must use the codes specified by the Italian Tax Authority to identify the type of invoice. |
| Italy: Accounting Reference | You can specify a code or text to identify the supplier for administrative accounting purposes. |
| Italy: Data Type | If you specify N3.5(dichiarazioni d'intento) as the DataType, you must add the DataType element. |
Supplier Configuration
| Topic | Description |
|---|---|
| Italy: Supplier's Professional Register Details | You can specify supplier data such as a name or address. |
| Italy: Supplier's EORI Number | You can include the Supplier's EORI number. |
| Italy: Supplier's Fiscal Code | You can specify an Italian Supplier's Fiscal Code. |
| Italy: Supplier's Tax System Code | You must specify the Supplier's Tax System Code. |
| Italy: Province for Supplier's Business | You can specify the State or Province for Italian Supplier's business. |
| Italy: Supplier's Base Capital | You can specify the Supplier's registered base capital. |
| Italy: Supplier's Business Registration Number | You can specify an Italian Supplier's REA number. |
| Italy: Supplier Sole Proprietor | You can indicate whether an Italian Supplier is a sole proprietor. |
| Italy: Supplier's Liquidation Status | You can indicate a Supplier's liquidation status |
| Italy: Supplier Natural Person | If the Supplier is a person rather than a legal entity like a business, you must specify the person's details. |
| Italy: Supplier's Permanent Italian Establishment | You can specify the permanent address of a supplier who is not resident in Italy. |
| Italy: Supplier's Tax Representative's EORI Number | If the Supplier's Tax Representative has an EORI number, you can specify it. |
| Italy: Supplier's Tax Representative's Fiscal Code | If an Italian Supplier's Italian Tax Representative has a fiscal code, you can specify it. |
| Italy: Supplier's Tax Representative Natural Person | If an Italian Supplier's Tax Representative is a person, you must specify their first and last names. |
| Italy: Supplier's Province or State | You can specify an Italian supplier's province or state code. |
Buyer Configuration
| Topic | Description |
|---|---|
| Italy: Buyer's EORI Code | You can include the Buyer's EORI number. |
| Italy: Buyer's Fiscal Code | You must specify a Buyers Fiscal code if you do not specify a VAT number for them. |
| Italy: Buyer's Postal Address | You can specify a Buyer's state or province. |
| Italy: Buyer Natural Person | If the Buyer is a person rather than a legal entity like a business, you must specify the person's details. |
| Italy: Buyer's Permanent Italian Establishment | You can specify the permanent address of a buyer who is not resident in Italy. |
| Italy: Buyer's Tax Representative | If the Buyer has a Tax Representative and they must be present on the Document, you must specify the details. |
| Italy: NSO Reference for Buyers | If you want, you can specify an Nodo Smistamento Ordini (NSO) reference for a buyer. |
| Italy: Buyer Accounting Reference | You can specify a reference to the Buyer's financial accounts. |
Additional Document Configuration
| Topic | Description |
|---|---|
| Italy: Agreement Number | You can specify the framework agreement number. |
| Italy: Document Reference | If a Document references multiple other Documents, you can reference these on the invoice line level. |
| Italy: Attachments | You can use these elements to attach files. |
| Italy: Invoice Reference Number | When you send an adjustment e-invoice or a credit note, you must reference the previous invoice. |
| Italy: Tender or Lot Reference | You can specify a reference to a tender or lot. |
| Italy: Progress Stage Reference Number | You can specify a reference to the state or stage of progression to which this Document refers. |
Social Security Configuration
| Topic | Description |
|---|---|
| Italy: Article 73 Indicator | If Article 73 applies, you can indicate it. |
| Italy: Digital Stamps | If you want, you can indicate if a digital stamp is present. |
| Italy: Project Reference | You can specify a code to represent public investment funds. |
| Italy: Social Security Base Amount | If a social security allowance exists, you can specify the base amount. |
| Italy: Social Security Administration Reference | You can specify the Administration Reference for social security related allowances. |
| Italy: Social Security Withholding Indicator | You can specify if a social security allowance is subject to holding. |
| Italy: Social Security Tax Exemption Reason | If a tax exemption exists for a social security allowance, you must specify the reason for the exemption. |
| Italy: Social Security Tax Rate | If a social security allowance exists, you must specify the tax rate. |
| Italy: Social Security Contribution Amount | If a social security allowance includes a contribution, you must specify the amount of the contribution. |
| Italy: Social Security Contribution Percentage | If a social security allowance includes a percentage contribution to a fund, you must specify the percentage. |
| Italy: Social Security Charge Code | If a social security allowance charge applies, you must specify VRBL:IT:ZZZ as the reason code. |
| Italy: Social Security Organization Code | When social security charges are applied, you must specify the Social Secutiry Organization's code. |
Tax Configuration
| Topic | Description |
|---|---|
| Italy: Incidental Costs | If incidental costs related to the tax rate exist, you can specify them. |
| Italy: Withholding Tax Type Code | If tax is withheld, you must specify the details. |
| Italy: VAT Mechanism | You can specify the mechanism of payment for VAT. |
| Italy: Tax Exemption Reason | You can specify a free text description for a tax exemption. |
| Italy: Tax Exemption Reason Code | If no tax is applied, you must specify a reason. |
| Italy: Tax Exemption Reason Code (Invoice Lines) | You can specify Tax Exemption Reason Code on the invoice line level. |
Delivery Configuration
| Topic | Description |
|---|---|
| Italy: Vehicle Details | You can specify details about vehicle registration and the distance covered. |
| Italy: Transport Invoice Reference | You can specify a reference to an invoice related to transportation. |
| Italy: Delivery Location | You can specify the address that goods are sent to. |
| Italy: Carrier's EORI Code | You can specify the Carrier's EORI code. |
| Italy: Carrier's Driver's License ID | You can specify the Carrier's driving license. |
| Italy: Carrier's Fiscal Code | You can specify the Carrier's Fiscal code. |
Payment and Price Configuration
| Topic | Description |
|---|---|
| Italy: Payee Data | You can specify the details of the person who confirms a payment in Italy. |
| Italy: Payment Terms Code | You must specify the Payment Terms code. |
| Italy: Penalty Start Date | You can specify the start date for any penalties. |
| Italy: Early Payment End Date | You can specify the end date for early payment discounts. |
| Italy: Payment Terms Start Date | You can specify the start date of any payment terms. |
| Italy: Payment Reason Code | If a Document contains a payment, you must specify a reason code. |
| Italy: Rounding Amount | If you use Rounding, you must specify it. |
| Italy: Transfer or Service Type Code | If a a discount, bonus, rebate or an incidental expense applies, you must specify a transfer or service type code. |
| Italy: Unit Price Allowance | You can specify an allowance that is applied to the unit price on the line-item level. |
| Italy: Item Gross Price | You can specify an item's gross price on each invoice line. |
Japan
| Topic | Description |
|---|---|
| Japan: Overview | Overview information for this country. |
| Japan: Receiver | Read about the Receiver used by this country. |
| Japan: Example Documents | Example Documents. |
| Japan: Configurations | Read about the configurations used by this country. |
| Japan: Rules | Read about the Rules used by this country. |
Japan Configuration Overview
| Topic | Description |
|---|---|
| Japan: Configuration Overview | Overview of the configuration topics for this country. |
| Japan: Invoice Type Codes | In Japan, you must use one of the allowed invoice type codes to specify the type of document. |
| Japan: Tax Accounting Currency | If you specify a currency other than JPY in the DocumentCurrencyCode element, you must specify JPY in the TaxCurrencyCode element. |
| Japan: Invoice Document Reference | For Japanese correction invoices, you must specify the preceding invoice number and issue date. |
| Japan: Supplier's Tax Scheme | Depending on the type of invoice, you are required to include or exclude the S |
| Japan: Allowances and Charges (Document Level) | In Japan, you must include tax details that relate to allowances and charges. |
| Japan: Tax Amounts | Japan has certain requirements for how tax amounts are modelled. |
| Japan: Tax Category | In Japan, you must include certain Tax Category information. |
| Japan: Invoiced Quantity for Returns | In Japan, returns must have a negative value for the invoice quantity. |
| Japan: Invoice Line Net Amount for Returns | For Japanese returns, you must specify a negative amount for the InvoiceLineExtension element. |
| Japan: Line Level Tax Information | In Japan, you must specify certain tax information for each InvoiceLine element. |
| Japan: Item Names for Summary Invoices | For summary invoices, you may need to include the delivery note number. |
| Japan: Line Level Document Reference | For summary invoices, you can specify the delivery note number. |
Lithuania
| Topic | Description |
|---|---|
| Lithuania: Overview | Overview information for this country. |
| Lithuania: Receiver | The Receiver used by this country. |
| Lithuania: Examples | A list of the elements that are required. |
| Lithuania: Rules | The rules that govern the processing of the Documents for this country. |
Malaysia
| Topic | Description |
|---|---|
| Malaysia: Overview | Overview information for this country. |
| Malaysia: Receiver | The Receiver used for this country. |
| Malaysia: Example Files | Example Documents. |
| Malaysia: Required Elements | A list of the elements that are required. |
| Malaysia: Restrictions | A list of elements that are restricted. For example, character limits. |
| Malaysia: Standard Values and Attributes | A list of the standard values for elements and attributes. |
| Malaysia: Element Hierarchy | Example hierarchies of elements for this country. |
| Malaysia: Configuration Overview | The country specific configurations for Malaysia. |
| Malaysia: Rules | The rules that govern the processing of the Documents for this country. |
Malaysia: Configuration Overview
The following table lists the sections that contain the Malaysian configuration topics:
| Topic | Description |
|---|---|
| Malaysia: Configuration Overview | Overview of the different configuration topics for Malaysia. |
| Malaysia: General Configuration | Topics that are relevant for general configuration of things like the Invoice Type Codes, TTN IDs, Incoterms for deliveries and so on |
| Malaysia: Supplier Configuration | Supplier configurations. |
| Malaysia: Additional Document Configuration | Information about modelling additional documents for Malaysia. |
| Malaysia: Tax Configuration | Information about modelling modelling tax for Malaysia. |
Malaysia: General Configuration
| Topic | Description |
|---|---|
| Malaysia: General Configuration | Topics covering general configuration for Malaysia. |
| Malaysia: Original e-Invoice Reference | If your e-invoice or credit note references an original e-invoice, Malaysia requires that you reference the original invoice in any credit, debit or refund note. |
| Malaysia: Invoice Type Code | You must provide an Invoice Type code in Malaysia. |
| Malaysia: States | Malaysia requires that you include the code for the State for addresses within the country. |
| Malaysia: Product Categorization | Malaysia has specific requirement for how you categorize products. |
| Malaysia: Business Registration Number (BRN) | You must use a BRN for any Malaysian business specified in the e-invoice or credit note. |
| Malaysia: Incoterm | Incoterms are required for applicable Malaysian Documents. |
| Malaysia: Payment Means | If you want, you can specify the means of payment, such as a credit card. |
Malaysia: Supplier Configuration
| Topic | Description |
|---|---|
| Malaysia: Supplier Configuration | Overview of Supplier related configurations. |
| Malaysia: Supplier's Billing Reference Number | You may want to specify a Supplier's internal reference number. |
| Malaysia: Supplier's CertEX Authorization Number | An Authorization Number for Certified Exporter (CertEX) indicates that the supplier is an certified exporter in Malaysia. |
| Malaysia: Supplier's Standard Industrial Classification Code (MSIC) | You musty specify an industrial classification code and descriptions for goods on Malaysian invoices. |
Malaysia: Additional Document Configuration
| Topic | Description |
|---|---|
| Malaysia: Additional Document Configuration | Overview of configurations for additional documents. |
| Malaysia: Customs Form Reference Number | You are required to reference any Custom's Forms in applicable Documents. |
| Malaysia: K2 Forms | If applicable, you are required to specify the Customs Form No.2 (K2) number. |
| Malaysia: Free Trade Agreement (FTA) | If applicable, you must specify any Free Trade Agreement (FTA) information. |
Malaysia: Tax Configuration
| Topic | Description |
|---|---|
| Malaysia: Tax Configuration | Overview of tax related configurations. |
| Malaysia: Tourism Tax Registration Number (TTRN) | The Tourism Tax Registration Number (TTRN) identifies a part as a participant in the Tourism Tax (TT) scheme in Malaysia. |
| Malaysia: Sales and Service Tax (SST) Registration Number | The SST number identifies a participant in the Malaysian Sales and Service Tax (SST) scheme. |
| Malaysia: Tax Identification Number (TIN) | You must include a TIN in your invoices and credit notes. |
| Malaysia: Tax Categories | You must specify Malaysian Tax Category information. |
| Malaysia: Tax for Foreign Currency Transactions | If the DocumentCurrencyCode is different from the TaxCurrencyCode, you need to specify the exchange rate. |
| Malaysia: Tax Totals (Document) | Read about how to model tax totals at the Document level |
| Malaysia: Tax Totals (Line) | You must add the Tax Amount and the Taxable amount for each line in your Malaysian e-invoices and credit notes. |
Netherlands
| Topic | Description |
|---|---|
| Netherlands: Overview | Overview information for this country. |
| Netherlands: Receiver | The Receiver used by this country. |
| Netherlands: Examples | Example Documents. |
| Netherlands: Standard Values | Standard values used in this country. |
| Netherlands: Configuration Overview | Country specific configurations. |
| Netherlands: Rules | The Rules that govern the processing of the Documents for this country. |
Netherlands: Configuration Overview
| Topic | Description |
|---|---|
| Netherlands: Configuration Overview | Overview of the configuration topics for this country. |
| Netherlands: Invoice Reference | You must reference the preceding invoice in the subsequent credit note. |
| Netherlands: Order Line References | Read about how to reference other lines in Dutch Documents. |
| Netherlands: Supplier's Postal Address | You must specify the address of Netherlands-based suppliers. |
| Netherlands: Supplier's Legal Entity | You must specify the Supplier's legal entity for Dutch Documents. |
| Netherlands: Supplier's Tax Representative Postal Address | You must specify the Supplier's Tax Representative's postal address. |
| Netherlands: Buyer Postal Address | You must specify the address for Netherlands-based Buyers. |
| Netherlands: Buyer's Legal Entity | You must specify the legal entity for Netherlands-based buyers. |
| Netherlands: Payment Means | You must specify a Payment Means for payments to Netherlands-based suppliers. |
Portugal
| Topic | Description |
|---|---|
| Portugal: Overview | Overview information for this country. |
| Portugal: Receiver | Read about the Receiver used by this country. |
| Portugal: Example Documents | Example Documents. |
| Portugal: Extensions | The Extensions for this country. |
| Portugal: Configurations | Configuration topics. |
| Portugal: Rules | The Rules used by this country. |
Portugal: Configuration Overview
| Topic | Description |
|---|---|
| Portugal: Billing Software | In Portugal, you must identify the billing software that issued the document. |
| Portugal: Invoice Type Code | Portugal requires that you use specific values for the Invoice Type Code. |
| Portugal: Buyer Accounting Reference | You must specify a reference to the buyers accounts for Portuguese B2G Documents. |
| Portugal: Additional Document Reference | For Portuguese B2G documents, you must attach a QR code as an additional document reference. |
| Portugal: Project Reference | For Portuguese B2G documents, you are required to provide a reference to the batch that includes the various documents. |
| Portugal: Payment Means Type Code | You must specify the type of payment using the Payment Means Type Code. |
| Portugal: ATM Payment Entity | If the payment method is an ATM payment, you must included the ATM entity's number for B2G documents. |
| Portugal: Remittance Information | You must add a reference to the payment if the payment method is ATM or DUC, for Portuguese B2G documents. |
| Portugal: Tax Exchange Rate | Portuguese B2G documents require you include the tax exchange rate for foreign transactions. |
| Portugal: Tax Category (Tax Exemptions) | In Portugal, you need to add reason code and description for tax exemptions. |
| Portugal: Withholding Tax Total | In some cases, you may want to model withheld tax. |
| Portugal: Item Commodity Classification | The Portuguese Public Administration requires that you classify items. |
| Portugal: Document Reference ID | Portugal has specific rules for references to the Commitment Document (Número do compromisso). |
| Portugal: Buyer Accounting Reference (Invoice Line) | For Portuguese B2G documents, you must include the Commitment Number (Número do compromisso). |
| Portugal: Invoice Line Tax Information | You can include tax information at line level. |
Romania
| Topic | Description |
|---|---|
| Romania: Overview | Overview information for this country. |
| Romania: Receivers | The Receiver used by this country. |
| Romania: Example Files | Example Documents. |
| Romania: Required Elements | A list of the elements that are required. |
| Romania: Character Restrictions | A list of elements that are restricted. For example, character limits. |
| Romania: Standard Values and Attributes | A list of the standard values for elements and attributes. |
| Romania: Element Hierarchy | Example hierarchies of elements for this country. |
| Romania: Configuration Topics | The country specific configurations. |
| Romania: Rules | The rules that govern the processing of the Documents for this country. |
Romania: Configuration Overview
| Topic | Description |
|---|---|
| Romania: Invoice Type Codes | You must specify the Invoice Type using the Invoice Types codes that are required by the Romanian Tax Authority. |
| Romania: States (Provinces) | You must provide the State code for Romanian parties' addresses in Romanian Documents. |
| Romania: City Sector | Romanian e-invoices and credit notes that contain Bucharest addresses, need to specify the city sector. |
Saudi Arabia
| Topic | Restriction |
|---|---|
| Saudi Arabia: Overview | Overview information for this country. |
| Saudi Arabia: Receiver | Read about the Receiver used by this country. |
| Saudi Arabia: Example Documents | Example Documents. |
| Saudi Arabia: Configuration Overview | Configurations for this country. |
| Saudi Arabia: Extensions | Extensions for this country. |
| Saudi Arabia: Rules | The Rules used by this country. |
Saudi Arabia: Configuration Overview
| Topic | Description |
|---|---|
| Saudi Arabia: UUIDs | You must include UUID information for Saudi Arabian documents. |
| Saudi Arabia: Invoice Type Code | You must use specific values for the InvoiceTypeCode in Saudi Arabia. |
| Saudi Arabia: Invoice Subtype Code | You must specify an invoice subtype code for Saudi Arabia. |
| Saudi Arabia: Supplier's Invoice Document Reference | For Saudi Arabian Credit and Debit Notes, the Document must contain an invoice reference number and a reason in a textual description. |
| Saudi Arabia: Additional Supplier Identification | You can specify additional Suppliers in Saudi Arabian Documents. |
| Saudi Arabia: Party's Legal Entity | You must specify a party's legal entity in Saudi Arabia. |
| Saudi Arabia: Supplier's Postal Address | Saudi Arabia has specific requirements for Supplier's postal addresses. |
| Saudi Arabia: Additional Buyers Identification | You can specify additional Buyers in Saudi Arabian documents. |
| Saudi Arabia: Buyer's Postal Address | Saudi Arabia has specific requirements for Buyer's postal addresses. |
| Saudi Arabia: Latest Delivery Date | In Saudi Arabia, you can specify dates for continuous supply. |
| Saudi Arabia: Payment Means Code | You must specify the means of payment. |
| Saudi Arabia: Tax Totals | Saudi Arabia has specific requirements for how tax totals are modelled. |
| Saudi Arabia: Tax Categories | Saudi Arabian has specific requirements for how tax information is modelled. |
| Saudi Arabia: Prepayment Amounts | For prepaid amounts in Saudi Arabia, you must model this in a specific way. |
Serbia
| Topic | Description |
|---|---|
| Serbia: Overview | Overview information for this country. |
| Serbia: Receiver | Read about the Receiver used for this country. |
| Serbia: Example Documents | Example Documents. |
| Serbia: Extensions | Extensions for this country. |
| Serbia: Configuration Overview | Configuration topics. |
| Serbia: Rules | Rules used by this country. |
Serbia: Configuration Overview
| Topic | Description |
|---|---|
| Serbia: Invoice Type Code | You must use the values specified here for invoice types in Serbia. |
| Serbia: Payment Due Date | For advanced payments in Serbia, you must specify the payment date. |
| Serbia: Invoicing Period | You must specify a description for the invoicing period. |
| Serbia: Buyer Reference | You must add a specific buyer reference for Documents that reference a public procurement, that is not carried out by the buyer. |
| Serbia: Invoice Document Reference | For final invoices and credit notes in Serbia, you must specify some details from the preceeding invoice. |
| Serbia: Tax Category | You must use specific values for the Tax Category and Tax Scheme IDs. |
| Serbia: Tax Information (Line Level) | You must include specific tax information at the line level. |
| Serbia: Advanced Payment Information | You must include specific information about any advanced payments in final invoices. |
| Serbia: Reduced Tax Totals | You must include specific information to model reduced tax totals. |
| Serbia: Legal Monetary Totals (for Reduced Totals) | You must include specific information about reduced totals in the Legal Monetary Totals for the final invoice. |
Slovakia
| Topic | Description |
|---|---|
| Slovakia: Overview | Overview information for this country. |
| Slovakia: Receivers | The Receiver used by this country. |
| Slovakia: Examples | Example Documents. |
| Slovakia: Rules | The rules that govern the processing of the Documents for this country. |
Slovenia
| Topic | Description |
|---|---|
| Slovenia: Overview | Overview information for this country. |
| Slovenia: Receiver | The Receiver used by this country. |
| Slovenia: Examples | Example Documents. |
| Slovenia: Rules | The Rules that govern the processing of the Documents for this country. |
Spain
| Topic | Description |
|---|---|
| Spain: Overview | Overview information for this country. |
| Spain: Receiver | The Receiver used by this country. |
| Spain: Example Documents | Example e-invoices and credit notes. |
| Spain: Rules | The rules that govern the processing of the Documents for this country. |
Sweden
| Topic | Description |
|---|---|
| Sweden: Overview | Overview information for this country. |
| Sweden: Receivers | The Receiver used by this country. |
| Sweden: Examples | Example e-invoices and credit notes. |
| Sweden: Configuration Overview | The country specific configurations. |
| Sweden: Rules | The rules that govern the processing of the Documents for this country. |
Sweden: Configuration Overview
| Topic | Description |
|---|---|
| Sweden: Configuration Overview | Overview of the configuration topics for this country. |
| Sweden: Supplier's Company IDs | For Swedish Suppliers. you can specify their Swedish VAT ID. |
| Sweden: Supplier's Tax Schemes | For Swedish Suppliers, you must specify specific values for their Tax Scheme ID and Company ID. |
| Sweden: Supplier's Legal Entity | The Supplier's legal entity identifies them. |
| Sweden: Allowances and Charges | In Sweden, you must specify the percentage tax rate for allowances and charges. |
| Sweden: Tax Categories (Document Level) | You must specify the tax rate percentage for Swedish Tax Categories at the Document level. |
| Sweden: Tax Categories (Line Level) | You must specify the tax rate percentage for Swedish Tax Categories at the line level. |
| Sweden: Monetary Transfer System for Credit Transfers | If you specify Credit Transfer as the Payment Means, you must specify the system used for the transfer. |
UK
| Topic | Description |
|---|---|
| UK: Overview | OVerview information for this country. |
| UK: Receiver | The Receiver used by this country. |
| UK: Examples | Example Documents. |
| UK: Rules | The rules that govern the processing of the Documents for this country. |
VRBL Reference Guide
VRBL Reference Guide
| Topic | Description |
|---|---|
| VRBL Reference Guide | Overview of the topics in the VRBL Reference Guide. |
| Receivers | A list of the Receivers used by each supported country. |
| Attributes | Attributes allow you to attribute a value to a key block. For example, you can use them to specify a currency for a payment key block. |
| Example Documents | A list of examples for each country. |
| Country Specific Configurations | A list of configurations specific to each country. |
| Element Hierarchy Examples | A list of examples showing the elements in hierarchical order.. |
| Rules | A list of the Rules. |
| VRBL Elements Reference Guide | A list of all the core VRBL elements. |
| VRBL Extensions Reference Guide | A list of the Extensions of VRBL. |
VRBL Elements Reference Guide
| Topic | Description |
|---|---|
| AccountingCost | The buyer's accounting code, applied to the Invoice as a whole, expressed as text. |
| AccountingCustomerParty | Use this element to model the a buyer's details. |
| AccountingSupplierParty | Use this element to model the supplier's information in an invoice or credit note. |
| AdditionalDocumentReference | Use this element to model references to additional documents. |
| AllowanceCharge | Use the AllowanceCharge element to model allowances and charges. |
| BillingReference | Use this element to model billing reference information. |
| BuyerReference | A reference provided by the buyer used for internal routing of the document. |
| CustomizationID | Identifies a user-defined customization of UBL for a specific use. |
| Delivery | Use the Delivery element to model delivery information. |
| DeliveryTerms | A set of delivery terms associated with this document. |
| DocumentCurrencyCode | A code signifying the default currency for this document. |
| ID | An identifier for this document, assigned by the sender. |
| Invoice | The Invoice object is the highest level object in a Document. |
| InvoiceLine | Use the InvoiceLine element to model a line in an invoice. |
| InvoicePeriod | Use the InvoicePeriod element to model the time during which the invoice remains valid. |
| InvoiceTypeCode | A code signifying the type of the Document. |
| IssueDate | The date, assigned by the sender, on which this document was issued. |
| IssueTime | The time, assigned by the sender, at which this document was issued. |
| Item | Items are the good or service that is sold on an invoice line or specified in a credit note. |
| ItemPriceExtension | Use this to model price extensions for an item. |
| LegalMonetaryTotal | Use this element to specify the legal monetary total. |
| LineCountNumeric | The number of lines in the document. |
| Note | Free-form text pertinent to this document, conveying information that is not contained explicitly in other structures. |
| OrderReference | Use this element to model order reference information. |
| OriginatorDocumentReference | A reference to an originator document associated with this document. |
| Party | The Party element models a party's details. |
| PayeeParty | Use the PayeeParty element to model the payee's information. |
| PaymentMeans | Use this element to model the means of payment. |
| PaymentTerms | Use the PaymentTerms element to model notes about the payment. |
| PrepaidPayments | Use this element to model prepaid payments. |
| Price | Use the Price element to model the price of an item. |
| ProjectReference | Information about a project. |
| ProfileID | Identifies a user-defined profile of the customization of UBL being used. |
| Shipment | Use this element to model shipping details. |
| StatementDocumentReference | A reference to a Statement associated with this document. |
| SellerSupplierParty | The seller. |
| TaxCategory | Use this element to specify Tax Category information. |
| TaxCurrencyCode | A code signifying the currency used for tax amounts in the Invoice. |
| TaxExchangeRate | The exchange rate between the document currency and the tax currency. |
| TaxPointDate | The date of the Invoice, used to indicate the point at which tax becomes applicable. |
| TaxRepresentativeParty | The tax representative. |
| TaxScheme | Use this element to model Tax Scheme information. |
| TaxSubtotal | Use the Tax Subtotal object to model tax subtotals. |
| TaxTotal | Use the Tax Total element to model the total amount of tax. |
| UBLExtensions | A container for extensions foreign to the document. |
| UBLVersionID | Identifies the earliest version of the UBL 2 schema for this document type that defines all of the elements that might be encountered in the current instance. |
| WithholdingTaxTotal | The total withholding tax. |
VRBL Extensions Reference Guide
Updated 22 days ago