Esta guía te muestra, paso a paso, cómo conectar tus tiendas de WooCommerce con GelatoConnect, para que los pedidos fluyan automáticamente desde WooCommerce directamente a tu flujo de producción.
Requisitos previos
Antes de empezar a conectar una tienda de WooCommerce con GelatoConnect, asegúrate de tener lo siguiente:
Cliente configurado en GelatoConnect: El cliente que es propietario de la tienda WooCommerce debe crearse con acceso a Storefronts habilitado
Configuración compatible con WooCommerce: WooCommerce versión 2.4.8 o superior con la API configurada correctamente
Acceso de administrador: Tanto el PSP (Proveedor de Servicios de Impresión) como tu cliente deben tener acceso de administrador a la tienda WooCommerce
Resumen del proceso de conexión
El proceso de conexión consta de cuatro fases clave:
Preparación: Cómo dejar todo listo en GelatoConnect y WooCommerce
Conexión de la tienda: Creando el enlace entre WooCommerce y GelatoConnect
Configuración de productos: Cómo preparar tus productos para imprimir
Pruebas: Comprobando la integración con pedidos de prueba
Vamos a ver cada fase paso a paso.
Fase 1: Preparación en GelatoConnect y WooCommerce
1) Configura a tu cliente
Ve a la sección de Clientes en el menú de navegación de la izquierda de tu cuenta de GelatoConnect
Selecciona el cliente que tiene la tienda WooCommerce. Si no está en la lista, añade un cliente nuevo.
2) Decide si quieres dar acceso a tu cliente a la interfaz de Storefronts Connect
Storefronts Connect es la interfaz que utilizan los PSP y tus clientes para gestionar escaparates B2C (incluyendo WooCommerce), importaciones CSV y tiendas manuales.
Sin acceso a la interfaz de Storefronts Connect:
Los PSPs se encargan de conectar los nuevos productos a la tienda de WooCommerce
Es posible que tu cliente quiera ponerse en contacto contigo para consultar los detalles del pedido.
Necesitarás acceso de administrador a la tienda WooCommerce para autorizar la conexión.
Con acceso a la interfaz de Storefronts Connect:
Tus clientes pueden añadir nuevos productos a su tienda de WooCommerce cuando lo deseen
Tu cliente puede ver el historial de pedidos y los detalles de seguimiento
No necesitarás acceso de administrador a la tienda de WooCommerce, pero tu cliente sí lo necesitará para autorizar la conexión.
3) Accede a la interfaz de Storefronts Connect
Los PSP pueden acceder a los escaparates usando sus datos de acceso actuales de GelatoConnect.
Para que tus clientes puedan acceder a Storefronts Connect:
Ve a la sección de clientes en GelatoConnect
Selecciona al cliente y luego ve a Editar cliente en la esquina superior derecha
Activa el interruptor "Habilitar escaparates"
Indica el correo electrónico, nombre y apellidos de tu cliente
Cuando hagas clic en el botón "Añadir admin", tu cliente recibirá un correo electrónico con las instrucciones para iniciar sesión.
4) Prepara tu catálogo de productos
Antes de conectar la tienda, asegúrate de tener productos configurados en GelatoConnect.
Necesitarás haber creado modelos de producto y productos para tus clientes usando estos modelos de producto.
Dentro de un producto para clientes, puedes decidir qué cliente tendrá acceso a ese producto.
5) Configura tu tienda de WooCommerce
Para asegurarte de que tu tienda de WooCommerce esté bien configurada para la integración con GelatoConnect:
Comprueba el acceso a la API REST de WooCommerce:
Verifica que tu archivo
.htaccesscontenga:SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1
Activar la REST API Legacy:
Desde tu Panel de administración de WooCommerce, ve a WooCommerce → Ajustes → Avanzado
Selecciona la pestaña Legacy APIMarca la casilla para
"Activar la REST API Legacy"Haz clic en
Guardar cambiosConfigura los ajustes de enlaces permanentes
:Ve a
Ajustes → Enlaces permanentes en tu panel de WordPressEn
Configuración común, selecciona cualquier opción excepto Simple.
Haz clic en Guardar cambios
Comprueba que la API funciona visitando
https://your-site-url-here.com/wc-api/v1/en tu navegador
Instala el plugin WooCommerce Legacy REST API (para WooCommerce 9.0+):
Ve a Plugins → Añadir nuevo en tu Panel de WordPress
Busca "WooCommerce Legacy REST API"
Instala y activa el plugin
Instala el plugin de Gelato:
En tu Panel de WordPress, ve a Plugins → Añadir nuevo
Buscar "Gelato"
Instala y activa el plugin Gelato Integration for WooCommerceActualiza el plugin de Gelato para usarlo en tu tienda
:En tu Panel de administración de WordPress, ve a
Plugins → Editor de pluginsEn el menú desplegable de la esquina superior derecha, selecciona
Gelato Integration for WooCommerceEn el panel derecho, busca y abre
includes → Connector → GelatoConnector.phpBusca esta línea de código:
const GELATO_DASHBOARD_URL = 'https://dashboard.gelato.com';
Sustitúyelo por:const GELATO_DASHBOARD_URL = 'https://storefronts.gelato.com';
Haz clic enActualizar archivo para guardar los cambiosFase 2: Conectar una tienda WooCommerce
Para comerciantes (tu cliente)
Inicia sesión en Storefronts
Ve a Tiendas:
Haz clic en la pestaña Tiendas en la barra de navegación de la izquierda
Haz clic en el icono de WooCommerce para empezar el proceso de conexión
Introduce la URL de tu tienda WooCommerce
Haz clic en "Continuar" para autorizar la conexión:
Te llevaremos a la página de autenticación de WooCommerce
Inicia sesión si te lo pide
Revisa los permisos que solicita Gelato
Haz clic en Autorizar para aprobar la conexión
Confirma la conexión:
Después de autorizar, volverás al Panel de Storefronts Connect
Comprueba que tu tienda aparece en la lista de tiendas conectadas con el estado "Conectado"
Para PSP (tú)
Los pasos para conectar una tienda de WooCommerce como PSP son muy parecidos a los de conectar una tienda como cliente tuyo.
La diferencia principal es que también se te pedirá que elijas a qué instalaciones y a qué clientes quieres asignar la tienda WooCommerce.
Fase 3: Configuración de productos
Una vez que la tienda esté conectada, tendrás que vincular tus productos en GelatoConnect con los listados de productos en la tienda WooCommerce. Hay tres formas de conectar los productos:
Método 1: Conectar productos existentes de WooCommerce
Si la tienda ya tiene productos que deben producirse a través de GelatoConnect:
Sincronizar productos
:En el Panel de Storefronts Connect, haz clic en la tienda WooCommerce conectada dentro de la lista de tiendas.
Haz clic en el botón
Sincronizar productos en la esquina superior derecha para obtener la lista actual de productos de la tienda.Espera a que termine la sincronización
Asignar productos
:Después de sincronizar, todos los productos de WooCommerce aparecerán en la pestaña Todos los productos
Para cada producto que necesites producir, haz clic en el producto y luego pulsa el botón Conectar.
Elige el producto que quieres conectar del catálogo
Para los productos que necesitan archivos de diseño, te llevaremos al Design Editor, donde podrás subir tu archivo de diseño.
Haz clic en Conectar para guardar la asignación
Método 2: Crear productos nuevos en Storefronts Connect
Para crear nuevos productos que se publicarán en la tienda de WooCommerce:
Ve a la tienda de WooCommerce en la lista de tiendas
Haz clic en el botón
Añadir producto en la esquina superior derechaPuedes añadir un producto completamente nuevo o elegir uno que ya hayas añadido a una tienda existente.
Si vas a añadir un producto individual:
Selecciona un producto del catálogo de productos
Añade un diseño usando el Design Editor
Configura los detalles del producto (nombre, descripción, precio)
Después, publica el producto en la tienda de WooCommerce
Método 3: Conexión masiva de productos
Para tiendas con muchos productos, puedes usar la función de operaciones en lote:
Exportar lista de productos
:Ve a la página de la tienda en Storefronts Connect y haz clic en
Operaciones en lote en la esquina superior derecha.Selecciona
Conectar productos usando archivosHaz clic en
Exportar CSV y se descargará un archivo CSV con todos los productos de la tienda.Rellena el CSV
:Abre el archivo CSV en una aplicación de hojas de cálculo
Para cada producto, añade lo siguiente en las columnas correspondientes:
UID del producto
: El identificador de producto de GelatoConnectURL del archivo de diseño
: URL al archivo imprimible de cada producto. Debe ser un enlace directo al archivo.Importar productos asignados
:Vuelve a Storefronts y haz clic en
Operaciones en loteIntroduce tu dirección de correo electrónico, haz clic en
Subir CSV y elige tu archivo CSVHaz clic en
Conectar productos usando archivos en la esquina superior derechaFase 4: Probando la integración
Antes de confiar en la integración para pedidos de producción, prueba bien la conexión:
Haz un pedido de prueba
:Ve al sitio web de la tienda WooCommerce
Compra uno de los productos asignados. Te recomendamos usar un código de descuento para hacer pruebas.
Finaliza el proceso de compra
Verifica la recepción del pedido
:Comprueba que el pedido aparece en Storefronts Connect
Comprueba que también aparezca en la página de gestión de pedidos de tu Panel de GelatoConnect
Confirma que todos los detalles del pedido sean correctos, incluyendo:
Información del cliente
Especificaciones del producto
Archivos de diseño
Detalles de envío
Sigue tu pedido durante la producción
:Sigue el pedido de prueba a lo largo de tu flujo de producción
Verifica que las actualizaciones de estado se reflejen correctamente en Storefronts Connect y en el área de administración de WooCommerce
Cancelar pedido de prueba (opcional)
:Haz otro pedido de prueba
Cancélalo desde WooCommerce
Comprueba que la cancelación se haya realizado correctamente en GelatoConnect
Verify the cancellation is processed correctly in GelatoConnect