Solucionador de problemas con la integración básica

Desconectar y volver a instalar tu integración es una solución fiable para errores de conexión persistentes, fallos de autenticación y situaciones en las que los pedidos han dejado de importarse y otros pasos de solución de problemas no han funcionado. Antes de hacerlo, entiende exactamente lo que perderás.

Pasos para restablecer tu integración

1. En tu cuenta de Sendcloud, ve a Configuración > Integraciones.
2. Busca tu integración en la lista y haz clic en Desconectar.
3. Vuelve a instalar la integración siguiendo la guía de configuración de tu plataforma. Puedes encontrar todas las guías de instalación en la sección Integraciones del Centro de ayuda.
4. Después de reconectarte, ve a Configuración > Integraciones > Configurar y vuelve a crear las reglas de envío que se eliminaron.

Antes de revisar la configuración de tu tienda, asegúrate de que tu cuenta de Sendcloud está completamente configurada. Una cuenta incompleta puede bloquear silenciosamente una nueva conexión. Consulta primero los pasos de configuración de la cuenta al inicio de este artículo.

Si tu cuenta está correctamente configurada, trabaja en lo siguiente:

Tu tienda no es accesible públicamente
Sendcloud necesita llegar a tu tienda a través de Internet para establecer una conexión. Si tu tienda está en modo de mantenimiento, protegida con contraseña o aún no publicada, la conexión fallará. Asegúrate de que tu tienda esté activa y sea accesible públicamente antes de conectarla.

Tu certificado SSL es inválido o ha caducado
Aunque tu tienda se cargue correctamente en un navegador, un certificado SSL inválido bloqueará las llamadas API de Sendcloud. Comprueba que tu certificado es válido y está correctamente configurado con tu proveedor de alojamiento.

Un plugin o aplicación de terceros está causando un conflicto
Los plugins de seguridad, de caché y las extensiones de pago son las causas más comunes de conflictos de conexión. Para identificar al responsable, desactiva tus plugins adicionales uno a uno, empezando por los de seguridad, cortafuegos o caché, e intenta reconectar después de cada uno. En cuanto la conexión tenga éxito, habrás encontrado el conflicto.

Las direcciones IP de Sendcloud están siendo bloqueadas
Si tu servidor o entorno de alojamiento utiliza un cortafuegos o una lista de direcciones IP permitidas, puede estar bloqueando Sendcloud. Añade las direcciones IP de Sendcloud a tu lista de permitidos: 

La lista completa también se mantiene y actualiza en: https://cdn.sendcloud.com/global-media/public-ips.txt 
Si tu tienda usa Cloudflare, su configuración de seguridad también puede bloquear Sendcloud. Consulta nuestra guía específica: Solucionar el bloqueo de Sendcloud por Cloudflare.

Un proxy de caché está bloqueando las llamadas API
Si usas un proxy de caché, asegúrate de que no bloquee ni almacene en caché las solicitudes API de Sendcloud. Pide a tu desarrollador que compruebe la configuración de caché y se asegure de que el dominio de Sendcloud no está bloqueado.

Revisar el registro de solicitudes fallidas
Ve a Configuración > Integraciones > Registro de solicitudes fallidas en tu cuenta de Sendcloud. Los errores de conexión se registran aquí con una descripción. Comparte el mensaje de error con tu proveedor de alojamiento o desarrollador si necesitas ayuda para interpretarlo.

Si tu integración funcionaba y ha dejado de funcionar sin que hayas realizado cambios obvios, la causa casi siempre es algo que ha cambiado en el lado de tu tienda o en el lado de Sendcloud. Trabaja en lo siguiente antes de ponerte en contacto con el soporte.

Comprueba primero si es un problema en el lado de Sendcloud
Antes de dedicar tiempo a solucionar problemas en tu tienda, consulta la página de estado de Sendcloud. Si hay un incidente activo que afecta a las integraciones, es posible que tu problema se resuelva solo una vez que se solucione — no necesitas hacer nada por tu parte.

Piensa en qué ha cambiado recientemente
La gran mayoría de las interrupciones repentinas de integración se desencadenan por un cambio, incluso uno que parece no tener relación con Sendcloud. Pregúntate:

• ¿Has actualizado recientemente la plataforma de tu tienda, el tema o algún plugin?
• ¿Has actualizado el plugin o la aplicación de Sendcloud en tu tienda?
• ¿Tu proveedor de alojamiento ha migrado tu servidor o ha cambiado alguna configuración?
• ¿Ha cambiado el dominio o la URL de tu tienda?
• ¿Has regenerado claves API o cambiado contraseñas en el panel de administración de tu tienda?
• ¿Has instalado un nuevo plugin de seguridad o activado una regla de cortafuegos?

