PHPackages                             abb/fakturownia - 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. [API Development](/categories/api)
4. /
5. abb/fakturownia

ActiveLibrary[API Development](/categories/api)

abb/fakturownia
===============

PHP client for Fakturownia API

2.2.0(3mo ago)862.6k↓42%3[1 issues](https://github.com/mariusz-zajac/fakturownia/issues)1MITPHPPHP >=7.4CI failing

Since Dec 30Pushed 3mo ago2 watchersCompare

[ Source](https://github.com/mariusz-zajac/fakturownia)[ Packagist](https://packagist.org/packages/abb/fakturownia)[ RSS](/packages/abb-fakturownia/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (12)Versions (18)Used By (1)

Fakturownia (InvoiceOcean)
==========================

[](#fakturownia-invoiceocean)

PHP client for [Fakturownia](https://fakturownia.pl) ([InvoiceOcean](https://invoiceocean.com)) API.

Requirements
------------

[](#requirements)

- PHP 7.4 or higher with curl and json extensions.

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

[](#installation)

The recommended way to install the library is via [Composer](https://getcomposer.org).

```
$ composer require abb/fakturownia
```

Usage example
-------------

[](#usage-example)

```
$config = new \Abb\Fakturownia\Config('your_subdomain', 'api_token');
$fakturownia = new \Abb\Fakturownia\Fakturownia($config);

// Get invoice with ID 123
$response = $fakturownia->invoices()->getOne(123);

// Get invoices by parameters
$params = [
    'period' => 'this_month',
    'page' => '1',
];
$response = $fakturownia->invoices()->getAll($params);

// Get invoice with ID 123 as PDF and save it to file
$pdfContent = $fakturownia->invoices()->getPdf(123);
file_put_contents('/path/to/invoice_123.pdf', $pdfContent);

// Create an invoice
$invoiceData = [
    'kind' => 'vat',
    'number' => null,
    'sell_date' => '2013-01-16',
    'issue_date' => '2013-01-16',
    'payment_to' => '2013-01-23',
    'seller_name' => 'Wystawca Sp. z o.o.',
    'seller_tax_no' => '5252445767',
    'buyer_name' => 'Klient1 Sp. z o.o.',
    'buyer_email' => 'buyer@testemail.pl',
    'buyer_tax_no' => '5252445767',
    'positions' => [
        [
            'name' => 'Produkt A1',
            'tax' => 23,
            'total_price_gross' => 10.23,
            'quantity' => 1,
        ],
        [
            'name' => 'Produkt A2',
            'tax' => 0,
            'total_price_gross' => 50,
            'quantity' => 3,
        ],
    ],
];
$response = $fakturownia->invoices()->create($invoiceData);

// Update invoice with ID 123
$invoiceData = [
    'buyer_name' => 'Nowa nazwa klienta Sp. z o.o.',
    'positions' =>  [
        [
            'id' => 32649087,
            'name' => 'Nowa nazwa pozycji na fakturze',
        ],
    ],
];
$response = $fakturownia->invoices()->update(123, $invoiceData);

// Delete invoice with ID 123
$response = $fakturownia->invoices()->delete(123);
```

### Error handling

[](#error-handling)

```
$fakturownia = new \Abb\Fakturownia\Fakturownia($config);
$invoiceData = [
    // ...
];

try {
    $response = $fakturownia->invoices()->create($invoiceData);
} catch (\Abb\Fakturownia\Exception\ApiException $e) {
    $msg = $e->getMessage(); // error message
    $statusCode = $e->getCode(); // status code, e.g. 400, 401, 500 etc.
    $details = $e->getDetails(); // error details (if available)
} catch (\Abb\Fakturownia\Exception\RuntimeException $e) {
    $msg = $e->getMessage();
}

$lastResponse = $fakturownia->getLastResponse(); // last API response or NULL if not available
```

API documentation
-----------------

[](#api-documentation)

More information about the required parameters for each method can be found here: [PL](https://app.fakturownia.pl/api) | [EN](https://app.invoiceocean.com/api).

###  Health Score

55

—

FairBetter than 97% of packages

Maintenance78

Regular maintenance activity

Popularity37

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity72

Established project with proven stability

 Bus Factor1

Top contributor holds 94% 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 ~200 days

Recently: every ~425 days

Total

16

Last Release

104d ago

Major Versions

1.6.0 → v2.x-dev2025-01-18

PHP version history (4 changes)1.0.0PHP >=5.4.0

1.3.0PHP ^7.1

1.4.0PHP ^7.1 || ^8.0

v2.x-devPHP >=7.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/d69dc21fbad500f2299218c462dcefa8518563605c4e91837ad37b80204c1a06?d=identicon)[abb](/maintainers/abb)

---

Top Contributors

[![mariusz-zajac](https://avatars.githubusercontent.com/u/22937140?v=4)](https://github.com/mariusz-zajac "mariusz-zajac (79 commits)")[![patryk-sawicki](https://avatars.githubusercontent.com/u/30780444?v=4)](https://github.com/patryk-sawicki "patryk-sawicki (3 commits)")[![olafkryus](https://avatars.githubusercontent.com/u/14991562?v=4)](https://github.com/olafkryus "olafkryus (1 commits)")[![Suvres](https://avatars.githubusercontent.com/u/67355511?v=4)](https://github.com/Suvres "Suvres (1 commits)")

---

Tags

apifakturowniageneratorinvoiceinvoiceoceanphp-clientphpapiclientinvoiceoceanfakturownia

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/abb-fakturownia/health.svg)

```
[![Health](https://phpackages.com/badges/abb-fakturownia/health.svg)](https://phpackages.com/packages/abb-fakturownia)
```

###  Alternatives

[openai-php/client

OpenAI PHP is a supercharged PHP API client that allows you to interact with the Open AI API

5.8k28.0M318](/packages/openai-php-client)[mollie/mollie-api-php

Mollie API client library for PHP. Mollie is a European Payment Service provider and offers international payment methods such as Mastercard, VISA, American Express and PayPal, and local payment methods such as iDEAL, Bancontact, SOFORT Banking, SEPA direct debit, Belfius Direct Net, KBC Payment Button and various gift cards such as Podiumcadeaukaart and fashioncheque.

60216.0M85](/packages/mollie-mollie-api-php)[shopware/platform

The Shopware e-commerce core

3.4k1.5M3](/packages/shopware-platform)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.6M574](/packages/shopware-core)[deepseek-php/deepseek-php-client

deepseek PHP client is a robust and community-driven PHP client library for seamless integration with the Deepseek API, offering efficient access to advanced AI and data processing capabilities.

46688.8k5](/packages/deepseek-php-deepseek-php-client)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.4M203](/packages/sulu-sulu)

PHPackages © 2026

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