Download the PHP package orangecat/module-verifactuapi without Composer

On this page you can find all versions of the php package orangecat/module-verifactuapi. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

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 PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • 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.
Please rate this library. Is it a good library?

Informations about the package module-verifactuapi

Orangecat Verifactuapi - Módulo de Integración VERIFACTU para Magento 2

⚠️ AVISO IMPORTANTE

Este módulo NO ha sido probado en ambientes productivos y debe ser utilizado bajo la exclusiva responsabilidad de quien lo instale y use.

El módulo se proporciona "tal cual" sin garantías de ningún tipo. Se recomienda encarecidamente realizar pruebas exhaustivas en entornos de desarrollo y staging antes de considerar su uso en producción.

📋 Sobre VERIFACTU

A partir de julio de 2026, la Agencia Tributaria española (AEAT) implementará el sistema VERIFACTU (anteriormente conocido como VeriFactu), que exigirá que todos los sistemas de facturación cumplan con los requisitos de trazabilidad e integridad establecidos en el reglamento.

Este módulo facilita la integración de Magento 2 con el sistema VERIFACTU para cumplir con esta obligación legal.

⚙️ Arquitectura de Integración

IMPORTANTE: Este módulo NO se comunica directamente con la API de la AEAT. En su lugar, utiliza el servicio intermediario VERIFACTU API de NEMON INVOCASH (https://verifactuapi.es), que actúa como puente entre Magento y la AEAT.

Flujo de trabajo:

🚀 Características Principales

Para el Cliente (Frontend)

Para el Administrador (Backend)

Panel de Control de Facturas

Grid de Logs de API

Accesible desde Sistema > Herramientas > Verifactu API Logs

Webhooks

📦 Instalación

⚙️ Configuración

Navega a: Tiendas > Configuración > Orangecat > Verifactu API

1. Configuración General (General Settings)

2. Credenciales de API (API Credentials)

💡 Nota: Necesitas crear una cuenta en https://verifactuapi.es para obtener estas credenciales

3. Información del Emisor (Emisor Information)

4. Configuración de Reintentos (Retry Settings)

5. Configuración de Notificaciones (Notification Settings)

6. Configuración del Webhook (Webhook Configuration)

7. Configuración de Visualización del QR (QR Display Settings)

Personaliza los mensajes mostrados a los clientes:

8. Configuración de Depuración (Debug Settings)

🔄 Funcionamiento del Sistema

Proceso Automático

  1. Creación de Factura: Cuando se crea una factura en Magento, se crea automáticamente un registro en estado "pendiente"

  2. Procesamiento por Cron: El cron job (*/5 * * * * - cada 5 minutos) procesa hasta 50 facturas pendientes por ejecución

  3. Envío a VERIFACTU: Las facturas se envían a la API de VERIFACTU con todos los datos fiscales necesarios

  4. Estado "Enviada": La factura pasa a estado "sent" (enviada), esperando validación de la AEAT

  5. Webhook de Confirmación: Cuando la AEAT valida la factura, VERIFACTU envía una notificación webhook con el resultado

  6. Estado Final: La factura pasa a estado "confirmed" (confirmada), "warning" (confirmada con advertencias), o se reintenta si hay errores

Gestión de Errores

🌍 Idiomas Soportados

El módulo incluye traducciones completas para:

Las traducciones se encuentran en el directorio i18n/

🔧 Tareas Cron

El módulo registra dos tareas cron:

  1. Procesamiento de Facturas Pendientes

    • Job: orangecat_verifactuapi_process_pending
    • Frecuencia: Cada 5 minutos (*/5 * * * *)
    • Función: Envía facturas pendientes a VERIFACTU (máximo 50 por ejecución)
  2. Limpieza de Logs Antiguos
    • Job: orangecat_verifactuapi_clean_logs
    • Frecuencia: Diaria a las 2:00 AM (0 2 * * *)
    • Función: Elimina logs más antiguos que el período configurado

📊 Base de Datos

El módulo crea dos tablas:

  1. orangecat_verifactu_invoice: Almacena el estado y datos de cada factura enviada a VERIFACTU
  2. orangecat_verifactu_api_log: Registra todas las comunicaciones con la API (si el debug está activado)

🐛 Debug y Resolución de Problemas

Activar Logs Detallados

  1. Navega a la configuración del módulo
  2. En "Debug Settings", activa "Activar Registro Detallado"
  3. Revisa los logs en Sistema > Herramientas > Verifactu API Logs

Logs del Sistema

Los logs del módulo también se escriben en:

Busca líneas que contengan "Verifactu" para filtrar información relevante.

Problemas Comunes

Facturas que no se envían:

Webhook no funciona:

PDFs sin QR:

📝 Notas Técnicas

Cálculo de Impuestos

El módulo agrupa automáticamente los artículos de la factura por tipo impositivo y los ajusta a las tasas válidas españolas (0%, 2%, 4%, 5%, 7.5%, 10%, 21%).

Destinatario (Cliente)

El NIF del cliente solo se incluye en el registro si:

Compatibilidad

🤝 Soporte

No se brinda ningun tipo de soporte sobre el codigo de este modulo

Para soporte relacionado con la API de VERIFACTU, contacta con NEMON INVOCASH en https://verifactuapi.es

🔗 Enlaces Útiles


Versión del módulo: 1.0.0
Última actualización: 2025


All versions of module-verifactuapi with dependencies

PHP Build Version
Package Version
Requires php Version ^7.4|^8.0|^8.1
magento/framework Version ^102.0|^103.0
magento/module-sales Version ^102.0|^103.0
magento/module-backend Version ^102.0|^103.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package orangecat/module-verifactuapi contains the following files

Loading the files please wait ...