PTS Alegra

Documentación completa para instalar, configurar y utilizar el módulo PTS Alegra en tu tienda PrestaShop.

¿Qué es PTS Alegra?

PTS Alegra conecta tu tienda PrestaShop con Alegra para emitir facturas y notas de crédito electrónicas desde el propio pedido, sincronizando clientes, productos, transportistas, cuentas bancarias, numeraciones y retenciones.

5.3.2
Versión
PS 1.7.6+
PS 8.x
PS 9.x
Multitienda
Multi-idioma

Características Principales

Facturación desde el pedido

La factura de Alegra se emite desde la propia ficha del pedido de PrestaShop, y desde ahí también se crean las notas de crédito.

Asociación de datos

Productos, transportistas, clientes, cuentas bancarias y retenciones se emparejan con su equivalente en Alegra para que la factura salga con la información correcta.

Numeraciones por país

Cada país puede tener asignada su propia numeración de Alegra, además de la numeración por defecto del módulo.

Ticket POS

Genera un ticket de punto de venta con los datos del establecimiento que se configuran en el propio módulo.

Requisitos del Sistema

Requisito Mínimo Recomendado
PrestaShop 1.7.6 9.x
PHP 7.2.5 8.1+
Extensiones de PHP curl, mbstring, openssl Las mismas
Cuenta de Alegra Activa, con usuario y token de API Una cuenta sandbox además, para pruebas

Instalación

Existen dos métodos para instalar el módulo en tu tienda PrestaShop, dependiendo de las características de tu servidor.

Método 1: Instalación desde el Back Office

1
Accede al Back Office

Inicia sesión en el panel de administración de tu tienda PrestaShop.

2
Navega a Módulos

Ve a Módulos → Gestor de módulos en el menú lateral.

3
Sube el módulo

Haz clic en "Subir un módulo" y selecciona el archivo ZIP descargado.

4
Instala y activa

Una vez subido, el módulo se instalará automáticamente. Haz clic en "Configurar" para comenzar.

Método 2: Instalación por FTP

1
Descomprime el archivo ZIP

Extrae el contenido del archivo ZIP en tu ordenador local.

2
Conéctate por FTP

Usa un cliente FTP (como FileZilla) para conectarte a tu servidor.

3
Sube la carpeta del módulo

Sube la carpeta del módulo a /modules/ en tu instalación de PrestaShop.

4
Instala desde el Back Office

Ve a Módulos → Gestor de módulos, busca el módulo y haz clic en "Instalar".

Posibles Problemas de Instalación

Si experimentas errores de override al instalar o activar el módulo, no intentes resolverlo por tu cuenta si no tienes experiencia técnica. Contacta con nuestro equipo de soporte para recibir ayuda personalizada y resolver el conflicto de manera segura.

Contactar con Soporte

Cuentas

Es la primera pestaña del módulo y la única que aparece mientras no haya conexión con Alegra. Aquí se dan de alta las cuentas de Alegra con las que va a trabajar la tienda. El módulo admite varias, y una de ellas se marca después como cuenta por defecto.

La pestaña lista las cuentas ya conectadas y ofrece un botón Sincronizar cuentas, que actualiza el estado (activa o inactiva) de las cuentas que ya existen en Alegra.

Datos de conexión

Son los cuatro campos del formulario que aparece al añadir una cuenta. Los tres últimos son obligatorios: sin ellos el botón de guardar permanece inactivo.

Cuenta sandbox

Marca la cuenta como cuenta de pruebas. Úsala para verificar el funcionamiento del módulo sin emitir documentos en la cuenta real de Alegra.

Usuario

El usuario de la cuenta de Alegra con la que se conecta la tienda.

Token de usuario

El token de API que genera Alegra para ese usuario. Es lo que autoriza al módulo a operar sobre la cuenta.

País de la cuenta

El país al que pertenece la cuenta de Alegra. Condiciona el comportamiento fiscal de los documentos que se emiten con ella.

General

Reúne los ajustes que gobiernan cómo factura el módulo. Se llega a ellos desde Módulos → PTS Alegra → Configurar, en la pestaña General.

Depuración

Modo de depuración

Activa el registro de depuración del módulo para diagnosticar su comportamiento. Al activarlo aparece el campo IP.

IP

