Download the PHP package stea/factura-electronica without Composer
On this page you can find all versions of the php package stea/factura-electronica. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download stea/factura-electronica
More information about stea/factura-electronica
Files in stea/factura-electronica
Package factura-electronica
Short Description Native Costa Rica factura electrónica (v4.4): build, XAdES-EPES sign, and submit comprobantes.
License MIT
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 factura-electronica
stea/factura-electronica
A native PHP 8.5 / Laravel package for Costa Rica factura electrónica v4.4. It builds comprobante XML, signs it with XAdES-EPES using a Hacienda-issued PKCS#12 certificate, and submits it to the Ministerio de Hacienda reception API — with no dependency on external SOAP wrappers, Java signers, or proprietary tooling.
The signing layer is built cleanly on top of robrichards/xmlseclibs;
the rest is plain PHP + illuminate/http. The core (DTOs, clave, XML builders, signer) has no
Laravel dependency and is independently testable.
Status: the four document types this project actually transacts — FE, FEE, FEC, and MensajeReceptor — have been accepted by Hacienda's sandbox (
api-stag). ND, NC, and TE build and validate against the official v4.4 XSDs but have not been exercised against a live response. This is community software, not affiliated with or endorsed by the Ministerio de Hacienda. Validate against your own Hacienda environment before relying on it in production. No warranty — see LICENSE.
Features
- All v4.4 document types:
FacturaElectronica(01),NotaDebito(02),NotaCredito(03),TiqueteElectronico(04),FacturaElectronicaCompra(08),FacturaElectronicaExportacion(09), andMensajeReceptor(05/06/07). - Clave + consecutivo helpers (you own the numbering).
- XAdES-EPES signing: signing-policy hash,
SignedProperties,SigningCertificate,SignerRole, RSA-SHA256, the three required references — built to the structure Hacienda accepts. - Transport: OAuth2 password grant against the IDP (token cached), submit to
recepción, andconsultarstatus, for both sandbox and production. - Typed exceptions and XSD validation against the bundled official v4.4 schemas.
- Framework-friendly: a service provider binds a
FacturaElectronicaManagerfrom config.
Requirements
- PHP 8.5+,
ext-openssl,ext-dom,ext-libxml - A Hacienda-issued PKCS#12 (
.p12) certificate and its PIN - Hacienda API credentials (username / password /
client_id) for your environment
Installation
Publish the config (Laravel):
Set the environment variables the config reads:
The certificate is read from a filesystem path, not an env var. Keep the
.p12out of version control and inject it at deploy time.
Usage
MensajeReceptor (accepting a received comprobante) uses emitirMensajeReceptor(MensajeReceptorDto).
Architecture
Testing
Document builders are validated against the official v4.4 XSDs. A gated integration suite can emit to
the Hacienda sandbox when FE_SANDBOX=1 and credentials are present in the environment; it is skipped
otherwise.
Costa Rica Hacienda v4.4 references
Official Ministerio de Hacienda / Dirección General de Tributación documentation this package
implements (v4.4 is mandatory since 2025; it adds ProveedorSistemas, clave/consecutivo coding,
and CodigoActividadReceptor):
- Anexos y Estructuras v4.4 (the authoritative technical spec — document structures + field notes): portal · PDF
- Comprobantes Electrónicos — Generalidades y Versión 4.4 (overview of the changes): PDF
- Resolución DGT — Disposiciones Técnicas de Comprobantes Electrónicos (the governing resolution): PDF
- Official v4.4 XML schemas (XSD) — bundled in
resources/xsd/v4.4/, sourced from:https://cdn.comprobanteselectronicos.go.cr/xml-schemas/v4.4/(e.g. facturaElectronica.xsd,facturaElectronicaCompra.xsd,facturaElectronicaExportacion.xsd,mensajeReceptor.xsd, …) - XAdES signature policy — the resolution whose SHA-256 digest is embedded in the
SignaturePolicy: Resolución General sobre disposiciones técnicas (PDF) - ATV — Comprobantes Electrónicos portal: atv.hacienda.go.cr
Contributing
Issues and PRs welcome. See CONTRIBUTING.md for setup, testing, static analysis, code style, and PR guidelines. Please do not include real cédulas, certificates, signatures, or invoice data in fixtures or examples — use synthetic values only.
License
MIT — see LICENSE.
All versions of factura-electronica with dependencies
ext-dom Version *
ext-openssl Version *
ext-libxml Version *
robrichards/xmlseclibs Version ^3.1
illuminate/support Version ^11.0 || ^12.0 || ^13.0
illuminate/http Version ^11.0 || ^12.0 || ^13.0