PHPackages                             dazza-dev/laravel-dgt-cr - 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. dazza-dev/laravel-dgt-cr

ActiveLibrary

dazza-dev/laravel-dgt-cr
========================

Paquete Laravel para generar, firmar y enviar documentos electrónicos (Factura, Nota crédito, Nota débito y Tiquete Electrónico) al Ministerio de Hacienda (Costa Rica).

v1.0.0(5mo ago)05MITPHPPHP >=8.0

Since Nov 26Pushed 5mo agoCompare

[ Source](https://github.com/dazza-dev/laravel-dgt-cr)[ Packagist](https://packagist.org/packages/dazza-dev/laravel-dgt-cr)[ RSS](/packages/dazza-dev-laravel-dgt-cr/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (5)Versions (2)Used By (0)

Laravel DGT Costa Rica 🇨🇷
=========================

[](#laravel-dgt-costa-rica-)

Paquete Laravel para generar, firmar y enviar documentos electrónicos (Factura, Nota crédito, Nota débito y Tiquete Electrónico) al Ministerio de Hacienda (Costa Rica).

Instalar
--------

[](#instalar)

```
composer require dazza-dev/laravel-dgt-cr
```

Configurar
----------

[](#configurar)

Publica el archivo de configuración:

```
php artisan vendor:publish --tag="laravel-dgt-cr-config"
```

Migraciones
-----------

[](#migraciones)

Publica y ejecuta las migraciones:

```
php artisan vendor:publish --tag="laravel-dgt-cr-migrations"
```

```
php artisan migrate
```

Insertar los datos
------------------

[](#insertar-los-datos)

```
php artisan dgt-cr:install
```

Variables de entorno
--------------------

[](#variables-de-entorno)

```
DGT_TEST=true # true o false
DGT_CERTIFICATE_PATH=ruta_del_certificado
DGT_CERTIFICATE_PASSWORD=clave_del_certificado
DGT_AUTH_USERNAME=nombre_de_usuario
DGT_AUTH_PASSWORD=contraseña_de_usuario
DGT_PATH=ruta_donde_se_guardaran_los_archivos
DGT_CALLBACK_URL=url_de_callback
```

Ejemplos
--------

[](#ejemplos)

### Generar un documento electrónico

[](#generar-un-documento-electrónico)

Para enviar un documento electrónico como Factura, Nota crédito, Nota débito o Tiquete Electrónico. primero debes pasar la estructura de datos que puedes encontrar en: [dazza-dev/dgt-xml-generator](https://github.com/dazza-dev/dgt-xml-generator).

### Configurar el emisor y receptor

[](#configurar-el-emisor-y-receptor)

Antes de enviar un documento, debes configurar el emisor y receptor. Esto se puede hacer con los métodos `setIssuer` y `setReceiver`.

```
use DazzaDev\LaravelDgtCr\Facades\LaravelDgtCr;

$client = LaravelDgtCr::getClient();

// Emisor
$client->setIssuer([
    'identification_type' => '02',
    'identification_number' => 'identificacion_emisor',
]);

// Receptor
$client->setReceiver([
    'identification_type' => '02',
    'identification_number' => 'identificacion_receptor',
]);
```

```
// Usar el valor en inglés de la tabla
$client->setDocumentType('invoice');

// Datos del documento
$client->setDocumentData($documentData);

// Enviar el documento
$document = $client->sendDocument();
```

### Tipos de documentos disponibles

[](#tipos-de-documentos-disponibles)

DocumentoValorFactura`invoice`Nota de crédito`credit-note`Nota de débito`debit-note`Tiquete Electrónico`ticket`Mensaje Receptor`receiver-message`### Consultar estado del documento enviado

[](#consultar-estado-del-documento-enviado)

Después de enviar un documento, puedes consultar su estado usando el método `checkStatus`:

```
$documentStatus = $client->checkStatus(
    documentKey: $clave
);
```

### Buscar un documento

[](#buscar-un-documento)

Para buscar un documento debemos pasar la clave del documento que se obtiene al enviar el documento.

```
$document = $client->getDocument(
    documentKey: $clave
);
```

### Obtener lista de documentos

[](#obtener-lista-de-documentos)

Para obtener una lista de documentos electrónicos que se han enviado, puedes usar el método `getDocuments`.

```
$documents = $client->getDocuments(
    offset: 0,
    limit: 50
);
```

### Obtener los listados

[](#obtener-los-listados)

El ministerio de hacienda tiene una lista de códigos que este paquete te pone a disposición para facilitar el trabajo de consultar esto en el anexo técnico:

```
use DazzaDev\LaravelDgtCr\Facades\LaravelDgtCr;

// Obtener los listados disponibles
$listings = LaravelDgtCr::getListings();

// Consultar los datos de un listado por tipo
$listingByType = LaravelDgtCr::getListing('tipos-comprobante');
```

Contribuciones
--------------

[](#contribuciones)

Las contribuciones son bienvenidas. Si encuentras algún error o tienes ideas para mejoras, por favor abre un issue o envía un pull request. Asegúrate de seguir las pautas de contribución.

Autor
-----

[](#autor)

Laravel DGT Costa Rica fue creado por [DAZZA](https://github.com/dazza-dev).

Licencia
--------

[](#licencia)

Este proyecto está licenciado bajo la [MIT License](https://opensource.org/licenses/MIT).

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance70

Regular maintenance activity

Popularity5

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity40

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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

Unknown

Total

1

Last Release

167d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/0a4e49637e94903e3732c3cf0c3e23b2e7a85286ab196f1ff078b0cea058f8b6?d=identicon)[dazza-dev](/maintainers/dazza-dev)

---

Top Contributors

[![dazza-dev](https://avatars.githubusercontent.com/u/21293561?v=4)](https://github.com/dazza-dev "dazza-dev (1 commits)")

---

Tags

Costa Ricadgtdgt-laravel

###  Code Quality

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/dazza-dev-laravel-dgt-cr/health.svg)

```
[![Health](https://phpackages.com/badges/dazza-dev-laravel-dgt-cr/health.svg)](https://phpackages.com/packages/dazza-dev-laravel-dgt-cr)
```

###  Alternatives

[anourvalar/eloquent-serialize

Laravel Query Builder (Eloquent) serialization

11320.2M21](/packages/anourvalar-eloquent-serialize)[namu/wirechat

A Laravel Livewire messaging app for teams with private chats and group conversations.

54324.5k](/packages/namu-wirechat)[statamic-rad-pack/runway

Eloquently manage your database models in Statamic.

135192.6k5](/packages/statamic-rad-pack-runway)

PHPackages © 2026

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