E Invoicing

Introduction

e-invoicing is rapidly being adopted in many jurisdictions. Invoice Ninja has supported UBL format invoices for some time and now we also support a range of e-invoice formats including direct delivery of e-invoices over the PEPPOL network.

All of the supported e-invoice standards can be downloaded directly after creating a standard invoice in Invoice Ninja. In some jurisdictions you are able to forward the e-invoice directly to your customer, however in some regions (ie, Italy) the invoice is sent through the government and then forwarded onto the customer. This introduces a number of complexities including both parties being registered with the government body (SDI for Italy). If you are in one of these jurisdictions, you will need to start the process (if you have not already) in acquiring a government routing ID.

e-invoice standards

The list of supported e-invoice formats include:

PEPPOL

ALPHA RELEASE - NOT FOR PRODUCTION USE

How does it work?

Invoice Ninja will be rolling out a PEPPOL access point which will be available for both self hosted and hosted users to route their e-invoices through the PEPPOL network.

How do I get started?

All users

Each particular jurisdiction has a specific set of fields which MUST be populated in order for an e-invoice to be validated. For example, in Germany a Payment Means field is required within the e-invoice. What is this? This is the sending parties paymnet details, ie IBAN + financial account meta data such as bank, FIB etc. Without this data the e-invoice cannot be generated or sent. As you onboard through the application you will have the opportunity to validate your data to ensure delivery of your e-invoices.

Hosted users

We will be sending out notifications to our hosted users for the steps required for onboarding in their particular region.

Self hosted users

Self Hosted users will be proxying their e-invoices through our hosted platform. What does this mean? In order to send your e-invoices you'll need to register your service with Invoice Ninja and we will create your legal entity id for you. Your system will then route e-invoices through our system as required. For security and data privacy, the service will only ever proxy the data that is sent, we will never store the data that is sent.

How do I prepare my Invoice Ninja installation to support e-invoicing?

There are a few important considerations with e-invoicing.

  1. All taxes must be applied at the line level. Total taxes are not supported with e-invoicing
  2. If you do not charge VAT/TAX on your invoices, you still need to apply a tax code/reason ie. Cross Border exemption, seller with no VAT number etc
  3. After an invoice has been "sent" it can never be modified, instead if there are changes that need to be applied you must create a new Invoice/Credit with the changes

Can I receive e-invoices?

Yes, in an upcoming version we will also support the delivery of e-invoicing via the peppol network directly into your company.

(Self hosted users will receive these via WebHook)

Getting started checklist

Hosted Users

Self Hosted Users

Code lists / values

Payment Means Codelist 1 - Instrument not defined
2 - Automated clearing house credit
3 - Automated clearing house debit
4 - ACH demand debit reversal
5 - ACH demand credit reversal
6 - ACH demand credit
7 - ACH demand debit
8 - Hold
9 - National or regional clearing
10 - In cash
11 - ACH savings credit reversal
12 - ACH savings debit reversal
13 - ACH savings credit
14 - ACH savings debit
15 - Bookentry credit
16 - Bookentry debit
17 - ACH demand cash concentration/disbursement (CCD) credit
18 - ACH demand cash concentration/disbursement (CCD) debit
19 - ACH demand corporate trade payment (CTP) credit
20 - Cheque
21 - Banker\'s draft
22 - Certified banker\'s draft
23 - Bank cheque (issued by a banking or similar establishment)
24 - Bill of exchange awaiting acceptance
25 - Certified cheque
26 - Local cheque
27 - ACH demand corporate trade payment (CTP) debit
28 - ACH demand corporate trade exchange (CTX) credit
29 - ACH demand corporate trade exchange (CTX) debit
30 - Credit transfer
31 - Debit transfer
32 - ACH demand cash concentration/disbursement plus (CCD+) credit
33 - ACH demand cash concentration/disbursement plus (CCD+) debit
34 - ACH prearranged payment and deposit (PPD)
35 - ACH savings cash concentration/disbursement (CCD) credit
36 - ACH savings cash concentration/disbursement (CCD) debit
37 - ACH savings corporate trade payment (CTP) credit
38 - ACH savings corporate trade payment (CTP) debit
39 - ACH savings corporate trade exchange (CTX) credit
40 - ACH savings corporate trade exchange (CTX) debit
41 - ACH savings cash concentration/disbursement plus (CCD+) credit
42 - Payment to bank account
43 - ACH savings cash concentration/disbursement plus (CCD+) debit
44 - Accepted bill of exchange
45 - Referenced home-banking credit transfer
46 - Interbank debit transfer
47 - Home-banking debit transfer
48 - Bank card
49 - Direct debit
50 - Payment by postgiro
51 - FR, norme 6 97-Telereglement CFONB (French Organisation for Banking Standards) - Option A
52 - Urgent commercial payment
53 - Urgent Treasury Payment
60 - Promissory note
61 - Promissory note signed by the debtor
62 - Promissory note signed by the debtor and endorsed by a bank
63 - Promissory note signed by the debtor and endorsed by a third party
64 - Promissory note signed by a bank
65 - Promissory note signed by a bank and endorsed by another bank
66 - Promissory note signed by a third party
67 - Promissory note signed by a third party and endorsed by a bank
70 - Bill drawn by the creditor on the debtor
74 - Bill drawn by the creditor on a bank
75 - Bill drawn by the creditor, endorsed by another bank
76 - Bill drawn by the creditor on a bank and endorsed by a third party
77 - Bill drawn by the creditor on a third party
78 - Bill drawn by creditor on third party, accepted and endorsed by bank
91 - Not transferable banker\'s draft
92 - Not transferable local cheque
93 - Reference giro
94 - Urgent giro
95 - Free format giro
96 - Requested method for payment was not used
97 - Clearing between partners
ZZZ - Mutually defined

