Download the PHP package l2ernestoo/facturalesgt without Composer
On this page you can find all versions of the php package l2ernestoo/facturalesgt. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download l2ernestoo/facturalesgt
More information about l2ernestoo/facturalesgt
Files in l2ernestoo/facturalesgt
Package facturalesgt
Short Description Laravel package for Guatemalan FEL certification with Ainnova / Guatefacturas.
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 facturalesgt
FacturalesGT
FacturalesGT es un package Laravel para emitir, almacenar y anular documentos FEL de Guatemala desde aplicaciones propias, puntos de venta, ERPs o sistemas administrativos.
La primera version esta disenada para trabajar con el certificador Ainnova / Guatefacturas mediante su servicio SOAP. El package mantiene una arquitectura extensible para agregar otros certificadores sin acoplar la logica fiscal a modelos de una aplicacion especifica.
Caracteristicas
- Configuracion desde base de datos, no desde
.env. - Credenciales cifradas con
Laravel Crypt. - Empresa emisora, sucursales fiscales, credenciales, documentos, items y anulaciones.
- Builders para
FACT,FCAM,FPEQ,FCAP,FESP,NABN,RDON,RECI,NDEByNCRE. - Certificacion y anulacion con Ainnova / Guatefacturas.
- Snapshots de documentos emitidos para auditoria.
- Mapeo independiente del modelo fuente: el package no conoce
Order,Sale,Invoiceni ningun modelo de tu app. - Soporte para limites mensuales de DTE y configuracion POS por sucursal.
Requisitos
- PHP
^8.2 - Laravel
^11,^12o^13 - Extensiones PHP
curlysimplexml - Una aplicacion Laravel con
APP_KEYconfigurado para poder cifrar credenciales
Instalacion
Cuando el package ya este publicado en Packagist:
Durante desarrollo local puedes usar un repository tipo path:
Luego ejecuta:
Configuracion opcional
El package carga migraciones automaticamente. Si quieres personalizar defaults tecnicos o nombres de tablas, publica el config:
El archivo config/fel.php no debe usarse para guardar usuarios, passwords o URLs privadas por ambiente. Esas credenciales se guardan en base de datos.
Tablas creadas
fel_companies: empresa emisora principal, NIT, regimen, certificador, modo y limites.fel_company_credentials: usuario FEL, password FEL, basic auth, URLs y maquina.fel_branch_settings: relacion entre empresa emisora y sucursal del sistema.fel_documents: documentos emitidos o con error.fel_document_items: snapshot de lineas certificadas.fel_annulments: anulaciones y respuesta del certificador.
Los nombres se pueden cambiar desde config/fel.php.
Crear configuracion Ainnova / Guatefacturas
Nota:
passwordybasic_passwordse cifran automaticamente. No los guardes en.env.
Mapear una venta, orden o factura
Cada aplicacion debe convertir su modelo fuente a FelDocumentData. Para eso puedes implementar FelSourceMapperInterface.
Emitir un DTE
Si Ainnova / Guatefacturas responde correctamente, el documento queda con status CERTIFIED. Si el certificador falla, queda con status ERROR y se conserva request_xml, soap_request, response_body o error_message segun aplique.
Reintentar un documento con error
Anular un DTE
Si la anulacion es aceptada, el documento pasa a status ANNULLED y se crea un registro en fel_annulments.
Configuracion para POS
Puedes leer la configuracion activa por sucursal:
El resultado incluye empresa activa, documento por defecto, si debe mostrarse un switch de FEL, si debe marcarse automaticamente y el uso mensual:
Tipos de documento soportados
| Tipo | Descripcion |
|---|---|
FACT |
Factura |
FCAM |
Factura cambiaria |
FPEQ |
Factura pequeno contribuyente |
FCAP |
Factura cambiaria pequeno contribuyente |
FESP |
Factura especial |
NABN |
Nota de abono |
RDON |
Recibo por donacion |
RECI |
Recibo |
NDEB |
Nota de debito |
NCRE |
Nota de credito |
Para NCRE y NDEB, envia el documento asociado en options:
Respuesta certificada
El package guarda datos importantes devueltos por Ainnova / Guatefacturas:
metadata.certifier_response puede incluir nombre, direccion, telefono y referencia. Esto es util para tickets, PDFs, reportes y auditoria.
Extender a otro certificador
Implementa CertifierInterface y registralo en config/fel.php:
Luego configura la empresa con certifier = otro.
Ejecutar pruebas
Licencia
MIT
All versions of facturalesgt with dependencies
ext-curl Version *
ext-simplexml Version *
illuminate/contracts Version ^11.0|^12.0|^13.0
illuminate/database Version ^11.0|^12.0|^13.0
illuminate/encryption Version ^11.0|^12.0|^13.0
illuminate/support Version ^11.0|^12.0|^13.0
nesbot/carbon Version ^2.72|^3.0