Conectar Wix

Conectá un sitio de Wix eCommerce para traer sus pedidos de reparto local a Ruta. Necesitás el plan Pro, ser dueño o administrador del sitio en Wix y que la integración esté habilitada en tu entorno.

La forma simple es la app de Ruta para Wix: un clic, sin claves. Si tu entorno todavía no la ofrece, o preferís no instalar una app, podés conectar con una API key (más abajo, «Opción avanzada»).

#1. Conectá con la app de Ruta

1. En Integraciones (en la barra de arriba del panel), elegí Wix → Conectar y tocá Conectar con Wix.
2. Wix te pide elegir el sitio y aceptar los permisos de Ruta: ver tus pedidos (Read Orders) y marcarlos como enviados (Manage Orders).
3. Volvés a Ruta con el sitio conectado.

También podés empezar desde Wix: instalá Ruta desde el Wix App Market (o desde el enlace que te pasemos) y abrila desde el panel de tu sitio. Ruta te pide confirmar que ese sitio es de tu empresa: tocá Conectar el sitio. Si no tenías la sesión abierta, primero entrás a Ruta y después confirmás.

#2. Elegí qué opciones de envío reparte tu equipo

Wix trata el reparto local, el correo y el retiro como opciones de envío. Ruta sólo trae las que vos elegís:

1. En la conexión, abrí Ajustes de la conexión (se abre solo mientras no elegiste ninguna).
2. Tocá Buscar las opciones en mis pedidos: Ruta lee tus últimos pedidos y te muestra sus opciones de envío con cuántos pedidos tuvo cada una.
3. Marcá las de reparto local y tocá Guardar opciones de reparto. Los retiros aparecen deshabilitados: nunca se reparten.

Si una opción todavía no tiene pedidos, escribí su código en Agregar un código a mano (es el shippingInfo.code de un pedido de esa opción).

Desde ahí, los pedidos llegan al instante y Ruta revisa además cada 15 minutos por si algún aviso se perdió. Buscar pedidos ahora pide una consulta antes.

#3. Avisar a Wix

Con Avisar a Wix encendido (viene encendido si aceptaste el permiso para marcar pedidos):

• Cuando la entrega sale, Ruta crea un envío en el pedido con la empresa Ruta, el código de seguimiento y el link de seguimiento, en estado en reparto (In_Delivery). Wix puede mandarle al comprador su email de envío, según cómo tengas configurados los emails de tu sitio.
• Cuando se entrega, ese envío pasa a entregado (Fulfilled).

Ruta no toca un pedido cancelado ni uno que ya marcaste como preparado a mano. Si Wix rechaza el aviso, la entrega sigue igual y la conexión muestra Requiere revisión con el motivo; tocá Reintentar cuando lo resuelvas. Para no avisar, apagá Avisar a Wix en los ajustes de la conexión.

#Opción avanzada: conectar con una API key

Si tu entorno no ofrece la app de Ruta, o preferís una clave de tu cuenta:

1. En tu cuenta Wix, abrí Configuración de la cuenta → API Keys y generá una clave para el sitio que vas a conectar. Elegí Read Orders (y Manage Orders si querés que Ruta avise a Wix).
2. Copiá la clave y el Site ID. El Site ID es el identificador del sitio (cinco grupos separados por guiones), no la dirección web ni el ID de tu cuenta.
3. Identificá los códigos de las opciones de reparto local de tu tienda: son los valores de shippingInfo.code de un pedido de cada opción, no el título visible. Una vez conectada, Buscar las opciones en mis pedidos también te los muestra.
4. En Wix → Conectar, abrí Opción avanzada: conectar con una clave y completá Código de tu sitio (el Site ID), Clave de Wix y los códigos (uno por línea, hasta 20). Elegí Conectar tienda.

Ruta guarda la clave cifrada y encola una consulta. Revisá Tus conexiones → Últimas búsquedas de pedidos: guardar la conexión no confirma todavía que Wix haya aceptado la clave. Con una API key, Avisar a Wix empieza apagado; encendelo en los ajustes si la clave tiene Manage Orders.

#Webhooks opcionales con una app propia

Con una API key, los pedidos llegan cada 15 minutos. Para recibirlos al instante necesitás además una app Wix tuya instalada en ese sitio (una API key no crea suscripciones a webhooks). Quien administra tu app debe:

1. Crear una app autogestionada en Wix con Read Orders e instalarla en el sitio (no hace falta publicarla).
2. En Webhooks, suscribir eCommerce → Order Approved, Order Updated y Order Canceled a la URL que muestra Ruta después de conectar.
3. Copiar Get Public Key y el Instance ID de esa app en ese sitio (no el Site ID ni el App ID).
4. En Cambiar la conexión Wix → Recibir pedidos al instante, pegar la clave pública y el Instance ID junto con la API key. Ruta acepta la clave pública con sus líneas BEGIN PUBLIC KEY / END PUBLIC KEY.
5. Revisar el registro de entregas de webhooks de Wix: Ruta debe responder 200.

Ruta verifica el JWT firmado con RSA de esa app y su Instance ID antes de aceptar el aviso, y después consulta el pedido actual a Wix; un aviso repetido no duplica la entrega.

#Qué pedidos entran

Se importan los pedidos APPROVED, PAID, NOT_FULFILLED, con dirección y con un código local de los que elegiste. Los retiros (pickupDetails), los envíos por otras opciones, los pedidos pendientes y los ya preparados no crean entregas. El nombre, dirección y teléfono salen del destino de envío; la nota del comprador se usa como instrucciones.

El pago contra entrega no se deduce del total ni de que el pedido esté aprobado. Por defecto los pedidos NOT_PAID no entran. Para una operación de cobro con monto fijo, el administrador puede configurar defaults.amountToCollect en la API de conexiones; sólo entonces se admiten pedidos locales NOT_PAID con ese monto explícito. No se consultan transacciones ni se infiere la deuda.

Un pedido CANCELED ya importado cancela su entrega si todavía no salió. Si ya está en camino o cerrada, Ruta conserva su estado y deja un aviso para revisar. Esto se comprueba por webhook y por polling. Un reembolso sin cancelación no cancela la entrega.

Los cambios posteriores de dirección se corrigen manualmente en Ruta. La referencia externa es el número del pedido (number), sin # inicial. Si ya creás ese pedido mediante la API pública, usá el mismo externalReference y comercio remitente: se vincula a la entrega existente. Si conectás sitios cuyos números se repiten, asigná un comercio remitente distinto a cada conexión.

#Si algo falla

Con una API key, Cambiar la conexión Wix reemplaza todas las credenciales: si recibías webhooks, volvé a pegar también la clave pública y el Instance ID. Para desconectar, elegí Pausar conexión y desinstalá la app de Ruta (o revocá la API key) en Wix. No envíes claves ni datos de clientes al pedir ayuda.

#Privacidad

Ruta usa los datos del pedido (nombre, dirección, teléfono y nota del comprador) sólo para hacer la entrega, y no le cambia a Wix nada más que el envío de Ruta. Si desinstalás la app, Ruta deja de leer tu sitio y conserva las entregas ya hechas como registro de tu operación. Para pedir una copia o el borrado de los datos de un comprador, escribinos desde tu cuenta.