Generate e-invoices (E-Rechnung in German) conforming to EN16931 (Factur-X/ZUGFeRD, UBL, CII, XRechnung aka X-Rechnung) from LibreOffice Calc/Excel data or JSON.
npm install @e-invoice-eu/cli
src="https://raw.githubusercontent.com/gflohr/e-invoice-eu/main/assets/e-invoice-eu-logo-2.webp"
width="256" height="256" />







Generate e-invoices (E-Rechnung in German) conforming to EN16931 (Factur-X/ZUGFeRD, UBL, CII, XRechnung aka X-Rechnung) from LibreOffice Calc/Excel data or JSON.
- Description
- Features
- Documentation
- Installation
- Usage
- General
- The Command invoice
- Argument format
- Argument lang
- Argument embedPDF
- Argument pdf
- Argument data
- Argument attachments
- Getting Supported Formats
- Getting the JSON Schema Definitions
- Reporting Bugs
- Copyright
- Disclaimer
This package contains the commandline interface of @e-invoice-eu/core
installed as e-invoice-eu. It uses the E-Invoice-EU core library@e-invoice-eu/core
internally.
The program can create e-invoices in the following formats:
- Cross Industry Invoice - CII
- Universal Business Language - UBL
- Factur-X/ZUGFeRD (all profiles including XRECHNUNG) with full PDF/A support
E-Invoices can be created directly from data in the E-Invoice-EU internal
format
or via a mapping definition
from popular spreadsheet formats like .ods, .xlsx, .csv, ...
The general documentation of e-invoice-eu is available at thee-invoice-eu GitHub page.
For reference, you can also consult the
API documentation.
``sh`
npm install -g @e-invoice-eu/cli
You can test that the installation has worked with the command e-invoice-eu
--version. The output should be the version number of the installed software.
The general usage patterns are:
`sh`
e-invoice-eu COMAND [COMMAND_OPTIONS]
e-invoice-eu [GLOBAL_OPTIONS]
You can get information about the program like this:
`sh`
e-invoice-eu --help
The command invoice takes the following options and arguments:
| Name | Argument | Description |
| ----------------- | -------- | --------------------------------------------------------------------------------------------- |
| -f, --format | string | a supported format |string
| -o, --output | | write output to specified file instead of standard output |string
| -i, --invoice | | JSON file with invoice data, mandatory for invoice generation from JSON |string
| -m, --mapping | | YAML or JSON file with mapping, mandatory for invoice generation from spreadsheet data |string
| -d, --data | | invoice spreadsheet file, mandataory for invoice generation from spreadsheet data |string
| -l, --lang | | a language identifier like fr-fr |string
| --embedPDF | | use if a PDF version should be embedded into XML output |
| -p, --pdf | | a PDF version of the invoice |string
| --pdf-id | | ID of the embedded PDF, defaults to the document number; ignored for Factur-X/ZUGFeRD |string
| --pdf-description | | optional description of the embedded PDF; ignored for Factur-X/ZUGFeRD |string
| -a, --attachment | | optional name of an additional attachment |string
| --attachment-id | |
#### Argument format
This contains the format of the e-invoice as a case-insensitive string. You
can also use aliases. For example, Factur-X-Comfort is an alias forFactur-X-EN16931.
#### Argument lang
A language identifier like fr-fr. This is only used for the Factur-X/ZUGFeRD
formats for some canned texts in the PDF XMP meta data.
#### Argument embedPDF
This is only used for the pure XML formats (everything that is not
Factur-X/ZUGFeRD). If it has a truthy value, a PDF version of the invoice
is embedded as a base64 encoded string in the XML.
#### Argument pdf
This is required in two cases:
1. The format is a Factur-X/ZUGFeRD format and data was not specified.embedPDF
2. The format is a pure XML format, was specified and data was not specified.
#### Argument data
A spreadsheet version of the invoice. If a PDF is required, either because
embedPDF was specified for pure XML or because the format is Factur-X/ZUGFeRD,
LibreOffice is invoked for rendering the spreadsheet
as a PDF.
This feature will trigger an exception if used in the browser.
#### Argument attachments
You can specify an arbitrary number of additional attachments.
In case of the pure XML formats, they are embedded as base64 encoded strings
in the XML. In case of Factur-X/ZUGFeRD they are attached to the PDF,
additionally to the mandatory attachment factur-x.xml.
`typescript
import { FormatFactoryService } from '@e-invoice-eu/core';
const factoryService = new FormatFactoryService();
const formats = factoryService.listFormatServices();
`
In format you will find an array ofFormatInfo
objects.
`typescript`
import { invoiceSchema, mappingSchema } from '@e-invoice-eu/core';
These variables contain the schema for the
Invoice
and Mapping
interfaces. These schemas can be passed as an argument to the compile method of an Ajv instance, see https://ajv.js.org/api.html#ajv-compile-schema-object-data-any-boolean-promise-any for more information!
The schemas have the type
JSONSchemaType
and
JSONSchemaType
respectively.
Please report bugs at https://github.com/gflohr/e-invoice-eu/issues.
Copyright (C) 2024-2025 Guido Flohr
rights reserved.
This is free software available under the terms of the
WTFPL.
This free software has been written with the greatest possible care, but like
all software it may contain errors. Use at your own risk! There is no
warranty and no liability.