Conector FactuSOL para PrestaShop: pedidos, precios, existencias y facturas

Descripción

Dos piezas, un solo producto

El conector son dos programas que se compran juntos y trabajan juntos. El módulo ecom_factusol se instala en la tienda PrestaShop (1.7.8 y 8.x) y expone una API con token: guarda el estado de cada pedido respecto a FactuSOL, guarda las facturas que le llegan y pone los botones en la ficha del pedido y en una pestaña propia. El programa FactusolSync se instala en el ordenador donde está FactuSOL, de Software DELSOL: lee y escribe la base de datos de FactuSOL con el mismo motor que usa FactuSOL, y cada pocos minutos llama a la tienda.

Es el programa el que llama a la tienda, nunca al revés. No hay que abrir puertos en el ordenador del comercio, ni poner una IP fija, ni instalar Access ni Office: el instalador lo lleva todo dentro. Y no hay nube por medio: los datos van del ordenador del comercio a su tienda y de su tienda a su ordenador, sin pasar por ningún servidor de terceros ni pagar ninguna cuota.

De la tienda a FactuSOL: los pedidos

Cada pedido que entre en uno de los estados que usted marque (por defecto, los ya pagados: Pago aceptado, Preparación en curso y Pago remoto aceptado) se crea en FactuSOL como pedido de cliente en una serie reservada a la web (por defecto la 7, la misma que reserva DELSOL para Internet), con el mismo total al céntimo, las mismas líneas y el IVA desglosado por tipo. Los portes y los descuentos van como líneas propias con su IVA.

• Si el cliente no existe en FactuSOL, se crea (por su correo; si ya existía, se reutiliza y no se duplica). Los clientes empresa llevan su nombre fiscal, su persona de contacto y su NIF.
• Si un artículo no existe en FactuSOL, se crea en ese momento con su referencia, nombre, precio, coste e IVA, en la familia web que elija, marcado «subir a web» y oculto en la pantalla táctil del TPV. El pedido se crea igualmente.
• Las formas de pago se emparejan módulo a módulo: ps_wirepayment → transferencia, redsys → tarjeta, paypal → PayPal. Lo que no esté emparejado usa la forma de pago por defecto.
• Cada pedido se crea dentro de una transacción: si algo falla a mitad (FactuSOL cerrado, disco lleno) no queda nada a medias, y el error se lee en la ficha del pedido de PrestaShop.
• Un pedido ya exportado no se vuelve a crear, aunque el programa pase mil veces.

La comprobación del NIF decide qué factura se hace. Antes de exportar, el conector mira el NIF de la dirección de facturación. Si está vacío o no es correcto (o si no lo identifica la AEAT, cuando está instalado el módulo aeatnifverify), el pedido llega a FactuSOL sin NIF y marcado «FACTURA SIMPLIFICADA», para que el operario la emita así y no se quede una factura completa a un NIF inventado. Si es correcto, el pedido lleva su NIF y se factura como factura completa.

De FactuSOL a la tienda: precios, coste, existencias, nombre, EAN y estado

En cada pasada el programa lee los artículos de FactuSOL (el precio de la tarifa que elija, el coste, las existencias del almacén que elija, el nombre, el código de barras y si está descatalogado) y la tienda actualiza los productos con la misma referencia (o el mismo EAN-13, si la referencia no aparece). Las combinaciones se localizan por su propia referencia.

Lo que el programa envía y la tienda no tiene permitido, la tienda lo ignora. Lo que no existe en la tienda no se crea: se cuenta y se enseña.

La factura que FactuSOL ya ha emitido, en el pedido

Cuando usted factura el pedido en FactuSOL, el programa ve la factura, monta su PDF con los datos de FactuSOL (empresa, número serie-número, fecha, pedido de origen, cliente, líneas con su IVA, bases y cuotas por tipo, total y forma de pago), lo sube a la tienda y el pedido pasa al estado «Enviado a FactuSOL», que el módulo crea al instalarse y usted puede cambiar por otro. Puede ser automático en cada pasada o a petición, con el botón Solicitar factura de la ficha del pedido.

La factura se descarga desde tres sitios que van al mismo mecanismo: la ficha del pedido en el back-office, la pestaña Pedidos del programa y su pestaña Facturas. Cada enlace de descarga lleva un token nuevo y sirve una sola vez: el anterior deja de valer. Si la factura cambia en FactuSOL, el PDF se sustituye.

Lo que se ve en el back-office

• La pantalla del módulo: la URL de la API y el token con botones para copiarlos y regenerarlo, el estado del agente de Windows (versión, equipo, empresa de FactuSOL, última sincronización, último resultado), los contadores, los diez últimos pedidos, el registro de depuración y la configuración entera en cinco pestañas con un solo botón Guardar.
• La pestaña Pedidos → FactuSOL: todos los pedidos con su estado en la tienda, su estado en FactuSOL y su factura, y cuatro botones por fila: Exportar, Ignorar, Solicitar factura y Descargar.
• La tarjeta FactuSOL en la ficha de cada pedido, con el número del pedido en FactuSOL, el cliente, los artículos creados como «solo web», la factura (número, fecha, importe, descargas) y los mismos cuatro botones. Y, si lo activa, una nota privada en Mensajes por cada exportación y cada factura.

El programa de Windows: FactusolSync

Un ejecutable de 32 bits con instalador, que se instala en el ordenador de FactuSOL (Windows 10 u 11) y usa el motor de Access que FactuSOL ya trae. Funciona con FactuSOL abierto. Tiene cinco pestañas (Estado, Pedidos, Artículos, Facturas y Registro) y un formulario de configuración que lee FactuSOL y le lista sus empresas, series, almacenes, tarifas, formas de pago y tipos de IVA para que elija de un desplegable. El botón Crear tarea programada deja una tarea del Programador de Windows que sincroniza sola cada N minutos, sin ventana. A partir de ahí no hace falta abrirlo.

Lo que NO hace, dicho con todas las letras

• No crea facturas en FactuSOL. FactuSOL lleva VeriFactu y una factura metida a mano en su base de datos saltaría el registro y la cadena de huellas. La factura la emite FactuSOL; el conector la copia a la tienda.
• No toca el TPV de FactuSOL. No escribe en ninguna de sus tablas, y los artículos web quedan ocultos en su pantalla táctil.
• No es un servicio en la nube. Los datos no salen del ordenador del comercio ni de su tienda.
• No crea productos en PrestaShop desde FactuSOL: solo actualiza los que ya existen. Tampoco lleva categorías, imágenes, descripciones ni combinaciones nuevas.
• No lleva clientes de FactuSOL a la tienda ni estados de envío de FactuSOL al pedido.

Requisitos

• PrestaShop 1.7.8 o 8.x, con PHP 7.4 a 8.3. La tienda tiene que responder por HTTPS desde el ordenador de FactuSOL.
• Windows 10 u 11 con FactuSOL de Software DELSOL instalado (el instalador del agente avisa si no encuentra el motor de Access de 32 bits: eso significa que ese no es el ordenador de FactuSOL).
• Multitienda: la configuración es global (un solo FactuSOL para todas las tiendas), se avisa en pantalla y los pedidos se leen de todas.
• Los pedidos anteriores a la instalación quedan marcados como preexistentes y no se exportan solos: nunca se le llena FactuSOL con el histórico de la tienda.