librecodeoop / nfse-php

dev-main / 1.0.x-dev 2026-10-14 10:04 UTC

Requires

• php: ^8.2
• ext-dom: *
• ext-mbstring: *
• ext-openssl: *
• ext-soap: *
• bacon/bacon-qr-code: ^3.0
• csharpru/vault-php: ^4.4
• dompdf/dompdf: ^3.1.6
• psr/http-client: ^1.0
• psr/http-factory: ^1.0

Requires (Dev)

• donatj/mock-webserver: ^2.7
• friendsofphp/php-cs-fixer: ^3.0
• php-coveralls/php-coveralls: ^2.9
• phpunit/phpunit: ^11.0
• vimeo/psalm: ^6.0

AGPL-3.0-or-later

• LibreCode Coop

• brazil
• nfse
• fiscal
• nfse-php
• nota-fiscal
• xml-signing
• sefin

Published on Packagist.org on 2026-10-15 22:45 UTC

README

NFS-e Nacional em PHP — nfse-php

Biblioteca PHP livre para integrar a Nota Fiscal de Serviço Eletrônica (NFS-e) no padrão nacional, sem exigir Laravel, Akaunting ou outro framework.

English: Framework-agnostic PHP library for Brazil's National Electronic Service Invoice (NFS-e): DPS submission, consultation, cancellation, digital signing and DANFSe PDF generation.

Integre a NFS-e sem reimplementar o protocolo fiscal

Integrar aplicações ao Sistema Nacional NFS-e envolve XML, assinatura digital, certificados, comunicação com a SEFIN e interpretação dos documentos autorizados. O nfse-php reúne essas responsabilidades em componentes PHP reutilizáveis, para que equipes concentrem esforços nas funcionalidades do seu sistema.

O projeto é útil para desenvolvedores de ERP, sistemas de gestão, plataformas SaaS e integrações que precisam incorporar fluxos de NFS-e Nacional.

O que a biblioteca oferece

• Emissão, consulta e cancelamento de NFS-e por meio dos contratos de integração SEFIN implementados.
• Assinatura digital da DPS, com certificado e recursos de proteção de credenciais.
• Geração local da DANFSe em PDF, a partir do XML autorizado, sem depender da aparência de um sistema de gestão específico.
• Integração com OpenBao/HashiCorp Vault, além de interfaces que permitem adaptar o armazenamento de segredos.
• Consulta de documentos e eventos via ADN, separada do fluxo de emissão SEFIN.
• Validação de XML e assinaturas com distinção explícita entre integridade criptográfica e confiança na cadeia de certificados.

A biblioteca não decide automaticamente o enquadramento tributário de cada operação, não substitui orientação fiscal e não presume que novos leiautes publicados já estejam ativos em produção.

Comece pelo Composer

composer require librecodeoop/nfse-php

Veja a integração PHP, os contratos de emissão e as garantias da DANFSe antes de conectar um ambiente de produção.

Para quem é

Esta é uma biblioteca independente: não precisa do Akaunting e não exige que uma aplicação utilize os mesmos componentes de infraestrutura da LibreCode. Quem desenvolve módulos, conectores ou sistemas próprios pode usar os contratos públicos e adaptar as dependências ao seu contexto.

Para integrar NFS-e diretamente no Akaunting, conheça o módulo akaunting-nfse, mantido separadamente.

Suporte profissional e evolução do projeto

A LibreCode desenvolve soluções livres e oferece consultoria, integração, adaptações, suporte técnico e manutenção para equipes que precisam operar NFS-e em seus sistemas.

Contato comercial: [e-mail]

O código é aberto à comunidade. Contribuições, relatos de problemas e melhorias são bem-vindos; consulte CONTRIBUTING.md e as issues.