Seguimiento de paquetes

Propósito e intención del usuario: la herramienta resuelve el seguimiento de paquetes entre múltiples transportistas para flujos de operaciones y atención al cliente. Acepta uno o más números de seguimiento con identificadores de transportista opcionales para recuperar estado actual, ubicación y ETA. Se usa en el cumplimiento de comercio electrónico, planificación logística y soporte para proporcionar actualizaciones precisas a clientes o alimentar paneles downstream, especialmente cuando se necesita una vista unificada entre transportistas. Lógica central y características: capacidades clave incluyen normalización de entradas, mapeo de transportistas y orquestación de APIs para obtener estado en tiempo real de transportistas o agregadores de datos. Funcionalidades obligatorias: búsqueda por múltiples números, esquema de salida estandarizado, validación de entradas y controles de frescura de datos. Funciones opcionales/avanzadas: procesamiento por lotes con reconocimiento de límites de tasa, almacenamiento en caché, notificaciones estilo webhook y formatos de exportación (JSON/CSV) con soporte de localización.
Entradas y salidas: entradas incluyen tracking_numbers (array de cadenas, requeridas), carriers (opcional array o mapping), include_eta (boolean, por defecto true), locale (opcional). Salidas son shipments (array de objetos) con campos: tracking_number, carrier, status, location, timestamp, eta, history (array de eventos). Reglas de validación exigen tracking_numbers no vacíos e identificadores de carrier conocidos si se proporcionan, timestamps ISO 8601 para salidas.
Algoritmos y cálculos: la herramienta usa llamadas REST API a transportistas o agregadores con timeouts y políticas de reintento. Reglas ETA: usar ETA del transportista cuando esté disponible; en caso contrario, estimar usando tiempos de tránsito típicos por ruta y el último evento. Normalización de estados: asigna estados específicos del transportista a una taxonomía común (In Transit, Out for Delivery, Delivered, Exception, Pending).
Errores y escenarios límite: entradas inválidas, transportistas desconocidos o entradas faltantes generan errores de validación. Resultados parciales con códigos de error por envío cuando un transportista no está accesible. Timeouts, límites de tasa o fallos de API disparan lógica de reintentos o fallback a los datos más recientes permitidos.
Industria/Región y Localización: normas ISO 8601, hora UTC y taxonomía de estados estandarizada. Cobertura global; formatos de datos conforme a convenciones industriales. Privacidad acorde con GDPR y prácticas regionales; la moneda no aplica. Supuestos y Exclusiones: se asume acceso a APIs de transportistas o agregadores autorizados; no hay interfaz de usuario; datos no disponibles marcados; no hay streaming en tiempo real; se excluye lógica de enrutamiento interno o datos de inventario.