action.skip

Electronic Invoices

DE E-Rechnung
FR e-facture

← Invoice Distribution

Understanding Electronic Invoices

When operating certain markets, your business may require to distribute electronic invoices – structured invoice data that is exchanged electronically between trading partners in order to automate accounts payable processing.

In particular, public institutions in the EU and, to an increasing extent, enterprises are required to accept and process electronic invoices. A set of common specifications and standards (Peppol) provides for interoperability between issuers and recipients across Europe.

E-Invoice Support in JustOn

Note

Be aware of the following preconditions:

  • To prevent data incompatibility issues and be up to date with the latest e-invoice requirements, creating and distributing e-invoices always requires the newest JustOn Billing & Invoice Management version.

  • Creating and distributing e-invoices involves Salesforce API access and therefore requires at least the Salesforce Enterprise Edition.

To support enterprise and public e-invoicing, JustOn Billing & Invoice Management can prepare electronic invoices and credits. Currently, it supports the following formats:

Businesses can

  • send e-invoice XML files to the Peppol Network, from where the e-invoices will be distributed to their recipients, or
  • just create e-invoice XML files and send these documents to their recipients via an invoice submission portal or email.

For information on inbound e-invoices, see Expenses From Electronic Invoices.

Info

Prior to creating and distributing e-invoices, make sure to contact JustOn Support for your e-invoice onboarding. To this end, file a corresponding ticket in the JustOn Support Portal.

Be aware that if you want to send e-invoices via Peppol, your organization must contract with JustOn for this service and request the technical activation via JustOn Support.

E-Invoice FAQ E-Invoice in Germany – A Guideline DE Configuration: Enabling E-Invoicing

E-Invoice Distribution via Peppol

JustOn Billing & Invoice Management allows distributing electronic invoices via the Peppol Network. This is an infrastructure for exchanging electronic documents, where a set of common specifications and standards provides for interoperability between issuers and recipients across Europe.

Once set up, JustOn Billing & Invoice Management creates legally valid XRechnung files and sends them to the Peppol Network. Peppol will transfer the e-invoices to the recipients and send notifications about the distribution status.

peppol
Distributing invoices through Peppol

E-Invoice Workflows

JustOn Billing & Invoice Management supports the following e-invoice scenarios:

(1) The user finalizes an invoice that meets the e-invoice preconditions and clicks Send E-Invoice.

(2) JustOn Billing & Invoice Management prepares the e-invoice XML file (einvoice_<invoice-date>_<invoice-number>_<format-specifier>) and validates it.

(3) On successful validation, JustOn Billing & Invoice Management saves the e-invoice XML file as an attachment to the invoice record and shows the Send dialog.

In case of validation failures, JustOn Billing & Invoice Management writes an error summary to the E-Invoice Error field and attaches a complete HTML error report (einvoice_<invoice-date>_<invoice-number>_<einvoice-format>_validation_report) to the invoice record.

(4) The user clicks Send. If necessary, the user can modify the recipient address (and scheme). JustOn Billing & Invoice Management transfers the e-invoice file to the Peppol Network for distribution (E-Invoice Provider Status is Queued).

xrechnung_workflow

(5) Peppol will transfer the e-invoices to the recipients and send notifications about the distribution status, which is stored in the E-Invoice Provider Status field on the invoice and related Peppol Notification records. Once the e-invoice is successfully sent to the recipient, the E-Invoice Provider Status will be Sent.

(1) The use selects the intended e-invoice format via the E-Invoice Format field on the invoice.

(2) The user invokes the e-invoice generation for an invoice, clicking Create E-Invoice.

(3) JustOn Billing & Invoice Management prepares the e-invoice XML file (einvoice_<invoice-date>_<invoice-number>_<format-specifier>) and validates it.

(4) On successful validation, JustOn Billing & Invoice Management saves the e-invoice XML file as an attachment to the invoice record.

In case of validation failures, JustOn Billing & Invoice Management writes an error summary to the E-Invoice Error field and attaches a complete HTML error report (einvoice_<invoice-date>_<invoice-number>_<einvoice-format>_validation_report) to the invoice record.

