Weave Code
Sped Nfe Laravel Package
nfephp-org/sped-nfe
Biblioteca PHP para gerar, assinar e comunicar NF-e (55) e NFC-e (65) com as SEFAZ. Suporta todos os estados, emissão com eCPF (com exceções), envio síncrono e atualizações conforme notas técnicas e schemas recentes do SPED NF-e.
API para geração e comunicação das NFe com as SEFAZ autorizadoras
Frequently asked questions about Sped Nfe
- Como instalar o nfephp-org/sped-nfe em um projeto Laravel?
- Use Composer para instalar via `composer require nfephp-org/sped-nfe`. Não há dependências Laravel específicas, mas você precisará configurar manualmente a geração de XML, assinatura digital (com certificados A1/A3) e comunicação com SEFAZ. Recomenda-se usar o Laravel Service Container para gerenciar instâncias da classe principal.
- O pacote suporta NF-e 5.0 e NFCe com QR-Code versão 3?
- Sim, o pacote está atualizado com as Notas Técnicas recentes (2025.001 e 2025.002), incluindo suporte ao QR-Code NFCe versão 3 e adequações da Reforma Tributária do Consumo (RTC). Verifique o README para versões específicas dos schemas (PL_010v1.20b, PL_010C v1.30).
- Como lidar com certificados digitais (A1/A3) no Laravel?
- Armazene os arquivos de certificados (PFX ou PEM) em um diretório seguro (ex: `storage/app/certificates/`) e use o Laravel Filesystem para carregá-los dinamicamente. O pacote exige que você configure o caminho e senha do certificado antes de assinar XMLs. Evite hardcoding de credenciais.
- O pacote é compatível com Laravel 9 e PHP 8.x?
- O pacote foi lançado em 2020 e não tem garantia de compatibilidade nativa com PHP 8.x ou Laravel 9+. Teste em um ambiente isolado e, se necessário, faça ajustes manuais (ex: tipagem estrita, namespaces). Considere forks ativos ou alternativas como `nfephp/nfe` para projetos novos.
- Como testar a integração com SEFAZ sem enviar NF-es reais?
- Use o modo *sandbox* do SEFAZ (disponível em alguns estados como SP e RJ) ou implemente mocks com a biblioteca `vcrphp` para gravar/resgatar respostas XML. O pacote não inclui um ambiente de teste integrado, então você precisará configurar manualmente os endpoints de homologação.
- Quais estados brasileiros são suportados para emissão de NF-e com eCPF?
- Os estados **CE, PR e SP não aceitam emissão de NF-e com eCPF**. Para os demais estados (incluindo AM e GO, que não foram verificados oficialmente), o pacote deve funcionar. Consulte a documentação do SEFAZ do seu estado para confirmar regras específicas.
- Como tratar erros de validação do SEFAZ (ex: cStat=500)?
- O SEFAZ retorna erros em XML com códigos como `cStat=500` (rejeição). O pacote não traduz esses erros automaticamente, então você deve implementar uma camada de mapeamento (ex: `NFeErrorMapper`) para converter mensagens técnicas em formatos legíveis para usuários ou logs.
- É possível processar NF-es em lote ou apenas uma por vez?
- O pacote não inclui recursos nativos de batch processing, mas você pode implementar lógica personalizada para enviar várias NF-es em sequência ou usar filas do Laravel (ex: `nfephp/nfe-queue`) para processamento assíncrono. Considere limites de taxa do SEFAZ (geralmente 1 NF-e por segundo).
- Quais alternativas ao nfephp-org/sped-nfe existem para Laravel?
- Alternativas incluem `nfephp/nfe` (mais ativo, suporte a NF-e 5.0), `sped/nfe` (com foco em SPED), ou soluções comerciais como **ContaAzul NF-e** ou **Totvs NF-e**. Avalie se a alternativa suporta seus requisitos de estado (ex: SP, RJ) e integração com ERP.
- Como garantir conformidade com as Notas Técnicas do SEFAZ (ex: 2025.002-RTC)?
- O pacote já incorpora atualizações recentes, mas você deve validar manualmente os XMLs gerados contra os schemas do SEFAZ (ex: `PL_010v1.20b`). Use ferramentas como o **Validador de NF-e do SEFAZ** ou bibliotecas como `spatie/array-to-xml` para garantir conformidade antes do envio.
Weaver
How can I help you explore Laravel packages today?