Printags para PrestaShop
Módulo de PrestaShop para vender sus tarjetas PVC y NFC personalizadas
Su cliente sube el diseño de su tarjeta en la ficha de producto. El pedido pagado va a Printags, que lo imprime y lo envía a su cliente. El número de seguimiento vuelve al pedido de PrestaShop.
Versión 1.0.0 · PrestaShop 8.1, 8.2 y 9 · licencia AFL-3.0 · Se instala con el archivo zip, sin pasar por PrestaShop Addons
Lo que hace el módulo
¿Qué hace el módulo de Printags en su tienda PrestaShop?
El diseño se sube en la ficha de producto
Un bloque del módulo recibe el archivo: PNG, JPEG o PDF de hasta 25 MB, enviado directamente desde el navegador del cliente a Printags, con vista previa y control de las proporciones de la tarjeta (89,6 × 57,98 mm). PrestaShop solo conserva el identificador del archivo, en la personalización de la línea del carrito.
Un enlace codificado en el chip NFC
El cliente puede indicar un enlace para codificar en el chip. El bloqueo del chip en solo lectura es una opción por producto, desactivada por defecto e irreversible.
El pedido pagado se convierte en un pedido de Printags
Cuando el pedido pasa a un estado pagado, el módulo pide un presupuesto a Printags, comprueba su saldo y crea el pedido en firme. Nunca dos veces, y reenviado automáticamente tras un error de red.
El seguimiento vuelve al pedido
El número de seguimiento se anota en el transportista del pedido, como desde el back-office, en tiempo real por webhook o en cada ejecución de la tarea cron. Por defecto, el cliente recibe el correo «en tránsito» y el pedido pasa a «Enviado».
Un modo Prueba en el sandbox
En modo Prueba, los pedidos se crean en el sandbox de Printags: ni se cobran ni se fabrican. Prueba y Producción tienen cada uno su propia conexión.
Una copia de la tienda no envía nada
La conexión está ligada a la dirección de la tienda. En una copia (preproducción), ningún pedido va a Printags y la conexión original no se toca.
Requisitos
¿Qué necesita para instalar el módulo?
- PrestaShop 8.1, 8.2 o 9
- PHP 7.2.5 o posterior, PHP 8.1 o posterior para PrestaShop 9
- Una tienda servida en https
- Una tarea cron que llame a una dirección cada 5 minutos, recomendada
- Una cuenta Printags con una suscripción activa
- Interfaz del módulo en español, inglés, francés, alemán e italiano
Las tarjetas que pide el módulo se facturan a la tarifa del plan de su cuenta Printags y se cargan en el saldo de la cuenta con cada pedido enviado.
Instalación
¿Cómo instalar y conectar el módulo de PrestaShop?
1
Descargue el módulo
El archivo printags-prestashop.zip, con el botón en la parte superior de esta página. No lo descomprima.
2
Instálelo en PrestaShop
Módulos > Administrador de módulos y luego «Subir un módulo». Arrastre el archivo zip o selecciónelo: PrestaShop instala el módulo.
3
Abra la configuración del módulo
Haga clic en «Configurar» al terminar la instalación, o en el módulo Printags en el Administrador de módulos.
4
Elija el modo Prueba y guarde
El módulo arranca en modo Producción. Elija Prueba: los pedidos pasan por el sandbox de Printags y ni se cobran ni se fabrican. Guarde antes de conectar, la conexión se aplica al modo elegido.
5
Haga clic en «Conectar Printags»
Ninguna clave API que copiar: la conexión es una autorización OAuth en Printags. La tienda debe usar https.
6
Autorice la tienda en su panel de Printags
Inicie sesión en su cuenta Printags y apruebe la conexión. En modo Producción, solo el titular de la cuenta y sus administradores pueden conectar una tienda. De vuelta en PrestaShop, la configuración muestra la cuenta conectada y su saldo.
7
Declare sus productos Printags
Sección «Productos Printags», «Añadir o modificar un producto»: indique el ID del producto de PrestaShop, elija el producto Printags en el catálogo (el modelo de tarjeta) y, si hace falta, el embalaje. Marque «Bloquear el chip tras la codificación» solo si el chip no debe reescribirse nunca. El bloque para subir el diseño aparece entonces en la ficha del producto.
8
Programe la tarea cron
La sección «Envío y seguimiento» muestra una dirección que el cron de su servidor debe llamar cada 5 minutos: es la que envía los pedidos pagados. Sin cron, la opción «Enviar también los pedidos pendientes tras las páginas del back-office», activada por defecto, los envía como máximo cada 5 minutos mientras alguien usa el back-office.
9
Haga un pedido de prueba
Pida este producto en su tienda subiendo un diseño y pase el pedido a un estado pagado. La nota «Printags: pedido de PRUEBA creado» aparece en la página del pedido en el back-office.
10
Pase a Producción
Elija el modo Producción, guarde y haga clic de nuevo en «Conectar Printags»: cada modo tiene su propia conexión. Los pedidos pagados se imprimen, se envían y se cobran.
Preguntas frecuentes
El módulo de Printags para PrestaShop
¿Cómo se facturan las tarjetas que pide el módulo?
A la tarifa del plan de su cuenta Printags. El importe se carga en el saldo prepago de la cuenta con cada pedido enviado, tras el presupuesto que el módulo pide a Printags.
¿Qué pasa si el saldo de mi cuenta Printags no es suficiente?
El pedido no se envía y queda a la espera. Su estado en PrestaShop no cambia, así que su cliente no recibe ningún correo. Una nota indica el total y el saldo, y se envía un correo a la dirección de la tienda. Recargue la cuenta y haga clic en «Enviar a Printags» en la página del pedido o en la lista «Pedidos pendientes de su acción» de la configuración del módulo.
¿Un pedido cancelado o reembolsado en PrestaShop se cancela en Printags?
No automáticamente una vez enviado: una nota y un correo le avisan, y usted lo cancela desde su panel de Printags si no debe fabricarse. Las tarjetas reembolsadas antes del envío no se piden.
¿Los pedidos contra reembolso se envían a Printags?
Sí, una vez pagados: cuando el pedido pasa a «Pago aceptado» o «Entregado», o con «Enviar a Printags». El módulo ps_cashondelivery se reconoce de entrada, y otros módulos de pago contra reembolso se añaden en los ajustes. La opción «Enviar automáticamente los pedidos contra reembolso», desactivada por defecto, los envía sin esperar: su saldo Printags se carga entonces antes de que su cliente pague.
¿Adónde va el archivo de mi cliente y qué datos recibe Printags?
El diseño va directamente del navegador del cliente a Printags, mediante un enlace firmado de un solo uso: no se guarda en su servidor y PrestaShop solo conserva el identificador del archivo. Una vez pagado el pedido, Printags recibe las líneas del pedido, el identificador del diseño, el enlace NFC y la dirección de entrega (nombre, dirección, teléfono, correo) para imprimir y enviar las tarjetas.
¿Hace falta una tarea cron?
Es recomendable: una tarea cron que llame cada 5 minutos a la dirección que muestra la configuración del módulo envía los pedidos pagados y recoge el seguimiento. Si el módulo Gestor de tareas cron (cronjobs) está instalado, la tarea también se registra allí, cada hora. Sin cron, los pedidos salen como máximo cada 5 minutos mientras alguien usa el back-office.
¿Mi tienda debe ser accesible desde internet?
Para el seguimiento en tiempo real, sí: Printags llama a un webhook en su tienda, en https. Sin webhook, la tarea cron consulta el estado de los pedidos abiertos cada hora.
¿Puedo usar el módulo en una copia de mi tienda?
La conexión está ligada a la dirección de la tienda donde se hizo. En una copia (preproducción), no se envía ningún pedido y la conexión original no se renueva ni se revoca. Si la tienda ha cambiado de dirección de verdad, conecte Printags de nuevo.
¿El módulo está en PrestaShop Addons?
No. Se instala con el archivo zip de esta página: Módulos > Administrador de módulos, «Subir un módulo».
Sus primeras tarjetas vendidas desde PrestaShop
Instale el módulo, conecte su cuenta en modo Prueba y haga un pedido de prueba antes de abrir la venta.