Download the PHP package daniel-monroy/sat-estado-cfdi without Composer
On this page you can find all versions of the php package daniel-monroy/sat-estado-cfdi. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download daniel-monroy/sat-estado-cfdi
More information about daniel-monroy/sat-estado-cfdi
Files in daniel-monroy/sat-estado-cfdi
Package sat-estado-cfdi
Short Description Paquete interno Laravel para consultar estado CFDI (SAT)
License MIT
Homepage https://github.com/DanielMonroy/SatEstadoCFDI
Informations about the package sat-estado-cfdi
SatEstadoCFDI (Laravel Package)
Este paquete integra la librería phpcfdi/sat-estado-cfdi en Laravel 12 y 13 para consultar el estado de un CFDI directamente en el servicio web del SAT.
El protocolo que utiliza el SAT para esta consulta es SOAP sobre HTTP/HTTPS, expuesto como servicio web. Este paquete se conecta mediante un cliente HTTP PSR-18, con compatibilidad para reintentos, timeouts, caché y una integración HTTP opcional para proyectos Laravel.
Documentación
- Instalación
- Uso
- Integración HTTP
- Errores
- Pruebas
- Seguridad
- Arquitectura
- Registro de cambios
- Contribuir
- Guía de actualización
Compatibilidad
| PHP | Laravel |
|---|---|
| 8.3 | 12, 13 |
| 8.4 | 12, 13 |
📦 Instalación
Instálalo vía Composer:
⚙️ Configuración
Publica el archivo de configuración:
Ejemplo de configuración en config/sat-estado-cfdi.php:
En el archivo .env puedes definir:
Uso desde Laravel
Servicio
Facade
Desde XML
📡 Integración HTTP opcional
Si SAT_ESTADO_EXPOSE_ROUTES está en true, se habilitan los siguientes endpoints:
| Método | Endpoint | Descripción |
|---|---|---|
| POST | /api/cfdi/estado |
Consulta el estado de un CFDI |
| GET | /api/cfdi/estatus |
Verifica que el servicio esté activo |
El prefijo (/api) y el middleware (ej. auth, sanctum, etc.) pueden modificarse con la variable
SAT_ESTADO_ROUTE_PREFIX y SAT_ESTADO_ROUTE_MIDDLEWARE.
Ejemplo de consulta
o con multipart/form-data enviando directamente el archivo XML:
La respuesta será similar a:
Manejo de errores
- Si el CFDI no existe, el paquete responde
404en la integración HTTP opcional y devuelve un DTOnot_found. - Si el XML está mal formado o no puede leerse, la integración HTTP opcional responde
422. - Si el XML excede
SAT_ESTADO_MAX_XML_KB, la integración HTTP opcional responde422. - Si la expresión no contiene al menos
id,re,rrytt, la validación HTTP responderá422.
Desarrollo
Instala dependencias de desarrollo y ejecuta las herramientas locales:
Notas
- El paquete se apoya en y utiliza la librería phpcfdi/sat-estado-cfdi
- El servicio del SAT puede ser intermitente, se recomienda configurar caché y reintentos.
- No desactives
SAT_ESTADO_HTTP_VERIFYsalvo debugging controlado. - Los estados dependen de la respuesta oficial del SAT.
- Si necesitas una integración agnóstica al framework, usa directamente
phpcfdi/sat-estado-cfdi. Este paquete está orientado específicamente a Laravel.
Licencia
Este paquete usa licencia MIT. Sus dependencias principales usan licencias permisivas compatibles, como MIT, BSD-3-Clause y Apache-2.0.
All versions of sat-estado-cfdi with dependencies
laravel/framework Version ^12.0|^13.0
phpcfdi/sat-estado-cfdi Version ^2.0
phpcfdi/cfdi-expresiones Version ^v3.3.0
guzzlehttp/guzzle Version ^7.9
nyholm/psr7 Version ^1.8
php-http/guzzle7-adapter Version ^1.0
ext-dom Version *