horstoeko/zugferdublbridge

Convert Factur-X/ZUGFeRD (CII-Syntax) to PEPPOL (UBL-Syntax) and visa versa

v1.0.10 2024-12-20 22:05 UTC

Requires

• php: ^7.3|^7.4|^8

Requires (Dev)

• pdepend/pdepend: ^2
• phploc/phploc: ^7
• phpmd/phpmd: ^2
• phpstan/phpstan: ^1.8
• phpunit/phpunit: ^9
• sebastian/phpcpd: ^6
• squizlabs/php_codesniffer: ^3

MIT

• Daniel Erling

• convert
• invoice
• electronic
• ZUGFeRD
• cii
• ubl
• factur-x
• xrechnung

README

Table of Contents

• ZUGFeRD/Factur-X (CII-Syntax) to PEPPOL (UBL-Syntax)
  • Table of Contents
  • License
  • Overview
  • Further information
  • Related projects
  • Dependencies
  • Installation
  • Usage
    • Convert CII to UBL
      • From XML file to XML file
      • From XML string to XML file
      • From XML file to XML string
    • Convert UBL to CII
      • From XML file to XML file
      • From XML string to XML file
      • From XML file to XML string
  • Usage with horstoeko/zugferd
    • CII to UBL
    • UBL to CII

License

The code in this project is provided under the MIT license.

Overview

Caution

This library is currently still considered experimental and should therefore be used with caution. I would be happy for an issue to be posted if bugs are found.

With horstoeko/zugferdublbridge you can convert the Factur-X/ZUGFeRD-CII-Syntax to PEPPOL UBL-Syntax and visa versa.

Further information

• ZUGFeRD (German)
• XRechnung (German)
• Factur-X (France)

Related projects

• horstoeko/zugferd

Dependencies

This package has no dependencies.

Installation

There is one recommended way to install horstoeko/zugferdublbridge via Composer:

• adding the dependency to your composer.json file:

  "require": {
      ..
      "horstoeko/zugferdublbridge":"^1",
      ..
  },

Usage

For detailed eplanation you may have a look in the examples of this package and the documentation attached to every release.

Convert CII to UBL

From XML file to XML file

use horstoeko\zugferdublbridge\XmlConverterCiiToUbl;

$sourceXmlFilename = '/path/to/cii.xml.file';
$destinationXmlFilename = '/path/to/ubl.xml.file'

XmlConverterCiiToUbl::fromFile($sourceXmlFilename)->convert()->saveXmlFile($destinationXmlFilename);

From XML string to XML file

use horstoeko\zugferdublbridge\XmlConverterCiiToUbl;

$xmlContent = '<xml>....</xml>';
$destinationXmlFilename = '/path/to/ubl.xml.file'

XmlConverterCiiToUbl::fromString($xmlContent)->convert()->saveXmlFile($destinationXmlFilename);

From XML file to XML string

use horstoeko\zugferdublbridge\XmlConverterCiiToUbl;

$sourceXmlFilename = '/path/to/cii.xml.file';

$converterXmlString = XmlConverterCiiToUbl::fromFile($sourceXmlFilename)->convert()->saveXmlString();

Convert UBL to CII

From XML file to XML file

use horstoeko\zugferdublbridge\XmlConverterUblToCii;

$sourceXmlFilename = '/path/to/ubl.xml.file';
$destinationXmlFilename = '/path/to/cii.xml.file'

XmlConverterUblToCii::fromFile($sourceXmlFilename)->convert()->saveXmlFile($destinationXmlFilename);

From XML string to XML file

use horstoeko\zugferdublbridge\XmlConverterUblToCii;

$xmlContent = '<xml>....</xml>';
$destinationXmlFilename = '/path/to/cii.xml.file'

XmlConverterUblToCii::fromString($xmlContent)->convert()->saveXmlFile($destinationXmlFilename);

From XML file to XML string

use horstoeko\zugferdublbridge\XmlConverterUblToCii;

$sourceXmlFilename = '/path/to/ubl.xml.file';

$converterXmlString = XmlConverterUblToCii::fromFile($sourceXmlFilename)->convert()->saveXmlString();

Usage with horstoeko/zugferd

CII to UBL

You can convert the output of horstoko/zugferd to UBL using this library:

use horstoeko\zugferd\ZugferdDocumentBuilder;
use horstoeko\zugferd\ZugferdProfiles;
use horstoeko\zugferd\codelists\ZugferdPaymentMeans;
use horstoeko\zugferdublbridge\XmlConverterCiiToUbl;

$document = ZugferdDocumentBuilder::CreateNew(ZugferdProfiles::PROFILE_EN16931);
$document
    ->setDocumentInformation("471102", "380", \DateTime::createFromFormat("Ymd", "20180305"), "EUR")
    ----

$destinationXmlFilename = '/path/to/ubl.xml.file'

XmlConverterCiiToUbl::fromString($document->getContent())->convert()->saveXmlFile($destinationXmlFilename);

UBL to CII

You can convert a UBL document and handle it with horstoko/zugferd

use horstoeko\zugferd\ZugferdDocumentReader;
use horstoeko\zugferdublbridge\XmlConverterUblToCii;

$sourceXmlFilename = '/path/to/ubl.xml.file';

$converterXmlString = XmlConverterUblToCii::fromFile($sourceXmlFilename)->convert()->saveXmlString();

$document = ZugferdDocumentReader::readAndGuessFromContent($converterXmlString);

$document->getDocumentInformation(
    $documentno,
    $documenttypecode,
    $documentdate,
    $duedate,
    $invoiceCurrency,
    $taxCurrency,
    $documentname,
    $documentlanguage,
    $effectiveSpecifiedPeriod
);

echo "The Invoice No. is {$documentno}" . PHP_EOL;