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 Developers Guide: A guide for using VRBL.
- VRBL Reference Guide: A reference for all the components of VRBL, such as Elements and 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. |
| Release Notes | Read about releases. |
API User Guide
Using the Vertex e-Invoicing API
| Topic | Description |
|---|---|
| Using the Vertex e-Invoicing API | The overview for this section. |
| Error Handling | Information about error and status messages. |
| API Reference Guide | Lists all the components of the API. |
| Vertex e-Invoicing Webhook | This section explains how you can use the Webhook. |
API Reference Guide
| Topic | Description |
|---|---|
| Send Document | The request you use to send Documents to the service. |
| Idempotency Key | To prevent submitting duplicate copies of the invoice, supply a key parameter. |
| Get Document Status | The request you use to retrieve the status of the processing. |
| Document Workflow Status | The messages sent back by the Get Document Status request. |
| Get Documents from the Invoice Queue | Use this request to retrieve documents to be integrated into your processing system. |
| Get Additional Document Data | Use this request to retrieve additional raw data related to the invoice. |
| Mark Documents as Integrated | Use this request to mark documents as integrated. |
VRBL Developers Guide
| Topic | Description |
|---|---|
| VRBL Developer's Guide Overview | This section describes how to model your e-invoices and credit notes. |
| VRBL Basic Concepts | Read this introduction to Vertex Universal Standard (VRBL) and some basic concepts. |
| VRBL: Modeling Overview | This section contains topics that explain each element of an example VRBL Document. |
| PEPPOL: Modeling Overview | Get an overview of the basics of PEPPOL. |
| EN-16931: Modeling Overview | Get an overview of EN-16931's requirements. |
VRBL Basic Concepts
| Topic | Description |
|---|---|
| VRBL: Basic Concepts | Overview topic for this section. |
| VRBL Formats and Compatibility | Read about the formats that VRBL supports. |
| VRBL Processing | Read about how the service processes VRBL. |
| Document- and Line-Level Elements | Elements can be defined at the Document or Line level or both. |
| Rules, Schematrons and Receivers | Get an overview of the components that help process Documents. |
| Extensions | Get an overview of Extensions. |
| Generally Required Elements | Read the elements that are generally required in most countries. |
| Standard Values | Get an overview of standard values. |
| Attributes | Attributes are used to classify the values in elements. |
| Example Documents | Read the example Documents for each country. |
Routing Overview
| Topic | Description |
|---|---|
| VRBL: Routing Overview | Overview for this section. Routing describes the process of delivering a Document to the intended destination, based on a set of variables. |
| VRBL: Recipients | Read about how to configure the parties who receive Documents. |
| VRBL: Networks | You can use different networks to send Documents to recipients |
| VRBL: Receiver IDs | Use the Receiver ID to specify the system that receives the Documents. |
| VRBL: Receiver Details | In certain use cases, you need to add some details about the recipient. |
| VRBL: Endpoint IDs | Endpoint IDs are used to identify e-invoicing systems such as buyers. |
| VRBL: Sender ID | You must specify the Sender ID. |
| VRBL: Specification IDs | You must include a Specification ID. |
| VRBL: Business Process Types | The Business Process Type helps the service process the Document. |
Documents
| Topic | Description |
|---|---|
| Document-Level Elements | Read a list of elements that can be specified at the Document-level. |
| Line-Level Elements | Read a list of elements that can be specified at the Line-level. |
Additional Documents
| Topic | Description |
|---|---|
| Additional Document References Overview | Overview topic for this section. |
| Additional Document Reference | You may want to model references like URLs to other documents. |
| Sales and Order References | You may want to add a reference to an additional document, such as a sales or order refence. |
| Preceding Document References | You can specify a reference to a billing related document. |
| Dispatch Advice References | You can reference a dispatch advice in your Document. |
| Receipt Advice References | You can reference a receipt advice in your Documents. |
| Tender or Lot References | You can model a reference to a lot or tender. |
| Contract References | You can add a reference to a purchasing contract in your Documents. |
| Project References | You can add a reference to a project to your Document. |
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. |
| Tax Point Dates | You can add Tax Point date to your Documents. |
Parties and Party Identifications
| Topic | Description |
|---|---|
| VRBL: Parties and Party Identification | Overview topic for this section. |
| VRBL: Suppliers | You can model information about suppliers. |
| VRBL: Buyers | Read about how to model Buyers. |
| VRBL: Payees | Payees are the parties who receive payments. |
| VRBL: Supplier's Tax Representatives | You can model Tax Representative information. |
| VRBL: Legal Entities and Representatives | Legal entities and representatives can be modelled for parties. |
| VRBL: Payers | You can model payer's bank account information. |
| VRBL: Business Unit | You can add a reference to your Business Unit to your Documents. |
| VRBL: Company Code | You may want to add your Company Code to Documents for accounting or other purposes. |
| VRBL: Company IDs | Model the IDs that represent companies. |
Prices, Items, and Amounts
| Topic | Description |
|---|---|
| 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 | Payment means are used to pay for the goods or services specified in the invoices or in refunds specified in credit notes. |
| Payment Terms | You can model information about the payment terms. |
| Prepaid Payments | Prepaid payments are usually made before the goods are purchased. |
| Charges | A Charge increases the total of the Document. |
| Allowances | Allowances are reductions from the total amount, such as a discount. |
Delivery Information
| Topic | Description |
|---|---|
| Delivery Information | Delivery information about the delivery location and carrier can be modelled. |
Belgium
| Topic | Description |
|---|---|
| Belgium PEP: Overview | Overview of information for this country. |
| Belgium PEP: Receiver | The receivers used by this country. |
| Belgium PEP: Example Documents | Example e-invoices and credit notes. |
| Belgium PEP: Rules | The rules that govern the processing of the Documents for this country. |
Croatia
| Topic | Description |
|---|---|
| Croatia PEP: Overview | Overview for this country. |
| Croatia PEP: Receiver | The Receivers used by this country. |
| Croatia PEP: Example Documents | Example Documents. |
| Croatia PEP: Rules | The rules that govern the processing of the Documents for this country. |
Denmark
| Topic | Description |
|---|---|
| Denmark PEP: Overview | Overview for this country. |
| Denmark PEP: Receiver | The Receivers used by this country. |
| Denmark PEP: Example Documents | Example Documents. |
| Denmark PEP: Configuration Overview | Topics describing country-specific configurations. |
| Denmark PEP: 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 Supplier is 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 PEP: Overview | Overview for this country. |
| Estonia PEP: Receiver | The Receivers used by this country. |
| Estonia PEP: Example Documents | Example Documents. |
| Estonia PEP: Rules | The rules that govern the processing of the Documents for this country. |
Finland
| Topic | Description |
|---|---|
| Finland PEP: Overview | Overview information for this country. |
| Finland PEP: Receiver | The Receivers used by this country. |
| Finland PEP: Example Documents | Example Documents. |
| Finland PEP: 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: Standard Values | Read about the standard values used by France. |
| France: Example Documents | Example Documents. |
| France: Configuration Overview | Get an overview of the configurations for France. |
| 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: Rules | Get an overview of the rules used for Germany. |
Germany Configuration Overview
| Topic | Description |
|---|---|
| Germany XR: Configuration Overview | Overview of all topics. |
| Germany XR: Receiver Details | If you send Documents using email, you must specify the email address. |
| Germany XR: Third-Party Payments | You can specify information about third party payments in German B2G Documents. |
| Germany XR: Third-Party Payable Amounts | If you specify a third-party payment, you need to also specify the payable amount. |
| Germany XR: Invoice Type Codes | If a supplier is German, you must use one of the Invoice Type Codes listed here. |
| Germany XR: German Buyer Reference (Leitweg-ID) | You must specify the Leitweg-ID for German Buyers in B2G Documents, |
| Germany XR: Additional Documents | If you attach a document using the AdditionalDocumentReference element, you must specify an ID. |
| Germany XR: Supplier's SEPA ID | If the Payment Means Code is a direct debit, you need to specify the Supplier's or Payee's SEPA ID. |
| Germany XR: Payee's SEPA ID | If the Payment Means Code is a direct debit, you need to specify the Supplier's or Payee's SEPA ID. |
| Germany XR: Supplier's Contact | You must specify the contact information for Germany B2G. |
| Germany XR: Supplier's Electronic Address | You can specify an electronic address for a Supplier. |
| Germany XR: Supplier's Postal Address | You must specify a Supplier's address in Germany. |
| Germany XR: Buyer Information | You must specify the Buyer's information for German buyers. |
| Germany XR: Buyer's Electronic Address | You can add the buyers' email address or Endpoint ID. |
| Germany XR: Delivery Information | For German Buyers, the delivery information must include a city name and valid German post code. |
| Germany XR: Payment Instructions | You must specify the Payment Means for German Documents. |
| Germany XR: 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 XR: Credit Transfer | If you specify Credit Transfer as the Payment Means, you must specify the Payee's bank account. |
| Germany XR: 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 XR: Payment Terms | You can provide discount information in the PaymentTerms element. |
| Germany XR: Sub-Invoice Lines | These lines are a group of recursive information elements that contains information about individual subordinate invoice line items. |
| Germany XR: 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 XR: German Payee's IBAN | 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 XR: German Payer's IBAN | 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 PEP: Overview | Overview information for this country. |
| Greece PEP: Receivers | Read about the Receiver used by this country. |
| Greece PEP: Examples | Example Documents. |
| Greece PEP: Extensions | The Extensions for this country. |
| Greece PEP: Standard Values | The standard values for this country. |
| Greece PEP: Configuration Overview | Configuration topics. |
| Greece PEP: Rules | The Rules used by this country. |
Greece Configuration Overview
| Topic | Description |
|---|---|
| Greece PEP: Configuration Overview | Overview of the configuration topics for this country. |
| Greece PEP: Invoice Number Patterns | Greece requires that the invoice numbers that you use follow a specific pattern. |
| Greece PEP: Installation Serial Number | Greece requires that you include the installation serial number in your documents. |
| Greece PEP: Invoice Sub Type Code | You must specify the type of invoice in Greece with the specified codes. |
| Greece PEP: Invoice Series | In Greece, you must specify the Invoice Series value. |
| Greece PEP: Additional Document Reference | You must specify the MARK number for Greek Suppliers. |
| Greece PEP: Supplier's Electronic Address | You must specify the Supplier's electronic address. |
| Greece PEP: Suppliers Tax Scheme | You must specify the supplier's Tax Scheme information. |
| Greece PEP: Supplier's Name | You must specify the Supplier's name. |
| Greece PEP: Buyer's Tax Scheme | You must include specific information for Greek Buyers. |
Italy
| Topic | Description |
|---|---|
| Italy FPA: Overview | Overview information for this country. |
| Italy FPA: Receivers | The Receiver used by this country. |
| Italy FPA: Example Documents | Example Documents. |
| Italy FPA: Extensions | Extensions used by this country. |
| Italy FPA: Standard Values | A list of the standard values for elements and attributes. |
| Italy FPA: Configuration Overview | Read about the configuration for this country. |
| Italy FPA: Rules | The Rules that govern the processing of the Documents for this country. |
Italy Configuration Overview
| Topic | Description |
|---|---|
| Italy FPA: General Configuration | General configuration topics for routing details, invoice types, and other topics. |
| Italy FPA: Supplier Configurations | Configuration for Suppliers. |
| Italy FPA: Buyer Configuration | Configurations for Buyers. |
| Italy FPA: Additional Document Configuration | Configurations for attached and referenced Documents. |
| Italy FPA: Social Security and Public Entity Configurations | Configurations for social security and public entities such as public investment funds. |
| Italy FPA: Tax Configuration | Tax configuration topics. |
| Italy FPA: Delivery and Transport Configurations | How to model information relating to delivery and the transport industry. |
| Italy FPA: Payment and Price Configurations | How to model payment and pricing information, including allowances. |
General Configuration
| Topic | Description |
|---|---|
| Italy FPA: Transmission Format Code | You need specify a dedicated code to represent the transaction format code. |
| Italy FPA: Sdi Receiver Code | You must specify an SDI Receiver code. |
| Italy FPA: Invoice Type Codes | You must use the codes specified by the Italian Tax Authority to identify the type of invoice. |
| Italy FPA: Accounting Reference | You can specify a code or text to identify the supplier for administrative accounting purposes. |
| Italy FPA: Data Type | If you specify N3.5 (dichiarazioni d'intento) as the DataType, you must add the DataType element. |
| Italy FPA: Article 73 Indicator | If Article 73 applies, you can indicate it. |
Supplier Configuration
| Topic | Description |
|---|---|
| Italy FPA: Supplier's Professional Register Details | In Italy, a supplier's details can be held in a Professional Register. You can add these details to your Documents. |
| Italy FPA: Supplier's EORI Number | You can include the Supplier's EORI number. |
| Italy FPA: Supplier's Fiscal Code | You can specify an Italian Supplier's Fiscal Code. |
| Italy FPA: Supplier's Tax System Code | You must specify the Supplier's Tax System Code. |
| Italy FPA: Province for Supplier's Business | You can specify the State or Province for Italian Supplier's business. |
| Italy FPA: Supplier's Base Capital | You can specify the Supplier's registered base capital. |
| Italy FPA: Supplier's Business Registration Number | You can specify an Italian Supplier's REA number. |
| Italy FPA: Supplier Sole Proprietor | You can indicate whether an Italian Supplier is a sole proprietor. |
| Italy FPA: Supplier's Liquidation Status | You can indicate a Supplier's liquidation status. |
| Italy FPA: 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 FPA: Supplier's Permanent Italian Establishment | You can specify the permanent address of a supplier who is not resident in Italy. |
| Italy FPA: Supplier's Tax Representative's EORI Number | If the Supplier's Tax Representative has an EORI number, you can specify it. |
| Italy FPA: Supplier's Tax Representative's Fiscal Code | If an Italian Supplier's Italian Tax Representative has a fiscal code, you can specify it. |
| Italy FPA: 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 FPA: Supplier's Province or State | You can specify an Italian supplier's province or state code. |
Buyer Configuration
| Topic | Description |
|---|---|
| Italy FPA: Buyer's EORI Code | You can include the Buyer's EORI number. |
| Italy FPA: Buyer's Fiscal Code | You must specify a Buyers Fiscal code if you do not specify a VAT number for them. |
| Italy FPA: Buyer's Postal Address | You can specify a Buyer's state or province. |
| Italy FPA: 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 FPA: Buyer's Permanent Italian Establishment | You can specify the permanent address of a buyer who is not resident in Italy. |
| Italy FPA: 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 FPA: NSO Reference for Buyers | If you want, you can specify an Nodo Smistamento Ordini (NSO) reference for a buyer. |
| Italy FPA: Buyer Accounting Reference | You can specify a reference to the Buyer's financial accounts. |
Additional Document Configuration
| Topic | Description |
|---|---|
| Italy FPA: Agreement Number | You can specify the framework agreement number. |
| Italy FPA: Document Reference | If a Document references multiple other Documents, you can reference these on the invoice line level. |
| Italy FPA: Attachments | You can use these elements to attach files. |
| Italy FPA: Invoice Reference Number | When you send an adjustment e-invoice or a credit note, you must reference the previous invoice. |
| Italy FPA: Tender or Lot Reference | You can specify a reference to a tender or lot. |
| Italy FPA: 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 FPA: Digital Stamps | If you want, you can indicate if a digital stamp is present. |
| Italy FPA: Project Reference | You can specify a code to represent public investment funds. |
| Italy FPA: Social Security Base Amount | If a social security allowance exists, you can specify the base amount. |
| Italy FPA: Social Security Administration Reference | You can specify the Administration Reference for social security related allowances. |
| Italy FPA: Social Security Withholding Indicator | You can specify if a social security allowance is subject to withholding. |
| Italy FPA: Social Security Tax Exemption Reason | If a tax exemption exists for a social security allowance, you must specify the reason for the exemption. |
| Italy FPA: Social Security Tax Rate | If a social security allowance exists, you must specify the tax rate. |
| Italy FPA: Social Security Contribution Amount | If a social security allowance includes a contribution, you must specify the amount of the contribution. |
| Italy FPA: Social Security Contribution Percentage | If a social security allowance includes a percentage contribution to a fund, you must specify the percentage. |
| Italy FPA: Social Security Charge Code | If a social security allowance charge applies, you must specify VRBL:IT:ZZZ as the reason code. |
| Italy FPA: Social Security Organization Code | When social security charges are applied, you must specify the Social Security Organization's code. |
Tax Configuration
| Topic | Description |
|---|---|
| Italy FPA: Incidental Costs | If incidental costs related to the tax rate exist, you can specify them. |
| Italy FPA: Withholding Tax Type Code | If tax is withheld, you must specify the details. |
| Italy FPA: VAT Mechanism | You can specify the mechanism of payment for VAT. |
| Italy FPA: Tax Exemption Reason | You can specify a free text description for a tax exemption. |
| Italy FPA: Tax Exemption Reason Code | If no tax is applied, you must specify a reason. |
| Italy FPA: Tax Exemption Reason Code (Invoice Lines) | You can specify Tax Exemption Reason Code on the invoice line level. |
Delivery Configuration
| Topic | Description |
|---|---|
| Italy FPA: Vehicle Details | You can specify details about vehicle registration and the distance covered. |
| Italy FPA: Transport Invoice Reference | You can specify a reference to an invoice related to transportation. |
| Italy FPA: Delivery Location | You can specify the address that goods are sent to. |
| Italy FPA: Carrier's EORI Code | You can specify the Carrier's EORI code. |
| Italy FPA: Carrier's Driver's License ID | You can specify the Carrier's driving license. |
| Italy FPA: Carrier's Fiscal Code | You can specify the Carrier's Fiscal code. |
Payment and Price Configuration
| Topic | Description |
|---|---|
| Italy FPA: Payee Data | You can specify the details of the person who confirms a payment in Italy. |
| Italy FPA: Payment Terms Code | You must specify the Payment Terms code. |
| Italy FPA: Penalty Start Date | You can specify the start date for any penalties. |
| Italy FPA: Early Payment End Date | You can specify the end date for early payment discounts. |
| Italy FPA: Payment Terms Start Date | You can specify the start date of any payment terms. |
| Italy FPA: Payment Reason Code | If a Document contains a payment, you must specify a reason code. |
| Italy FPA: Rounding Amount | If you use Rounding, you must specify it. |
| Italy FPA: 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 FPA: Unit Price Allowance | You can specify an allowance that is applied to the unit price on the line-item level. |
| Italy FPA: Item Gross Price | You can specify an item's gross price on each invoice line. |
Japan
| Topic | Description |
|---|---|
| Japan PEP: Overview | Overview information for this country. |
| Japan PEP: Receiver | Read about the Receiver used by this country. |
| Japan PEP: Example Documents | Example Documents. |
| Japan PEP: Configuration Overview | Read about the configurations used by this country. |
| Japan PEP: Rules | Read about the Rules used by this country. |
Japan Configuration Overview
| Topic | Description |
|---|---|
| Japan PEP: Configuration Overview | Overview of the configuration topics for this country. |
| Japan PEP: Invoice Issue Time | You can add the time when the invoice was issued to Japanese Documents. |
| Japan PEP: Invoice Type Codes | In Japan, you must use one of the allowed invoice type codes to specify the type of document. |
| Japan PEP: Tax Accounting Currency | If you specify a currency other than JPY in the DocumentCurrencyCode element, you must specify JPY in the TaxCurrencyCode element. |
| Japan PEP: Invoice Document Reference | For Japanese correction invoices, you must specify the preceding invoice number and issue date. |
| Japan PEP: Supplier's Tax Scheme | Depending on the type of invoice, you are required to include or exclude the S. |
| Japan PEP: Allowances and Charges (Document Level) | In Japan, you must include tax details that relate to allowances and charges. |
| Japan PEP: Tax Amounts | Japan has certain requirements for how tax amounts are modelled. |
| Japan PEP: Tax Category | In Japan, you must include certain Tax Category information. |
| Japan PEP: Invoiced Quantity for Returns | In Japan, returns must have a negative value for the invoice quantity. |
| Japan PEP: Invoice Line Net Amount for Returns | For Japanese returns, you must specify a negative amount for the InvoiceLineExtension element. |
| Japan PEP: Line Level Tax Information | In Japan, you must specify certain tax information for each InvoiceLine element. |
| Japan PEP: Item Names for Summary Invoices | For summary invoices, you may need to include the delivery note number. |
| Japan PEP: 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 B2G/B2B: Overview | Overview information for this country. |
| Malaysia B2G/B2B: Receiver | The Receiver used for this country. |
| Malaysia B2G/B2B: Example Documents | Example Documents. |
| Malaysia B2G/B2B: Standard Values | A list of the standard values for elements and attributes. |
| Malaysia B2G/B2B: Configuration Overview | The country-specific configurations for Malaysia. |
| Malaysia B2G/B2B: Rules | The rules that govern the processing of the Documents for this country. |
Malaysia: Configuration Overview
| Topic | Description |
|---|---|
| Malaysia MYS: Configuration Overview | Overview of the different configuration topics for Malaysia. |
| Malaysia MYS: 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 MYS: Supplier Configuration | Supplier configurations. |
| Malaysia MYS: Additional Document Configuration | Information about modelling additional documents for Malaysia. |
| Malaysia MYS: Tax Configuration | Information about modelling modelling tax for Malaysia. |
Malaysia: General Configuration
| Topic | Description |
|---|---|
| Malaysia MYS: General Configuration | Topics covering general configuration for Malaysia. |
| Malaysia MYS: 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 MYS: Invoice Type Code | You must provide an Invoice Type code in Malaysia. |
| Malaysia MYS: States | Malaysia requires that you include the code for the State for addresses within the country. |
| Malaysia MYS: Product Categorization | Malaysia has specific requirement for how you categorize products. |
| Malaysia MYS: Business Registration Number (BRN) | You must use a BRN for any Malaysian business specified in the e-invoice or credit note. |
| Malaysia MYS: Incoterm | Incoterms are required for applicable Malaysian Documents. |
| Malaysia MYS: Payment Means | If you want, you can specify the means of payment, such as a credit card. |
Malaysia: Supplier Configuration
| Topic | Description |
|---|---|
| Malaysia MYS: Supplier Configuration | Overview of Supplier related configurations. |
| Malaysia MYS: Supplier's Billing Reference Number | You may want to specify a Supplier's internal reference number. |
| Malaysia MYS: Supplier's CertEX Authorization Number | An Authorization Number for Certified Exporter (CertEX) indicates that the supplier is an certified exporter in Malaysia. |
| Malaysia MYS: Supplier's Standard Industrial Classification Code (MSIC) | You musty specify an industrial classification code and descriptions for goods on Malaysian invoices. |
| Malaysia MYS: Supplier's Phone Number | You must add the Supplier's phone number to your Malaysian Documents. |
Malaysia: Additional Document Configuration
| Topic | Description |
|---|---|
| Malaysia MYS: Additional Document Configuration | Overview of configurations for additional documents. |
| Malaysia MYS: Additional Supporting Documents | You are required to reference any Custom's Forms in applicable Documents. |
| Malaysia MYS: Preceding e-Invoice Reference | If applicable, you are required to specify the Customs Form No.2 (K2) number. |
| Malaysia MYS: Supplier's Billing Reference Number | If applicable, you must specify any Free Trade Agreement (FTA) information. |
Malaysia: Tax Configuration
| Topic | Description |
|---|---|
| Malaysia MYS: Tax Configuration | Overview of tax related configurations. |
| Malaysia MYS: 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 MYS: Sales and Service Tax (SST) Registration Number | The SST number identifies a participant in the Malaysian Sales and Service Tax (SST) scheme. |
| Malaysia MYS: Tax Identification Number (TIN) | You must include a TIN in your invoices and credit notes. |
| Malaysia MYS: Tax Categories | You must specify Malaysian Tax Category information. |
| Malaysia MYS: Tax for Foreign Currency Transactions | If the DocumentCurrencyCode is different from the TaxCurrencyCode, you need to specify the exchange rate. |
| Malaysia MYS: Tax Totals (Document) | Read about how to model tax totals at the Document level. |
| Malaysia MYS: 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 PEP: Overview | Overview information for this country. |
| Netherlands PEP: Receiver | The Receiver used by this country. |
| Netherlands PEP: Examples | Example Documents. |
| Netherlands PEP: Standard Values | Standard values used in this country. |
| Netherlands PEP: Configuration Overview | Country-specific configurations. |
| Netherlands PEP: Rules | The Rules that govern the processing of the Documents for this country. |
Netherlands: Configuration Overview
| Topic | Description |
|---|---|
| Netherlands PEP: Configuration Overview | Overview of the configuration topics for this country. |
| Netherlands PEP: Invoice Reference | You must reference the preceding invoice in the subsequent credit note. |
| Netherlands PEP: Order Line References | Read about how to reference other lines in Dutch Documents. |
| Netherlands PEP: Supplier's Postal Address | You must specify the address of Netherlands-based suppliers. |
| Netherlands PEP: Supplier's Legal Entity | You must specify the Supplier's legal entity for Dutch Documents. |
| Netherlands PEP: Supplier's Tax Representative Postal Address | You must specify the Supplier's Tax Representative's postal address. |
| Netherlands PEP: Buyer Postal Address | You must specify the address for Netherlands-based Buyers. |
| Netherlands PEP: Buyer's Legal Entity | You must specify the legal entity for Netherlands-based buyers. |
| Netherlands PEP: Payment Means | You must specify a Payment Means for payments to Netherlands-based suppliers. |
Portugal
| Topic | Description |
|---|---|
| Portugal PTC: Overview | Overview information for this country. |
| Portugal PTC: Receiver | Read about the Receiver used by this country. |
| Portugal PTC: Example Documents | Example Documents. |
| Portugal PTC: Extensions | The Extensions for this country. |
| Portugal PTC: Configurations | Configuration topics. |
| Portugal PTC: 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 a 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 the line level. |
Romania
| Topic | Description |
|---|---|
| Romania PEF: Overview | Overview information for this country. |
| Romania PEF: Receivers | The Receiver used by this country. |
| Romania PEF: Examples | Example Documents. |
| Romania PEF: Standard Values | A list of the standard values for elements and attributes. |
| Romania PEF: Configuration Overview | The country-specific configurations. |
| Romania PEF: Rules | The rules that govern the processing of the Documents for this country. |
Romania: Configuration Overview
| Topic | Description |
|---|---|
| Romania PEF: Invoice Type Codes | You must specify the Invoice Type using the Invoice Types codes that are required by the Romanian Tax Authority. |
| Romania PEF: Supplier's State (Province) | You must provide the State code for Romanian Suppliers' addresses. |
| Romania PEF: Supplier's City Sector | You must provide the city sector code for Romanian Suppliers' Bucharest addresses. |
| Romania PEF: Buyer's State (Province) | You must provide the State code for Romanian Buyers' addresses. |
| Romania PEF: Buyer's City Sector | You must provide the city sector code for Romanian Buyers' Bucharest addresses. |
Saudi Arabia
| Topic | Restriction |
|---|---|
| Saudi Arabia ZTA: Overview | Overview information for this country. |
| Saudi Arabia ZTA: Receiver | Read about the Receiver used by this country. |
| Saudi Arabia ZTA: Example Documents | Example Documents. |
| Saudi Arabia ZTA: Configuration Overview | Configurations for this country. |
| Saudi Arabia ZTA: Extensions | Extensions for this country. |
| Saudi Arabia ZTA: Rules | The Rules used by this country. |
Saudi Arabia: Configuration Overview
| Topic | Description |
|---|---|
| Saudi Arabia: Third Party Invoice Indicator | You can indicate if the Document was issued by a third party. |
| Saudi Arabia: Nominal Invoice Indicator | You can indicate if an invoice is a nominal invoice. |
| Saudi Arabia: Summary Invoice Indicator | You can indicate that an invoice is a summary invoice. |
| Saudi Arabia: Simplified Invoice Indicator | You can specify if an invoice is a simplified invoice. |
| Saudi Arabia: UUID | You must include a UUID ifor Saudi Arabian documents. |
| Saudi Arabia: Invoice Type Code | You must use specific values for the InvoiceTypeCode in 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 SRF: Overview | Overview information for this country. |
| Serbia SRF: Receiver | Read about the Receiver used for this country. |
| Serbia SRF: Example Documents | Example Documents. |
| Serbia SRF: Extensions | Extensions for this country. |
| Serbia SRF: Configuration Overview | Configuration topics. |
| Serbia SRF: 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 preceding 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. |
| Serbia: Supplier's Electronic Address | You can specify the Supplier's electronic address. |
| Serbia: Supplier's ID | You can add an identifier for the Supplier. |
| Serbia: Supplier's Tax Scheme | You can specify the Supplier's Tax Scheme. |
| Serbia: Supplier's Legal Entity | You can specify a Supplier's legal entity. |
| Serbia: Buyer 's Electronic Address | You can specify the Buyer's electronic address. |
| Serbia: Buyer's ID | You can add an identifier for the Buyer. |
| Serbia: Buyer's Tax Scheme | You can specify the Buyer's Tax Scheme. |
| Serbia: Buyer's Legal Entity | You can specify a Buyer's legal entity. |
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 PEP: Overview | Overview information for this country. |
| Spain PEP: Receiver | The Receiver used by this country. |
| Spain PEP: Example Documents | Example e-invoices and credit notes. |
| Spain PEP: Rules | The rules that govern the processing of the Documents for this country. |
Sweden
| Topic | Description |
|---|---|
| Sweden PEP: Overview | Overview information for this country. |
| Sweden PEP: Receivers | The Receiver used by this country. |
| Sweden PEP: Examples | Example e-invoices and credit notes. |
| Sweden PEP: Configuration Overview | The country specific configurations. |
| Sweden PEP: Rules | The rules that govern the processing of the Documents for this country. |
Sweden: Configuration Overview
| Topic | Description |
|---|---|
| Sweden PEP: Configuration Overview | Overview of the configuration topics for this country. |
| Sweden PEP: Supplier's Company IDs | For Swedish Suppliers, you can specify their Swedish VAT ID. |
| Sweden PEP: Supplier's Tax Schemes | For Swedish Suppliers, you must specify specific values for their Tax Scheme ID and Company ID. |
| Sweden PEP: Supplier's Legal Entity | The Supplier's legal entity identifies them. |
| Sweden PEP: Allowances and Charges | In Sweden, you must specify the percentage tax rate for allowances and charges. |
| Sweden PEP: Tax Categories (Document Level) | You must specify the tax rate percentage for Swedish Tax Categories at the Document level. |
| Sweden PEP: Tax Categories (Line Level) | You must specify the tax rate percentage for Swedish Tax Categories at the line level. |
| Sweden PEP: 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. |
| 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. |
| InvoiceNote | You can add a note to a Document. |
| 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 4 months ago