Verifactu

  • Posts: 39
  • Thank you received: 1
  • Hikashop Business
2 days 11 hours ago #373037

-- HikaShop version -- : 6.5.0.

Hola,

Alguien esta interesado en un plugin para Verifactu para conectar con la AEAT de España?

Un saludo

Please Log in or Create an account to join the conversation.

  • Posts: 86042
  • Thank you received: 14174
  • MODERATOR
2 days 5 hours ago #373038

Hola,

Sí, hay interés, es un tema que nos empieza a llegar de los comerciantes españoles.

Por nuestra parte no está previsto integrarlo en el núcleo de HikaShop a corto plazo, y la razón no es técnica sino legal : el reglamento no obliga solamente al comerciante, obliga también al productor del software, que debe emitir una declaración responsable certificando que su programa cumple los requisitos de integridad e inalterabilidad. Un sistema informático de facturación tiene que ser no modificable por el usuario, y HikaShop es una extensión PHP que el comerciante instala en su propio servidor y que puede modificar libremente con overrides y plugins. Convertir eso en un SIF certificado no es un desarrollo, es un compromiso permanente.

Por eso, si desarrollas un plugin, la arquitectura que te recomendamos es la de puente y no la de SIF completo : HikaShop envía los datos de la factura a un proveedor VeriFactu ya certificado (hay varias APIs en el mercado en España), y ese proveedor genera el registro encadenado, lo firma, lo remite a la AEAT y te devuelve la huella, el CSV y el QR para imprimir en la factura. Así el certificado del comerciante no vive en el servidor de la tienda y la declaración responsable la mantiene el proveedor, no tú. La otra vía, generar tú mismo el registro de alta, la cadena de huellas, la firma XAdES y el registro de eventos, es mucho más trabajo y te deja con la responsabilidad encima.

En HikaShop tienes lo necesario para engancharlo :

- El evento onAfterInvoiceCreate se dispara justo cuando HikaShop asigna el número de factura a un pedido, con el pedido completo como parámetro. Es el punto natural para generar el registro de alta.
- El plugin Attach invoice genera el PDF de la factura con TCPDF, que sabe dibujar códigos QR de forma nativa, así que ahí es donde se añade el QR y la mención VERI*FACTU.

Dos puntos que conviene aclarar antes de empezar, porque cambian el alcance :

- Muchas tiendas no necesitan que HikaShop sea el SIF. Si la factura la emite su programa de contabilidad a partir de un export de pedidos, el SIF es ese programa, y HikaShop solo le alimenta los datos. Los obligados al SII están directamente fuera del ámbito de VeriFactu.
- Si eliges la modalidad VeriFactu, con remisión inmediata a la AEAT, los registros no necesitan firma electrónica, es la remisión la que da la garantía. La modalidad sin remisión sí exige firma y conservación local, y es bastante más pesada de implementar. Para una tienda online la primera es casi siempre la buena opción.

Sobre las herramientas, existe la librería josemmo/Verifactu-PHP, en MIT, que cubre la generación de los registros y el envío a la AEAT. Curiosamente es del mismo autor que josemmo/einvoicing, la librería que ya usamos en nuestro plugin Attach invoice para el formato UBL. Pide PHP 8.2 como mínimo, así que habría que ponerle un control de versión en el plugin.

Si desarrollas el plugin, dínoslo, lo podemos referenciar en nuestra web para que los comerciantes españoles lo encuentren.

Please Log in or Create an account to join the conversation.

  • Posts: 39
  • Thank you received: 1
  • Hikashop Business
3 hours 17 minutes ago #373059

# PLG_HIKASHOP_VERIFACTU

He desarrollado personalmente este plugin para integrar la gestión de **Veri*Factu** con **Joomla + HikaShop**, incorporando las funciones necesarias para la generación, gestión y seguimiento de facturas y abonos.

El plugin ha sido desarrollado y **se han realizado las pruebas pertinentes con la AEAT** dentro del entorno y configuración utilizados durante su desarrollo.

## Características principales

* Gestión de facturas y abonos mediante Veri*Factu*.
* Registro en la base de datos de un **historial de todas las facturas y abonos** procesados por el plugin.
* Conservación de la información necesaria para realizar un seguimiento de cada registro.
* Gestión de facturas negativas/abonos y sus correspondientes tipos de devolución.
* Generación y utilización del **código QR Veri*Factu*** en las facturas.
* Declaración Responsable integrada en el propio plugin.
* Condiciones de uso del software incluidas.
* Manual completo de instalación y configuración incluido dentro del plugin.
* Configuración de los campos personalizados necesarios para el correcto funcionamiento del sistema.

