Ir al contenido principal

[Recepción de pedidos - GCW] Integrar GelatoConnect con Cloudprinter

Juliana Maciel Maruri da Cunha avatar
Escrito por Juliana Maciel Maruri da Cunha
Actualizado hace más de 2 semanas

Bienvenido a la guía para integrar Gelato Connect con Cloudprinter. Esta integración te permite comunicarte sin complicaciones entre ambas plataformas, para que puedas recibir pedidos de Cloudprinter y gestionarlos de forma eficiente a través de Gelato Connect. Sigue estos sencillos pasos para configurar la integración y empezar a gestionar pedidos de Cloudprinter en cuestión de minutos u horas (en vez de meses).

Hay 3 pasos para recibir y procesar los pedidos de Cloudprinter con GelatoConnect:

  1. Configura la integración de la API para que todo funcione en sintonía.

  2. Añade el catálogo de productos de Cloudprinter a GelatoConnect.

  3. Configura flujos de trabajo de producción para un procesamiento sin complicaciones.


Paso 1: Integración de la API

El primer paso es conectar los sistemas mediante API. Así, los pedidos y las actualizaciones podrán moverse sin problemas entre GelatoConnect y Cloudprinter.

  1. Crea las interfaces de Producción y Señales en Cloudprinter:

    • En tu cuenta de Cloudprinter, crea una interfaz de producción llamada "GelatoConnect API - Dev": selecciona la plantilla "Your own API". En el campo Host, solo indica "www.gelato.com", y en el campo de direcciones IP, especifica "184.169.223.162". Configura el resto siguiendo las instrucciones de ayuda de Cloudprinter. Deja esta configuración en "modo de prueba" y con prioridad baja para que los pedidos reales no se procesen por esta conexión.

    • En tu cuenta de Cloudprinter, crea una interfaz de señales llamada "GelatoConnect Signals - Dev". Configúrala con baja prioridad, ya que solo es para hacer pruebas.

  2. Crea el cliente "Cloudprinter" en GelatoConnect:

    • Inicia sesión en GelatoConnect.

    • Ve a la sección Clientes en el menú de la izquierda.

    • Haz clic en Crear cliente y ponle el nombre Cloudprinter al cliente.

    • Selecciona Aplicar preajuste para Cloudprinter para cargar la configuración automáticamente.

    • En la ventana emergente que aparece, copia y pega las claves API de las interfaces Production y Signals que creaste en Cloudprinter en el paso 1.

  3. Autorizar comunicación:

    • GelatoConnect generará un host de endpoint cuando introduzcas las claves API en la ventana emergente.

    • Copia este endpoint y pégalo en el campo "Host" de la interfaz de producción (sustituyendo el nombre de host de ejemplo "www.gelato.com" que añadiste en el paso 1).

  4. Crea un mapa de métodos de envío:

    • Crea una búsqueda en GelatoConnect para relacionar los métodos de envío de Cloudprinter con los métodos de envío de Gelato. Sigue las instrucciones que encontrarás aquí y utiliza el archivo Excel adjunto para hacer la correspondencia.

    • Dentro de tu plantilla de envío de pedidos, es posible que necesites reemplazar la siguiente fila al final de la plantilla:

      "shipmentMethodUid": ##{{ order.shipping.method|js }},

      con:

      "shipmentMethodUid": ##{{ lookups({"alias": order.shipping.method}, strict=False, default="")|js }},

      donde «alias» enlaza con el campo de plantilla establecido como ##{{alias}} dentro de tu búsqueda.

Una vez terminado, los sistemas quedan sincronizados. Los puntos finales de la API necesarios para tareas como enviar y actualizar pedidos ya están configurados, lo que garantiza una comunicación automática.


Paso 2: Configura los productos de Cloudprinter

A continuación, vas a importar el catálogo de productos de Cloudprinter en GelatoConnect.