Restringe la depuración a una dirección IP concreta, de modo que solo esa vea el comportamiento en pruebas. El módulo incluye un botón para rellenar el campo con la IP desde la que estás conectado.

Integraciones

Integración con comisiones de ventas

Conecta el módulo con PTS Sales Commissions. Para que la integración funcione, ese módulo tiene que estar instalado y activo en la tienda: si no lo está, activar aquí el interruptor no añade nada a la pantalla de facturación.

Cuenta y valores por defecto

Cuenta Alegra por defecto

Elige cuál de las cuentas conectadas usa el módulo para facturar. Es la opción que desbloquea el resto de la pestaña y las pestañas de asociación.

Moneda ISO predeterminada

Declara cuál es la moneda base de tu cuenta de Alegra. Las opciones son Peso colombiano (COP) y Euro (EUR). No limita en qué monedas puede vender la tienda: es la referencia con la que el módulo decide si un pedido va en moneda propia o en moneda extranjera.

Idioma por defecto para enviar información

Determina en qué idioma viajan los datos que el módulo manda a Alegra.

Numeración por defecto para facturas

La numeración de Alegra que se aplica a las facturas cuando el país del pedido no tiene una numeración propia asignada en la pestaña Numeraciones.

Cuenta contable predeterminada para productos

La cuenta contable de Alegra que se asigna a los productos que el módulo crea o factura cuando no tienen una propia.

Terminos de entrega

El incoterm que acompaña a la factura. La lista incluye, entre otros, Costo y flete (CFR), Costo, flete y seguro (CIF), En fábrica (EXW) y Franco a bordo (FOB).

Grupos de clientes que no pueden facturar

Selecciona uno o varios grupos de clientes de PrestaShop cuyos pedidos no se podrán facturar con el módulo. Admite varios grupos a la vez.

Centro de costos

El centro de costos de Alegra al que se imputan las facturas que emite el módulo.

Comportamiento al facturar

Mostrar Ticket POS después de la facturación

Al terminar de emitir la factura, abre automáticamente el ticket de punto de venta.

Mostrar la factura creada en otra página

Tras crear la factura, la abre en una página aparte en lugar de quedarse en la ficha del pedido.

Emitir factura con pago automático

La factura se emite dando el pago por registrado, sin tener que marcarlo en un paso posterior.

Ocultar botón de emitir factura

Retira el botón de emitir factura de la ficha del pedido. Resulta útil en tiendas donde la facturación no la hace quien gestiona los pedidos.

Clientes y registros

Guardar clientes con segundo nombre y segundo apellido

Al crear el cliente en Alegra, reparte el nombre y los apellidos de PrestaShop en los cuatro campos de Alegra en lugar de en dos. Solo se aplica a clientes que son persona natural; las empresas se guardan con su razón social.

Ignorar clientes repetidos

Lo que se ignora es la comprobación de duplicados, no los clientes: al activarla, Alegra acepta crear una ficha nueva aunque ya exista otra con el mismo número de identificación, en lugar de rechazar la petición. Déjala desactivada si prefieres que una identificación repetida detenga la facturación para revisarla.

Guardar registros de las solicitudes a Alegra

Permite guardar registros sobre las peticiones hechas a Alegra que retornen un error. Son los que sirven para diagnosticar una factura que no llegó a emitirse.

Asociar

Agrupa las cinco pantallas que emparejan datos de PrestaShop con datos de Alegra. Todas siguen el mismo patrón: una tabla con las asociaciones existentes y un formulario para añadir una nueva. Solo aparecen cuando hay una Cuenta Alegra por defecto elegida.

Productos

Empareja un producto de la tienda con su producto equivalente en Alegra, para que la línea de factura salga con el artículo correcto.

Producto Alegra

El producto de la cuenta de Alegra con el que se empareja.

Producto

El producto de la tienda PrestaShop que se va a emparejar.

Transportistas

Empareja cada transportista de la tienda con un producto de Alegra, que es como Alegra representa el cargo por envío dentro de la factura.

Producto Alegra

El producto de Alegra que representa el envío de ese transportista.

Transportista

El transportista de PrestaShop que se va a emparejar.

Clientes

Empareja un cliente de la tienda con su ficha en Alegra, para no duplicarlo al facturar.

Cliente Alegra

