Download the PHP package jcf/espiaonfe without Composer
On this page you can find all versions of the php package jcf/espiaonfe. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download jcf/espiaonfe
More information about jcf/espiaonfe
Files in jcf/espiaonfe
Package espiaonfe
Short Description Pacote Laravel para integração com a API do EspiãoNFe - Gerenciamento de certificados digitais, NF-e, CT-e, NFSe e XMLs
License MIT
Homepage https://github.com/jotacfurtado/espiaonfe-laravel
Informations about the package espiaonfe
Jcf/EspiaoNfe
Pacote Laravel para integração com a API do EspiãoNFe. Este pacote fornece uma interface simples e elegante para interagir com todos os endpoints da API EspiãoNFe, facilitando o gerenciamento de certificados digitais, empresas, NFes, CTes, NFSe e muito mais.
Instalação
Você pode instalar o pacote via Composer:
Configuração
Após instalar o pacote, publique o arquivo de configuração:
Isso criará o arquivo config/espiaonfe.php em sua aplicação.
Em seguida, configure as variáveis de ambiente no seu arquivo .env:
Nota: O
ESPIAONFE_BASE_URIé opcional e já possui um valor padrão (https://api.espiaonfe.com.br). Use apenas se precisar apontar para um ambiente diferente.
Uso
O pacote fornece uma API fluente estilo Laravel que torna o uso extremamente elegante e intuitivo:
✨ Métodos Intuitivos
O pacote inclui métodos auto-explicativos que tornam o código mais limpo e fácil de entender:
Tipo de Período (XMLs)
Modelos de Documentos
API Fluente ✨
O pacote utiliza query builders que permitem encadear métodos de forma fluente, similar ao Eloquent do Laravel:
Exemplo: Obter Empresas com Paginação
Exemplo: Trabalhar com Certificados
Exemplo: NF-e, CT-e e NFSe
Exemplo: XMLs e PDFs
📌 Entendendo tipoPeriodoEmissao() vs tipoPeriodoInclusao()
Estes métodos definem como o período de consulta será interpretado:
-
tipoPeriodoEmissao()- Consulta pela data de emissão do documento- Filtra XMLs pela data em que o documento foi emitido pelo emissor
- Exemplo: NF-e emitida em 15/01/2024 será encontrada ao buscar o período de 01/01/2024 a 31/01/2024
- Use quando: Você quer todos os documentos emitidos em um determinado período
tipoPeriodoInclusao()- Consulta pela data de inclusão no Espião Cloud- Filtra XMLs pela data em que foram recebidos/importados no sistema Espião Cloud
- Exemplo: NF-e emitida em 15/01/2024 mas incluída no sistema em 20/01/2024 será encontrada apenas no período que inclui 20/01/2024
- Use quando: Você quer saber quais documentos foram adicionados ao sistema em um período específico
Exemplo Prático:
Exemplo: Resgate de XML
Exemplo: Logs
Validações e Tratamento de Erros
O pacote inclui validações automáticas e tratamento de erros robusto:
Validações Automáticas
- Formato de Data: Valida formato DD/MM/AAAA e verifica se a data é válida
- Ordem de Período: Garante que a data inicial seja anterior ou igual à data final
- CNPJ/CPF: Valida formato básico (11 ou 14 dígitos, aceita formatação)
- Modelos: Valida modelos fiscais conforme contexto (NF-e, CT-e, etc.)
Exceções Específicas
O pacote fornece exceções específicas para diferentes tipos de erros HTTP:
Configurações Avançadas
Timeout e Retry
Configure timeout e retry automático para requisições:
Logging de Requisições
Para debug, você pode habilitar o logging de todas as requisições:
Isso registrará no log do Laravel:
- Todas as requisições HTTP (método, URI, dados)
- Todas as respostas de erro (status, corpo da resposta)
Changelog
Veja o CHANGELOG para obter informações sobre mudanças recentes.
Licença
Este pacote é de código aberto e está licenciado sob a Licença MIT.
All versions of espiaonfe with dependencies
illuminate/support Version ^10.0|^11.0|^12.0
illuminate/http Version ^10.0|^11.0|^12.0