easybill/zugferd-php

ZUGFeRD PHP SDK (Factur-X, XRechnung) - Convert PHP Objects to XML and back.

v2.1.1 2024-11-07 08:28 UTC

Requires

• php: ^8.1
• ext-dom: *
• jms/serializer: ^3.16

Requires (Dev)

• ext-libxml: *
• friendsofphp/php-cs-fixer: ^3.16
• phpstan/phpstan: ^1.10
• phpstan/phpstan-strict-rules: ^1.5
• phpunit/phpunit: ^9.3
• rector/rector: ^1.0
• symfony/finder: ^5.4

Suggests

• ext-libxml: Needed for XSD validation

MIT

• Patrick Romowicz
• Jan Nöhles

• ZUGFeRD
• factur-x
• xrechnung

README

ZUGFeRD PHP SDK (Factur-X, XRechnung) - Convert PHP Objects to XML and back.

Look @ Tests for more details

Installation

The recommended way of installing this library is using Composer.

Add this repository to your composer information using the following command

composer require easybill/zugferd-php

Usage ZUGFeRD v1

Convert XML to PHP Objects:

use Easybill\ZUGFeRD\Reader;

$document = Reader::create()->getDocument('zugferd-file.xml');
echo $document->getHeader()->getId(); // Get invoice No.

Convert PHP Objects to XML:

use Easybill\ZUGFeRD\Builder;
use Easybill\ZUGFeRD\Model\Document;
 
$doc = new Document(Document::TYPE_COMFORT);
$doc->getHeader()->setId('RE1337'); // Set invoice No.

$xml = Builder::create()->getXML($doc);
echo $xml; // Zugferd XML.

Usage ZUGFeRD v2

Convert XML to PHP Objects:

use Easybill\ZUGFeRD2\Reader;

$xml = file_get_contents('factur-x.xml');
$obj = Reader::create()->transform($xml);

Convert PHP Objects to XML:

use Easybill\ZUGFeRD2\Builder;
 
$obj = ...;

$xml = Builder::create()->transform($obj);
echo $xml; // Zugferd XML.

Contributing

Please feel free to send bug reports and pull requests.

License

Published as open source under the terms of MIT License.