El cliente ya existente en Alegra.

Cliente

El cliente de la tienda PrestaShop.

Cuentas de banco

Relaciona un método de pago de la tienda con la cuenta bancaria de Alegra en la que se registra el cobro.

Cuenta bancaria alegra

La cuenta bancaria de Alegra donde se anota el pago.

Moneda

La moneda de la cuenta bancaria.

Método de pago

El método de pago de PrestaShop que se asocia a esa cuenta.

Nombres del pago

Permite cubrir las variantes con que un mismo método aparece nombrado en los pedidos.

Retenciones

Define qué retención de Alegra se aplica según el país y el método de pago del pedido.

País

El país al que se aplica la retención.

Método de pago

El método de pago al que se aplica la retención.

Retención

La retención de Alegra que se aplica cuando se cumplen las dos condiciones anteriores.

Facturas

Agrupa el listado de facturas emitidas y los ajustes que lo rodean: a quién se le permite facturar, qué datos lleva el ticket y cómo traer de vuelta los cambios hechos en Alegra.

Lista de facturas

Muestra las facturas que el módulo ha emitido. Cada fila lleva un color según su estado, y la propia pantalla incluye la leyenda:

  • Color de factura en estado Borrador.
  • Color de factura en estado Abierta.
  • Color de factura en estado Cerrada.
  • Color de los pedidos que no se pueden facturar.

Desde las acciones de cada fila se hace lo mismo que desde el bloque del pedido, incluido Vincular factura Alegra existente y Desvincular factura. El bloque del pedido es un atajo: no hace falta abrir cada pedido.

Restricciones

Asigna una cuenta de Alegra concreta a un cliente o a un grupo de clientes. Es útil cuando la tienda trabaja con varias cuentas y cada una atiende a un público distinto.

Cuenta de Alegra

La cuenta de Alegra a la que se aplica la restricción.

Grupos

Los grupos de clientes de PrestaShop que quedan afectados.

Cliente

Un cliente concreto, cuando la restricción no es de grupo sino individual.

Configuración de Ticket

Los datos del establecimiento que se imprimen en el Ticket POS. A diferencia del resto de pestañas, aquí los cambios se guardan solos al salir de cada campo.

Nombre de la tienda

El nombre del establecimiento tal y como debe aparecer en el ticket.

Dirección del establecimiento

La dirección que se imprime en el ticket.

Teléfono

El teléfono de contacto del establecimiento.

Email

El correo de contacto del establecimiento.

Dominio del sitio web

La dirección web de la tienda.

Texto libre

Un texto propio que se añade al ticket.

Sincronizar facturas

Trae a PrestaShop el estado actual de las facturas de Alegra, para cuando se han hecho cambios directamente allí.

1
Elige el rango de fechas

En el calendario, marca la fecha de inicio y la de fin de las facturas que quieres actualizar.

2
Pulsa «Sincronizar facturas»

El botón permanece inactivo hasta que hayas seleccionado un rango.

Numeraciones

Asigna a cada país la numeración de Alegra que deben usar sus facturas. Lo que no tenga numeración propia aquí usa la Numeración por defecto para facturas de la pestaña General.

Asignar una numeración a un país

Lista de paises

El país al que se asigna la numeración.

Numeraciones

La numeración de Alegra que se aplicará a ese país.

Facturar un pedido

La facturación no vive en la configuración del módulo, sino en la ficha del pedido de PrestaShop, en un bloque llamado Facturación Alegra que el módulo añade. Todo lo que sigue ocurre ahí.

Antes de empezar: lo que el módulo te va a pedir

Una factura de Alegra necesita que todo lo que va dentro exista también en Alegra. Si algo falta, el módulo no falla en silencio: abre una pantalla que enumera lo que le falta y te deja resolverlo sin salir del pedido, con un botón Asociar (enlazarlo con algo que ya existe en Alegra) o Crear en Alegra (darlo de alta en el momento).

Los avisos que puedes encontrarte, y qué significa cada uno:

