fresh-advance/electronic-invoice

Extension for PDF Invoice module to support electronic invoices.

v1.0.0-rc.3 2025-06-11 22:23 UTC

Requires

• php: >=8.1
• fresh-advance/invoice: ^v5.0.0
• horstoeko/zugferd: ^1.0

Requires (Dev)

• codeception/codeception: ^5.2
• codeception/module-asserts: ^3.0
• codeception/module-db: ^3.0
• codeception/module-filesystem: ^3.0
• codeception/module-webdriver: ^4.0
• mikey179/vfsstream: ~1.6.8
• oxid-esales/codeception-modules: dev-b-7.1.x
• oxid-esales/codeception-page-objects: dev-b-7.1.x
• oxid-esales/developer-tools: dev-b-7.1.x
• phpmd/phpmd: ^2.11
• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^11
• squizlabs/php_codesniffer: 3.*

Conflicts

• oxid-esales/oxideshop-ce: <7.1

proprietary

• pdf
• modules
• payments
• invoice
• OXID
• electronic-invoice
• PDF Invoice

README

Features

• Extends the PDF Invoice module to generate ZUGFeRD compliant PDF invoices

Limitations

• Only Twig shop installations supported
• 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 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

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

Installation

Module is available on packagist and installable via composer

composer require fresh-advance/electronic-invoice

Development installation

To be able running the tests and other preconfigured quality tools, please install the module as a root package.

The next section shows how to install the module as a root package by using the Fresh Advance Development Base.

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

Development installation on Fresh Advance Development Base

The installation instructions below are shown for the current Fresh Advance Development Base 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 $_

1. 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

1. Run the recipe to setup the development environment

./source/recipes/setup-development.sh

You should be able to access the shop with http://localhost.local and the admin panel with http://localhost.local/admin (credentials: [e-mail] / admin)

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

Please make sure you checked the License before using the module. License subscription can be bought on MB Arbatos Klubas website