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(1mo ago)856.9k—6.9%3[1 issues](https://github.com/mariusz-zajac/fakturownia/issues)1MITPHPPHP >=7.4

Since Dec 30Pushed 1mo ago2 watchersCompare

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

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

57

—

FairBetter than 98% of packages

Maintenance86

Actively maintained with recent releases

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

58d 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.8k22.6M232](/packages/openai-php-client)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

74513.7M114](/packages/meilisearch-meilisearch-php)[openai-php/symfony

Symfony Bundle for OpenAI

215715.5k3](/packages/openai-php-symfony)[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.

47073.9k5](/packages/deepseek-php-deepseek-php-client)[gemini-api-php/client

API client for Google's Gemini API

216221.4k5](/packages/gemini-api-php-client)[mozex/anthropic-php

Anthropic PHP is a supercharged community-maintained PHP API client that allows you to interact with Anthropic API.

46365.1k13](/packages/mozex-anthropic-php)

PHPackages © 2026

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