Lo que dice Qué hacer
Los siguientes productos no están asociados en Alegra… Asociarlos o crearlos. Se evita de antemano desde Asociar → Productos.
El siguiente transportista no está asociado en Alegra… Igual, desde Asociar → Transportistas.
El siguiente cliente no está asociado en Alegra… Crearlo o asociarlo. Si es una persona natural, el número de identificación es obligatorio y sin él la facturación se detiene.
El siguiente medio de pago no está asociado en Alegra… Asociarlo desde Asociar → Cuentas de banco.
Los siguientes impuestos no fueron creados en Alegra… Crearlos en Alegra. Estos no se dan de alta desde el módulo.
No se ha asociado una numeración por defecto para las facturas. Elegirla en General → Numeración por defecto para facturas.
La moneda del pedido no está creada en Alegra… Crearla en Alegra.
No tiene activada la opción multidivisa en Alegra, actívela. Es un ajuste de tu cuenta de Alegra, no del módulo.

Según el pedido y el país de la cuenta, el módulo puede pedirte además dos cosas antes de seguir: los Datos de cliente que falten (tipo y número de documento, país de origen del documento) y la Información requerida para la factura, que es donde se rellenan la tasa de conversión y la fecha de facturación cuando hacen falta.

El ciclo de una factura, paso a paso

Una factura de Alegra pasa por tres estados, y el módulo enseña en cada uno solo lo que tiene sentido hacer:

Estado Qué es Botones disponibles
Sin facturar El pedido aún no tiene nada en Alegra. Facturar · Modificar cliente y facturar · Vincular factura Alegra existente
Borrador Existe en Alegra pero no es un documento definitivo: se puede revisar y rehacer. Facturar · Modificar cliente y facturar · Vista previa · Convertir borrador a factura · Convertir borrador a factura y emitirla
Abierta Factura definitiva, pendiente de cobro. Descargar factura · Ticket POS · Pagar factura · Eliminar pago · Crear nota de crédito · Desvincular factura
Cerrada Factura definitiva y cobrada. Descargar factura · Ticket POS · Crear nota de crédito · Desvincular factura
1
Facturar

Crea el borrador en Alegra con los datos del pedido. Es el punto donde aparecen los avisos del apartado anterior si falta algo por asociar. No emite nada todavía.

2
Vista previa

Abre el borrador para comprobarlo antes de convertirlo. Es el último momento barato para detectar un error.

3
Convertir borrador a factura

Convierte el borrador en factura definitiva dentro de Alegra, sin enviarla a la entidad fiscal.

4
Convertir borrador a factura y emitirla

Lo mismo que el anterior y además la emite, que es el paso de facturación electrónica. Es la opción que se usa normalmente.

5
Pagar factura

Registra el cobro en Alegra y pasa la factura de Abierta a Cerrada. El pago se anota en la cuenta bancaria que hayas asociado a ese método de pago.

Las demás acciones del bloque

Modificar cliente y facturar

Abre los datos del cliente para corregirlos antes de crear el borrador. Es lo que hay que usar cuando el cliente puso mal su documento o falta un dato fiscal: cambiarlo aquí evita tener que anular la factura después.

Descargar factura

Descarga el PDF de la factura ya definitiva. Es el fichero que la tarea programada borra pasados 30 días; la factura sigue en Alegra.

Ticket POS

Abre el ticket de punto de venta con los datos que hayas puesto en Facturas → Configuración de Ticket. Si tienes activado Mostrar Ticket POS después de la facturación, se abre solo al terminar de facturar.

Eliminar pago

Borra en Alegra los pagos anotados en esa factura. Aparece junto a Pagar factura mientras la factura sigue Abierta, que es cuando todavía se puede rectificar un cobro mal registrado. Si no hay ningún pago anotado, no hay nada que borrar.

Crear nota de crédito

Es la forma de rectificar o anular una factura ya emitida, y solo aparece cuando la factura es definitiva (abierta o cerrada). Abre un formulario con el número, el contacto, el motivo, las notas, el tipo y la descripción de la operación, el concepto, el tipo de factura rectificativa, la fecha de emisión, la moneda, la lista de precios, el centro de costos y la orden de entrega.

Al crear la nota de crédito, la factura anulada deja de estar asociada al pedido, que queda libre para vincularle la factura que la sustituye.

Vincular factura Alegra existente

Asocia al pedido una factura que ya existe en Alegra, por ejemplo una que se hizo a mano allí. Aparece cuando el pedido no tiene factura y abre la lista de las últimas facturas de ese cliente en Alegra, con su número, fecha, total y estado. Si el total no coincide con el del pedido se marca en rojo, pero se puede vincular igualmente.

