PHPackages                             miwaniec/ifirma-api - 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. miwaniec/ifirma-api

ActiveLibrary[API Development](/categories/api)

miwaniec/ifirma-api
===================

IFirmaApi is a wrapper for official iFirma API. IFirma is one of the most popular internet accounting systems in Poland.

v1.3.1(2mo ago)533.2k↓20.5%5MITPHPPHP ^5.6.0|^7.0.0|^8.0

Since Mar 17Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/miwaniec/ifirma-api)[ Packagist](https://packagist.org/packages/miwaniec/ifirma-api)[ Docs](https://github.com/miwaniec/ifirmaapi)[ RSS](/packages/miwaniec-ifirma-api/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (9)DependenciesVersions (10)Used By (0)

IFirmaApi
=========

[](#ifirmaapi)

The wrapper in PHP for official [iFirma API](http://api.ifirma.pl/) (in Polish). IFirma is one of the most popular internet accounting systems in Poland. API functions and fields are in Polish, names in my code are in English for better understanding. Created at the end of 2017 for internal projects, published in March 2019 here. If you need help, please create an issue in this repository. It is part of most useful API functions. Check examples below (more in [example.php](src/example.php)).

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

[](#installation---httpspackagistorgpackagesmiwaniecifirma-api)

```
composer require miwaniec/ifirma-api
```

Usage
-----

[](#usage)

1. Get accountancy month (current value in system)

```
$account = new \IFirmaApi\Account('login', 'key');
$response = $account->getAccountancyMonth();
echo 'Accountancy month: ' . $response->get('MiesiacKsiegowy') . '/' . $response->get('RokKsiegowy');

```

2. Add invoice - a simple example for an existing contractor

```
$invoice = new \IFirmaApi\Invoice('login', 'key');
$invoceDomestic = new \IFirmaApi\Model\InvoiceDomestic('123456789', '2019-01-01', 7);
$invoceDomestic->addItem( new \IFirmaApi\Model\Item('IT support', 100, 3));
$response = $invoice->add( $invoceDomestic );
$invoiceId = $response->get('Identyfikator');
echo 'Invoice ID: ' . $invoiceId;

```

optionally, you can send invoice to KSeF right after adding (if you have KSeF enabled in your account)

```
$invoice->sendToKsef($invoiceId);

```

3. Download invoice

```
$invoice = new \IFirmaApi\Invoice('login', 'key');
$invoice->getAsPdf('1/1/2019');

```

###  Health Score

56

—

FairBetter than 97% of packages

Maintenance87

Actively maintained with recent releases

Popularity35

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity71

Established project with proven stability

 Bus Factor1

Top contributor holds 90% 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 ~325 days

Recently: every ~377 days

Total

9

Last Release

62d ago

PHP version history (2 changes)v1.0PHP ^5.6.0|^7.0.0

v1.2.1PHP ^5.6.0|^7.0.0|^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/979fa94e38a722dffb1649fc30090fc49589cc71b885a1c17f2a3456180fd884?d=identicon)[miwaniec](/maintainers/miwaniec)

---

Top Contributors

[![miwaniec](https://avatars.githubusercontent.com/u/1790724?v=4)](https://github.com/miwaniec "miwaniec (18 commits)")[![jszczypk](https://avatars.githubusercontent.com/u/409167?v=4)](https://github.com/jszczypk "jszczypk (1 commits)")[![pperzyna](https://avatars.githubusercontent.com/u/25820587?v=4)](https://github.com/pperzyna "pperzyna (1 commits)")

---

Tags

ifirmaifirma-apiksefphpphpapiinvoiceifirmaksef

### Embed Badge

![Health badge](/badges/miwaniec-ifirma-api/health.svg)

```
[![Health](https://phpackages.com/badges/miwaniec-ifirma-api/health.svg)](https://phpackages.com/packages/miwaniec-ifirma-api)
```

###  Alternatives

[jstolpe/instagram-graph-api-php-sdk

Instagram Graph API PHP SDK

138110.7k2](/packages/jstolpe-instagram-graph-api-php-sdk)

PHPackages © 2026

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