https://github.com/josemmo/einvoicing

Library for reading and creating European-compliant electronic invoices (EN 16931)
https://github.com/josemmo/einvoicing

eu europe invoice invoicing peppol php ubl

Last synced: about 12 hours ago
JSON representation

Library for reading and creating European-compliant electronic invoices (EN 16931)

• Host: GitHub
• URL: https://github.com/josemmo/einvoicing
• Owner: josemmo
• License: mit
• Created: 2020-07-04T14:55:54.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2024-04-04T09:42:12.000Z (9 months ago)
• Last Synced: 2024-05-02T06:03:28.383Z (8 months ago)
• Topics: eu, europe, invoice, invoicing, peppol, php, ubl
• Language: PHP
• Homepage: https://josemmo.github.io/einvoicing/
• Size: 2.73 MB
• Stars: 101
• Watchers: 13
• Forks: 28
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        


    
European Invoicing (eInvoicing)





    

    

    

    

    



## About

eInvoicing is a PHP library for creating and reading electronic invoices according to the [eInvoicing Directive and European standard](https://ec.europa.eu/digital-building-blocks/wikis/display/DIGITAL/eInvoicing).

It aims to be 100% compliant with [EN 16931](https://ec.europa.eu/digital-building-blocks/wikis/x/boTXGw) as well as with the most popular CIUS and extensions, such as [PEPPOL BIS](https://docs.peppol.eu/poacc/billing/3.0/bis/).

## Installation

First of all, make sure your environment meets the following requirements:

- PHP 7.1 or higher

- [SimpleXML extension](https://www.php.net/book.simplexml) for reading and exporting UBL/CII invoices

Then, you should be able to install this library using Composer:

```

composer require josemmo/einvoicing

```

## Usage

For a proper quick start guide, visit the documentation website at

[https://josemmo.github.io/einvoicing/](https://josemmo.github.io/einvoicing/).

### Importing invoice documents

```php

use Einvoicing\Exceptions\ValidationException;

use Einvoicing\Readers\UblReader;

$reader = new UblReader();

$document = file_get_contents(__DIR__ . "/example.xml");

$inv = $reader->import($document);

try {

    $inv->validate();

} catch (ValidationException $e) {

    // Invoice is not EN 16931 complaint 

}

```

### Exporting invoice documents

```php

use Einvoicing\Identifier;

use Einvoicing\Invoice;

use Einvoicing\InvoiceLine;

use Einvoicing\Party;

use Einvoicing\Presets;

use Einvoicing\Writers\UblWriter;

// Create PEPPOL invoice instance

$inv = new Invoice(Presets\Peppol::class);

$inv->setNumber('F-202000012')

    ->setIssueDate(new DateTime('2020-11-01'))

    ->setDueDate(new DateTime('2020-11-30'));

// Set seller

$seller = new Party();

$seller->setElectronicAddress(new Identifier('9482348239847239874', '0088'))

    ->setCompanyId(new Identifier('AH88726', '0183'))

    ->setName('Seller Name Ltd.')

    ->setTradingName('Seller Name')

    ->setVatNumber('ESA00000000')

    ->setAddress(['Fake Street 123', 'Apartment Block 2B'])

    ->setCity('Springfield')

    ->setCountry('DE');

$inv->setSeller($seller);

// Set buyer

$buyer = new Party();

$buyer->setElectronicAddress(new Identifier('ES12345', '0002'))

    ->setName('Buyer Name Ltd.')

    ->setCountry('FR');

$inv->setBuyer($buyer);

// Add a product line

$line = new InvoiceLine();

$line->setName('Product Name')

    ->setPrice(100)

    ->setVatRate(16)

    ->setQuantity(1);

$inv->addLine($line);

// Export invoice to a UBL document

header('Content-Type: text/xml');

$writer = new UblWriter();

echo $writer->export($inv);

```

## Roadmap

These are the expected features for the library and how's it going so far:

- [x] Representation of invoices, parties and invoice lines as objects

- [x] Compatibility with the most used [CIUS and extensions](https://ec.europa.eu/digital-building-blocks/wikis/display/EINVCOMMUNITY/Registry+of+CIUS+%28Core+Invoice+Usage+Specifications%29+and+Extensions)

- [x] Export invoices to UBL documents

- [x] Import invoices from UBL documents

- [ ] Export invoices to CII documents

- [ ] Import invoices from CII documents

- [x] Proper documentation