Solo se pueden vincular facturas abiertas o cerradas, del mismo contacto de Alegra que el cliente del pedido y que no estén ya vinculadas a otro pedido.

Desvincular factura

Quita la asociación entre el pedido y su factura, después de pedir confirmación. Aparece cuando la factura es definitiva (abierta o cerrada).

En la ficha del cliente y en la del producto

El módulo añade también un bloque propio en la ficha del cliente y en la del producto del back-office, para ver y gestionar desde ahí su correspondencia en Alegra sin tener que ir a las pantallas de Asociar.

Tarea programada

El módulo expone una URL de tarea programada que borra los archivos PDF de facturas antiguos, para que no se acumulen en el servidor. La pantalla muestra la URL con botones para copiarla o abrirla.

Traducciones

Editar Traducciones

El módulo incluye un editor de traducciones que te permite personalizar todos los textos en cualquier idioma instalado en tu tienda.

  1. Accede a la sección "Traducciones" en la configuración del módulo
  2. Selecciona el idioma que deseas editar
  3. Modifica las cadenas de texto según necesites
  4. Haz clic en "Guardar" para aplicar los cambios

Acciones disponibles

El editor de traducciones incluye varias acciones para gestionar tus traducciones:

  • Guardar: Guarda los cambios realizados en las traducciones.
  • Guardar y descargar: Guarda los cambios y descarga el archivo de traducciones para respaldo.
  • Comparte con nosotros: Envía tus traducciones a nuestro equipo PresTeamShop para incluirlas en futuras versiones del módulo.
  • Expandir todo: Muestra todas las secciones de traducciones expandidas.
  • Contraer todo: Oculta el contenido de todas las secciones.

Copias de seguridad

El sistema de copias de seguridad te permite proteger la configuración del módulo y restaurarla en caso de necesidad.

Generar copia de seguridad

Para crear una nueva copia de seguridad, haz clic en el botón "Generar nueva copia de seguridad". El sistema creará un respaldo de la configuración actual del módulo.

Subir copia de seguridad

Si tienes una copia de seguridad descargada previamente, puedes cargarla haciendo clic en el botón "Subir copia de seguridad". Se abrirá un diálogo donde podrás seleccionar el archivo ZIP de la copia de seguridad.

Copias de seguridad disponibles

La lista muestra todas las copias de seguridad creadas. Puedes filtrar por fecha utilizando el selector de fecha y actualizar la lista con el botón "Actualizar lista".

Acciones de la lista

Cada copia de seguridad en la lista tiene las siguientes acciones disponibles:

Restaurar copia de seguridad

Restaura la configuración del módulo

Descargar copia de seguridad

Descarga el archivo ZIP

Eliminar copia de seguridad

Elimina la copia de seguridad

Para restaurar, haz clic en el botón "Restaurar copia de seguridad" de la copia que deseas recuperar y confirma la acción en el diálogo.

Solución de Problemas

Problemas Comunes

Verifica que el módulo esté correctamente instalado y activado. Si el módulo tiene la opción de modo depuración y esta está activa, asegúrate de que tu IP esté en la lista de IPs permitidas. También limpia la caché de PrestaShop desde Parámetros avanzados → Rendimiento.

Verifica que tu versión de PHP sea compatible (7.2 o superior). Revisa los logs de error de PHP y PrestaShop. Si el problema persiste, contacta con soporte técnico proporcionando los mensajes de error.

Si recibes un error de override durante la instalación, significa que otro módulo ya está utilizando los mismos archivos. No intentes resolverlo manualmente. Contacta con nuestro equipo de soporte para recibir ayuda personalizada.

Es necesario configurar la conexión con Alegra para empezar a usar el módulo. Añade una cuenta en la pestaña Cuentas con su usuario, token de usuario y país; hasta que no haya una cuenta conectada, el resto de pestañas no aparece.

Debe elegir una cuenta Alegra por defecto para poder usar el módulo. Hasta que no la selecciones en General → Cuenta Alegra por defecto, las opciones que dependen de la cuenta permanecen deshabilitadas y las pantallas de Asociar no se muestran.