During creation, all previously attached e-invoice specific files with the prefix einvoice_<invoice-date>_<invoice-number>_ will be deleted.

xrechnung_workflow

(5) The user sends the produced e-invoice XML file to the recipient.

E-Invoice Implementation Details

JustOn Billing & Invoice Management acts as the "user interface" for managing e-invoices and controls the data management. However, significant parts of the business logic to produce e-invoices, including the validation, run on the Heroku-based platform.

To support the Peppol BIS Billing and the XRechnung formats and the distribution via the Peppol Network, JustOn Billing & Invoice Management adds a number of fields to the relevant objects Invoice and Invoice Line Item as well as to the custom settings Business Entity, Quantity Units and Tax Rules.

New fields on Invoice
Field Description
Buyer Reference A unique identification of the invoice recipient.
When doing business with German public authorities (B2G scenarios), the buyer reference usually holds the Leitweg-ID (see ZFB | eRechnung).
E-Invoice Distribution Channel The distribution channel for the e-invoice.
Can be E-Mail or Peppol.
E-Invoice Error Holds details regarding errors during e-invoice generation.
E-Invoice Provider Status Tracks the lifecycle of the e-invoice with the distribution provider, see E-Invoice Provider Status.
E-Invoice Provider Messages Holds details regarding the status in the provider queue, a JSON string including timestamp and message set by the provider.
E-Invoice Recipient Address The recipient address for an issued electronic invoice.
Addresses are subject to the Electronic Address Scheme.
When creating e-invoices in the Peppol BIS Billing format or when distributing e-invoices via the Peppol network, only a limited set of address schemes is allowed.
E-Invoice Recipient Scheme Id The identifier that indicates the type of the used e-invoice recipient address.
E-Invoice Status Indicates the result of the e-invoice creation, see E-Invoice Status.
Purchase Order No. Reference to the purchase order on which the invoice is based (see Purchase-Related Information).
Is usually given by the buyer to track the purchase in their system; retrieved from a source record ( contract) and set on the invoice on invoice creation.
Seller ID An identifier of the seller (see Purchase-Related Information).
Is usually given by the buyer to track the vendor in their system; retrieved from a source record ( contract) and set on the invoice on invoice creation.
VAT Breakdown The serialized contents (JSON) of the tax breakdown table.
Is updated when invoice line items are modified.
New fields on Invoice Line Item
Field Description
Unit Code A code for the measurement unit applicable to the invoiced quantity, is copied from Code on the Quantity Units custom setting.
The code is expected to be one of the codes listed in UNECE Recommendation No. 20 "Codes for Units of Measure Used in International Trade" or UNECE Recommendation No 21 "Codes for Passengers, Types of Cargo, Packages and Packaging Materials", see UNECE Code List Recommendations.
VAT Category Code A code for categorizing VAT regulations, is copied from VAT Category Code on the Tax Rules custom setting.
The code is expected to be one of the codes listed in the code list 5305 of the United Trade Data Interchange Directory (UNTDID), see UNTDID 5305 Duty or tax or fee category code.
New Fields on Business Entity
Field Description
E-Invoice Format The target format for electronic invoices.
Currently, Peppol BIS Billing UBL and XRechnung UBL are supported.
E-Invoice Sender Address The return address for replies to an issued electronic invoice.
Addresses are subject to the Electronic Address Scheme.
When creating e-invoices in the Peppol BIS Billing format or when distributing e-invoices via the Peppol network, only a limited set of address schemes is allowed.
E-Invoice Sender Scheme Id The identifier that indicates the type of the used e-invoice sender address.
New field on Quantity Units
Field Description
Code A code for the measurement unit applicable to the invoiced quantity, is copied to Unit Code on the invoice line item.
The code is expected to be one of the codes listed in UNECE Recommendation No. 20 "Codes for Units of Measure Used in International Trade" or UNECE Recommendation No 21 "Codes for Passengers, Types of Cargo, Packages and Packaging Materials", see UNECE Code List Recommendations.
New field on Tax Rules
Field Description
VAT Category Code A code for categorizing VAT regulations, is copied to VAT Category Code on the invoice line item.
The code is expected to be one of the codes listed in the code list 5305 of the United Trade Data Interchange Directory (UNTDID), see UNTDID 5305 Duty or tax or fee category code.

