Conectar Loop Returns: las devoluciones llegan por webhook, márquelas y procéselas en el almacén
Cree una API key con el scope returns en Loop admin en Returns Management → Tools & integrations → Developer Tools, complete esa única clave en Integration, entienda por qué la prueba queda pendiente de verificación y active.
El conector de Loop Returns conecta su portal de devoluciones de Loop con el sistema de devoluciones (RMS). Las devoluciones no se traen por la API: llegan por webhook cuando los compradores las crean en Loop. Una vez dentro, el almacén trabaja aquí: marcar una devolución y procesar una devolución son las dos acciones de esta conexión. No crea etiquetas de devolución. La conexión tiene un solo campo, la Loop API Key.
Requisitos previos#
- Una cuenta de Loop a la que pueda entrar como administrador, con acceso a Returns Management → Tools & integrations → Developer Tools.
- Las devoluciones ocurren primero en Loop: los compradores inician la devolución en Loop y esta conexión la recibe; no es un lugar para crear una devolución desde cero.
- Entienda la vía de entrada antes de empezar: las devoluciones llegan solo por webhook, no hay una extracción por API programada que esperar y esta conexión no proporciona etiquetas de devolución.
Obtener credenciales#
- Inicie sesión en Loop admin.
- Vaya a Returns Management → Tools & integrations → Developer Tools.
- Cree allí una API key nueva y asegúrese de incluir el scope returns. El scope returns es un requisito estricto: sin él, las acciones de marcar y procesar devoluciones fallarán después.
- Copie la clave completa. Cuando este sistema se comunica con Loop, la clave se envía en el encabezado X-Authorization: usted no completa ese encabezado en ningún sitio, solo completa la clave.
Completar en Integration#
- Abra Integration → Marketplace → Loop Returns → Nueva conexión.
- api_key, obligatorio, Loop API Key: pegue la clave creada en Loop admin → Returns Management → Tools & integrations → Developer Tools, completa y con el scope returns. Es un campo de tipo contraseña y se guarda como secreto. Esta conexión no tiene más campos: ni dirección de tienda, ni dirección de servidor, nada más que completar.
- Guarde la conexión y ejecute la prueba, y lea primero la sección siguiente, porque el resultado de la prueba de este canal no se parece al de los demás.
Probar la conexión#
Haga clic en Probar la conexión y espere este resultado: con una clave real completada, la prueba no vuelve como aprobada, vuelve como no aprobada, pendiente de verificación, y no envía ninguna solicitud a Loop. Ese es el comportamiento esperado para este canal, no una señal de que su clave esté mal. La razón es simple: Loop no tiene una comprobación de solo lectura verificada que pueda probar que la clave funciona sin cambiar datos. Las acciones conocidas de Loop, marcar y procesar, cambian una devolución, así que no pueden usarse como prueba inofensiva, y la ruta de lectura de los detalles de devolución no se ha confirmado desde la documentación oficial. Por eso la prueba solo comprueba que hay una clave presente, envía cero solicitudes e informa pendiente de verificación. No siga recreando claves buscando un resultado en verde: una clave correcta con el scope returns muestra exactamente este resultado. Si prueba con la clave vacía, el resultado es solo una comprobación simulada y viene etiquetado como simulado; no prueba nada sobre una cuenta real de Loop.
Mapping / elegir plantilla#
Elija el mapping estándar de Loop Returns. Toma una devolución que llega por webhook y la registra como una devolución en el sistema de devoluciones, con su referencia de devolución, referencia de pedido, artículos y cantidades tal como los envía Loop. Antes de activar, recorra una devolución real: inicie una devolución en Loop, deje que llegue y compare la devolución aquí con Loop lado a lado: referencia, artículos y cantidades. Si algo no coincide, ajuste ese campo en el mapping en lugar de cambiar nada en Loop.
Activar#
Tras activar, las devoluciones creadas en Loop llegan por webhook y aparecen como devoluciones para trabajar. El almacén abre aquí una devolución, la marca cuando necesita atención y la procesa cuando la devolución está gestionada: esas dos acciones se envían a Loop para esa devolución. Vigile las primeras devoluciones reales en Runs / Logs y compárelas con Loop antes de dejar la conexión sin supervisión.
Lo que esta conexión no hace: no trae devoluciones de Loop por la API según un programa, así que no hay un botón de sincronización que esperar; y no crea etiquetas de devolución, así que los compradores siguen recibiendo sus etiquetas como las proporciona el propio Loop. Las devoluciones empiezan en Loop, llegan por webhook y aquí se marcan y se procesan.
Preguntas frecuentes#
Completé una clave real, pero la prueba dice no aprobada, pendiente de verificación
Este es el resultado esperado para Loop Returns, incluso con una clave perfecta. Loop no tiene una comprobación de solo lectura verificada que pueda probar que una clave funciona sin cambiar datos, así que la prueba no envía ninguna solicitud e informa pendiente de verificación. El resultado le dice que hay una clave presente; no le dice que la clave esté mal.
Deje de recrear claves. Confirme que la clave guardada es la creada en Loop admin → Returns Management → Tools & integrations → Developer Tools con el scope returns, siga con el mapping y la activación, y juzgue la conexión por la primera devolución real que llegue por webhook.
La prueba se veía bien sin clave, pero nunca pasa nada real
Con la clave vacía, la prueba solo ejecuta una comprobación simulada y etiqueta el resultado como simulado. Ese resultado nunca se comunica con su cuenta de Loop, así que no puede traer devoluciones ni enviar acciones de marcar y procesar.
Cree una API key real con el scope returns en Loop admin → Returns Management → Tools & integrations → Developer Tools, péguela en el campo api_key y guarde. Después, la prueba mostrará pendiente de verificación: para este canal, así se ve una clave real.
Marcar o procesar una devolución falla
La causa más probable es la propia API key: marcar y procesar son las acciones que se comunican con Loop y necesitan una clave creada con el scope returns. Una clave creada sin ese scope puede estar en la conexión pareciendo completa, mientras Loop rechaza cada acción real sobre una devolución.
Cree una clave nueva en Loop admin → Returns Management → Tools & integrations → Developer Tools, esta vez incluyendo el scope returns, reemplace la api_key guardada por ella y reintente la acción de marcar o procesar sobre la misma devolución.
La conexión está activa, pero no llegan devoluciones
En esta conexión, las devoluciones solo llegan de una manera: por webhook, en el momento en que un comprador crea una devolución en Loop. No hay una extracción por API detrás, así que una conexión activa sin devoluciones nuevas en Loop mostrará correctamente nada nuevo, y las devoluciones creadas antes de la activación no se traen después.
Inicie una devolución real en Loop y espérela aquí y en Runs / Logs. Si llega, la conexión funciona y el periodo tranquilo anterior simplemente no tenía devoluciones nuevas. Si nunca llega, confirme que la conexión está activada con la clave correcta guardada y revise Runs / Logs de ese periodo.
Los compradores preguntan dónde está su etiqueta de devolución
Esta conexión no proporciona etiquetas de devolución en absoluto. Recibe devoluciones y envía las acciones de marcar y procesar; la etiqueta que imprime un comprador viene del propio Loop, según el arreglo de etiquetas que ya tenga en Loop.
Mantenga el flujo de etiquetas del comprador dentro de Loop y revise allí sus ajustes de etiquetas de Loop. Use esta conexión para lo que hace: recibir la devolución aquí para que el almacén pueda marcarla y procesarla.
¿Qué clave debo usar si tengo varias API keys de Loop?
Solo una clave sirve para esta conexión: una clave creada en Returns Management → Tools & integrations → Developer Tools con el scope returns. Las claves creadas para otros fines, o sin ese scope, completarán el campo, pero las acciones de marcar y procesar devoluciones no funcionarán con ellas.
Elija la clave con el scope returns, o cree una nueva siguiendo los pasos de credenciales de arriba, péguela completa en api_key y guarde. Hay un solo campo, así que no hay un segundo lugar donde una clave equivocada pueda esconderse.