Jurisdiction specific requirements

AT - Austria

CustomerAssignedAccountID - Mandatory for GOV clients

If you are sending an e-invoice to a government body, then you must include in the object

AccountingSupplierParty > CustomerAssignedAccountID

This is the ID of the department within the government that the e-invoice will be routed to

BE - Belgium

No additional requirements, when your legal entity id is created this is automatically sync'd with HERMES

CH - Switzerland

Payment Means - Mandatory

The payment means contains information on how the seller wishes to be paid. Use the Payment Means you must have at least ONE payment means that is a Credit Transfer type

   <cac:PaymentMeans>
      <cbc:PaymentMeansCode>30</cbc:PaymentMeansCode> <!-- code from payment means code list Credit Transfer-->
      <cac:PayeeFinancialAccount>
         <cbc:ID>DE89370400440532013000</cbc:ID> <!-- IBAN CODE -->
         <cac:FinancialInstitutionBranch>
            <cbc:ID>DEUTDEMMXXX</cbc:ID> <!-- BIC CODE -->
         </cac:FinancialInstitutionBranch>
      </cac:PayeeFinancialAccount>
   </cac:PaymentMeans>

DE - Germany

Payment Means - Mandatory

The payment means contains information on how the seller wishes to be paid. Use the Payment Means list to determine the correct code required. For example, to display your bank account details the following would be required

   <cac:PaymentMeans>
      <cbc:PaymentMeansCode>30</cbc:PaymentMeansCode> <!-- code from payment means code list Credit Transfer-->
      <cac:PayeeFinancialAccount>
         <cbc:ID>DE89370400440532013000</cbc:ID> <!-- IBAN CODE -->
         <cac:FinancialInstitutionBranch>
            <cbc:ID>DEUTDEMMXXX</cbc:ID> <!-- BIC CODE -->
         </cac:FinancialInstitutionBranch>
      </cac:PayeeFinancialAccount>
   </cac:PaymentMeans>

ES - Spain

*** Government registration required ***

Payment Means - Mandatory

The payment means contains information on how the seller wishes to be paid. Use the Payment Means you must have at least ONE payment means that is a Credit Transfer type

   <cac:PaymentMeans>
      <cbc:PaymentMeansCode>30</cbc:PaymentMeansCode> <!-- code from payment means code list Credit Transfer-->
      <cac:PayeeFinancialAccount>
         <cbc:ID>DE89370400440532013000</cbc:ID> <!-- IBAN CODE -->
         <cac:FinancialInstitutionBranch>
            <cbc:ID>DEUTDEMMXXX</cbc:ID> <!-- BIC CODE -->
         </cac:FinancialInstitutionBranch>
      </cac:PayeeFinancialAccount>
   </cac:PaymentMeans>

Due Date - Mandatory

The invoice MUST have a due date set.

Government bound e-invoices

If sending to a Spanish government body the property

AccountingCustomerParty > PublicIdentifiers

Must be set

FI - Finland

No special requirements

FR - France

The SIRET / 0009 identifier of the final recipient is to be included in the invoice.accountingCustomerParty.publicIdentifiers array.

IT - Italy

No special requirements

NL - Netherlands

When sending to government bodies the following property must be configured

accountingSupplierParty > party > contact >email

PL -Poland

*** Government registration required ***

RO -Romania

*** Government registration required ***

Special codes for county

The county field for a Romania address must use the ISO3166-2:RO codes, e.g. "RO-AB, RO-AR". Don’t omit the country prefix!

Special codes for city

The city field for county RO-B must be SECTOR1 - SECTOR6.

SE - Sweden

Receiver needs to be registered with Svefaktura to receive the e-invoice

ZUGFeRD

CBA PowerBoard

Enabling ZUGFeRD is as simple as enabling e-invoicing in Settings > E-Invoice, selecting the appropriate X format you wish to generate and save! As the ZUGFeRD is very comprehensive, you can also embed the einvoice within the PDF document itself, simply toggle on the Merge E-Invoice and PDF switch and then save.

** NOTE **

The ZUGFeRD standard does not accept negative valued invoices. Historically some users may have used a negative invoice to indicate a Credit Note, this is no longer possible. Instead a dedicated Credit Note should be generated with matching POSTIVE values which reflect the credit you wish to assign.

Facturae

Spanish e-invoice documents are supported and generate valid documents. these can be uploaded into the FACe system.

FatturaPA

Italian e-invoices can be generated, however as there is no connection in the SDI as yet. This format is not currently production ready.

FACT1

Romanian e-invoices can be generated, however as there is no delivery connection as yet. This format is not currently production ready.

EN16931

Standard EN16931 documents can be generated and downloaded as needed.

Want to contribute? Edit this page on GitHub!