Download the PHP package kowts/efatura-cv without Composer
On this page you can find all versions of the php package kowts/efatura-cv. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download kowts/efatura-cv
More information about kowts/efatura-cv
Files in kowts/efatura-cv
Package efatura-cv
Short Description Biblioteca PHP para validação e emissão de documentos fiscais electrónicos e-Fatura de Cabo Verde.
License MIT
Homepage https://github.com/Kowts/efatura-cv-php
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package efatura-cv
e-Fatura CV para PHP
Biblioteca PHP independente de frameworks para validar documentos fiscais, gerar XML DFE v11, validar com os XSD oficiais, assinar com XAdES-BES, criar pacotes ZIP e comunicar com serviços e-Fatura de Cabo Verde.
[!IMPORTANT] Este projecto não é oficial da DNRE. A utilização em produção exige homologação do software, credenciais válidas e testes nos ambientes oficiais.
Funcionalidades
- nove tipos de documento:
FTE,FRE,TVE,RCE,NCE,NDE,DTE,DVEeNLE; - geração, validação e interpretação de IUD;
- validação de NIF, entidades, linhas, impostos e reconciliação de totais;
- emissão online e em contingência;
- geração de XML compacto DFE v11;
- ciclo de eventos
FDCeUDN, incluindo XML, ZIP e submissão; - validação com os XSD oficiais de 27 de Maio de 2024;
- assinatura XAdES-BES com RSA-SHA256;
- validação de certificados e correspondência da chave privada;
- pacotes ZIP Deflate com nomes
{IUD}.xml; - sequências e idempotência em memória ou transaccionais por PDO;
- submissão por middleware e directamente à plataforma;
- consultas fiscais, repetição segura e reconciliação através de PSR-18;
- cálculos monetários com representação decimal exacta;
- DFA em PDF com QR Code;
- DTOs imutáveis e tipados, sem retirar a API por arrays;
- integrações opcionais com Laravel, Symfony e Yii2;
- CLI para inspeccionar IUDs e validar XML;
- respostas JSON/XML normalizadas;
- nenhuma dependência de Laravel, Symfony ou outro framework.
Fluxo de emissão
O fluxo completo, com decisões de contingência, validação, assinatura, submissão e reconciliação, está documentado em Arquitectura.
Requisitos
- PHP 8.1 ou superior;
- extensões
curl,dom,json,libxml,opensslezip.
Instalação
Para instalar directamente do ramo de desenvolvimento, pode declarar o repositório Git:
Utilização rápida
Integração com Yii2
Instale também o Yii2 na aplicação consumidora:
Para arranque local, testes ou ambientes sem submissão fiscal real, pode
registar o componente apenas com config:
[!WARNING] Em produção, configure o componente Yii2 através da propriedade
factory, utilizandoPdoSequenceStoreePdoSubmissionRegistry. O armazenamento em memória destina-se apenas a desenvolvimento e testes.Consulte docs/yii2.md para a configuração completa.
Depois use a biblioteca sem duplicar regras fiscais:
Em produção, construa o cliente com uma factory e stores persistentes:
As tabelas de sequência e submissão devem ser criadas por migrações Yii2.
Sequências em produção
O armazenamento predefinido existe apenas em memória. Em produção, use uma base de dados para impedir números duplicados entre processos. A implementação PDO suporta SQLite, MySQL/MariaDB, PostgreSQL e SQL Server:
A sequência é independente por NIF transmissor, ano, LED e tipo documental. Guarde sempre o IUD, XML, ZIP e resposta de transporte. Uma falha de rede não autoriza a reutilização ou substituição automática do número fiscal.
Consulte Persistência PDO para detalhes de motores suportados, migrações, idempotência e limites conhecidos.
Segurança
- nunca envie chaves, certificados, tokens ou credenciais para o navegador;
- não guarde segredos no repositório;
- valide o certificado antes da emissão;
- use TLS e armazenamento cifrado;
- registe respostas técnicas sem expor dados pessoais ou segredos;
- fixe uma versão exacta do pacote em sistemas de produção.
Consulte Assinatura e certificados e Segurança.
Documentação
- Arquitectura
- Referência da API
- Referência automática da API
- Auditoria técnica
- Conformidade
- Assinatura e certificados
- Persistência PDO
- Guia de produção
- Emissão em contingência
- Laravel, Symfony e Yii2
- Guia fiscal completo para Yii2
- Lançamentos e verificação
- Exemplos completos
- Exemplo em PHP puro
- Exemplos dos tipos documentais
- Contribuir
Estado do projecto
O pacote está em desenvolvimento activo. Os XSD oficiais estão incluídos, mas não foram publicados vectores oficiais para comparar byte a byte IUD, ZIP e assinaturas. Os testes internos não devem ser confundidos com certificação oficial.
Origem dos artefactos
Os XSD incluídos são os artefactos do sistema e-Fatura de Cabo Verde.
Licença
MIT © 2026 Kowts.
All versions of efatura-cv with dependencies
ext-curl Version *
ext-dom Version *
ext-json Version *
ext-libxml Version *
ext-openssl Version *
ext-zip Version *
nyholm/psr7 Version ^1.8
psr/http-client Version ^1.0
psr/http-factory Version ^1.0
psr/log Version ^3.0