README

PHP library for generating electronic invoices in the ISDOC format (version 6.0.2) -- the Czech national standard for electronic invoicing.

Interactive Demo | Packagist | Dokumentace v cestine

Features

• ISDOC 6.0.2 compliant XML output
• All document types: invoice, credit note, debit note, proforma, advance invoice, simplified invoice
• VAT payer and non-VAT payer invoices
• Reverse charge support
• Multiple VAT rates
• Foreign currency support
• Czech bank database (names, BIC/SWIFT, IBAN generation)
• Automatic address parsing (street + building number)
• Country name to ISO code resolution
• Fluent API with method chaining
• Total rounding
• Save to file or download as HTTP response

Requirements

• PHP 8.3+
• Extensions: dom, bcmath

Installation

composer require kenod/isdoc-exporter

Quick Start

use Kenod\IsdocExporter\Invoice;

$invoice = new Invoice();
$invoice
    ->setNumber('2024001')
    ->setIssueDate('2024-01-15')
    ->setDueDate('2024-02-15');

$invoice->supplier
    ->setName('Supplier s.r.o.')
    ->setStreet('Main Street 10')
    ->setCity('Prague')
    ->setZip('110 00')
    ->setCompanyId('12345678');

$invoice->customer
    ->setName('Customer a.s.')
    ->setStreet('Side Street 20')
    ->setCity('Brno')
    ->setZip('602 00')
    ->setCompanyId('87654321');

$invoice->payment
    ->setAccountNumber('123456789')
    ->setBankCode('0100')
    ->setVariableSymbol('2024001');

$invoice
    ->addItem('Website development', 1.0, 'pcs', 15000.0, 15000.0, 0.0)
    ->addItem('Hosting for 1 year', 12.0, 'months', 200.0, 200.0, 0.0);

// Save to file
$invoice->export()->save('invoice.isdoc');

// Or get XML as string
$xml = $invoice->export()->toString();

// Or send as HTTP download
$invoice->export()->download('invoice.isdoc');

VAT Payer Invoice

$invoice = new Invoice();
$invoice
    ->setNumber('FV-2024-042')
    ->setIssueDate('2024-03-01')
    ->setDueDate('2024-03-15')
    ->setVatPayer(true)
    ->setDeliveryDate('2024-02-29')
    ->setRoundTotal(true);

// Supplier and customer setup...

// Items with VAT (unitPrice without VAT, unitPriceWithVat with VAT, vatRate)
$invoice
    ->addItem('Development', 80.0, 'hrs', 1500.0, 1815.0, 21.0)
    ->addItem('Printed manual', 50.0, 'pcs', 350.0, 392.0, 12.0);

$invoice->export()->save('vat_invoice.isdoc');

Credit Note

use Kenod\IsdocExporter\DocumentType;
use Kenod\IsdocExporter\Invoice;

$invoice = new Invoice();
$invoice
    ->setDocumentType(DocumentType::CreditNote)
    ->setNumber('DN-2024-001')
    ->setIssueDate('2024-04-01')
    ->setDueDate('2024-04-15')
    ->setVatPayer(true)
    ->setDeliveryDate('2024-04-01')
    ->setOriginalDocumentNumber('FV-2024-042')
    ->setOriginalDocumentDate('2024-03-01');

// ...

Reverse Charge

$invoice = new Invoice();
$invoice
    ->setNumber('FV-2024-RC-001')
    ->setIssueDate('2024-06-30')
    ->setDueDate('2024-07-30')
    ->setVatPayer(true)
    ->setDeliveryDate('2024-06-30')
    ->setReverseCharge(true)
    ->setReverseChargeType('4'); // 4 = construction services

// ...

Foreign Currency

$invoice = new Invoice();
$invoice
    ->setCurrencyCode('CZK')
    ->setForeignCurrencyCode('EUR')
    ->setCurrencyRate(25.35)
    ->setRefCurrencyRate(1.0);

// ...

Document Types

API Reference

Invoice

Invoice Properties

Party

PaymentInfo

IsdocExporter

Development

composer install
composer check    # runs phpcs + phpstan + phpunit
composer phpcs    # code style check
composer phpcbf   # auto-fix code style
composer phpstan  # static analysis (level 8)
composer test     # unit tests

License

MIT