Rastreamento de pacotes

Propósito e intenção do usuário: a ferramenta resolve o rastreamento de pacotes entre várias transportadoras para equipes operacionais e fluxos de atendimento. Aceita um ou mais códigos de rastreio com identificadores de transportadora opcionais para recuperar status atual, localização e ETA. É usada por fulfilment de e-commerce, planejadores logísticos e agentes de suporte para fornecer atualizações precisas aos clientes ou alimentar painéis a jusante, especialmente quando é necessária uma visão unificada entre transportadoras. Lógica central e recursos: capacidades-chave incluem normalização de entrada, mapeamento de transportadoras e orquestração de APIs para obter status em tempo real de transportadoras ou agregadores de dados. Funcionalidades obrigatórias: pesquisa por múltiplos números, esquema de saída padronizado, validação de entradas e controles de atualidade dos dados. Funcionalidades opcionais/avançadas: processamento em lotes com reconhecimento de limites de taxa, cache, notificações tipo webhook e formatos de exportação (JSON/CSV) com suporte de localização.
Entradas & Saídas: entradas incluem tracking_numbers (array de strings, requeridas), carriers (opcional array ou mapping), include_eta (booleano, padrão true), locale (opcional). Saídas são shipments (array de objetos) com campos: tracking_number, carrier, status, location, timestamp, eta, history (array de eventos). Regras de validação exigem tracking_numbers não vazios e identificadores de carrier conhecidos se fornecidos, timestamps ISO 8601 para saídas.
Algoritmos & Cálculos: a ferramenta utiliza chamadas REST API para carriers ou agregadores com timeouts e políticas de retry. Regras ETA: usar ETA fornecida pelo carrier quando disponível; caso contrário, estimar usando tempos de trânsito típicos por rota e o último evento. Normalização de status: mapa os status específicos do carrier para uma taxonomia comum (In Transit, Out for Delivery, Delivered, Exception, Pending).
Erros & Casos Limites: entradas inválidas, carriers desconhecidos ou inputs ausentes geram erros de validação. Resultados parciais com códigos de erro por envio quando um carrier está indisponível. Timeouts, limites de taxa ou falhas de API disparam retry ou fallback para dados mais recentes permitidos.
Indústria/Região & Localização: padrões ISO 8601, horário UTC e taxonomia de status padronizada. Cobertura global; formatos de dados conforme convenções da indústria. Privacidade conforme RGPD e práticas regionais; moeda não aplicável. Suposições & Exclusões: supõe acesso às APIs de transportadoras ou agregadores autorizados; não há interface de usuário; dados indisponíveis sinalizados; sem streaming em tempo real; exclui lógica interna de roteamento ou dados de inventário.