Si alguno de estos casos se aplica, ese cambio es muy probablemente la causa. Consulta el registro de solicitudes fallidas (ver la sección anterior) para ver el error que apareció aproximadamente al mismo tiempo.

Comprueba que tu plugin de Sendcloud está actualizado
Una versión obsoleta del plugin de Sendcloud en tu tienda es una causa habitual de interrupciones repentinas, especialmente después de una actualización de plataforma. Ve a la sección de plugins o aplicaciones de tu tienda y confirma que estás usando la última versión de la integración de Sendcloud.

Comprueba que tus credenciales API siguen siendo válidas
Si las claves API o los tokens se han regenerado en tu tienda, incluso de forma automática, la conexión con Sendcloud se interrumpe de inmediato. Ve a Configuración > Integraciones > Configurar en tu cuenta de Sendcloud y verifica las credenciales. Si parecen desactualizadas, vuelve a conectar la integración con las nuevas claves.

Revisar el registro de solicitudes fallidas
Ve a Configuración > Integraciones > Registro de solicitudes fallidas y busca el momento en que empezaron a aparecer los errores. El código de error y la descripción te dirán qué ha cambiado. Relaciona el error con la sección correspondiente de este artículo.

Realiza las siguientes comprobaciones en orden antes de ponerte en contacto con el soporte.

Los nuevos pedidos pueden tardar hasta 4 minutos en aparecer
Sendcloud obtiene los nuevos pedidos aproximadamente cada 4 minutos. Si acabas de realizar un pedido de prueba y aún no ha aparecido, espera unos minutos y actualiza la página antes de asumir que algo va mal.

Comprueba el filtro de fechas en Sendcloud
Por defecto, la vista de pedidos entrantes muestra los pedidos de los últimos 7 días. Si estás buscando pedidos más antiguos, abre el filtro de fechas y configura un intervalo más amplio. Esta es la razón más común por la que los pedidos parecen estar «desaparecidos».

Los pedidos de más de 30 días no se importan
Cuando conectas tu tienda por primera vez, Sendcloud importa solo los pedidos de los últimos 30 días. Los pedidos realizados antes de ese período no aparecerán automáticamente. Si necesitas importar pedidos más antiguos, contacta con el soporte desde tu cuenta de Sendcloud.

Comprueba que tu integración sigue conectada
Ve a Configuración > Integraciones y confirma que tu tienda aparece en la lista de integraciones conectadas. Si no es así, la conexión se ha perdido y deberá restablecerse. Consulta la sección siguiente sobre cómo restablecer tu integración.

Revisar el registro de solicitudes fallidas
Ve a Configuración > Integraciones > Registro de solicitudes fallidas. Si hay errores en la lista, anota el mensaje de error — es la forma más rápida de diagnosticar qué está fallando. Comparte el error con tu proveedor de alojamiento o desarrollador si es necesario.

Un plugin puede estar enviando datos de pedido incompletos
Algunos plugins modifican o eliminan datos de pedidos antes de que lleguen a Sendcloud, lo que provoca que los pedidos fallen silenciosamente. Desactiva los plugins adicionales uno a uno para identificar si alguno está interfiriendo. Los productos marcados como virtuales en tu tienda también pueden provocar que se omitan pedidos.

Es posible que tu tienda no sea accesible públicamente
Si tu tienda ha entrado en modo de mantenimiento o la conexión se ha vuelto inaccesible, los pedidos dejan de importarse. Comprueba que tu tienda está activa y es accesible desde Internet.

Cuando creas una etiqueta en Sendcloud, la integración envía automáticamente el número de seguimiento y el estado del pedido actualizado a tu tienda. Si esto no está ocurriendo, comprueba lo siguiente.

Comprueba que tu integración sigue conectada
Los comentarios solo pueden enviarse si la conexión entre Sendcloud y tu tienda está activa. Ve a Configuración > Integraciones y confirma que tu tienda aparece en las integraciones conectadas. Si la conexión se ha perdido, las actualizaciones de seguimiento de los pedidos enviados mientras tanto no se enviarán de forma retroactiva — tendrás que actualizar esos pedidos manualmente en tu tienda.

Revisar el registro de solicitudes fallidas
Ve a Configuración > Integraciones > Registro de solicitudes fallidas. Si Sendcloud intentó enviar información de seguimiento y falló, el error queda registrado aquí con una descripción. Es la forma más rápida de confirmar si se realizó algún intento de envío.

Comprueba cuándo se creó la etiqueta
La información de seguimiento se envía en el momento en que se crea la etiqueta en Sendcloud. Si la etiqueta se creó mientras la integración estaba desconectada, no se habrá enviado información de seguimiento para ese pedido. Actualiza el estado del pedido manualmente en tu tienda en esos casos.

