# efatura

> Framework-agnostic Node.js engine for Cabo Verde e-Fatura fiscal documents. The core builds DFE documents, generates official v11 XML, signs with XAdES-BES, packages ZIP payloads, and checks DNRE fiscal readiness, with Express, Fastify, and Nest adapters over shared HTTP routes.

## Start here

- [Installation](https://efatura.akira-io.com/01-installation): The package ships runtime dependencies for validation and DFA PDF generation:
- [Configuration](https://efatura.akira-io.com/02-configuration): createEfatura(config) accepts a config object and optional dependency implementations.
- [Quick Start](https://efatura.akira-io.com/03-quick-start): invoice.id is generated as a UUID when no id is provided.

## Guides

- [Technical Briefing: Cape Verde e-Fatura](https://efatura.akira-io.com/04-technical-briefing): This document is the project reference for implementing @akira-io/efatura. It consolidates the supplied official Cape Verde Electronic Invoicing System...
- [XML v11](https://efatura.akira-io.com/05-xml-v11): The XML builder follows the Cape Verde e-Fatura Technical Manual v11.0 for the DFE envelope shape.
- [Validation And Zod](https://efatura.akira-io.com/06-validation-zod): The core layer contains contracts only. Zod is used outside core, in domain value-object schemas and presentation request schemas.
- [Packaging](https://efatura.akira-io.com/07-packaging): DFE transmission uses ZIP files containing compact XML documents. The implementation lives in src/application/packaging because packaging is an application...
- [Adapters](https://efatura.akira-io.com/08-adapters): The package exposes optional HTTP adapters through subpath exports. They live in src/presentation and depend on the public Efatura facade.

## Reference

- [Architecture](https://efatura.akira-io.com/10-architecture): @akira-io/efatura follows the same clean boundary used by node-sisp and payable: a framework-agnostic facade, a contracts-only core, domain value objects...
- [Compliance Matrix](https://efatura.akira-io.com/11-compliance-matrix): This matrix tracks implementation coverage against the official e-Fatura v11 manual and the XML-XSD package published at efatura.cv/docs/xsd.