PHPackages                             agsystemspl/fakturownia-rest-client - 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. [HTTP & Networking](/categories/http)
4. /
5. agsystemspl/fakturownia-rest-client

ActiveLibrary[HTTP & Networking](/categories/http)

agsystemspl/fakturownia-rest-client
===================================

PHP client for Fakturownia.pl API

1.0.1(5mo ago)064↓62.5%MITPHPPHP >=7.0

Since Jan 16Pushed 5mo ago1 watchersCompare

[ Source](https://github.com/agsystemspl/fakturownia-rest-client)[ Packagist](https://packagist.org/packages/agsystemspl/fakturownia-rest-client)[ RSS](/packages/agsystemspl-fakturownia-rest-client/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (2)Versions (2)Used By (0)

Fakturownia (InvoiceOcean) Rest API Client
==========================================

[](#fakturownia-invoiceocean-rest-api-client)

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

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

[](#requirements)

- PHP >= 7.0
- [agsystemspl/abstract-rest-client](https://github.com/agsystemspl/abstract-rest-client) ^1.0

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

[](#installation)

### Composer

[](#composer)

```
composer require agsystemspl/fakturownia-rest-client
```

Usage
-----

[](#usage)

### Client Initialization

[](#client-initialization)

```
use AGSystems\Fakturownia\REST\Client;

$accessToken = 'JDxxxxxxxxxxxxxx';

// For Fakturownia (Polish version)
$apiUrl = 'https://YOUR_DOMAIN.fakturownia.pl/';

// For InvoiceOcean (English version)
// $apiUrl = 'https://YOUR_DOMAIN.invoiceocean.com/';

$client = new Client($accessToken, $apiUrl);
```

### Available Resources

[](#available-resources)

The client supports the following API endpoints:

ResourceDescription`invoices`Invoices`clients`Clients`products`Products`payments`Payments`categories`Categories`warehouses`Warehouses`warehouse_documents`Warehouse Documents### Examples

[](#examples)

#### Fetching Resource Lists

[](#fetching-resource-lists)

```
// Get a list of clients with pagination
$clients = $client->clients->get([
    'page' => 1,
    'per_page' => 25
]);

// Get a list of invoices
$invoices = $client->invoices->get();
```

#### Fetching a Single Resource

[](#fetching-a-single-resource)

```
// Get a client by ID
$clientData = $client->clients(123)->get();

// Get an invoice by ID
$invoice = $client->invoices(456)->get();
```

#### Creating a Resource

[](#creating-a-resource)

```
// Add a new client
$newClient = $client->clients->post([
    'client' => [
        'name' => 'Company XYZ',
        'tax_no' => '1234567890',
        'city' => 'Warsaw'
    ]
]);

// Create an invoice
$newInvoice = $client->invoices->post([
    'invoice' => [
        'kind' => 'vat',
        'number' => null,
        'sell_date' => '2024-01-15',
        'issue_date' => '2024-01-15',
        'payment_to' => '2024-01-29',
        'client_id' => $newClient->id,
        'positions' => [
            ['name' => 'Service', 'quantity' => 1, 'total_price_gross' => 123.00]
        ]
    ]
]);
```

#### Updating a Resource

[](#updating-a-resource)

```
// Update client data
$client->clients(123)->put([
    'client' => [
        'name' => 'New Company Name'
    ]
]);
```

#### Deleting a Resource

[](#deleting-a-resource)

```
// Delete a client
$client->clients(123)->delete();
```

#### Sending Invoice by Email

[](#sending-invoice-by-email)

```
$client->invoices(456)->send_by_email->post();
```

API Documentation
-----------------

[](#api-documentation)

Full API documentation:

- **Fakturownia (PL)**:
- **InvoiceOcean (EN)**:

License
-------

[](#license)

MIT

###  Health Score

31

—

LowBetter than 66% of packages

Maintenance70

Regular maintenance activity

Popularity11

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity30

Early-stage or recently created project

 Bus Factor1

Top contributor holds 50% 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

Unknown

Total

1

Last Release

169d ago

### Community

Maintainers

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

---

Top Contributors

[![stonekins](https://avatars.githubusercontent.com/u/234693457?v=4)](https://github.com/stonekins "stonekins (4 commits)")[![krzysztofgwiazda](https://avatars.githubusercontent.com/u/1054403?v=4)](https://github.com/krzysztofgwiazda "krzysztofgwiazda (3 commits)")[![mindc](https://avatars.githubusercontent.com/u/1355190?v=4)](https://github.com/mindc "mindc (1 commits)")

---

Tags

phpapirestinvoiceoceanfakturowniafakturownia.plinvoiceocean.com

### Embed Badge

![Health badge](/badges/agsystemspl-fakturownia-rest-client/health.svg)

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

PHPackages © 2026

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