1. Accede a los modelos de productos:

  • Ve a la sección Productos en el menú de la izquierda y haz clic en Modelos de productos.

  • Haz clic en Añadir desde catálogo > Añadir desde cliente y selecciona Cloudprinter.

2. Descarga los archivos de referencia desde Cloudprinter:

  • Abre una nueva pestaña y accede a tu cuenta de Cloudprinter.

  • Ve a Catálogo de productos > Descargar referencias.

  • Descarga los dos archivos necesarios: Referencia de productos y Referencia de opciones.

3. Sube los archivos de referencia a GelatoConnect:

  • Arrastra y suelta los archivos descargados en el área de subida de GelatoConnect.

  • GelatoConnect mostrará todos los productos que tienes configurados en tu cuenta de Cloudprinter.

4. Selecciona las categorías de productos:

  • Revisa la lista de productos (puede cambiar según tu cuenta de Cloudprinter).

  • Elige las categorías que tienes pensado producir (por ejemplo, papel con membrete, folletos, etc.).

5. Mapea los tipos de papel:

  • Elige los tipos de papel adecuados para cada producto.

  • Si tienes acuerdos especiales con Cloudprinter para stock personalizado, puedes ajustar la asignación aquí.

  • Si no, te recomendamos usar las opciones predeterminadas.

6. Genera productos y variantes:

  • Haz clic en Continuar para generar los modelos de producto seleccionados.

  • GelatoConnect creará automáticamente productos con atributos asignados y códigos internos de producto para la producción.

Cuando termines, podrás ver el producto creado y revisar detalles como la asignación de papel, las opciones de acabado y los UIDs del producto.


Paso 3: Configuración de los flujos de trabajo de producción

Por último, ajusta o actualiza los flujos de trabajo para que se adapten a lo que puedes producir.

  1. Accede a la configuración de producción:

    • Utiliza la herramienta de configuración de producción en GelatoConnect para definir los pasos de producción (por ejemplo, impresión, laminado, encuadernación) para cada categoría de producto (por ejemplo, tarjetas de visita, libros cosidos).

    • Asegúrate de que todos los formatos de Cloudprinter tengan una configuración de producción definida y activa.

Para obtener una guía detallada y un vídeo sobre cómo configurar la producción, consulta el paso correspondiente en la guía de incorporación aquí.


Paso 4: Activa los pedidos en tiempo real desde Cloudprinter

  1. Crea pedidos de prueba desde el Centro de Pruebas de Cloudprinter o coordinando directamente con el equipo de Cloudprinter. Comprueba la recepción del pedido y el archivo para asegurarte de que todo está listo para producir.

  2. Envía las tarjetas de tarifas de envío a Cloudprinter

    1. Pide el archivo editable de la tarjeta de tarifas de Cloudprinter a tu responsable de implementación de GelatoConnect Workflow.

    2. Rellénalo y envía tus tarifas de envío actualizadas a Cloudprinter al inicio del proceso de incorporación (y cada año después de los cambios en las tarifas de las empresas de transporte).

  3. Informa al equipo de Cloudprinter sobre el proceso de pruebas y pide su consentimiento para cambiar los pedidos en vivo a GelatoConnect.

  4. Pásate a recibir pedidos en tiempo real en GelatoConnect:

    1. Crea una nueva interfaz de producción llamada "GelatoConnect API - Prod". Usa los mismos parámetros que la conexión "GelatoConnect API - Dev" que configuraste antes, pero selecciona la prioridad más alta y el "modo en vivo" para recibir los pedidos reales.

    2. Cambia cualquier interfaz de producción anterior a "Modo de prueba" para que los pedidos ya no se envíen allí.

    3. Crea una nueva interfaz de Signals llamada "GelatoConnect Signals - Prod". Usa los mismos parámetros que la conexión "GelatoConnect Signals - Dev" que creaste antes, pero dale la máxima prioridad para que se utilice en los pedidos en tiempo real.

¿Ha quedado contestada tu pregunta?