PHPackages                             khaller/fakturomania-sdk - 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. khaller/fakturomania-sdk

ActiveSdk[API Development](/categories/api)

khaller/fakturomania-sdk
========================

SDK for Fakturomania API

0.3.3(3y ago)81231[1 PRs](https://github.com/Hyd3r1/Fakturomania/pulls)MITPHPPHP >=7.4

Since Jul 1Pushed 1y ago1 watchersCompare

[ Source](https://github.com/Hyd3r1/Fakturomania)[ Packagist](https://packagist.org/packages/khaller/fakturomania-sdk)[ RSS](/packages/khaller-fakturomania-sdk/feed)WikiDiscussions master Synced yesterday

READMEChangelog (7)Dependencies (4)Versions (9)Used By (0)

[![build with PHP](https://camo.githubusercontent.com/c9bf3d7f0c5eeb1e731b243f3b0681593a696d2999af567be16a5305fcb6a8fc/68747470733a2f2f6d656469612e646973636f72646170702e6e65742f6174746163686d656e74732f313036383738343238353634323933363335322f313036383738343238353733393339333034342f5048505f3634682e706e67)](https://camo.githubusercontent.com/c9bf3d7f0c5eeb1e731b243f3b0681593a696d2999af567be16a5305fcb6a8fc/68747470733a2f2f6d656469612e646973636f72646170702e6e65742f6174746163686d656e74732f313036383738343238353634323933363335322f313036383738343238353733393339333034342f5048505f3634682e706e67) [![build with Composer](https://camo.githubusercontent.com/dfc08be4c0492787fbfd71faeda51101ee0a1fa112c8813e773b16680e4eed4a/68747470733a2f2f6d656469612e646973636f72646170702e6e65742f6174746163686d656e74732f313036383738353734313838383439393737332f313036383738353734313937323339343035352f636f6d706f7365725f3634682e706e67)](https://camo.githubusercontent.com/dfc08be4c0492787fbfd71faeda51101ee0a1fa112c8813e773b16680e4eed4a/68747470733a2f2f6d656469612e646973636f72646170702e6e65742f6174746163686d656e74732f313036383738353734313838383439393737332f313036383738353734313937323339343035352f636f6d706f7365725f3634682e706e67)

Fakturomania (Swagger)
----------------------

[](#fakturomania-swagger)

Install
-------

[](#install)

```
composer require khaller/fakturomania-sdk

```

Packagist -

Authentication
--------------

[](#authentication)

---

Generate Auth-Token for another operations

```
    $authData = new \Fakturomania\Models\Auth();
    $authData->userEmail = "admin@fakturomania.pl";
    $authData->password = "Hasło";

    $authentication = new \Fakturomania\Authentication();
    $authToken = $authentication->generateSession($authData);
```

Authentication available data

```
    $authToken->value - Get Auth-Token for other functions
    $authToken->userEmail - Get email address (used in registration)
    $authToken->userLoginEmail - Get email address used for login
    $authToken->valid - Get token valid time in unix

```

Invoices
--------

[](#invoices)

---

Create invoice

```
    $invoiceData = new \Fakturomania\Models\Invoice();
    $invoiceData->documentName = "FV";
    $invoiceData->documentNameIsCustom = false;
    $invoiceData->saleDate = now() * 1000;
    $invoiceData->issueDate = now() * 1000;
    $invoiceData->contractor = [
        'contractorId' => 1,
        'contractorVersionId' => 1
    ];
    $invoiceData->addRecord([
        'ordinal' => 1,
        'name' => 'Test',
        'unit' => 'szt',
        'quantity' => 10,
        'netPrice' => 100,
        'netValue' => 1000,
        'vatRate' => "23%",
        'vatValue' => 230,
        'grossValue' => 1230,
        'invoiceProductId' => 1,
        'invoiceProductVersion' => 22
    ]);
    $invoiceData->buyerName = "Andrzej Kowalski";
    $invoiceData->sellerName = "Fakturomania";
    $invoiceData->comments = "Gwarancja nie obowiązuje";
    $invoiceData->paymentInfo = [
        'paymentDeadline' => now() * 1000,
        'paymentMethod' => 'CASH',
    ];
    $invoiceData->bankName = "PKO BANK POLSKI";
    $invoiceData->bankAccountNumber = "33 3333 3333 3333 3333 3333 3333";
    $invoiceData->invoiceTaxInfo = [
        'vatSaleArt23' => false,
        'vatSaleArt28K' => false,
        'vatRelatedEntitiesArt32Ust2Pkt1' => false,
        'vatSplitPaymentMechanismMPP' => false,
    ];

    $sale = new \Fakturomania\Sale($authToken);
    $invoice = $sale->createInvoice($invoiceData);
```

Get Invoices

```
    $sale = new \Fakturomania\Sale($authToken);
    $sale
        ->getInvoices(0000, 1625151106577, "ascending", "issueDate")
        ->each(function ($item){
            print_r($item);
        });
```

Delete Invoice

```
    $sale = new \Fakturomania\Sale($authToken);
    $sale->deleteInvoice(637536);
```

Invoice available data

```
    $invoice->invoiceDetails - Get invoice details (Array)
    $invoice->invoiceInfo - Get invoice info (Array)
    $invoice->contractorInfo - Get contractor data (Array)
    $invoice->recordsInfo - Get information about products on invoice (Array)
    $invoice->paymentInfo - Get information about payment (Array)
    $invoice->taxInfo - Get information about tax (Array)

```

Contractor
----------

[](#contractor)

---

Create Contractor

```
    $contractorData = new \Fakturomania\Models\Contractor();
    $contractorData->name = "Andrzej Kowalski";
    $contractorData->nipPrefix = "PL";
    $contractorData->street = "ul. gen. Stefana Grota-Rowackiego 38";
    $contractorData->postalCode = "41-214";
    $contractorData->postalCity = "Sosnowiec";

    $contractorClass = new \Fakturomania\Contractor($authToken);
    $contractor = $contractorClass->createContractor($contractorData);
```

Update Contractor

```
    $contractorData = new \Fakturomania\Models\Contractor();
    $contractorData->name = "Andrzej Maćkowiak";
    $contractorData->nipPrefix = "PL";
    $contractorData->street = "ul. gen. Stefana Grota-Rowackiego 40";
    $contractorData->postalCode = "41-214";
    $contractorData->postalCity = "Sosnowiec";

    $contractorNew = $contractorClass->updateContractor($contractor->contractorId, $contractorData);
```

Get Contractor

```
    $contractor = $contractorClass->getContractor($id);
```

Contractor available data

```
    $contractor->contractorId - Return contractor ID
    $contractor->contractorVersionId - ID of Contractor version
    $contractor->name - Get Contractor name
    $contractor->nipPrefix - Contractor nip prefix (no required)
    $contractor->nip - Contractor NIP
    $contractor->street - Get Contractor street
    $contractor->postalCode - Get Contractor postalcode
    $contractor->postalCity - Get contractor city
    $contractor->customerAccountId - Get contractor customer account Id
    $contractor->supplierAccountId - Get contractor supplier account id
```

Products
--------

[](#products)

---

Create product

```
    $productData = new \Fakturomania\Models\Product();
    $productData->name = "Testowy produkt";
    $productData->classificationCode = "69.20.2";
    $productData->unit = "szt";
    $productData->quantity = 1;
    $productData->netPrice = 100;
    $productData->netValue = 100;
    $productData->vatRate = "23%";
    $productData->vatValue = 23;
    $productData->grossValue = 123;
    $productData->GTU = "GTU_12";

    $productClass = new \Fakturomania\Products($authToken);
    $product = $productClass->createProduct($productData);
```

Update product

```
    $productData = new \Fakturomania\Models\Product();
    $productData->name = "Fajny produkt";
    $productData->classificationCode = "69.20.2";
    $productData->unit = "szt";
    $productData->quantity = 1;
    $productData->netPrice = 100;
    $productData->netValue = 100;
    $productData->vatRate = "23%";
    $productData->vatValue = 23;
    $productData->grossValue = 123;
    $productData->GTU = "GTU_12";
    $product = $productClass->updateProduct($productId, $productData);
```

Get product

```
    $product = $productClass->getProduct($productId);
```

Delete product

```
    $productClass->deleteProduct($productId);
```

Product available data

```
    $product->id - Product id
    $product->versionId - Product version id
    $product->versionUUID - Product version UUID
    $product->created - UNIX timestamp of product create
    $product->organizationId - Product owner company id
    $product->modified - UNIX timestamp of product last modify
    $product->name - Product name
    $product->classificationCode - CN / PKOB code
    $product->unit - Unit
    $product->quantity - Amount
    $product->netPrice - Netto price
    $product->netValue - Netto value
    $product->vatRate - Vat rate
    $product->vatValue - Vat value
    $product->grossValue - Brutto price
    $product->GTU - GTU Code
    $product->isCurrent - Product is current?
    $product->deleted - Product is deleted?
```

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance32

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 93.2% 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 ~65 days

Recently: every ~94 days

Total

7

Last Release

1385d ago

PHP version history (2 changes)0.1.0PHP >=7.3

0.3.2PHP >=7.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/79f4351e83aec00e7607e04410e875731420b27c386d96ac6b0d8671bc7a7e4b?d=identicon)[Hyd3r1](/maintainers/Hyd3r1)

---

Top Contributors

[![Hyd3r1](https://avatars.githubusercontent.com/u/60399586?v=4)](https://github.com/Hyd3r1 "Hyd3r1 (41 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (3 commits)")

---

Tags

apifaktoromaniahacktoberfestphpphp-libraryphp7sdk

### Embed Badge

![Health badge](/badges/khaller-fakturomania-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/khaller-fakturomania-sdk/health.svg)](https://phpackages.com/packages/khaller-fakturomania-sdk)
```

###  Alternatives

[netflie/whatsapp-cloud-api

The first PHP SDK to send and receive messages using a cloud-hosted version of the WhatsApp Business Platform

640431.7k4](/packages/netflie-whatsapp-cloud-api)[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3731.2M42](/packages/tencentcloud-tencentcloud-sdk-php)[jasara/php-amzn-selling-partner-api

A fluent interface for Amazon's Selling Partner API in PHP

1344.8k1](/packages/jasara-php-amzn-selling-partner-api)[hardcastle/xrpl_php

PHP SDK / Client for the XRP Ledger

129.7k5](/packages/hardcastle-xrpl-php)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

255.2k](/packages/aedart-athenaeum)[mapado/rest-client-sdk

Rest Client SDK for hydra API

1125.9k2](/packages/mapado-rest-client-sdk)

PHPackages © 2026

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