El envío puede estar retrasado, no perdido
Si procesas un gran número de pedidos a la vez, tu plataforma puede limitar las actualizaciones entrantes de Sendcloud, provocando un breve retraso antes de que aparezcan los estados y los números de seguimiento. Espera unos minutos antes de asumir que el envío ha fallado por completo.

Estos dos errores son los problemas de autenticación más comunes en todas las integraciones. Se parecen pero tienen causas diferentes.

401 — Sendcloud no puede autenticarse con tu tienda
Significa que Sendcloud está siendo rechazado porque las credenciales que utiliza son inválidas o han caducado. Las causas más comunes son:

• Las claves API utilizadas para conectar tu integración han caducado o se han regenerado en tu tienda sin actualizarlas en Sendcloud.
• Tu cuenta de Sendcloud no tiene un método de pago configurado. Ve a Configuración > Finanzas y asegúrate de que haya un método de pago activo — una configuración de facturación incompleta puede bloquear la autenticación.

Para solucionar un error 401, regenera tus claves API en tu tienda e introdúcelas de nuevo en Sendcloud en Configuración > Integraciones > Configurar. Si eso no funciona, desconecta y vuelve a instalar la integración desde cero para generar una nueva conexión.

403 — Sendcloud está siendo bloqueado activamente
Significa que tu servidor o una capa de seguridad anterior está rechazando completamente las solicitudes de Sendcloud. Las causas más comunes son:

• Las direcciones IP de Sendcloud están bloqueadas por el cortafuegos o el entorno de alojamiento de tu servidor. Añádelas a tu lista de permitidos — la lista completa está en https://cdn.sendcloud.com/global-media/public-ips.txt.
• Cloudflare está bloqueando las solicitudes de Sendcloud a través del Bot Fight Mode o reglas WAF. Consulta nuestra guía específica: Solucionar el bloqueo de Sendcloud por Cloudflare.
• Para Shopify: el token OAuth utilizado durante la instalación ha caducado o los permisos de la aplicación han cambiado. Reinstalar la aplicación de Sendcloud en Shopify genera un nuevo token y resuelve este problema.

Consulta primero el registro de solicitudes fallidas
Ve a Configuración > Integraciones > Registro de solicitudes fallidas. Un error 401 aparecerá como orders.apis.base.exceptions.AuthenticationError. Un error 403 aparecerá como orders.apis.base.exceptions.AccessDenied o como un error genérico de acceso prohibido. El registro te indica con qué tipo te estás enfrentando antes de tomar ninguna acción.

El registro de solicitudes fallidas es tu primera parada para cualquier problema de integración. Registra cada vez que Sendcloud intentó comunicarse con tu tienda y falló — ya sea para obtener pedidos, enviar información de seguimiento o comprobar la conexión. Si algo va mal con tu integración, el motivo casi siempre está aquí.

Cómo encontrarlo
Ve a Configuración > Integraciones en tu cuenta de Sendcloud. Busca tu integración en la lista y haz clic en Ver > registro de problemas de conexión (o Registro de solicitudes fallidas, según el tipo de integración).

Qué verás
Cada entrada muestra la fecha y hora de la solicitud fallida, el código de error y una descripción de lo que salió mal. Los errores más recientes aparecen en la parte superior. Aspectos clave que debes buscar:

• El código de error (401, 403, 404, 500, etc.) te indica la categoría del problema. Usa la sección anterior sobre errores 401 y 403, o el solucionador de problemas de tu plataforma al final de este artículo, para relacionar el código con una solución.
• La descripción del error suele indicar la causa exacta, por ejemplo: orders.apis.base.exceptions.AuthenticationError o orders.apis.base.exceptions.NotFoundError. Copia este texto cuando contactes con el soporte, ya que acelera considerablemente el diagnóstico.
• La marca de tiempo te indica cuándo empezó el problema. Si los errores comienzan en un momento concreto, piensa en qué cambió aproximadamente en ese momento — una actualización de plugin, una migración de servidor, un cambio de contraseña o una actualización de WooCommerce son desencadenantes habituales.

Si el registro está vacío
Un registro vacío no siempre significa que todo funciona. Puede significar que Sendcloud no está llegando a tu tienda en absoluto — la solicitud ni siquiera pasa para generar un error. Si tus pedidos han dejado de importarse y el registro está vacío, vuelve a la lista de comprobación de conexión anterior y verifica que tu tienda es accesible públicamente y que las direcciones IP de Sendcloud no están bloqueadas.

Qué hacer con el error
La mayoría de los errores del registro son accionables — relaciona el código de error con la sección correspondiente de este artículo o con el solucionador de problemas de tu plataforma. Si has seguido los pasos relevantes y el error persiste, abre una solicitud de soporte desde tu cuenta de Sendcloud e incluye una captura de pantalla de la entrada del registro junto con el texto exacto del error. Es lo más útil que puedes proporcionar al soporte.