E-Invoice Formats

JustOn Billing & Invoice Management supports the following e-invoice formats:

  • Peppol BIS Billing (with UBL syntax) for electronic invoicing across Europe
  • XRechnung (with UBL syntax) for electronic invoicing within Germany

JustOn Billing & Invoice Management determines the e-invoice format as follows:

ON_EInvoiceFormat on the invoice source record
↳ E-Invoice Format on the related business entity
     ↳ Billing Country Code on the invoice and Country Code on the business entity

(1) Your org can make use of the ON field mechanism: set the field ON_EInvoiceFormat on the invoice source records to have the e-invoice format set on invoice creation.

(2) Without a dedicated ON field, JustOn Billing & Invoice Management checks the field E-Invoice Format on the related business entity. If it is set, the software uses the specified value on invoice creation.

(3) Without an e-invoice format setting via ON field or the business entity, JustOn Billing & Invoice Management determines the best matching format evaluating the fields Billing Country Code on the invoice and Country Code on the business entity. If the two fields specify DE, the software assumes that the business takes place in Germany, so it applies XRechnung UBL. Otherwise, the software assumes that the business involves other countries, so it uses the value Peppol BIS Billing UBL.

Info

Users can, however, manually change the target e-invoice format when creating the e-invoice XML file.

E-Invoice Statuses

E-Invoice Status

The field E-Invoice Status on the invoice indicates the result of the e-invoice creation:

Status Description
Not created Indicates invoices that have not been processed to create an e-invoice file.
Validation Error The e-invoice validation has failed. The validation report is attached to the invoice record.
Created The e-invoice has been successfully created and validated. The e-invoice XML file is attached to the invoice record.
Created With Warnings The e-invoice has been successfully created, but the validation has produced warnings. The e-invoice XML file and the validation report are attached to the invoice record.
Distribution Error Transferring the e-invoice to the distribution provider has failed.
In Peppol Queue The e-invoice has been successfully transferred to the distribution provider.

Info

Using the global settings option Ignore EInvoice Validation Warnings, JustOn Billing & Invoice Management will ignore validation warnings and set E-Invoice Status to Created, even if the validation has produced warnings. Consequently, no validation report will be attached to the invoice record.

E-Invoice Provider Status

The field E-Invoice Provider Status on the invoice tracks the lifecycle of the e-invoice with the distribution provider:

Status Description
Queued The e-invoice is ready to be sent to the recipient.
Validation Error The e-invoice validation has failed.
Conversion Error The e-invoice conversion (to a specific recipient format) has failed.
Send Error Sending the e-invoice to the recipient has failed.
Sent The e-invoice has been sent to the recipient.
Receiver Error Receiving the e-invoice by the recipient has failed.
Received The e-invoice has been received by the recipient.

Peppol Notifications

As Peppol transfers the e-invoices to the recipients, the sender will receive notifications about the distribution status. JustOn Billing & Invoice Management stores this information in dedicated Peppol Notification records, which are related to the original invoice.

These provider messages include the following information:

Field Description
Invoice Links to the related invoice
Timestamp Shows the notification time
Type Shows the type of the notification as provided by Peppol. Possible values include
Stage-Update: new processing step has started
Stage-Success: processing step has successfully completed
Error: error on processing
Stage Indicates the processing step of the invoice in the Peppol processing pipeline as provided by Peppol. Possible values include Validation, Conversion, Transmission, Reception
Is final Indicates whether the Peppol processing pipeline is completed and no more notifications are expected
Message Shows the key message of the notification as provided by Peppol, for example Transmission of your document was successful
Raw Notification Contains the raw response (JSON string map) from Peppol

E-Invoice Preconditions

