Guides

Example Documents

This topic links to the examples files for each supported country.

Suggest Edits

Minimum viable example

The following example shows the minimum elements required for a valid VRBL Document, This is also available as a Recipe on the Recipes tab:

  <?xml version="1.0" encoding="UTF-8"?>
  <ubl:Invoice
  	xmlns:ubl="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2"
  	xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2"
  	xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2"
  	xmlns:cec="urn:oasis:names:specification:ubl:schema:xsd:CommonExtensionComponents-2"
  	xmlns:vrbl="urn:vertexinc:vrbl:ExtensionComponent:1">
  	<cec:UBLExtensions>
  		<cec:UBLExtension>
  			<cec:ExtensionContent>
  				<vrbl:InvoiceExtension>
  					<vrbl:RoutingDetails>
  						<vrbl:Sender>A</vrbl:Sender>
  						<vrbl:Receiver>VRBL_CORE</vrbl:Receiver>
  					</vrbl:RoutingDetails>
  				</vrbl:InvoiceExtension>
  			</cec:ExtensionContent>
  		</cec:UBLExtension>
  	</cec:UBLExtensions>
  	<cbc:CustomizationID>urn:vertexinc:vrbl:billing:1</cbc:CustomizationID>
  	<cbc:ProfileID>urn:vertexinc:vrbl:billing:1</cbc:ProfileID>
  	<cbc:ID>12345</cbc:ID>
  	<cbc:IssueDate>2024-08-22</cbc:IssueDate>
  	<cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
  	<cbc:DocumentCurrencyCode>EUR</cbc:DocumentCurrencyCode>
  	<cac:AccountingSupplierParty>
  		<cac:Party>
  			<cac:PostalAddress>
  				<cac:Country>
  					<cbc:IdentificationCode>AT</cbc:IdentificationCode>
  				</cac:Country>
  			</cac:PostalAddress>
  			<cac:PartyLegalEntity>
  				<cbc:RegistrationName>Company A</cbc:RegistrationName>
  				<cbc:CompanyID>AAAAAA</cbc:CompanyID>
  			</cac:PartyLegalEntity>
  		</cac:Party>
  	</cac:AccountingSupplierParty>
  	<cac:AccountingCustomerParty>
  		<cac:Party>
  			<cac:PostalAddress>
  				<cac:Country>
  					<cbc:IdentificationCode>AT</cbc:IdentificationCode>
  				</cac:Country>
  			</cac:PostalAddress>
  			<cac:PartyLegalEntity>
  				<cbc:RegistrationName>Company B</cbc:RegistrationName>
  			</cac:PartyLegalEntity>
  		</cac:Party>
  	</cac:AccountingCustomerParty>
  	<cac:TaxTotal>
  		<cbc:TaxAmount currencyID="EUR">100</cbc:TaxAmount>
  		<cac:TaxSubtotal>
  			<cbc:TaxableAmount currencyID="EUR">1000</cbc:TaxableAmount>
  			<cbc:TaxAmount currencyID="EUR">100</cbc:TaxAmount>
  			<cac:TaxCategory>
  				<cbc:ID>S</cbc:ID>
  				<cbc:Percent>10</cbc:Percent>
  				<cac:TaxScheme>
  					<cbc:ID>VAT</cbc:ID>
  				</cac:TaxScheme>
  			</cac:TaxCategory>
  		</cac:TaxSubtotal>
  	</cac:TaxTotal>
  	<cac:LegalMonetaryTotal>
  		<cbc:LineExtensionAmount currencyID="EUR">1000</cbc:LineExtensionAmount>
  		<cbc:TaxExclusiveAmount currencyID="EUR">1000</cbc:TaxExclusiveAmount>
  		<cbc:TaxInclusiveAmount currencyID="EUR">1100</cbc:TaxInclusiveAmount>
  		<cbc:PayableAmount currencyID="EUR">1100</cbc:PayableAmount>
  	</cac:LegalMonetaryTotal>
  	<cac:InvoiceLine>
  		<cbc:ID>1</cbc:ID>
  		<cbc:InvoicedQuantity unitCode="H87">20</cbc:InvoicedQuantity>
  		<cbc:LineExtensionAmount currencyID="EUR">1000</cbc:LineExtensionAmount>
  		<cac:Item>
  			<cbc:Name>Example Item</cbc:Name>
  			<cac:StandardItemIdentification>
  				<cbc:ID schemeID="0160">1234567890128</cbc:ID>
  			</cac:StandardItemIdentification>
  			<cac:ClassifiedTaxCategory>
  				<cbc:ID>S</cbc:ID>
  				<cbc:Percent>10</cbc:Percent>
  				<cac:TaxScheme>
  					<cbc:ID>VAT</cbc:ID>
  				</cac:TaxScheme>
  			</cac:ClassifiedTaxCategory>
  		</cac:Item>
  		<cac:Price>
  			<cbc:PriceAmount currencyID="EUR">50</cbc:PriceAmount>
  		</cac:Price>
  	</cac:InvoiceLine>
  </ubl:Invoice>

Country specific examples

Example files are available for each supported country:

Updated 12 days ago