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(1mo ago)530.9k↑13.5%5MITPHPPHP ^5.6.0|^7.0.0|^8.0

Since Mar 17Pushed 1y 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 1mo ago

READMEChangelog (7)DependenciesVersions (9)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 );
echo 'Invoice ID: '. $response->get('Identyfikator');

```

3. Download invoice

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

```

###  Health Score

50

—

FairBetter than 96% of packages

Maintenance66

Regular maintenance activity

Popularity35

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor1

Top contributor holds 87.5% 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 ~365 days

Recently: every ~422 days

Total

8

Last Release

58d 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 (14 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

ifirma-apiphpphpapiinvoiceifirmaksef

### 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

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

PHPackages © 2026

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