PHPackages                             fresh-advance/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/invoice

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

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

OXID 7 Pdf Invoice Module

v5.0.2(3mo ago)4288↓100%1[1 issues](https://github.com/Fresh-Advance/Invoice/issues)[1 PRs](https://github.com/Fresh-Advance/Invoice/pulls)proprietaryPHPPHP ^8.1CI passing

Since Nov 16Pushed 2mo ago1 watchersCompare

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

READMEChangelog (10)Dependencies (17)Versions (22)Used By (0)

PDF Invoice module for OXID eShop
=================================

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

[![Development](https://github.com/Fresh-Advance/Invoice/actions/workflows/trigger.yaml/badge.svg?branch=b-7.1.x)](https://github.com/Fresh-Advance/Invoice/actions/workflows/trigger.yaml)[![Latest Version](https://camo.githubusercontent.com/63bd6624bfe5754bf3d7bf7f77af7ff83ed735c2565cc70f2671d682aa8b58d7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f46726573682d416476616e63652f496e766f6963653f6c6f676f3d636f6d706f736572266c6162656c3d6c617465737426696e636c7564655f70726572656c656173657326636f6c6f723d6f72616e6765)](https://packagist.org/packages/Fresh-Advance/Invoice)[![PHP Version](https://camo.githubusercontent.com/458ee9af8597c081d15370a3790fd5ee077d60b9ae00c5532042098d638e43fb/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f46726573682d416476616e63652f496e766f696365)](https://github.com/Fresh-Advance/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)

- Adjustable invoice pages margins
- Adjustable invoice pages header and footer (images are possible in inlined CSS)
- Invoice numbering automation (uses the order's oxbillnr field)
- Several fields are adjustable before invoice generation:
    - Invoice number template (or number itself, if number automation is not used)
    - Invoice date (with configurable format for automatic calculation)
    - Invoice signer person
- PDF Invoice file generated in shop Default language
    - Currently we have DE, EN and LT translations available. Feel free to add yours.
- PDF Invoice can be automatically generated and attached to user and owner order confirmation emails
    - Invoice filename format configurable through settings
- Total sum shown in words in the invoice.

Example
-------

[](#example)

[![image](https://private-user-images.githubusercontent.com/98882/502983666-f0da61be-677e-4c08-86d6-491af86969a4.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzQxNzIyNzEsIm5iZiI6MTc3NDE3MTk3MSwicGF0aCI6Ii85ODg4Mi81MDI5ODM2NjYtZjBkYTYxYmUtNjc3ZS00YzA4LTg2ZDYtNDkxYWY4Njk2OWE0LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjAzMjIlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwMzIyVDA5MzI1MVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWRjMmExM2E2NmFkN2FiZTNjYTIzZmJmNmUyYWRjNjBhMjIzNWZhMmY1MzMwZGZjZGQwYjY5ODNmZjM3Y2QzMTgmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.rsOuxnQTx2WdzzMcJ_Mk19r2sFKygJfKkA6SrYf8-I4)](https://private-user-images.githubusercontent.com/98882/502983666-f0da61be-677e-4c08-86d6-491af86969a4.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzQxNzIyNzEsIm5iZiI6MTc3NDE3MTk3MSwicGF0aCI6Ii85ODg4Mi81MDI5ODM2NjYtZjBkYTYxYmUtNjc3ZS00YzA4LTg2ZDYtNDkxYWY4Njk2OWE0LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjAzMjIlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwMzIyVDA5MzI1MVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWRjMmExM2E2NmFkN2FiZTNjYTIzZmJmNmUyYWRjNjBhMjIzNWZhMmY1MzMwZGZjZGQwYjY5ODNmZjM3Y2QzMTgmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.rsOuxnQTx2WdzzMcJ_Mk19r2sFKygJfKkA6SrYf8-I4)Limitations
-----------

[](#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-compatibility)

- Branch **b-7.1.x** is compatible with OXID Shop compilation **7.1.0 and up**
- Branch **b-7.0.x** is compatible with OXID Shop compilation **7.0.0-rc.2 and up**

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

Version compatibility
---------------------

[](#version-compatibility)

- v5.x is compatible with OXID Shop compilation 7.1.x-7.4.x [Additional Migration to v5.0 Notes](./migration/docs/4.x-to-5.x.md)
- v3.x is compatible with OXID Shop compilation 7.0.x-7.4.x

Note: Not all latest features and fixes are available in older than the last versions - always prefer the latest possible release.

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

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

- Show Vat for every product in list
- The Credit note issuing functionality
- Possibility to send generated invoice or credit note by email with button click.
- Other improvements? (feel free to ask in the Issues section for possible additional functions)

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

[](#installation)

Module is available on packagist and installable via composer

```
composer require fresh-advance/invoice
./vendor/bin/oe-eshop-doctrine_migration migrations:migrate fa_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/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
```

Overwriting the template
------------------------

[](#overwriting-the-template)

For customizing the template, start from creating the template extension in your module `views/twig/extensions/modules/fa_invoice/invoice/body.html.twig` with example content:

```
{% extends '@fa_invoice/invoice/body.html.twig' %}

{% block fa_invoice_invoice_body_order_number %}
    example overwrite
{% endblock %}
```

Next, check the original template, and overwrite the blocks you need.

### Troubles during overwrite?

[](#troubles-during-overwrite)

If overwrite doesnt work: first, clear the cache; second, might be the issue with module loading order. If so, create the file `var/configuration/shops/1/template_extension_chain.yaml` with content:

```
'@fa_invoice/invoice/body.html.twig':
  - oe_moduletemplate(please put your module id instead of the module template example)
```

### More information you might need for the template

[](#more-information-you-might-need-for-the-template)

The order variable in the template is the Order model object, so you can access all its fields and methods.

Some examples you might need for achieving the desired result:

- Customer number: {{ order.getOrderUser().getFieldData('oxcustnr') }}
- Payment method: {{ order.getPaymentType().oxpayments\_\_oxdesc.value }}
- Order net sum: {{ order.getOrderNetSum() }}

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

46

—

FairBetter than 93% of packages

Maintenance77

Regular maintenance activity

Popularity18

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 96.8% 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 ~66 days

Recently: every ~49 days

Total

18

Last Release

90d ago

Major Versions

v1.3.0 → v2.0.02023-10-07

v2.1.0 → v3.0.02024-09-26

v3.1.0 → v4.0.0-rc.12025-02-09

v4.1.0 → v5.0.0-rc.12025-06-08

PHP version history (2 changes)v1.0.0PHP ^8.0

v4.0.0-rc.1PHP ^8.1

### 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 (360 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (11 commits)")[![mariolorenz](https://avatars.githubusercontent.com/u/5525363?v=4)](https://github.com/mariolorenz "mariolorenz (1 commits)")

---

Tags

invoiceoxid-modulepdfpdfOXIDpaymentsmodulesinvoice

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

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

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

###  Alternatives

[laraveldaily/laravel-invoices

Missing invoices for Laravel

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

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

132802.5k3](/packages/atgp-factur-x)[anam/phantommagick

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

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

Library to generate PDF invoices

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

This is the PayPal module for the OXID eShop.

36510.9k2](/packages/oxid-esales-paypal-module)[oxid-esales/paymorrow-module

This is Paymorrow module for OXID eShop.

18237.9k](/packages/oxid-esales-paymorrow-module)

PHPackages © 2026

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