PHPackages                             andrevabo/danfse-nacional - 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. [PDF & Document Generation](/categories/documents)
4. /
5. andrevabo/danfse-nacional

ActiveLibrary[PDF & Document Generation](/categories/documents)

andrevabo/danfse-nacional
=========================

Gerador de PDF do DANFSe Nacional a partir do XML da NFS-e Padrão Nacional

v1.0.1(2mo ago)415—0%MITPHPPHP ^8.1

Since Feb 21Pushed 2mo agoCompare

[ Source](https://github.com/andrevabo/danfse-nacional)[ Packagist](https://packagist.org/packages/andrevabo/danfse-nacional)[ Docs](https://github.com/andrevabo/danfse-nacional)[ RSS](/packages/andrevabo-danfse-nacional/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (4)Versions (3)Used By (0)

DANFSe Nacional
===============

[](#danfse-nacional)

Biblioteca PHP para geração de PDF do DANFSe (Documento Auxiliar da Nota Fiscal de Serviços eletrônica) a partir do XML da NFS-e Padrão Nacional.

A biblioteca recebe o XML de uma NFS-e autorizada e devolve o conteúdo binário de um PDF em A4 retrato, sem nenhuma dependência de framework. Pode ser usada em projetos Laravel, Symfony, ou em scripts PHP puro.

O objetivo principal desta biblioteca é criar um documento o mais fiel possível ao DANFSe original gerado pela API da SEFAZ, com apenas alguns ajustes para melhorar a legibilidade.

Nas NFS-e do ambiente de Homologação, o PDF apresenta a mesma mensagem do documento original, "NFS-e SEM VALIDADE JURÍDICA", além de uma marca d’água adicional para diferenciar os PDFs de teste dos emitidos em Produção.

Exemplos
--------

[](#exemplos)

- [DANFSe - Produção](examples/danfse.pdf)
- [DANFSe - Homologação](examples/danfse-homologacao.pdf)

Requisitos
----------

[](#requisitos)

PHP 8.1 ou superior com as extensões `simplexml`, `mbstring` e `fileinfo` habilitadas.

Instalação
----------

[](#instalação)

```
composer require andrevabo/danfse-nacional
```

Uso básico
----------

[](#uso-básico)

O caminho mais direto é passar o XML e receber o PDF em uma única chamada.

```
use DanfseNacional\DanfseGenerator;

$xml = file_get_contents('nfse_autorizada.xml');

$generator = new DanfseGenerator();
$pdf = $generator->generateFromXml($xml);

file_put_contents('danfse.pdf', $pdf);
```

Logo da empresa
---------------

[](#logo-da-empresa)

Por padrão, o cabeçalho do documento exibe o logo incluído no pacote. Para substituí-lo pelo logo da empresa, informe o caminho do arquivo de imagem via `logoPath`. A biblioteca detecta o MIME type e monta o data URI automaticamente.

```
use DanfseNacional\DanfseGenerator;
use DanfseNacional\Config\DanfseConfig;

$config = new DanfseConfig(logoPath: '/caminho/para/logo.png');
$generator = new DanfseGenerator($config);

$pdf = $generator->generateFromXml($xml);
```

Para suprimir o logo completamente, passe `false`.

```
$config = new DanfseConfig(logoPath: false);
```

Caso o dado já esteja disponível como data URI (por exemplo, quando o logo é armazenado em banco de dados), é possível fornecê-lo diretamente via `logoDataUri`. Se ambos `logoDataUri` e `logoPath` forem informados, `logoDataUri` tem precedência. `logoPath: false` sempre suprime o logo, independente de `logoDataUri`.

```
$config = new DanfseConfig(logoDataUri: 'data:image/png;base64,...');
```

Identificação do município
--------------------------

[](#identificação-do-município)

O cabeçalho do DANFSe possui um espaço reservado para a identificação do ente municipal emissor. Por padrão esse espaço fica em branco. Para preenchê-lo, configure `MunicipalityBranding` com o nome do município, a secretaria responsável e o e-mail de contato. O logotipo do município segue a mesma convenção: aceita caminho de arquivo ou data URI.

```
use DanfseNacional\DanfseGenerator;
use DanfseNacional\Config\DanfseConfig;
use DanfseNacional\Config\MunicipalityBranding;

$config = new DanfseConfig(
    logoPath: '/caminho/para/logo-empresa.png',
    municipality: new MunicipalityBranding(
        name: 'Prefeitura de Niterói',
        department: 'Secretaria Municipal de Fazenda',
        email: 'iss@fazenda.niteroi.rj.gov.br',
        logoPath: '/caminho/para/logo-prefeitura.png',
    ),
);

$generator = new DanfseGenerator($config);
$pdf = $generator->generateFromXml($xml);
```

Geração em dois passos
----------------------

[](#geração-em-dois-passos)

É possível acessar o método `parseXml()` para obter um objeto `DanfseNacional\Dto\NFSe` com os dados da NFS-e antes de gerar o PDF.

```
use DanfseNacional\DanfseGenerator;

$generator = new DanfseGenerator();

$nfse = $generator->parseXml($xml);

// Acessa os dados tipados via DTOs
$numeroNfse = $nfse->infNFSe->nNFSe;
$cnpjEmitente = $nfse->infNFSe->emit->CNPJ;
$valorLiquido = $nfse->infNFSe->valores->vLiq;
$descricaoServico = $nfse->infNFSe->DPS->infDPS->serv->cServ->xDescServ;

$pdf = $generator->generatePdf($nfse);
```

Geração do HTML intermediário
-----------------------------

[](#geração-do-html-intermediário)

Para inspecionar o HTML gerado antes da renderização, útil em testes e depuração, use `generateHtml()`.

```
use DanfseNacional\DanfseGenerator;

$generator = new DanfseGenerator();
$nfse = $generator->parseXml($xml);

$html = $generator->generateHtml($nfse);
```

Entrega da resposta em aplicações web
-------------------------------------

[](#entrega-da-resposta-em-aplicações-web)

Em vez de salvar o arquivo em disco, o conteúdo binário do PDF pode ser enviado diretamente como resposta HTTP.

```
// PHP puro
header('Content-Type: application/pdf');
header('Content-Disposition: inline; filename="danfse.pdf"');
echo $pdf;

// Laravel
return response($pdf, 200, [
    'Content-Type' => 'application/pdf',
    'Content-Disposition' => 'inline; filename="danfse.pdf"',
]);
```

Estrutura dos dados mapeados
----------------------------

[](#estrutura-dos-dados-mapeados)

O método `parseXml()` retorna um objeto `DanfseNacional\Dto\NFSe` com propriedades tipadas e `readonly`. A hierarquia segue a estrutura do XML da NFS-e Nacional:

```
NFSe
└── InfNFSe
    ├── emit (Emitente)
    │   └── enderNac (EnderecoEmitente)
    ├── valores (ValoresNFSe)
    └── DPS (Dps)
        └── infDPS (InfDPS)
            ├── prest (Prestador)
            │   └── regTrib (RegTrib)
            ├── toma (Tomador)
            │   └── end (Endereco)
            │       └── endNac (EnderecoNacional)
            ├── interm (Intermediario)
            │   └── end (Endereco)
            ├── serv (Servico)
            │   ├── locPrest (LocPrest)
            │   └── cServ (CServ)
            └── valores (Valores)
                ├── vServPrest (VServPrest)
                └── trib (Tributacao)
                    ├── tribMun (TribMunicipal)
                    ├── tribFed (TribFederal)
                    │   └── piscofins (PisCofins)
                    └── totTrib (TotTrib)
                        └── pTotTrib (TotTribPercent)

```

Todos os campos opcionais no esquema da NFS-e são representados como propriedades `nullable` ou com valor padrão de string vazia, portanto o acesso nunca lança exceções por campo ausente.

Dependências
------------

[](#dependências)

A biblioteca depende exclusivamente de pacotes sem acoplamento a frameworks:

`dompdf/dompdf` para renderização do HTML em PDF, `cuyz/valinor` para o mapeamento seguro do array XML para os DTOs tipados, e `bacon/bacon-qr-code` para a geração do QR Code de consulta pública.

Testes
------

[](#testes)

```
composer install
./vendor/bin/phpunit
```

###  Health Score

38

—

LowBetter than 85% of packages

Maintenance84

Actively maintained with recent releases

Popularity12

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity44

Maturing project, gaining track record

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 ~3 days

Total

2

Last Release

83d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/5fee54622ad8c797ec146d67cff0dd2a76a303fcf309db8a9428b568112522ff?d=identicon)[andrevabo](/maintainers/andrevabo)

---

Tags

pdfnota fiscalbrazilnfsenfs-eDanfenfse-nacionaldanfse

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/andrevabo-danfse-nacional/health.svg)

```
[![Health](https://phpackages.com/badges/andrevabo-danfse-nacional/health.svg)](https://phpackages.com/packages/andrevabo-danfse-nacional)
```

###  Alternatives

[barryvdh/laravel-dompdf

A DOMPDF Wrapper for Laravel

7.3k87.6M278](/packages/barryvdh-laravel-dompdf)[consoletvs/invoices

Generate PDF invoices for your customers in laravel

455275.5k](/packages/consoletvs-invoices)[nucleos/dompdf-bundle

This bundle provides a wrapper for using dompdf inside symfony.

54882.8k1](/packages/nucleos-dompdf-bundle)[dino/dompdf-module

A Zend Framework 2 module for incorporating DOMPDF support.

61465.1k8](/packages/dino-dompdf-module)[hadder/nfse-nacional

Pacote para geração de NFSe Nacional usando componentes NFePHP (https://github.com/nfephp-org)

632.7k](/packages/hadder-nfse-nacional)[greenter/report

Representacion Impresa para Facturacion Electrónica SUNAT - Perú

1224.1k1](/packages/greenter-report)

PHPackages © 2026

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