kitfiscal/client

Client PHP pentru kitfiscal API — estimator fiscal PFA / SRL Micro / SRL Profit, Romania 2026 (WooCommerce, PrestaShop, Magento, Laravel).

v1.0.0 2026-08-17 11:33 UTC

Requires

• php: >=8.1
• ext-curl: *
• ext-json: *

Requires (Dev)

• phpunit/phpunit: ^10.5

MIT

• Ciprian Stefan Plesca

Published on Packagist.org on 2026-08-18 02:46 UTC

README

Client PHP pentru kitfiscal API (estimator fiscal PFA / SRL Micro / SRL Profit, România 2026). Fără dependențe externe (doar ext-curl + ext-json, disponibile pe aproape orice hosting) — potrivit pentru integrare directă în WooCommerce, PrestaShop, Magento, OpenCart sau orice aplicație Laravel / Symfony.

Instalare

composer require kitfiscal/client

Sau, fără Composer (ex. plugin WordPress simplu): copiază folderul src/ și încarcă manual clasele cu require.

Utilizare

use KitFiscal\Client\KitFiscalClient;
use KitFiscal\Client\Model\VenitInput;

$client = new KitFiscalClient('https://api.exemplu.ro/kitfiscal/');

$rezultat = $client->pfa(new VenitInput(
    venitBrutAnual: 250000,
    cheltuieliAnuale: 60000,
));

echo "{$rezultat->formaJuridica}: {$rezultat->venitNetRamas} lei net\n";

Comparație între toate formele juridice:

$comparativ = $client->compara(new VenitInput(venitBrutAnual: 300000, cheltuieliAnuale: 50000));
echo "Cel mai avantajos: {$comparativ->celMaiFavorabil}\n";

Gestionarea erorilor

Orice răspuns HTTP 4xx/5xx sau JSON invalid aruncă KitFiscal\Client\Exception\KitFiscalApiException, cu statusCode și responseBody disponibile pentru diagnoză. Erorile 5xx sunt reîncercate automat (backoff simplu); erorile 4xx (validare) nu sunt reîncercate.

try {
    $rezultat = $client->pfa($input);
} catch (\KitFiscal\Client\Exception\KitFiscalApiException $e) {
    error_log("kitfiscal API a eșuat: {$e->getMessage()} (status {$e->statusCode})");
}

Testare

composer install
composer test

Testele nu ating rețeaua reală — folosesc parametrul transport din constructorul KitFiscalClient pentru a simula răspunsurile HTTP.

Notă

Acest client este un strat subțire peste kitfiscal API (serverul Python). Nu conține nicio logică fiscală proprie — sursa unică de adevăr a calculului rămâne motorul Python (kitfiscal.pfa, srl_micro, srl_profit).

Publicare pe Packagist

Prima dată, o singură dată, manual: pachetul se înregistrează pe packagist.org cu contul GitHub, legat la acest repository. După asta, Packagist urmărește automat tag-urile Git — orice tag php-v1.0.0 publică o versiune nouă, fără acțiune suplimentară:

git tag php-v1.0.0
git push origin php-v1.0.0