Guide content:
Description
With the Finvoice interface, Severan invoices can be converted into einvoice data, which can be uploaded to your own einvoice operator's system for sending to customers. The interface can be used according to Finvoice 1.2, 1.3, 2.01, or 3.0 standards. The customer must make an agreement with the einvoice operator themselves (e.g., their own bank or Itella, Basware, etc.). The einvoice data is in XML format.
The invoice is processed as an electronic invoice, i.e., einvoice, if the customer has been given einvoice address details on the customer's card in Severa. After this, the invoice status is defined in Severa, from which invoices are collected into the data. A file containing the einvoice data is saved from Severa to your own computer, and this file is uploaded to your own einvoice operator's system, from which invoices are sent to customers electronically.
Attention before starting
Activation of the Finvoice interface in Severa with main user rights through subscription management > gear icon > Subscription.
The Finvoice interface does not support consumer e-invoicing.
The customer must have an agreement with the einvoice operator.
Implementation
Main user rights in Severa are required for implementation.
Invoice statuses
Invoice sending works so that invoice statuses are created in Severa, from which einvoice data is downloaded, and the status to which the invoice is changed after the transfer.
Click the gear icon and go to Settings > Billing > Invoice statuses
Add a new invoice status or edit an existing one, e.g., Pending transfer to Finvoice
Select options Not editable, Invoice number, Sent and Credit note default.
Add another invoice status or edit an existing one, to which the invoice is updated after the transfer, e.g., Transferred to Finvoice
Select options Not editable,Invoice number and Sent.
Move the invoice statuses by dragging so that the status with the Paid option remains below the aforementioned statuses.
Bank accounts
The company's bank account details are provided with the invoice, and the bank account must be in IBAN format.
Click the gear icon and go to Settings > Organization > Bank accounts
Edit the bank account format if necessary or add a new bank account using the Add bank account button
Ensure that the BIC code is correctly defined
If you have the business unit hierarchy add-on and the units are separate billing companies, add bank accounts for each company by selecting the desired unit from the dropdown menu.
Adding einvoice address
To send einvoices, add your company's einvoice address and operator code in the correct format (e.g., NDEAFIHH for Nordea) to Severa.
Company details
Click the gear icon > Settings > Company details
Add your company's Einvoice address and Einvoice operator code
Also check that your company has entered address details
Severa defines the sender's city as the headquarters. Note that the company's headquarters location may not be the same as the company's location. By default, the registered office is defined according to the City information in the company details, but the user can change it as desired.
Business unit
When you have the Business unit hierarchy add-on and the units are separate billing companies, add the vat number, einvoice address, einvoice operator code, and footer directly to the desired business unit.
Go to the gear icon in the upper right corner > Settings > Business units
Open the business unit details by clicking the unit and edit the details if necessary
Data transfer settings
The actual interface settings are made in Severa. Open the Finvoice data transfer settings by clicking the gear icon > Tools > Data transfer.
Open the Settings tab of the data transfer
Select Status of invoices to be downloaded dropdown menu to Pending transfer to Finvoice invoice status
Select Status to which invoices are transferred dropdown menu to Transferred to Finvoice invoice status
Save settings
Creating invoice data
Create an invoice in Severa
Change the invoice status to the status you added, e.g., Pending transfer to Finvoice invoice status
Click the gear icon > Tools >Data transfer and select Download invoices
Save the XML file to your computer
Upload the invoice data to your einvoice operator
Change the status of the invoices you uploaded by clicking the gear icon > Tools > Data transferand select Change status
Technical description Finvoice 1.2.
Details of own (sending) organization | Finvoice data field | Character count/additional information |
Vat number | SellerPartyIdentifier | 0-35 (formatting 1234567-8) |
Name | SellerOrganisationName | 2-35 |
Vat number | SellerOrganisationTaxCode | 0-35 (formatting 1234567-8) |
Street address | SellerStreetName | 2-35 |
City | SellerTownName | 2-35 |
Postal code | SellerPostCodeIdentifier | 2-35 |
Country code | Countrycode | 2 (e.g., FI, SE) |
Country | CountryName | 0-35 |
Billing contact person | SellerContactPersonName | 0-35 |
City | SellerHomeTownName | 0-35 |
Information about VAT registration | SellerVatRegistrationText | 0-35 |
Invoice notes field | SellerFreeText | 0-512 |
Bank account IBAN number | SellerAccountID | 2-35, attribute => IdentificationSchemeName=IBAN |
Bank account BIC code | SellerBic | 8-11, attribute => IdentificationSchemeName=BIC |
**Details of receiving organization | ||
From Severa invoice** | Finvoice data field | Character count/additional information |
--- | --- | --- |
Customer number | BuyerPartyIdentifier | 0-35 |
Customer name | BuyerOrganisationName | 2-35 |
Vat number | BuyerOrganisationTaxCode | 0-35 (formatting 1234567-8) |
Customer address | BuyerStreetName | 2-35 |
City | BuyerTownName | 2-35 |
Postal code | BuyerPostalCodeIdentifier | 2-35 |
Country code | Countrycode | 2 (e.g., FI, SE) |
Country | CountryName | 0-35 |
Customer contact | BuyerContactPersonName | 0-35 |
Contact person email | BuyerEmailaddressIdentifier | 0-48 |
From Severa invoice | Finvoice data field | Character count/additional information |
Invoice type code | InvoiceTypeCode | 5, INV01=invoice or INV02=credit note |
Invoice type text | InvoiceTypeText | 1-35, Always => "Invoice" or "Credit note" |
Code | OriginCode | 4-8, Always => "Original" |
Invoice number | InvoiceNumber | 1-20 |
Invoice date | InvoiceDate | 8, attribute => Format=CCYYMMDD |
Our reference | SellerReferenceIdentifier | 0-35 |
Order number | OrderIdentifier | 0-35 |
Invoice total excluding VAT | InvoiceTotalVatExcludedAmount | Attribute => AmountCurrencyIdentifier |
Invoice total VAT amount | InvoiceTotalVatAmount | Attribute => AmountCurrencyIdentifier |
Invoice total including VAT | InvoiceTotalVatIncludedAmount | Attribute =>AmountCurrencyIdentifier |
Invoice total excluding VAT | VatBaseAmount | Attribute => AmountCurrencyIdentifier |
VAT percentage | VatRatePercent | |
Invoice total VAT amount | VatRateAmount | Attribute => AmountCurrencyIdentifier |
Reverse charge description | VatFreeText | |
Free text field above invoice rows (Before invoice rows) | InvoiceFreeText | 0-512 * |
Free text field below invoice rows (After invoice rows) | InvoiceFreeText | 0-512 * |
Payment terms | PaymentTermsFreeText | 1-35 |
Invoice due date | InvoiceDueDate | 8, attribute => Format=CCYYMMDD |
Overdue interest | PaymentOverDueFineFreeText | 0-512 |
Overdue interest percentage | PaymentOverDueFinePercent | 1-7 |
Invoice payment status | PaymentStatusCode | 0-10, always "NOTPAID" |
Product/work type/travel expense code | ArticleIdentifier | 0-35 |
Invoice row description (e.g., work hour entry or product) | ArticleName | 0-70 |
Invoice row quantity | DeliveredQuantity | 0-14, attribute => QuantityUnitCode e.g., pcs |
Invoice row description (e.g., work hour entry or product) | OrderedQuantity | 0-14, attribute => QuantityUnitCode e.g., pcs |
Invoice row unit price | UnitPriceAmount | Attribute => AmountCurrencyIdentifier |
Attribute => UnitPriceUnitCode e.g., pcs | ||
Invoice row VAT percentage | RowVatRatePercent | 0-14 |
Invoice row VAT amount | RowVatAmount | Attribute => AmountCurrencyIdentifier |
Invoice row total excluding VAT | RowVatExcludedAmount | Attribute => AmountCurrencyIdentifier |
Invoice row total including VAT | RowAmount | Attribute => AmountCurrencyIdentifier |
Invoice date | EpiDate | 8, attribute => Format=CCYYMMDD |
Invoice reference number | EpiReference | 0-35 |
Bank account BIC code | EpiBfiIdentifier | 8-11, attribute => EpiBeneficiaryPartyDetails |
Sending company name | EpiNameAddressDetails | 2-35 |
Sending company vat number | EpiBei | 8-11 |
Sending company's bank account number (IBAN) | EpiAccountID | 1-34, attribute => IdentificationSchemeName |
Work number | EpiPaymentInstructionId | 0-35 |
Invoice reference number | EpiRemittanceInfoIdentifier | 2-35, attribute => IdentificationSchemeName=SPY |
Invoice total including VAT | EpiInstructedAmount | Attribute => AmountCurrencyIdentifier |
Always "SHA" | EpiCharge | Attribute => ChargeOption=SHA |
Invoice due date | EpiDateOptionDate | Attribute => Format=CCYYMMDD |
* The information in the fields above and below the invoice rows is added to the InvoiceFreeText field, which has a maximum character count of 512.
Technical description Finvoice 1.3.
Details of own (sending) organization | Finvoice data field | Character count/additional information |
Vat number | SellerPartyIdentifier | 0-35 (formatting 1234567-8) |
Name | SellerOrganisationName | 2-35 (if the name is longer, it is split into multiple lines) |
VAT identifier | SellerOrganisationTaxCode | 0-35 (formatting FI12345678) |
Street address | SellerStreetName | 2-35 (if character count > 35, split into 1-3 lines) |
City | SellerTownName | 2-35 |
Postal code | SellerPostCodeIdentifier | 2-35 |
Country code | Countrycode | 2 (e.g., FI, SE) |
Country | CountryName | 0-35 |
Billing contact person | SellerContactPersonName | 0-35 |
City | SellerHomeTownName | 0-35 |
Invoice notes field | SellerFreeText | 0-512 |
Information about VAT registration | SellerVatRegistrationText | 0-35 |
Bank account IBAN number | SellerAccountID | 0-35, attribute => IdentificationSchemeName=IBAN |
Bank account BIC code | SellerBic | 8-11, attribute => IdentificationSchemeName=BIC |
**Details of receiving organization | ||
From Severa invoice** | Finvoice data field | Character count/additional information |
--- | --- | --- |
Vat number | BuyerPartyIdentifier | 0-35 (formatting 1234567-8) |
Customer name | BuyerOrganisationName | 2-35 (if the name is longer, it is split into multiple lines) |
VAT identifier | BuyerOrganisationTaxCode | 0-35 (formatting FI12345678) |
Customer address | BuyerStreetName | 2-35 (if character count > 35, split into 1-3 lines) |
City | BuyerTownName | 2-35 |
Postal code | BuyerPostalCodeIdentifier | 2-35 |
Country code | Countrycode | 2 (e.g., FI, SE) |
Country | CountryName | 0-35 |
Customer contact | BuyerContactPersonName | 0-35 |
Contact person email | BuyerEmailaddressIdentifier | 0-70 |
From Severa invoice | Finvoice data field | Character count/additional information |
Invoice type code | InvoiceTypeCode | 5, INV01=invoice or INV02=credit note |
Invoice type text | InvoiceTypeText | 1-35, Always => "Invoice" or "Credit note" |
Code | OriginCode | Always => "Original" |
Invoice number | InvoiceNumber | 1-20 |
Invoice date | InvoiceDate | 8, attribute => Format=CCYYMMDD |
Our reference | SellerReferenceIdentifier | 0-35 |
Customer number | SellersBuyerIdentifier | 0-35 |
Order number | OrderIdentifier | 0-35 |
Sales person | SalesPersonName | 0-35 |
Your reference | BuyerReferenceIdentifier | 0-35 |
Project number | ProjectReferenceIdentifier | 0-35 |
Invoice total excluding VAT | InvoiceTotalVatExcludedAmount | 0-35, attribute => AmountCurrencyIdentifier |
Invoice total VAT amount | InvoiceTotalVatAmount | 0-35, attribute => AmountCurrencyIdentifier |
Invoice total including VAT | InvoiceTotalVatIncludedAmount | 0-35, attribute =>AmountCurrencyIdentifier |
Invoice total excluding VAT | VatBaseAmount | Attribute => AmountCurrencyIdentifier |
VAT percentage | VatRatePercent | |
VAT code | VatCode | 0-10 Code=AE if reverse charge is used on the invoice. |
Otherwise, the VatCode field is not in the invoice data | ||
Invoice total VAT amount | VatRateAmount | Attribute => AmountCurrencyIdentifier |
Reverse charge description | VatFreeText | 0-35 (if character count > 35, split into 1-3 lines) |
Notes | InvoiceFreeText | 0-512 (if character count > 512, split into multiple lines) |
Free text field above invoice rows (Before invoice rows) | InvoiceFreeText | 0-512 (if character count > 512, split into multiple lines) |
Free text field below invoice rows (After invoice rows) | InvoiceFreeText | 0-512 (if character count > 512, split into multiple lines) |
Payment terms | PaymentTermsFreeText | 1-35 |
Invoice due date | InvoiceDueDate | 8, attribute => Format=CCYYMMDD |
Overdue interest | PaymentOverDueFineFreeText | 0-70 |
Overdue interest percentage | PaymentOverDueFinePercent | |
Invoice payment status | PaymentStatusCode | Always "NOTPAID" |
Product/work type/travel expense code | ArticleIdentifier | 0-35 |
Product category code | ArticleGroupIdentifier | 0-35 (if the product belongs to a product category) |
Invoice row description (e.g., work hour entry or product) | ArticleName | 0-100 |
Invoice row quantity | DeliveredQuantity | 0-14, attribute => QuantityUnitCode e.g., pcs |
Invoice row description (e.g., work hour entry or product) | OrderedQuantity | 0-14, attribute => QuantityUnitCode e.g., pcs |
Invoice row unit price | UnitPriceAmount | Attribute => AmountCurrencyIdentifier |
Attribute => UnitPriceUnitCode e.g., pcs | ||
Used if invoice row description exceeds 100 characters | RowFreeText | 0-512 (if the name is longer, it is split into multiple lines) |
Invoice row VAT percentage | RowVatRatePercent | |
Invoice row VAT amount | RowVatAmount | Attribute => AmountCurrencyIdentifier |
Invoice row total excluding VAT | RowVatExcludedAmount | Attribute => AmountCurrencyIdentifier |
Invoice row total including VAT | RowAmount | Attribute => AmountCurrencyIdentifier |
Invoice date | EpiDate | 8, attribute => Format=CCYYMMDD |
Invoice reference number | EpiReference | 0-35 |
Bank account BIC code | EpiBfiIdentifier | 8-11, attribute => EpiBeneficiaryPartyDetails |
Sending company name | EpiNameAddressDetails | 2-35 |
Sending company vat number | EpiBei | 8-11 |
Sending company's bank account number (IBAN) | EpiAccountID | 1-34, attribute => IdentificationSchemeName |
Work number | EpiPaymentInstructionId | 0-35 |
Invoice reference number | EpiRemittanceInfoIdentifier | 2-35, attribute => IdentificationSchemeName=SPY |
Invoice total including VAT | EpiInstructedAmount | Attribute => AmountCurrencyIdentifier |
Always "SHA" | EpiCharge | Attribute => ChargeOption=SHA |
Invoice due date | EpiDateOptionDate | Attribute => Format |
Technical description Finvoice 2.01.
Details of own (sending) organization | Finvoice data field | Character count/additional information |
Vat number | SellerPartyIdentifier | 0-35 (formatting 1234567-8) |
Name | SellerOrganisationName | 2-70 (if the name is longer, it is split into multiple lines) |
VAT identifier | SellerOrganisationTaxCode | 0-35 (formatting FI12345678) |
Street address | SellerStreetName | 2-35 (if character count > 35, split into 1-3 lines) |
City | SellerTownName | 2-35 |
Postal code | SellerPostCodeIdentifier | 2-35 |
Country code | Countrycode | 2 (e.g., FI, SE) |
Country | CountryName | 0-35 |
Billing contact person | SellerContactPersonName | 0-35 |
City | SellerHomeTownName | 0-35 |
Invoice notes field | SellerFreeText | 0-512 |
Information about VAT registration | SellerVatRegistrationText | 0-35 |
Bank account IBAN number | SellerAccountID | 2-35, attribute => IdentificationSchemeName=IBAN |
Bank account BIC code | SellerBic | 8-11, attribute => IdentificationSchemeName=BIC |
**Details of receiving organization | ||
From Severa invoice** | Finvoice data field | Character count/additional information |
--- | --- | --- |
Vat number | BuyerPartyIdentifier | 0-35 (formatting 1234567-8) |
Customer name | BuyerOrganisationName | 2-70 (if the name is longer, it is split into multiple lines) |
VAT identifier | BuyerOrganisationTaxCode | 0-35 (formatting FI12345678) |
Customer address | BuyerStreetName | 2-35 (if character count > 35, split into 1-3 lines) |
City | BuyerTownName | 2-35 |
Postal code | BuyerPostalCodeIdentifier | 2-35 |
Country code | Countrycode | 2 (e.g., FI, SE) |
Country | CountryName | 0-35 |
Customer contact | BuyerContactPersonName | 0-35 |
Contact person email | BuyerEmailaddressIdentifier | 0-70 |
From Severa invoice | Finvoice data field | Character count/additional information |
Invoice type code | InvoiceTypeCode | 5, INV01=invoice or INV02=credit note |
Invoice type text | InvoiceTypeText | 1-35, Always => "Invoice" or "Credit note" |
Code | OriginCode | Always => "Original" |
Invoice number | InvoiceNumber | 1-20 |
Invoice date | InvoiceDate | 8, attribute => Format=CCYYMMDD |
Our reference | SellerReferenceIdentifier | 0-35 |
Customer number | SellersBuyerIdentifier | 0-35 |
Order number | OrderIdentifier | 0-35 |
Sales person | SalesPersonName | 0-35 |
Your reference | BuyerReferenceIdentifier | 0-35 |
Project number | ProjectReferenceIdentifier | 0-35 |
Invoice total excluding VAT | InvoiceTotalVatExcludedAmount | 1-22, attribute => AmountCurrencyIdentifier |
Invoice total VAT amount | InvoiceTotalVatAmount | 1-22, attribute => AmountCurrencyIdentifier |
Invoice total including VAT | InvoiceTotalVatIncludedAmount | 1-22, attribute =>AmountCurrencyIdentifier |
Invoice total excluding VAT | VatBaseAmount | 1-22 attribute => AmountCurrencyIdentifier |
VAT percentage | VatRatePercent | 1-7 |
VAT code | VatCode | 0-10 Code=AE if reverse charge is used on the invoice. |
Otherwise, the VatCode field is not in the invoice data | ||
Invoice total VAT amount | VatRateAmount | 1-22, attribute => AmountCurrencyIdentifier |
Reverse charge description | VatFreeText | 0-70 (if character count > 35, split into 1-3 lines) |
Notes | InvoiceFreeText | 0-512 (if character count > 512, split into multiple lines) |
Free text field above invoice rows (Before invoice rows) | InvoiceFreeText | 0-512 (if character count > 512, split into multiple lines) |
Free text field below invoice rows (After invoice rows) | InvoiceFreeText | 0-512 (if character count > 512, split into multiple lines) |
Payment terms | PaymentTermsFreeText | 1-70 |
Invoice due date | InvoiceDueDate | 8, attribute => Format=CCYYMMDD |
Overdue interest | PaymentOverDueFineFreeText | 0-70 |
Overdue interest percentage | PaymentOverDueFinePercent | 1-7 |
Invoice payment status | PaymentStatusCode | Always "NOTPAID" |
Product/work type/travel expense code | ArticleIdentifier | 0-35 |
Product category code | ArticleGroupIdentifier | 0-35 (if the product belongs to a product category) |
Invoice row description (e.g., work hour entry or product) | ArticleName | 0-100 |
Invoice row quantity | DeliveredQuantity | 0-14, attribute => QuantityUnitCode e.g., pcs |
Invoice row description (e.g., work hour entry or product) | OrderedQuantity | 0-14, attribute => QuantityUnitCode e.g., pcs |
Invoice row unit price | UnitPriceAmount | 1-22, attribute => AmountCurrencyIdentifier |
and attribute => UnitPriceUnitCode e.g., pcs | ||
Used if invoice row description exceeds 100 characters | RowFreeText | 0-512 (if the name is longer, it is split into multiple lines) |
Invoice row VAT percentage | RowVatRatePercent | 1-7 |
Invoice row VAT amount | RowVatAmount | 1-22, attribute => AmountCurrencyIdentifier |
Invoice row total excluding VAT | RowVatExcludedAmount | 1-22, attribute => AmountCurrencyIdentifier |
Invoice row total including VAT | RowAmount | 1-22, attribute => AmountCurrencyIdentifier |
Invoice date | EpiDate | 8, attribute => Format=CCYYMMDD |
Invoice reference number | EpiReference | 0-35 |
Bank account BIC code | EpiBfiIdentifier | 8-11, attribute => EpiBeneficiaryPartyDetails |
Sending company name | EpiNameAddressDetails | 2-35 |
Sending company vat number | EpiBei | 8-11 |
Sending company's bank account number (IBAN) | EpiAccountID | 1-34, attribute => IdentificationSchemeName |
Work number | EpiPaymentInstructionId | 0-35 |
Invoice reference number | EpiRemittanceInfoIdentifier | 2-35, attribute => IdentificationSchemeName=SPY |
Invoice total including VAT | EpiInstructedAmount | 4-19, attribute => AmountCurrencyIdentifier |
Always "SHA" | EpiCharge | 0, attribute => ChargeOption=SHA |
Invoice due date | EpiDateOptionDate | 8, attribute => Format |
Technical description Finvoice 3.0.
Details of own (sending) organization | Finvoice data field | Character count/additional information |
Vat number | SellerPartyIdentifier | 0-35 (formatting 1234567-8) |
Name | SellerOrganisationName | 2-70 (if the name is longer, it is split into multiple lines) |
VAT identifier | SellerOrganisationTaxCode | 0-35 (formatting FI12345678) |
Street address | SellerStreetName | 2-35 (if character count > 35, split into 1-3 lines) |
City | SellerTownName | 2-35 |
Postal code | SellerPostCodeIdentifier | 2-35 |
Country code | Countrycode | 2 (e.g., FI, SE) |
Country | CountryName | 0-35 |
Billing contact person | SellerContactPersonName | 0-70 |
Registered office (from company details) | SellerHomeTownName | 0-35 |
Information about VAT registration | SellerVatRegistrationText | 0-35 |
Invoice notes field | SellerFreeText | 0-512 |
Bank account IBAN number | SellerAccountID | 2-35, attribute => IdentificationSchemeName=IBAN |
Bank account BIC code | SellerBic | 8-11, attribute => IdentificationSchemeName=BIC |
Invoice language code | InvoiceRecipientLanguageCode |
**Details of receiving organization | ||
From Severa invoice** | Finvoice data field | Character count/additional information |
--- | --- | --- |
Vat number | BuyerPartyIdentifier | 0-35 (formatting 1234567-8) |
Customer name | BuyerOrganisationName | 2-70 (if the name is longer, it is split into multiple lines) |
VAT identifier | BuyerOrganisationTaxCode | 0-35 (formatting FI12345678) |
Customer address | BuyerStreetName | 2-35 (if character count > 35, split into 1-3 lines) |
City | BuyerTownName | 2-35 |
Postal code | BuyerPostalCodeIdentifier | 2-35 |
Country code | Countrycode | 2 (e.g., FI, SE) |
Country | CountryName | 0-35 |
Customer contact | BuyerContactPersonName | 0-70 |
Contact person email | BuyerEmailaddressIdentifier | 0-70 |
From Severa invoice | Finvoice data field | Character count/additional information |
Invoice type code | InvoiceTypeCode | 5, INV01=invoice or INV02=credit note |
Invoice type text | InvoiceTypeText | 1-35, Always => "Invoice" or "Credit note" |
Code | OriginCode | Always => "Original" |
Invoice number | InvoiceNumber | 1-20 |
Invoice date | InvoiceDate | 8, attribute => Format=CCYYMMDD |
Our reference | SellerReferenceIdentifier | 0-70 |
Customer number | SellersBuyerIdentifier | 0-70 |
Order number | OrderIdentifier | 0-70 |
Sales person | SalesPersonName | 0-35 |
Your reference | BuyerReferenceIdentifier | 0-70 |
Project number | ProjectReferenceIdentifier | 0-70 |
Invoice rows total excluding VAT | RowsTotalVatExcludedAmount | 1-22, attribute=> |
AmountCurrencyIdentifier | ||
Invoice total excluding VAT | InvoiceTotalVatExcludedAmount | 1-22, attribute => AmountCurrencyIdentifier |
Invoice total VAT amount | InvoiceTotalVatAmount | 1-22, attribute => AmountCurrencyIdentifier |
Invoice total including VAT | InvoiceTotalVatIncludedAmount | 1-22, attribute =>AmountCurrencyIdentifier |
Invoice total excluding VAT | VatBaseAmount | 1-22 attribute => AmountCurrencyIdentifier |
VAT percentage | VatRatePercent | 1-7 |
VAT code | VatCode | 0-10 Code=AE if reverse charge is used on the invoice. |
Otherwise, the VatCode field is not in the invoice data | ||
Invoice total VAT amount | VatRateAmount | 1-22, attribute => AmountCurrencyIdentifier |
Reverse charge description | VatFreeText | 0-70 (if character count > 35, split into 1-3 lines) |
Notes | InvoiceFreeText | 0-512 (if character count > 512, split into multiple lines) |
Free text field above invoice rows (Before invoice rows) | InvoiceFreeText | 0-512 (if character count > 512, split into multiple lines) |
Free text field below invoice rows (After invoice rows) | InvoiceFreeText | 0-512 (if character count > 512, split into multiple lines) |
Payment terms | PaymentTermsFreeText | 1-70 |
Invoice due date | InvoiceDueDate | 8, attribute => Format=CCYYMMDD |
Overdue interest | PaymentOverDueFineFreeText | 0-70 |
Overdue interest percentage | PaymentOverDueFinePercent | 1-7 |
Invoice payment status | PaymentStatusCode | Always "NOTPAID" |
Product/work type/travel expense code | ArticleIdentifier | 0-70 |
Product category code | ArticleGroupIdentifier | 0-70 (if the product belongs to a product category) |
Invoice row description (e.g., work hour entry or product) | ArticleName | 0-100 |
Invoice row quantity | DeliveredQuantity | 0-14, attribute => QuantityUnitCode e.g., pcs |
Invoice row description (e.g., work hour entry or product) | OrderedQuantity | 0-14, attribute => QuantityUnitCode e.g., pcs |
Invoice row unit price | UnitPriceAmount | 1-22, attribute => AmountCurrencyIdentifier |
and attribute => UnitPriceUnitCode e.g., pcs | ||
Used if invoice row description exceeds 100 characters | RowFreeText | 0-512 (if the name is longer, it is split into multiple lines) |
Invoice row VAT percentage | RowVatRatePercent | 1-7 |
Invoice row VAT amount | RowVatAmount | 1-22, attribute => AmountCurrencyIdentifier |
Invoice row total excluding VAT | RowVatExcludedAmount | 1-22, attribute => AmountCurrencyIdentifier |
Invoice row total including VAT | RowAmount | 1-22, attribute => AmountCurrencyIdentifier |
Invoice date | EpiDate | 8, attribute => Format=CCYYMMDD |
Invoice reference number | EpiReference | 0-35 |