PHPackages                             barnetik/ticketbai - 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. barnetik/ticketbai

ActiveLibrary

barnetik/ticketbai
==================

Generate, sign and submit TicketBAI compatible invoices

v0.6.3(12mo ago)416.0k↓26.9%19[5 issues](https://github.com/Barnetik/tbai-php-lib/issues)GPL-3.0-or-laterPHPPHP >=7.4 || >=8.0CI passing

Since Sep 5Pushed 10mo ago9 watchersCompare

[ Source](https://github.com/Barnetik/tbai-php-lib)[ Packagist](https://packagist.org/packages/barnetik/ticketbai)[ RSS](/packages/barnetik-ticketbai/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (4)Versions (16)Used By (0)

Tbai PHP lib
============

[](#tbai-php-lib)

TicketBai sistema erabiltzeko PHP liburutegia Librería para integrarse con el sistema TicketBai

Egungo Funtzionalitateak / Funcionalidades actuales
---------------------------------------------------

[](#egungo-funtzionalitateak--funcionalidades-actuales)

- Fakturen, fakturen zuzenketen eta hauen baliogabetzeen TicketBai formatudun XML-a sortu
- Fakturak, fakturen zuzenketak eta hauen baliogabetzeak XaDES motako sinadurarekin sinatu
- Fakturak, fakturen zuzenketak eta hauen baliogabetzeak EAEko hiru diputazioetako zerbitzuetara igorri.
- Bizkaiko kasuan (Batuz), pertsona fisikoentzako 140 modeloa ere badabil hiru kasuetarako (igorketa, zuzenketa eta baliogabetzeak)
- Gipuzkoa eta Arabako **Zuzendu** zerbitzuarekin integrazioa. Igorritako fakturen aldaketa eta zuzenketak baimentzen dituen zerbitzua. [@areinaNubeApp](https://github.com/areinaNubapp)-en ekarpenei esker.

---

- Generar XML en formato TicketBai de facturas, facturas rectificativas y cancelaciones de factura
- Firmar estos documentos con firma XaDES
- Enviar estos documentos a los servicios de las tres haciendas forales de la CAV.
- En el caso de Bizkaia (Batuz), es posible también emitir, rectificar y cancelar facturas para personas físicas utilizando el modelo 140.
- Integración con el servicio **Zuzendu** de Araba y Gipuzkoa que permite la subsanación y modificación de facturas emitidas. Gracias a las aportaciones de [@areinaNubeApp](https://github.com/areinaNubapp)

Instalazioa / Instalación
-------------------------

[](#instalazioa--instalación)

```
composer require barnetik/ticketbai
```

Erabilgarri dauden JSON dokumentuen definizioak / Definición de los documentos JSON disponibles
-----------------------------------------------------------------------------------------------

[](#erabilgarri-dauden-json-dokumentuen-definizioak--definición-de-los-documentos-json-disponibles)

Hurrengo helbidean, dokumentuak sortzeko erabili daitezkeen JSON dokumentuen definizioak topatu ahal ditzazkezue:

Podéis encontrar las definiciones de los JSON disponibles para la generación de documentos en el siguiente enlace:

Erabilera adibideak / Ejemplos de uso
-------------------------------------

[](#erabilera-adibideak--ejemplos-de-uso)

### Fakturaren sinaketa / Firma de una factura

[](#fakturaren-sinaketa--firma-de-una-factura)

[Adibide moduan erabiltzen dugun JSON fitxategia / JSON usado como ejemplo](./tests/Barnetik/Tbai/__files/tbai-sample.json)

```
use Barnetik\Tbai\Fingerprint\Vendor;
use Barnetik\Tbai\PrivateKey;
use Barnetik\Tbai\TicketBai;

$license = 'LICENCIA_DESARROLLO';
$developerCif = 'CIF';
$appName = 'TBAI PHP APP';
$version = '1.0';

$certificatePath = '/path/to/certificate.p12';
$certificatePassword = 'myCertificatePassword';

// Where we want the signed document to be stored
$signedXmlPath = './signed.xml';

$ticketbai = TicketBai::createFromJson(
    new Vendor($license, $developerCif, $appName, $version),
    json_decode(file_get_contents('tbai-sample.json'), true)
);

$ticketbai->sign(
    PrivateKey::p12($certificatePath),
    $certificatePassword,
    $signedXmlPath
);
```

### Faktura bidaltzea / Envío de la factura

[](#faktura-bidaltzea--envío-de-la-factura)

```
// We have an endpoint for each province Araba, Bizkaia or Gipuzkoa
use Barnetik\Tbai\Api\Bizkaia\Endpoint as BizkaiaEndpoint;

/**
 * BizkaiaEndpoint(bool $dev = false, bool $debug = false)
 * For production usage $dev param must be false
 * $bizkaiaEndpoint = new BizkaiaEndpoint();
 */
$bizkaiaEndpoint = new BizkaiaEndpoint(true, true);
$result = $bizkaiaEndpoint->submitInvoice(
    $ticketbai,
    PrivateKey::p12($certificatePath),
    $certificatePassword,
);

if ($result->isDelivered()) {
    var_dump('SUCCESS!');
} else {
    var_dump($result->errorDataRegistry());
    var_dump($result->headers());
}
```

### Hurrengo faktura kateatzeko behar den sinadura zatia lortu / Obtener el trozo de firma necesaria para encadenar la próxima factura

[](#hurrengo-faktura-kateatzeko-behar-den-sinadura-zatia-lortu---obtener-el-trozo-de-firma-necesaria-para-encadenar-la-próxima-factura)

```
$shortSignatureValue = $ticketbai->chainSignatureValue();
```

### QR kodea sortzea / Creación del QR

[](#qr-kodea-sortzea---creación-del-qr)

```
use Barnetik\Tbai\Qr;

/**
 * Qr(TicketBai $ticketBai, bool $dev = false)
 * For production usage $dev param must be false
 * $qr = new Qr($ticketbai);
 */
$qr = new Qr($ticketbai, true);

$qr->savePng('/path/to/qr.png');

// Get the code that must be shown over QR on any invoice
$tbaiIdentifier = $qr->ticketbaiIdentifier();
```

###  Health Score

41

—

FairBetter than 89% of packages

Maintenance50

Moderate activity, may be stable

Popularity37

Limited adoption so far

Community21

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 97.6% 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 ~48 days

Recently: every ~67 days

Total

14

Last Release

364d ago

### Community

Maintainers

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

---

Top Contributors

[![arraintxo](https://avatars.githubusercontent.com/u/1630107?v=4)](https://github.com/arraintxo "arraintxo (286 commits)")[![arkiski](https://avatars.githubusercontent.com/u/266587?v=4)](https://github.com/arkiski "arkiski (3 commits)")[![areinaNubapp](https://avatars.githubusercontent.com/u/93913294?v=4)](https://github.com/areinaNubapp "areinaNubapp (1 commits)")[![goear](https://avatars.githubusercontent.com/u/29330729?v=4)](https://github.com/goear "goear (1 commits)")[![necobm](https://avatars.githubusercontent.com/u/13090212?v=4)](https://github.com/necobm "necobm (1 commits)")[![nerio93](https://avatars.githubusercontent.com/u/44447294?v=4)](https://github.com/nerio93 "nerio93 (1 commits)")

---

Tags

phptbaiticketbai

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/barnetik-ticketbai/health.svg)

```
[![Health](https://phpackages.com/badges/barnetik-ticketbai/health.svg)](https://phpackages.com/packages/barnetik-ticketbai)
```

###  Alternatives

[kimai/kimai

Kimai - Time Tracking

4.6k7.4k1](/packages/kimai-kimai)[nativephp/mobile

NativePHP for Mobile

82724.0k43](/packages/nativephp-mobile)[pimcore/admin-ui-classic-bundle

171.1M46](/packages/pimcore-admin-ui-classic-bundle)[n1ebieski/ksef-php-client

PHP API client that allows you to interact with the API Krajowego Systemu e-Faktur

7228.4k](/packages/n1ebieski-ksef-php-client)[open-dxp/opendxp

Content & Product Management Framework (CMS/PIM)

7310.3k29](/packages/open-dxp-opendxp)[verbb/events

A full-featured plugin for event management and ticketing.

2311.7k](/packages/verbb-events)

PHPackages © 2026

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