## Código QR

He incorporado la generación del **código QR Veri*Factu*** dentro del funcionamiento del plugin.

El código QR puede utilizarse con **las dos opciones de generación de facturas PDF**:

* La **plantilla de factura incluida de forma nativa en HikaShop**.
* El plugin **HikaShop - generate PDF invoice**.

De esta manera, el código QR Veri*Factu* puede incorporarse a las facturas PDF independientemente de cuál de estos dos sistemas de generación de facturas se utilice.

## Historial de facturas y abonos

El plugin mantiene en la base de datos un **historial de las facturas y abonos gestionados**, permitiendo conservar la información relacionada con los registros enviados y su correspondiente seguimiento.

Esto permite disponer de una trazabilidad de las operaciones realizadas mediante el sistema Veri*Factu*.

## Instalación y configuración

El plugin incluye un **manual completo de instalación y configuración** dentro del propio archivo ZIP.

En dicho manual se detallan, entre otros aspectos:

* Instalación del plugin.
* Configuración necesaria de Veri*Factu*.
* Configuración de HikaShop.
* Configuración de las facturas y abonos.
* Creación y configuración de los **campos personalizados necesarios en HikaShop**.
* Configuración del código QR.
* Procedimientos de comprobación.
* Comandos necesarios para determinadas operaciones.

Se recomienda seguir el manual paso a paso antes de utilizar el plugin en producción.

## Acceso mediante SSH

Para realizar correctamente la instalación y configuración completa del plugin es necesario disponer de **acceso al terminal SSH del alojamiento**.

Los comandos necesarios para la instalación, configuración y comprobación están incluidos en el **manual que se encuentra dentro del propio plugin**.

Por este motivo, antes de instalarlo es necesario comprobar que el alojamiento permite el acceso mediante SSH y que se dispone de los permisos necesarios para ejecutar los comandos indicados en el manual.

## Joomla y HikaShop

El plugin ha sido desarrollado para trabajar conjuntamente con **Joomla y HikaShop**, pero es importante señalar que **Joomla y HikaShop no han sido desarrollados por Locker25.com**.

El plugin utiliza las funcionalidades proporcionadas por estos sistemas para realizar su integración con Veri*Factu*.

## ⚠️ Recomendación antes de instalar

**Recomendamos realizar una copia de seguridad completa del sitio web y de la base de datos antes de instalar el plugin.**

La copia de seguridad debe realizarse antes de cualquier instalación, actualización o modificación relacionada con el plugin.

Esto permitirá restaurar el sitio y la base de datos en caso de que se produzca cualquier incidencia durante la instalación o configuración.

## Pruebas con la AEAT

Durante el desarrollo se han realizado las **pruebas pertinentes con la AEAT** para comprobar el funcionamiento del sistema de envío y gestión de los registros Veri*Factu* dentro del entorno utilizado para el desarrollo.

No obstante, el funcionamiento final puede depender de la configuración concreta del servidor, Joomla, HikaShop, PHP, certificado digital, configuración de la empresa y otros componentes de terceros instalados en cada alojamiento.

Por ello, se recomienda realizar las comprobaciones correspondientes antes de utilizar el sistema en producción.

## Software freeware

**PLG_HIKASHOP_VERIFACTU es software freeware desarrollado por Locker25.com.**

El plugin se distribuye gratuitamente y ha sido desarrollado con el objetivo de facilitar la integración de HikaShop con Veri*Factu*.

El usuario debe leer y aceptar las **Condiciones de Uso** y la **Declaración Responsable** incluidas en el propio plugin antes de utilizarlo.

## Recomendación final

Antes de poner el sistema en producción:

1. Realice una **copia de seguridad completa**.
2. Lea el **manual incluido dentro del plugin**.
3. Compruebe que dispone de **acceso SSH**.
4. Cree y configure todos los **campos personalizados de HikaShop** indicados en el manual.
5. Configure correctamente el sistema Veri*Factu*.
6. Compruebe la configuración del código QR.
7. Realice las pruebas correspondientes.
8. Verifique que las facturas y abonos quedan correctamente registrados en el historial.

**Locker25.com recomienda realizar todas estas comprobaciones antes de utilizar el plugin en un entorno de producción.**

Please Log in or Create an account to join the conversation.

Time to create page: 0.058 seconds
Powered by Kunena Forum