Part of the business logic to produce e-invoices runs on the Heroku-based platform. So from a technical perspective, creating e-invoices requires the user to have access to the connected app JustOn Platform.

With respect to data, the following conditions must be met for JustOn Billing & Invoice Management to successfully create an e-invoice XML file. For details, see Preparing E-Invoice Source Data.

Invoice Status

The invoice must be finalized before creating or sending an e-invoice. That is, its status must not be Draft, Pre-Draft, Pre-Open.

Business Entity

The invoice must specify a business entity. To avoid typos, use the button Set Business Entity, see Setting Business Entity.

Buyer Reference

In addition, the invoice must specify a buyer reference – a unique identification of the invoice recipient.

  • When doing business with German public authorities (B2G scenarios), the buyer reference usually holds the Leitweg-ID (a unique identification of the invoice recipient, see ZFB | eRechnung).
  • In B2B scenarios, you need to agree on a buyer reference with your business partner.

Unit and Unit Code

The invoice line item must specify a unit defined using the custom setting Quantity Units.

The quantity unit must define a code for the measurement unit applicable to the quantity. The code is expected to be one of the codes listed in UNECE Recommendation No. 20 "Codes for Units of Measure Used in International Trade" or UNECE Recommendation No 21 "Codes for Passengers, Types of Cargo, Packages and Packaging Materials", see UNECE Code List Recommendations.

Typical unit codes include, for example:

Measurement Unit Unit Code
Piece H87
Hour HUR
Month MON
Kilowatt Hour KWH
(Page) Impression IM
Persons IE
Kilometre KMT

Tax Rate

The invoice line item must specify a tax rate defined using the custom setting Tax Rules.

The tax rule must define the tax rate, the business entity and the VAT Category Code. This is a code for categorizing VAT regulations, which is necessary for e-invoices. The code is expected to be one of the codes listed in the code list 5305 of the United Trade Data Interchange Directory (UNTDID), see Duty or tax or fee category code (Subset of UNCL5305).

Typical VAT category codes for businesses in Europe include:

Name VAT Category Code
Standard rate and reduced rate S
Exempt from tax E
Zero rated goods Z
VAT reverse charge AE
Free export, no tax G
Services outside scope of tax O
Intra-community supply K
Canary Islands tax L
Ceuta and Melilla tax M

Info

This information does not constitute any legally effective tax advice. JustOn cannot and must not provide such services. For any detailed questions, contact your tax consultant.

For businesses in Germany, you can consult the XRechnung specification (section 12.4 VAT rules) for information on applicable rules.

E-Invoice Address and Scheme

Organizations that send or receive electronic invoices must have a unique e-invoice address, which is codified using a specific address scheme identifier. Generally, e-invoice addresses are subject to the Electronic Address Scheme defined by the European Union.

When creating e-invoices in the Peppol BIS Billing format or when participating in the Peppol Network (as both sender and recipient), however, only a limited set of address schemes is allowed (see Electronic Address Scheme (EAS) in the Peppol documentation).

The e-invoice sender information must be specified in the relevant business entity's fields E-Invoice Sender Address and E-Invoice Sender Scheme Id. The e-invoice recipient information must be specified in the relevant invoice's fields E-Invoice Recipient Address and E-Invoice Recipient Scheme Id.

Example e-invoice address types include:

Electronic Address Scheme Example Value Corresponding Scheme ID
German VAT number DE123456789 9930
German Leitweg ID 04011000-1234512345-06 0204
French VAT number FR12345678901 9957
French SIREN code 732829320 0002
French SIRET code 732829320 00074 0009

The Peppol Directory lists the participants in the Peppol network. It allows for searching entities by name, address, ID or combinations thereof.

Required Fields

Make sure, in addition, that the following fields are set:

Object Required Fields
Invoice Invoice No.
Date
Business Entity
Buyer Reference
Account Name
Billing City
Billing Postal Code
Billing Street
Billing Country Code
E-Invoice Recipient Address
E-Invoice Recipient Scheme Id
Payment Method
Invoice Line Item Sequence
Quantity
Unit
Unit Code
Unit Price
Tax Rate
Business Entity Company
Tax ID
City
Postal Code
Country Code
Phone
Email Sender
IBAN
E-Invoice Sender Address
E-Invoice Sender Scheme Id

