¿Se agotó el tiempo de espera de la solicitud de seguimiento en tiempo real? Reintento, alternativa y reglas de estado que debes seguir
Cuando una solicitud de seguimiento en tiempo real agota el tiempo de espera, trata el estado más reciente del envío como desconocido, no como retrasado, perdido o sin cambios. Reintenta solo dentro de un límite de tiempo definido y, después, muestra una actualización claramente etiquetada como la última conocida o pide al usuario que vuelva a comprobarlo más tarde. Mantén separados durante todo el proceso el resultado de la solicitud, la antigüedad de los datos y el estado real del paquete.
Esta distinción es importante tanto para las páginas de seguimiento orientadas al cliente como para los sistemas que utilizan los datos de seguimiento para activar notificaciones o flujos de trabajo de soporte. Un tiempo de espera agotado indica que una respuesta no llegó a tiempo. No indica si el transportista tiene un evento nuevo, si un servicio ascendente procesó la solicitud o si el paquete se ha movido.
Primero, identifica qué agotó el tiempo de espera
Una solicitud de seguimiento puede fallar en varios puntos: el navegador puede dejar de esperar a tu aplicación, tu aplicación puede dejar de esperar a una API de seguimiento o esa API puede agotar el tiempo de espera mientras contacta con otro servicio. El usuario puede ver el mismo error genérico en cada caso, pero la acción adecuada es diferente.
- Tiempo de espera agotado en el cliente: La aplicación dejó de esperar. La solicitud del lado del servidor aún podría haberse completado. Comprueba tus propios registros de solicitudes o el almacén de resultados antes de emitir otra solicitud que pudiera duplicar el trabajo.
- Fallo de red o conexión: Tu sistema no recibió una respuesta utilizable. Es posible que no sepas si el servicio remoto procesó la solicitud.
- HTTP 504: Una puerta de enlace o un proxy no recibió una respuesta oportuna de un servidor ascendente. Esto describe la ruta de la solicitud, no el envío.
- HTTP 408: El servidor no recibió un mensaje de solicitud completo dentro del tiempo que estaba preparado para esperar. No es un estado de seguimiento del transportista.
- HTTP 200 con un evento antiguo: La solicitud se realizó correctamente, pero la información de seguimiento devuelta aún puede estar desactualizada. Una respuesta HTTP correcta no garantiza la actualidad de los datos.
Registra estos resultados como diagnósticos de la solicitud. No traduzcas ninguno de ellos en etiquetas del envío como “en tránsito”, “incidencia” o “entregado”. Esas etiquetas deben proceder de eventos de seguimiento o de un campo de estado documentado, no de la capa de transporte.
Utiliza un reintento limitado, no un bucle indefinido
Para una consulta de seguimiento de solo lectura, a menudo es razonable reintentar después de agotar el tiempo de espera. Aun así, debe existir un límite. Las solicitudes repetidas pueden aumentar la carga de un servicio con problemas, prolongar la espera del usuario y crear trabajo duplicado cuando varias capas de la aplicación reintentan de forma independiente.
- Establece un plazo total. Decide cuánto puede durar la operación orientada al usuario, incluido el intento inicial y cualquier reintento. No concedas a cada intento un plazo completo nuevo que supere el tiempo que la persona que llama puede esperar.
- Comprueba si la operación se puede repetir de forma segura. Una consulta normalmente es diferente de una solicitud que registra un envío, cambia configuraciones o crea un recurso. No reproduzcas automáticamente una solicitud que cambie el estado a menos que el contrato del proveedor o tus controles de idempotencia hagan que sea seguro.
- Reintenta los fallos transitorios con moderación. Utiliza un presupuesto de reintentos pequeño y explícito, así como un retraso con variación aleatoria, en lugar de enviar reintentos inmediatos y simultáneos desde muchos clientes.
- Respeta las instrucciones aplicables del servidor. Si una respuesta incluye un encabezado
Retry-Afterválido, no programes un reintento anterior. Respeta también cualquier límite más estricto de la aplicación o del proveedor. - Detente cuando se agote el plazo o el presupuesto. Cambia a una respuesta alternativa y programa por separado una conciliación posterior si el flujo de trabajo la necesita.
Un diseño práctico podría permitir un reintento orientado al usuario si queda suficiente tiempo, mientras traslada los intentos adicionales a una actualización en segundo plano. Es un ejemplo de política, no una regla universal de API. Elige los límites a partir de tus objetivos de nivel de servicio, la latencia observada y la documentación del proveedor. Cuenta también los reintentos realizados por las bibliotecas HTTP, las puertas de enlace y los trabajadores de tareas; de lo contrario, una política de aplicación aparentemente moderada puede generar muchas llamadas ascendentes.
Para HTTP 429, trata la respuesta como una señal de límite de frecuencia, no como un motivo para reintentar inmediatamente. HTTP 503 puede indicar una incapacidad temporal para gestionar la solicitud, y el servidor puede proporcionar Retry-After. Un 504 puede ser transitorio, pero no garantiza que el siguiente intento funcione. Los errores de autenticación generalmente requieren comprobar las credenciales o los permisos, mientras que las solicitudes con formato incorrecto requieren corregir los datos de entrada. Un identificador de seguimiento que produce un resultado de “no encontrado” requiere más cuidado: según el comportamiento documentado del proveedor y la etapa del envío, puede ser demasiado pronto para encontrar un registro o el identificador puede ser incorrecto. No conviertas un único resultado de este tipo en una afirmación definitiva de que el paquete no existe.
Elige una alternativa que conserve lo que sabes
La alternativa más segura suele ser el último resultado de seguimiento verificado, acompañado de su propia hora del evento y de una etiqueta honesta de actualidad. Mantén ese resultado separado del fallo de la solicitud actual. Una página podría indicar: “Última actualización disponible: Instalación de origen abandonada. Última comprobación: [hora]. Una actualización más reciente no está disponible temporalmente”. Incluye “Última comprobación” solo si tu sistema realmente la registra; no sustituye la hora del evento del transportista.
Utiliza la hora más específica que puedas respaldar. La hora de un evento del transportista describe cuándo ocurrió supuestamente. La hora en que tu sistema recibió ese evento describe la ingestión. La hora en que un usuario abrió la página no describe ninguna de las dos. Si la fuente no proporciona una hora del evento o una zona horaria fiables, evita inventarlas. Del mismo modo, si el resultado almacenado en caché no tiene una hora de recuperación registrada, llámalo “última actualización disponible” en lugar de afirmar que se actualizó recientemente.
Una alternativa debe respetar tres límites:
- Muestra los datos almacenados en caché como datos almacenados en caché. No presentes un evento antiguo como resultado de la solicitud cuyo tiempo de espera se agotó.
- No infieras progreso a partir del tiempo transcurrido. Un paquete no está “en reparto” simplemente porque lleve varios días en tránsito.
- No ocultes una incertidumbre importante. Si no existe un resultado anterior, indica que el seguimiento no está disponible temporalmente en lugar de mostrar un estado predeterminado inventado.
Otras alternativas pueden incluir un almacén de seguimiento sincronizado previamente, una consulta autorizada al transportista o una actualización posterior en segundo plano. Úsalas solo si se ajustan al envío, a tus permisos y a las condiciones de la fuente de datos. Una segunda fuente puede tener nombres de eventos o retrasos de información diferentes, así que conserva la procedencia y evita combinar registros contradictorios sin una regla para hacerlo. Si un cliente puede actuar según el resultado, ofrece una forma de reintentar o contactar con soporte en lugar de dejar un indicador de carga indefinidamente.
Mantén separados el estado de la solicitud, la actualidad de los datos y el estado del envío
Son tres campos diferentes, aunque una interfaz de usuario los muestre juntos. El estado de la solicitud indica si la consulta se realizó correctamente, agotó el tiempo de espera o recibió un error. La actualidad de los datos indica cuándo se observó la información devuelta o almacenada. El estado del envío indica qué informa la fuente de seguimiento sobre el paquete. Separarlos evita que un fallo temporal de la API sobrescriba un evento de entrega válido o convierta un evento antiguo “en tránsito” en una afirmación actual.
Por ejemplo, un sistema podría conservar un evento “Entregado” verificado de una consulta anterior mientras la actualización actual agota el tiempo de espera. El evento de entrega no desaparece. El estado combinado correcto es que el último estado disponible del envío es entregado y que la actualización más reciente falló. Por el contrario, si el último evento es “En tránsito”, un tiempo de espera agotado no confirma que el paquete siga en tránsito en este momento; solo confirma que no se obtuvo una respuesta más reciente.
Aplica una regla definida cuando los eventos lleguen fuera de orden. Compara los identificadores de eventos, las marcas de tiempo, la fuente y la semántica de estados documentada por el proveedor cuando esté disponible. No supongas que el orden en que tu sistema recibió las actualizaciones es el orden en que ocurrieron los eventos del envío. Tampoco permitas que un evento antiguo recibido tarde sustituya automáticamente un estado nuevo verificado. Sin embargo, las correcciones y excepciones pueden ser legítimas, así que evita una regla general que considere imposibles los cambios de estado posteriores a la entrega. Conserva los eventos subyacentes e investiga las contradicciones en lugar de reescribir silenciosamente el historial.
Si un proveedor devuelve HTTP 202, interprétalo según el contrato de ese endpoint: aceptar una solicitud no significa por sí mismo que la consulta de seguimiento se haya completado. Del mismo modo, HTTP 200 establece que una solicitud HTTP se realizó correctamente según la semántica de ese endpoint; no demuestra que todos los campos de seguimiento estén presentes o actualizados. Asigna los campos específicos de la respuesta del proveedor solo después de comprobar su documentación.
Haz visible el fallo para los operadores sin alarmar a los clientes
Un registro operativo útil incluye el ID de solicitud, el endpoint o la operación, el número de intentos, el tiempo transcurrido, la capa que agotó el tiempo de espera, el estado HTTP si se recibió alguno y si la respuesta procedía de una consulta en tiempo real o de una alternativa. Para los datos de seguimiento, registra la fuente y las marcas de tiempo relevantes del evento o de la recuperación. Gestiona los números de seguimiento y la información del cliente conforme a las reglas de acceso y conservación de tu organización; la utilidad diagnóstica no justifica exponer identificadores completos en registros sin restricciones.
Busca patrones en lugar de depender de un único tiempo de espera agotado. Un aumento de la tasa de tiempos de espera en una ruta de un transportista, respuestas 429 repetidas o una diferencia cada vez mayor entre la hora del evento del transportista y la hora de recuperación pueden indicar problemas distintos. El primero puede requerir una investigación del proveedor, el segundo puede requerir control de frecuencia y el tercero puede requerir comprobar la sincronización o la entrega de eventos. Si una aplicación ofrece seguimiento mediante un proveedor como la 17TRACK Tracking API, utiliza la documentación de ese proveedor para verificar los campos de respuesta específicos del endpoint, los límites de solicitudes y la gestión de errores antes de implementar estas reglas generales.
Para el mensaje dirigido al cliente, sé preciso y moderado: “No hemos podido actualizar el seguimiento en este momento. Esta es la última actualización disponible”. Indica el siguiente paso cuando sea útil, como volver a comprobarlo más tarde o contactar con soporte si el envío supera el plazo de entrega previsto proporcionado por el vendedor o el transportista. Evita prometer un tiempo de actualización que tu sistema no pueda garantizar.
Lista de comprobación para publicar un flujo de seguimiento seguro frente a tiempos de espera
- Confirma qué capa impone cada tiempo de espera y qué capa gestiona los reintentos.
- Establece un plazo total para la solicitud y un presupuesto de reintentos separado y limitado.
- Verifica que las operaciones reintentadas automáticamente se puedan repetir de forma segura.
- Respeta los límites de frecuencia y las instrucciones válidas de
Retry-After. - Almacena el resultado de la solicitud por separado del estado del envío y del historial de eventos.
- Etiqueta los datos alternativos y conserva su fuente y sus marcas de tiempo cuando estén disponibles.
- Prueba escenarios sin caché, con caché obsoleta, 429, 503, 504 y respuestas tardías.
- Comprueba que un tiempo de espera agotado no pueda activar una notificación de entrega incorrecta ni borrar un evento verificado.
La regla fundamental es sencilla: reintenta una solicitud solo cuando hacerlo sea seguro y útil; utiliza como alternativa solo información que puedas identificar; y nunca hagas una afirmación sobre el estado del envío a partir de un tiempo de espera HTTP.
Preguntas frecuentes
¿Debo reintentar inmediatamente una solicitud de seguimiento cuyo tiempo de espera se agotó?
No automáticamente. Comprueba que la operación se pueda repetir de forma segura, que el plazo general deje tiempo para otro intento y que ninguna instrucción de límite de frecuencia indique que debes esperar. Un reintento breve y limitado con variación aleatoria puede ser adecuado para una consulta de solo lectura; los reintentos inmediatos repetidos son una mala opción predeterminada.
¿HTTP 504 significa que el sistema de seguimiento del transportista está caído?
No. Significa que una puerta de enlace o un proxy no recibió a tiempo una respuesta ascendente. El problema puede estar en cualquier punto de esa ruta de solicitud. No demuestra la disponibilidad general del transportista ni el estado del paquete.
¿Puedo mostrar el último estado conocido después de un tiempo de espera agotado?
Sí, si lo etiquetas como la información más reciente disponible y no como una actualización correcta en tiempo real. Muestra la hora del evento y la hora de recuperación cuando se conozcan, y deja claro que no se pudo confirmar una actualización más reciente.
¿Un tiempo de espera agotado debe cambiar un envío de “en tránsito” a “incidencia”?
No. Un tiempo de espera agotado es un fallo de la solicitud, no un evento del envío. Cambia el estado del envío solo cuando una fuente de seguimiento fiable proporcione un evento o estado que respalde el cambio.
¿Qué ocurre si la solicitud cuyo tiempo de espera se agotó estaba creando o registrando un registro de seguimiento?
No supongas que falló. El sistema remoto podría haberlo procesado antes de que se perdiera la respuesta. Comprueba si existe un resultado y utiliza un mecanismo de idempotencia documentado o un procedimiento de recuperación aprobado por el proveedor antes de enviarlo de nuevo.
Fuentes
- RFC 9110, HTTP Semantics — definiciones de estados HTTP,
Retry-Aftery consideraciones para reintentar solicitudes. - RFC 6585, Additional HTTP Status Codes — definición de HTTP 429 y su uso con
Retry-After. - Amazon Builders’ Library, “Timeouts, retries, and backoff with jitter” — orientación de ingeniería sobre la amplificación de reintentos, el retroceso y la variación aleatoria.
- 17TRACK Tracking API documentation — referencia para verificar el comportamiento específico de la API del proveedor antes de la implementación.