Si has hecho cambios en Alegra, conviene borrar la caché para que los resultados se muestren correctamente. El propio módulo ofrece un botón para hacerlo desde su pantalla. Si lo que no cuadra es el estado de facturas ya emitidas, usa Facturas → Sincronizar facturas con el rango de fechas correspondiente.

Comprueba dos cosas: que el grupo predeterminado del cliente no esté incluido en General → Grupos de clientes que no pueden facturar, que es la opción que sí impide facturar; y que el botón no esté simplemente oculto por Ocultar botón de emitir factura. Si lo que ocurre es que la factura sale en la cuenta de Alegra equivocada, eso no es un bloqueo: mira las reglas de Facturas → Restricciones, que son las que deciden la cuenta.

Preguntas Frecuentes

Licencias y Compra

La licencia incluye actualizaciones y soporte técnico por un período determinado (6, 12 o 24 meses según el plan elegido). Una vez finalizado, puedes renovar opcionalmente para seguir recibiendo actualizaciones y soporte.
La licencia incluye instalación en un dominio de producción, acceso a todas las actualizaciones y soporte técnico durante el período activo de la licencia.
Puedes ver la demo en vivo disponible en nuestra web para conocer todas las funcionalidades del módulo. No ofrecemos versiones de prueba para instalar en tu sitio.
El módulo seguirá funcionando con normalidad, pero no recibirás nuevas actualizaciones ni tendrás acceso al soporte técnico.

Instalación y Compatibilidad

El módulo está diseñado para funcionar con cualquier tema que siga los estándares de PrestaShop. Si experimentas algún conflicto con tu tema, contacta con nuestro equipo de soporte.
Sí, tu licencia incluye instalación en dos entornos: producción y desarrollo/staging. Esto te permite probar actualizaciones y cambios antes de aplicarlos en tu tienda en vivo.
Sí, el módulo está diseñado para ser compatible con otros módulos. En caso de conflicto con algún módulo específico, nuestro equipo de soporte puede ayudarte a resolverlo.
No, la instalación es muy sencilla y se realiza desde el Back Office de PrestaShop. Si tienes algún problema durante la instalación, nuestro equipo de soporte está disponible para ayudarte.

Actualizaciones

No, las actualizaciones conservan toda tu configuración y datos. Solo perderías la configuración si desinstalas y vuelves a instalar el módulo, lo cual no es necesario para actualizar.
Puedes verificar las nuevas versiones visitando nuestra página web o accediendo a tu cuenta en nuestra tienda. Próximamente añadiremos la opción de revisar actualizaciones directamente desde el panel del módulo.
No es obligatorio, pero se recomienda actualizar para disfrutar de las últimas mejoras, nuevas funcionalidades y correcciones de seguridad.

Soporte Técnico

Normalmente respondemos en menos de 24-48 horas laborables.
Sí, siempre y cuando tengas el soporte activo dentro del período de tu licencia, tienes acceso completo al soporte técnico.
Puedes solicitar ayuda con la instalación, configuración, resolución de errores y consultas generales sobre el funcionamiento del módulo.
Sí, nuestro equipo de soporte atiende tanto en español como en inglés.

Reembolsos y Garantía

Solo aplicamos reembolso en el caso de que el módulo no logre funcionar en tu tienda después de recibir soporte técnico. Ten en cuenta que antes de la compra dispones de una demo para probar el módulo.
Garantizamos que el módulo funciona según lo descrito en la documentación. Si encuentras algún bug, lo corregimos sin coste adicional.

Personalización

Sí, ofrecemos servicios de desarrollo a medida. Contacta con nuestro equipo de soporte para solicitar un presupuesto personalizado.
No se recomienda modificar el código del módulo por tu cuenta, ya que perderías el soporte técnico y al actualizar el módulo perderías los cambios realizados. Si necesitas funcionalidades adicionales, te recomendamos solicitar un presupuesto de desarrollo a medida para que los cambios se incluyan en el módulo y se mantengan en futuras versiones.

Soporte

Si necesitas ayuda adicional o tienes alguna pregunta sobre el módulo, estamos aquí para ayudarte.

Soporte por Email

Envíanos un correo y te responderemos lo antes posible.

support@presteamshop.com

Centro de Ayuda

Visita nuestro centro de ayuda para más recursos.

Visitar Centro de Ayuda