The country code must be provided using the ALPHA-2 notation as specified in ISO-3166-1, see ISO 3166-1:Alpha2 Country codes in the Peppol documentation.

The payment method is not mandatory for producing valid e-invoice files. However, JustOn recommends to specify a payment method so that the e-invoice recipient receives any necessary payment details. Be aware that if you use the payment method SEPA, you must provide the required IBAN (either using RequestedPaymentInstrument when integrating with JustOn Cash Management, using a payment instrument in JustOn Billing & Invoice Management, or directly from the Bank Account field on the invoice).

Plain Text for Information Texts

The invoice includes a number of text fields that can hold explanatory information related to certain invoice data. For PDF output, the text can contain HTML markup. For e-invoice XML files, however, HTML is not allowed. This is why these fields exist in two versions: one for HTML/rich text and one for plain text.

HTML-Capable Field Plain Text Field
Payment Info Payment Info (Plain Text)
Text 1 Text 1 (Plain Text)

JustOn Billing & Invoice Management retrieves the texts from the corresponding template fields on invoice finalization (or when users manually copy the template text). This fills the invoice fields accordingly: the complete information, including HTML markup, is inserted in the appropriate fields, and the same information without HTML is inserted in the plain text fields.

Consequently, JustOn Billing & Invoice Management uses

  • the values in the HTML-capable fields for rendering the PDF files
  • the values in the plain text files for creating the e-invoice XML files.

E-Invoice Data Mapping

The following table lists the e-invoice fields that JustOn Billing & Invoice Management sets by default in Peppol BIS Billing and XRechnung files (see E-Invoice Formats), as well as their corresponding source objects and fields.

Info

Be aware that specific use cases may require additional information, which you will then have to provide in corresponding fields.

ID E-Invoice Target Area Data Source
Object > Field
BT-1 Invoice Number General Invoice > Invoice No
BT-2 Invoice Issue Date General Invoice > Date
BT-9 Payment Due Date General Invoice > Payment Due Date
BT-10 Buyer Reference General Invoice > Buyer Reference
BT-13 Purchase Order Reference General Invoice > Purchase Order No
BT-20 Payment Terms General Invoice > Payment Info
BT-22 Invoice Note General Invoice > Text 1
BT-25 Preceding Invoice Reference General Invoice > Related With
BT-27 Seller Name Seller identification Business Entity > Company
BT-29 Seller Identifier Seller identification Invoice > Seller Id
BT-30 Seller Legal Registration Identifier Seller identification Business Entity > E-Invoice Sender Legal Identifier
BT-30-1 Seller Legal Registration Identifier Identification Scheme Identifier Seller identification Business Entity > E-Invoice Sender Legal ID Scheme
BT-31 Seller VAT Identifier Seller identification Business Entity > Tax ID
BT-34 Seller Electronic Address Seller identification Business Entity > E-Invoice Sender Address
BT-34-1 Seller Electronic Address Identification Scheme Identifier Seller identification Business Entity > E-Invoice Sender Scheme Id
BT-35 Seller address Line 1 Seller address Business Entity > Street
BT-37 Seller City Seller address Business Entity > City
BT-38 Seller Post Code Seller address Business Entity > Postal Code
BT-39 Seller Country Subdivision Seller address Business Entity > State Code
BT-40 Seller Country Code Seller address Business Entity > Country Code
BT-41 Seller Contact Point Seller address Business Entity > Company
BT-42 Seller Contact Telephone Number Seller address Business Entity > Phone
BT-43 Seller Contact Email Address Seller address Business Entity > Email Sender
BT-44 Buyer Name Buyer identification Invoice > Account Name
BT-47 Buyer Legal Registration Identifier Buyer identification Invoice > E-Invoice Recipient Legal Identifier
BT-47-1 Buyer Legal Registration Identifier Identification Scheme Identifier Buyer identification Invoice > E-Invoice Recipient Legal ID Scheme
BT-48 Buyer VAT Identifier Buyer identification
  1. Account > ON_VATNumber
  2. Account > VATIN
