PHPackages                             fresh-advance/electronic-invoice - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. fresh-advance/electronic-invoice

ActiveOxideshop-module[Payment Processing](/categories/payments)

fresh-advance/electronic-invoice
================================

Extension for PDF Invoice module to support electronic invoices.

v1.0.2(5mo ago)14[2 PRs](https://github.com/Fresh-Advance/Electronic-Invoice/pulls)proprietaryPHPPHP &gt;=8.1CI failing

Since Jun 8Pushed 5mo agoCompare

[ Source](https://github.com/Fresh-Advance/Electronic-Invoice)[ Packagist](https://packagist.org/packages/fresh-advance/electronic-invoice)[ RSS](/packages/fresh-advance-electronic-invoice/feed)WikiDiscussions b-7.1.x Synced 1mo ago

READMEChangelog (3)Dependencies (15)Versions (14)Used By (0)

Electronic Invoice module for OXID eShop
========================================

[](#electronic-invoice-module-for-oxid-eshop)

[![Development](https://github.com/Fresh-Advance/Electronic-Invoice/actions/workflows/trigger.yaml/badge.svg?branch=b-7.1.x)](https://github.com/Fresh-Advance/Electronic-Invoice/actions/workflows/trigger.yaml)[![Latest Version](https://camo.githubusercontent.com/c963cd267872fdac9327c2b6fa242a9ef0ce781bfac828fa53a4b401c89200d2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f46726573682d416476616e63652f456c656374726f6e69632d496e766f6963653f6c6f676f3d636f6d706f736572266c6162656c3d6c617465737426696e636c7564655f70726572656c656173657326636f6c6f723d6f72616e6765)](https://packagist.org/packages/Fresh-Advance/Electronic-Invoice)[![PHP Version](https://camo.githubusercontent.com/7a667b5a970d1bd29a9ca4340d411ec260225784f27081cdf146585ee9968bf8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f46726573682d416476616e63652f456c656374726f6e69632d496e766f696365)](https://github.com/Fresh-Advance/Electronic-Invoice)

[![Quality Gate Status](https://camo.githubusercontent.com/7b6d3b3b5dbee10341487e086a6a63a6a65e37367ef196edf19fe7dbcef158d5/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d46726573682d416476616e63655f496e766f696365266d65747269633d616c6572745f737461747573)](https://sonarcloud.io/dashboard?id=Fresh-Advance_Invoice)[![Coverage](https://camo.githubusercontent.com/4d39a569d74f24fcee1e89bcae5cba659545395636c42b6701ebdcd008f82a40/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d46726573682d416476616e63655f496e766f696365266d65747269633d636f766572616765)](https://sonarcloud.io/dashboard?id=Fresh-Advance_Invoice)[![Technical Debt](https://camo.githubusercontent.com/cdb275e5ab72fca5ed7079487d307af1730b95bd517d10b027148c761365aab3/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d46726573682d416476616e63655f496e766f696365266d65747269633d7371616c655f696e646578)](https://sonarcloud.io/dashboard?id=Fresh-Advance_Invoice)

Features
--------

[](#features)

- Extends the [PDF Invoice module](https://github.com/Fresh-Advance/Invoice) to generate ZUGFeRD compliant PDF invoices

[![image](https://private-user-images.githubusercontent.com/98882/502985677-1867d8a5-a7ad-4b0d-a7c5-2ec2c176fb5c.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzU0NzAzOTEsIm5iZiI6MTc3NTQ3MDA5MSwicGF0aCI6Ii85ODg4Mi81MDI5ODU2NzctMTg2N2Q4YTUtYTdhZC00YjBkLWE3YzUtMmVjMmMxNzZmYjVjLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA0MDYlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNDA2VDEwMDgxMVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTkxNjVhYjYxMTE1NjI5NjBkNDI0OGI0MjI0YzVhYmEzODdkZGZkZWQwZjNkMGU1NjU1YzgwMWUyMGJhYzhiYjkmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.wMmw28RAYVZaf-zqYgjDXproseO9ovVfT8x78xs8DT8)](https://private-user-images.githubusercontent.com/98882/502985677-1867d8a5-a7ad-4b0d-a7c5-2ec2c176fb5c.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzU0NzAzOTEsIm5iZiI6MTc3NTQ3MDA5MSwicGF0aCI6Ii85ODg4Mi81MDI5ODU2NzctMTg2N2Q4YTUtYTdhZC00YjBkLWE3YzUtMmVjMmMxNzZmYjVjLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA0MDYlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNDA2VDEwMDgxMVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTkxNjVhYjYxMTE1NjI5NjBkNDI0OGI0MjI0YzVhYmEzODdkZGZkZWQwZjNkMGU1NjU1YzgwMWUyMGJhYzhiYjkmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.wMmw28RAYVZaf-zqYgjDXproseO9ovVfT8x78xs8DT8)[![image](https://private-user-images.githubusercontent.com/98882/502985633-62c355f2-7817-43ce-9cca-335e4b08731f.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzU0NzAzOTEsIm5iZiI6MTc3NTQ3MDA5MSwicGF0aCI6Ii85ODg4Mi81MDI5ODU2MzMtNjJjMzU1ZjItNzgxNy00M2NlLTljY2EtMzM1ZTRiMDg3MzFmLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA0MDYlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNDA2VDEwMDgxMVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWYzNzBlNDQ3OWE3MGVjNDJlM2Y1Zjc4ZGVkOGQyYmFkYmE4YmU2YzQ5ZDg4ZGNlYTdhZTQ4MjUxYmVlYzQ5ZjgmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.eqM29aFVVOw_OwZlBiVHB0FtUC25oRPAbpB6Yt1g6Ic)](https://private-user-images.githubusercontent.com/98882/502985633-62c355f2-7817-43ce-9cca-335e4b08731f.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzU0NzAzOTEsIm5iZiI6MTc3NTQ3MDA5MSwicGF0aCI6Ii85ODg4Mi81MDI5ODU2MzMtNjJjMzU1ZjItNzgxNy00M2NlLTljY2EtMzM1ZTRiMDg3MzFmLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA0MDYlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNDA2VDEwMDgxMVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWYzNzBlNDQ3OWE3MGVjNDJlM2Y1Zjc4ZGVkOGQyYmFkYmE4YmU2YzQ5ZDg4ZGNlYTdhZTQ4MjUxYmVlYzQ5ZjgmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.eqM29aFVVOw_OwZlBiVHB0FtUC25oRPAbpB6Yt1g6Ic)Requirements
------------

[](#requirements)

Please read this section carefully before using the module. Everything here is very important to make the invoice valid.

- The [PDF Invoice Module](https://github.com/Fresh-Advance/Invoice) is required to be installed and active
- Seller information is taken from the shop information settings (**Master Settings -&gt; Core Settings**) and should be filled in correctly
    - Company Name
    - **Tax number (Valid Tax ID)**
    - **VAT number (Valid Sales Tax ID)**
    - Company address (Street, City, ZIP).
    - Responsible person information (Name, Surnname, Phone, Fax, Email - info email in settings)
    - Email (info email in settings)
- **The country ISO2 code should be configured in the Electronic Invoice module settings**
- The invoice will be valid only if your Net and VAT totals are correct (item lines should sum up to correct totals)
    - The default shop functionality may lead to not matching totals in some cases.
    - The module which changes how the total VAT is calculated might help -

Limitations
-----------

[](#limitations)

- Tested with:
    - Shop 7.1 - PHP 8.1, 8.2, MySQL 5.7 and 8.0
    - Shop 7.2 - PHP 8.2, 8.3, MySQL 5.7 and 8.0

Branch compatibility
--------------------

[](#branch-compatibility)

- Branch b-7.1.x is compatible with OXID Shop compilation 7.1.0 and up

Note: Not all latest features are available in the older branches.

What to expect in next versions
-------------------------------

[](#what-to-expect-in-next-versions)

- Factur-X support
- Possibility to create electronic invoice as a separate document

Installation
------------

[](#installation)

Module is available on packagist and installable via composer

```
composer require fresh-advance/electronic-invoice

```

Development installation
========================

[](#development-installation)

To be able running the tests and other preconfigured quality tools, please install the module as a [root package](https://getcomposer.org/doc/04-schema.md#root-package).

The next section shows how to install the module as a root package by using the [Fresh Advance Development Base](https://github.com/Fresh-Advance/development).

In case of different environment usage, please adjust by your own needs.

Development installation on Fresh Advance Development Base
==========================================================

[](#development-installation-on-fresh-advance-development-base)

The installation instructions below are shown for the current [Fresh Advance Development Base](https://github.com/Fresh-Advance/development)for shop 7.1. Make sure your system meets the requirements of the Development Base.

1. Ensure all docker containers are down to avoid port conflicts
2. Clone the SDK for the new project

```
echo MyProject && git clone https://github.com/Fresh-Advance/development.git $_ && cd $_
```

2. Clone the repository to the source directory

```
git clone --recurse-submodules https://github.com/Fresh-Advance/Electronic-Invoice.git --branch=b-7.1.x ./source
```

3. Run the recipe to setup the development environment

```
./source/recipes/setup-development.sh
```

You should be able to access the shop with  and the admin panel with (credentials:  / admin)

### Running the tests and quality tools

[](#running-the-tests-and-quality-tools)

Check the "scripts" section in the `composer.json` file for the available commands. Those commands can be executed by connecting to the php container and running the command from there, example:

```
make php
composer tests-coverage
```

Commands can be also triggered directly on the container with docker compose, example:

```
docker compose exec -T php composer tests-coverage
```

License
-------

[](#license)

Please ensure that you have reviewed the licensing requirements before using this module. License subscriptions are available for purchase through the [Fresh Advance website](https://freshadvance.eu/).

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance73

Regular maintenance activity

Popularity5

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~20 days

Recently: every ~31 days

Total

10

Last Release

155d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/cf25d2c148579fed45c9fcaa19c3de35a750fa774812fbb5c30149f42f470215?d=identicon)[sieg](/maintainers/sieg)

---

Top Contributors

[![Sieg](https://avatars.githubusercontent.com/u/98882?v=4)](https://github.com/Sieg "Sieg (42 commits)")

---

Tags

pdfOXIDpaymentsmodulesinvoiceelectronic invoicepdf-invoice

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/fresh-advance-electronic-invoice/health.svg)

```
[![Health](https://phpackages.com/badges/fresh-advance-electronic-invoice/health.svg)](https://phpackages.com/packages/fresh-advance-electronic-invoice)
```

###  Alternatives

[laraveldaily/laravel-invoices

Missing invoices for Laravel

1.5k1.3M4](/packages/laraveldaily-laravel-invoices)[atgp/factur-x

PHP library to manage your Factur-X / ZUGFeRD 2.0 PDF invoices files

138825.5k3](/packages/atgp-factur-x)[num-num/ubl-invoice

A modern object-oriented PHP library to create and read valid UBL and EN 16931/Peppol BIS 3.0 files

135820.5k](/packages/num-num-ubl-invoice)[anam/phantommagick

PhantomMagick provides a simple API to ease the process of converting HTML to PDF or images

161456.4k2](/packages/anam-phantommagick)[konekt/pdf-invoice

Library to generate PDF invoices

212200.7k](/packages/konekt-pdf-invoice)[oxid-esales/paypal-module

This is the PayPal module for the OXID eShop.

36513.5k2](/packages/oxid-esales-paypal-module)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