BT-49 Buyer Electronic Address Buyer identification Invoice > E-Invoice Recipient Address
BT-49-1 Buyer Electronic Address Identification Scheme Identifier Buyer identification Invoice > E-Invoice Recipient Scheme Id
BT-50 Buyer address Line 1 Buyer address Invoice > Billing Street
BT-52 Buyer City Buyer address Invoice > Billing City
BT-53 Buyer Post Code Buyer address Invoice > Billing PostalCode
BT-54 Buyer Country Subdivision Buyer address Invoice > Billing State
BT-55 Buyer Country Code Buyer address Invoice > Billing CountryCode
BT-56 Buyer Contact Point Buyer address Invoice > Contact > Name
BT-57 Buyer Contact Telephone Number Buyer address Invoice > Contact > Phone
BT-58 Buyer Contact Email Adress Buyer address Invoice > Contact > Email
BT-73 Invoicing Period Start Date Invoice period Invoice > Service Period Start
BT-74 Invoicing Period End Date Invoice period Invoice > Service Period End
BT-75 Deliver to Address Line 1 Shipping address Invoice > Shipping Street
BT-77 Deliver to City Shipping address Invoice > Shipping City
BT-78 Deliver to Post Code Shipping address Invoice > Shipping Postal Code
BT-79 Deliver to Country Subdivision Shipping address Invoice > Shipping State Code
BT-80 Deliver to Country Code Shipping address Invoice > Shipping Country Code
BT-82 Payment Means Text Payment information Invoice > Payment Method
BT-83 Remittance Information Payment information Invoice > Payment Reference
BT-84 Payment Account Identifier Payment information Business Entity > IBAN
BT-89 Mandate Reference Identifier Payment information Invoice > Direct Debit Mandate Reference
BT-90 Bank Assigned Creditor Identifier Payment information Business Entity > SEPA Creditor ID
BT-91 Debited Account Identifier Payment information
  1. Invoice > Requested Payment Instrument > IBAN
  2. Invoice > Account > Current SEPA Mandate > IBAN
  3. Invoice > Bank Account
BT-106 Sum of Invoice Line Net Amount Invoice totals Invoice > Total (net)
BT-109 Invoice Total Amount Without VAT Invoice totals Invoice > Total (net)
BT-110 Invoice Total VAT Amount Invoice totals Invoice > Total (tax)
BT-112 Invoice Total Amount With VAT Invoice totals Invoice > Grand Total
BT-113 Paid Amount Invoice totals Invoice > Balance Difference
BT-115 Amount Due for Payment Invoice totals Invoice > Balance
BT-122 Supporting Document Reference General Content Document > Title
BT-123 Supporting Document Description General Content Document > Description
BT-126 Invoice Line Identifier Invoice line item information Invoice Line Item > Sequence
BT-127 Invoice Line Note Invoice line item information Invoice Line Item > Title + Description
BT-129 Invoiced Quantity Invoice line item information Invoice Line Item > Display Quantity
BT-130 Invoiced Quantity Unit of Measure Invoice line item information Invoice Line Item > Unit Code
BT-131 Invoice Line Net Amount Invoice line item information Invoice Line Item > Pos. Total (net)
BT-134 Invoice Line Period Start Date Invoice line item period Invoice Line Item > Service Period Start
BT-135 Invoice Line Period End Date Invoice line item period Invoice Line Item > Service Period End
BT-136 Invoice Line Allowance Amount Invoice line item discount Invoice Line Item > Calculated Net Discount
BT-151 Invoiced Item VAT Category Code Invoice line item information Invoice Line Item > VAT Category Code
BT-152 Invoiced Item VAT Rate Invoice line item information Invoice Line Item > Tax Rate
BT-153 Item Name Invoice line item information Invoice Line Item > Title
BT-154 Item Description Invoice line item information Invoice Line Item > Description