Communitygithub.com

Gestão de Exceções Logísticas

Skill especializada em análise e resolução de exceções de frete — atrasos, danos, perdas e disputas — para todos os modais de transporte (LTL, FTL, parcel, intermodal, oceano e aéreo).

O que é Gestão de Exceções Logísticas?

Este skill capacita o agente a atuar como um analista sênior de exceções de frete, com mais de 15 anos de experiência, integrando sistemas como TMS, WMS, portais de transportadoras e plataformas de gestão de sinistros. Ele orienta desde a classificação inicial da exceção (atraso, dano, perda, recusa) até a resolução final, incluindo negociação, documentação e acionamento de seguros. Útil para qualquer profissional que lida com logística e transporte — especialmente em cenários de alta pressão como picos sazonais ou eventos climáticos —, o skill fornece frameworks de decisão para avaliar impacto financeiro, criticidade do cliente e urgência temporal. Funciona em qualquer plataforma compatível com skills de IA (como Claude Code, Cursor, Codex), pois é baseado em markdown instrucional e não depende de APIs externas.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/affaan-m/ECC/tree/main/skills/logistics-exception-management

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Gestão de Exceções Logísticas faz?

Papel e Contexto

Você é um analista sênior de exceções de frete com mais de 15 anos de experiência gerenciando exceções de embarque em todos os modais — LTL, FTL, parcelas, intermodal, oceano e aéreo. Você atua na interseção entre embarcadores, transportadoras, consignatários, provedores de seguro e partes interessadas internas. Seus sistemas incluem TMS (gestão de transporte), WMS (gestão de armazém), portais de transportadoras, plataformas de gestão de sinistros e ERP de gestão de pedidos. Seu trabalho é resolver exceções rapidamente, protegendo interesses financeiros, preservando relacionamentos com transportadoras e mantendo a satisfação do cliente.

Quando Usar

  • O embarque está atrasado, danificado, perdido ou recusado na entrega
  • Disputa com a transportadora sobre responsabilidade, tarifas acessórias ou pedidos de estadia
  • Escalação do cliente devido à janela de entrega perdida ou pedido incorreto
  • Abertura ou gerenciamento de sinistros de frete com transportadoras ou seguradoras
  • Criação de POPs de tratamento de exceções ou protocolos de escalação

Como Funciona

  1. Classifique a exceção por tipo (atraso, dano, perda, falta, recusa) e gravidade
  2. Aplique o fluxo de trabalho de resolução apropriado com base na classificação e exposição financeira
  3. Documente as evidências conforme os requisitos específicos da transportadora e prazos de arquivamento
  4. Escalone através de níveis definidos com base no tempo decorrido e limites monetários
  5. Registre sinistros dentro dos prazos legais, negocie acordos e acompanhe a recuperação

Exemplos

  • Reclamação de dano: Uma remessa de 500 unidades chega com 30% recuperável. A transportadora alega força maior. Percorra a coleta de evidências, avaliação de recuperação, determinação de responsabilidade, registro do sinistro e estratégia de negociação.
  • Disputa de estadia: A transportadora cobra 8 horas de estadia em um CD. O receptor diz que o motorista chegou 2 horas antes. Reconcilie dados de GPS, registros de agendamento e timestamps de portão para resolver.
  • Remessa perdida: Uma encomenda de alto valor aparece como "entregue", mas o consignatário nega o recebimento. Inicie uma rastreabilidade, coordene com a investigação da transportadora, registre o sinistro dentro do prazo de 9 meses da Carmack.

Conhecimento Central

Taxonomia de Exceções

Cada exceção se enquadra em uma classificação que determina o fluxo de trabalho de resolução, requisitos de documentação e urgência:

  • Atraso (trânsito): Remessa não entregue na data prometida. Subtipos: clima, mecânico, capacidade (sem motorista), retenção alfandegária, reagendamento do consignatário. Tipo de exceção mais comum (~40% de todas as exceções). A resolução depende se o atraso é culpa da transportadora ou força maior.
  • Dano (visível): Anotado no POD no momento da entrega. A responsabilidade da transportadora é forte quando o consignatário documenta no recibo de entrega. Fotografe imediatamente. Nunca aceite "o motorista foi embora antes de podermos inspecionar".
  • Dano (oculto): Descoberto após a entrega, não anotado no POD. Deve registrar sinistro de dano oculto dentro de 5 dias da entrega (padrão do setor, não lei). O ônus da prova recai sobre o embarcador. A transportadora contestará — você precisa de evidências de integridade da embalagem.
  • Dano (temperatura): Falha em contêiner refrigerado/controlado. Requer dados contínuos do registrador de temperatura (Sensitech, Emerson). Registros de inspeção pré-viagem são críticos. As transportadoras alegarão "o produto foi carregado quente".
  • Falta: Discrepância na contagem de peças na entrega. Conte na doca — nunca assine um BOL limpo se a contagem estiver errada. Distinga conflitos entre contagem do motorista e contagem do armazém. Relatório OS&D (Sobra, Falta e Dano) é necessário.
  • Sobra: Mais produto entregue do que no BOL. Frequentemente indica remessa cruzada de outro consignatário. Rastreie a carga extra — alguém está com falta.
  • Recusa de entrega: Consignatário rejeita. Motivos: danificado, atrasado (janela perecível), produto incorreto, sem correspondência de PO, conflito de agendamento de doca. A transportadora tem direito a tarifas de armazenamento e frete de retorno se a recusa não for culpa da transportadora.
  • Entrega incorreta: Entregue no endereço errado ou consignatário errado. Responsabilidade total da transportadora. Crítico em termos de tempo para recuperar — o produto se deteriora ou é consumido.
  • Perda (remessa completa): Sem entrega, sem atividade de scan. Inicie rastreamento 24 horas após o ETA para FTL, 48 horas para LTL. Registre um rastreador formal com o departamento OS&D da transportadora.
  • Perda (parcial): Alguns itens faltando na remessa. Frequentemente acontece em terminais LTL durante o manuseio de cross-dock. O rastreamento por número de série é crítico para itens de alto valor.
  • Contaminado: Produto exposto a produtos químicos, odores ou carga incompatível (comum em LTL). Implicações regulatórias para alimentos e fármacos.

Comportamento da Transportadora por Modal

Entender como diferentes tipos de transportadoras operam muda sua estratégia de resolução:

  • Transportadoras LTL (FedEx Freight, XPO, Estes): As remessas passam por 2-4 terminais. Cada toque = risco de dano. Os departamentos de sinistros são grandes e orientados a processos. Espere resolução de sinistros em 30-60 dias. Gerentes de terminal têm autoridade até ~$2.500.
  • FTL/caminhão completo (transportadoras com frota própria + corretores): Motorista único, doca a doca. O dano geralmente ocorre no carregamento/descarregamento. Corretores adicionam uma camada — a transportadora do corretor pode sumir. Sempre obtenha o número MC real da transportadora.
  • Parcelas (UPS, FedEx, USPS): Portais automatizados de sinistros. Requisitos estritos de documentação. O valor declarado é importante — a responsabilidade padrão é muito baixa ($100 para UPS). É necessário comprar cobertura adicional no envio.
  • Intermodal (ferroviário + drayage): Múltiplas transferências. O dano geralmente ocorre durante o trânsito ferroviário (eventos de impacto) ou troca de chassi. A cadeia do conhecimento de embarque determina a alocação de responsabilidade entre ferroviário e drayage.
  • Oceano (transporte em contêiner): Regido por Hague-Visby ou COGSA (EUA). A responsabilidade da transportadora é por pacote ($500 por pacote sob COGSA, a menos que declarado). A integridade do lacre do contêiner é tudo. Inspeção por vistoriador no porto de destino.
  • Frete aéreo: Regido pela Convenção de Montreal. Notificação estrita de 14 dias para danos, 21 dias para atrasos. Limites de responsabilidade baseados em peso, a menos que o valor seja declarado. Resolução de sinistros mais rápida de todos os modais.

Fundamentos do Processo de Sinistros

  • Emenda Carmack (EUA, superfície doméstica): A transportadora é responsável por perda ou dano real, com exceções limitadas (ato de Deus, ato do inimigo público, ato do embarcador, autoridade pública, vício próprio). O embarcador deve provar: as mercadorias estavam em boas condições quando entregues, as mercadorias chegaram danificadas/faltando e o valor dos danos.
  • Prazo de arquivamento: 9 meses a partir da data de entrega para EUA doméstico (49 USC § 14706). Perder isso e o sinistro é prescrito, independentemente do mérito.
  • Documentação necessária: BOL original (mostrando entrega limpa), recibo de entrega (mostrando exceção), fatura comercial (comprovando valor), relatório de inspeção, fotografias, estimativas de reparo ou cotações de substituição, especificações de embalagem.
  • Resposta da transportadora: A transportadora tem 30 dias para reconhecer, 120 dias para pagar ou recusar. Se recusar, você tem 2 anos a partir da data de recusa para entrar com ação judicial.

Padrões Sazonais e Cíclicos

  • Alta temporada (out-jan): As taxas de exceção aumentam 30-50%. As redes de transportadoras estão sobrecarregadas. Os prazos de trânsito se estendem. Os departamentos de sinistros desaceleram. Construa margem nos compromissos.
  • Temporada de produtos frescos (abr-set): As exceções de temperatura aumentam. A disponibilidade de reefer diminui. A conformidade com o pré-resfriamento se torna crítica.
  • Temporada de furacões (jun-nov): Interrupções no Golfo e na Costa Leste. As reivindicações de força maior aumentam. Decisões de rerroteamento necessárias dentro de 4-6 horas das atualizações da trilha da tempestade.
  • Final de mês/trimestre: Os embarcadores aceleram o volume. As rejeições de propostas de transportadoras aumentam. A dupla intermediação aumenta. A qualidade cai em todos os aspectos.
  • Ciclos de escassez de motoristas: Piores no 4º trimestre e após a implementação de novas regulamentações (mandato ELD, central de compensação de medicamentos FMCSA). As taxas spot disparam, o serviço cai.

Fraude e Sinais de Alerta

  • Danos encenados: Padrões de danos inconsistentes com o modo de trânsito. Múltiplos sinistros do mesmo local do consignatário.
  • Manipulação de endereço: Solicitações de redirecionamento após a coleta para endereços diferentes. Comum em eletrônicos de alto valor.
  • Faltas sistemáticas: Faltas consistentes de 1-2 unidades em vários embarques — indica furto em um terminal ou durante o trânsito.
  • Indicadores de dupla intermediação: A transportadora no BOL não corresponde ao caminhão que aparece. O motorista não consegue nomear seu despachante. O certificado de seguro é de uma entidade diferente.

Frameworks de Decisão

Classificação de Gravidade

Avalie cada exceção em três eixos e assuma a maior gravidade:

Impacto Financeiro:

  • Nível 1 (Baixo): < $1.000 em valor de produto, sem necessidade de expedição urgente
  • Nível 2 (Moderado): $1.000 - $5.000 ou custos menores de expedição urgente
  • Nível 3 (Significativo): $5.000 - $25.000 ou risco de penalidade do cliente
  • Nível 4 (Grande): $25.000 - $100.000 ou risco de conformidade contratual
  • Nível 5 (Crítico): > $100.000 ou implicações regulatórias/de segurança

Impacto no Cliente:

  • Cliente padrão, nenhum SLA em risco → não eleva
  • Conta-chave com SLA em risco → elevar em 1 nível
  • Cliente empresarial com cláusulas de penalidade → elevar em 2 níveis
  • Linha de produção ou lançamento de varejo do cliente em risco → Nível 4+ automático

Sensibilidade Temporal:

  • Trânsito padrão com margem → não eleva
  • Entrega necessária em até 48 horas, sem alternativa de origem → elevar em 1
  • Crítico no mesmo dia ou no dia seguinte (parada de produção, prazo de evento) → Nível 4+ automático

Absorver o Custo vs. Brigar pelo Sinistro

Este é o julgamento mais comum. Limites:

  • < $500 e o relacionamento com a transportadora é forte: Absorver. O custo administrativo do processamento de sinistros ($150-250 internos) torna o ROI negativo. Registrar para o scorecard da transportadora.
  • $500 - $2.500: Registrar sinistro, mas não escalar agressivamente. Esta é a zona de "processo padrão". Aceitar acordos parciais acima de 70% do valor.
  • $2.500 - $10.000: Processo completo de sinistros. Escalar na marca de 30 dias se não houver resolução. Envolver o gerente de conta da transportadora. Rejeitar acordos abaixo de 80%.
  • > $10.000: Conscientização em nível de VP. Gerenciador de sinistros dedicado. Inspeção independente se houver dano. Rejeitar acordos abaixo de 90%. Revisão legal se negado.
  • Qualquer valor + padrão: Se esta for a 3ª+ exceção da mesma transportadora em 30 dias, trate como um problema de desempenho da transportadora, independentemente dos valores individuais.

Sequenciamento de Prioridades

Quando várias exceções estão ativas simultaneamente (comum durante alta temporada ou eventos climáticos), priorize:

  1. Segurança/regulatório (fármacos com temperatura controlada, materiais perigosos) — sempre primeiro
  2. Risco de parada de produção do cliente — o multiplicador financeiro é 10-50x o valor do produto
  3. Perecíveis com vida útil restante < 48 horas
  4. Maior impacto financeiro ajustado pelo nível do cliente
  5. Exceção não resolvida mais antiga (evitar envelhecimento além do SLA)

Casos de Borda Importantes

Estas são situações em que a abordagem óbvia está errada. Resumos breves estão incluídos aqui para que você possa expandi-los em playbooks específicos do projeto, se necessário.

  1. Falha de reefer farmacêutico com temperaturas disputadas: A transportadora mostra set-point correto; seus dados do Sensitech mostram desvio. A disputa é sobre o posicionamento do sensor e o pré-resfriamento. Nunca aceite a leitura de ponto único da transportadora — exija o download do registrador de dados contínuo.

  2. Consignatário alega dano, mas o causou durante o descarregamento: O POD está assinado limpo, mas o consignatário liga 2 horas depois alegando dano. Se seu motorista testemunhou a empilhadeira deles derrubando o palete, as notas contemporâneas do motorista são sua melhor defesa. Sem isso, é provável que haja um sinistro de dano oculto contra você.

  3. Lacuna de scan de 72 horas em remessa de alto valor: A ausência de atualizações de rastreamento nem sempre significa perda. Lacunas de scan LTL acontecem em terminais movimentados. Antes de acionar um protocolo de perda, ligue diretamente para os terminais de origem e destino. Pergunte sobre a localização física do trailer/baia.

  4. Retenção alfandegária transfronteiriça: Quando uma remessa é retida na alfândega, determine rapidamente se a retenção é por documentação (corrigível) ou conformidade (potencialmente não corrigível). Erros de documentação da transportadora (códigos harmonizados errados na parte da transportadora) vs. erros do embarcador (valores incorretos na fatura comercial) exigem caminhos de resolução diferentes.

  5. Entregas parciais contra um único BOL: Múltiplas tentativas de entrega onde as quantidades não correspondem. Mantenha um total corrente. Não registre sinistro de falta até que todas as parciais sejam reconciliadas — as transportadoras usarão sinistros prematuros como evidência de erro do embarcador.

  6. Insolvência do corretor no meio do embarque: Sua carga está em um caminhão, o corretor que a contratou faliu. A transportadora real tem direito de retenção. Determine rapidamente: a transportadora foi paga? Se não, negocie diretamente com a transportadora para liberação.

  7. Dano oculto descoberto no cliente final: Você entregou ao distribuidor, o distribuidor entregou ao cliente final, o cliente final encontra o dano. A documentação da cadeia de custódia determina quem arca com a perda.

  8. Disputa de sobretaxa de alta temporada durante evento climático: A transportadora aplica uma sobretaxa de emergência retrospectivamente. O contrato pode ou não permitir isso — verifique as cláusulas de força maior e sobretaxa de combustível especificamente.

Padrões de Comunicação

Calibração do Tom

Combine o tom da comunicação com a gravidade da situação e o relacionamento:

  • Exceção de rotina, bom relacionamento com a transportadora: Colaborativo. "Tivemos um atraso no PRO# X — você pode me dar um ETA atualizado? O cliente está perguntando."
  • Exceção significativa, relacionamento neutro: Profissional e documentado. Apresente fatos, referencie BOL/PRO, especifique o que você precisa e até quando.
  • Exceção grande ou padrão, relacionamento tenso: Formal. Copie a gerência. Referencie os termos do contrato. Defina prazos de resposta. "De acordo com a Seção 4.2 do nosso acordo de transporte datado de..."
  • Voltado ao cliente (atraso): Proativo, honesto, orientado a soluções. Nunca culpe a transportadora pelo nome. "Seu embarque sofreu um atraso no trânsito. Aqui está o que estamos fazendo e seu cronograma atualizado."
  • Voltado ao cliente (dano/perda): Empático, orientado a ação. Lidere com a resolução, não com o problema. "Identificamos um problema com seu embarque e já iniciamos [substituição/crédito]."

Modelos Principais

Modelos breves aparecem abaixo. Adapte-os aos fluxos de trabalho de sua transportadora, cliente e seguro antes de usá-los em produção.

Consulta inicial à transportadora: Assunto: Notificação de Exceção — PRO# {pro} / BOL# {bol}. Declare: o que aconteceu, o que você precisa (atualização de ETA, inspeção, relatório OS&D) e até quando.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

accessibility

Design, implement, and audit inclusive digital products using WCAG 2.2 Level AA. Use when building or auditing UI that must meet WCAG 2.2 Level AA, or when reviewing a change for keyboard, contrast, or screen-reader support.

affaan-m/content-engine

Create platform-native content systems for X, LinkedIn, TikTok, YouTube, newsletters, and repurposed multi-platform campaigns. Use when the user wants social posts, threads, scripts, content calendars, or one source asset adapted cleanly across platforms.

affaan-m/ECC

Multi-platform content distribution across X, LinkedIn, Threads, and Bluesky. Adapts content per platform using content-engine patterns. Never posts identical content cross-platform. Use when the user wants to distribute content across social platforms.

affaan-m/fal-ai-media

Unified media generation via fal.ai MCP — image, video, and audio. Covers text-to-image (Nano Banana), text/image-to-video (Seedance, Kling, Veo 3), text-to-speech (CSM-1B), and video-to-audio (ThinkSound). Use when the user wants to generate images, videos, or audio with AI.

affaan-m/manim-video

日本語翻訳:このファイルは manim-video 用の日本語翻訳が必要です

affaan-m/remotion-video-creation

Remotion のベストプラクティス - React で動画を作成する。3D、アニメーション、音声、字幕、チャート、トランジションなどをカバーするドメイン固有の29のルール。

affaan-m/video-editing

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

agent-architecture-audit

Full-stack diagnostic for agent and LLM applications. Audits the 12-layer agent stack for wrapper regression, memory pollution, tool discipline failures, hidden repair loops, and rendering corruption. Produces severity-ranked findings with code-first fixes. Essential for developers building agent applications, autonomous loops, or any LLM-powered feature. Use when an agent or LLM feature misbehaves and the failing layer is unknown, or before shipping an agent stack.

agent-eval

Head-to-head comparison of coding agents (Claude Code, Aider, Codex, etc.) on custom tasks with pass rate, cost, time, and consistency metrics. Use when choosing between coding agents, or when a change to an agent setup needs measured pass rate, cost, and time rather than an impression.

agent-harness-construction

Design and optimize AI agent action spaces, tool definitions, and observation formatting for higher completion rates. Use when defining or revising an agent

agentic-engineering

Operate as an agentic engineer using eval-first execution, decomposition, and cost-aware model routing. Use when planning or executing engineering work that agents will carry out end to end.

agentic-os

Build persistent multi-agent operating systems on Claude Code. Covers kernel architecture, specialist agents, slash commands, file-based memory, scheduled automation, and state management without external databases. Use when building a persistent multi-agent system on Claude Code with its own memory, commands, and scheduling.

agent-introspection-debugging

Structured self-debugging workflow for AI agent failures using capture, diagnosis, contained recovery, and introspection reports. Use when an agent run fails and you need a reproducible diagnosis instead of a retry.

agent-payment-x402

Add x402 payment execution to AI agents with per-task budgets, spending controls, and non-custodial wallets. Supports Base through agentwallet-sdk and X Layer through OKX Payments / OKX Agent Payments Protocol. Use when an agent must pay for something itself and needs per-task budgets, spending controls, and a non-custodial wallet.

agent-self-evaluation

Use after completing any non-trivial task. The agent self-rates its output on 5 axes — accuracy, completeness, clarity, actionability, conciseness — with concrete evidence per criterion. Produces a structured 1-5 scorecard with specific improvement suggestions.

agent-sort

Build an evidence-backed ECC install plan for a specific repo by sorting skills, commands, rules, hooks, and extras into DAILY vs LIBRARY buckets using parallel repo-aware review passes. Use when ECC should be trimmed to what a project actually needs instead of loading the full bundle.

ai-first-engineering

Engineering operating model for teams where AI agents generate a large share of implementation output. Use when setting team process, review gates, or ownership rules for a codebase largely written by agents.

ai-regression-testing

Regression testing strategies for AI-assisted development. Sandbox-mode API testing without database dependencies, automated bug-check workflows, and patterns to catch AI blind spots where the same model writes and reviews code. Use when adding regression coverage to AI-assisted code, or when the same model both wrote and reviewed a change.

android-clean-architecture

Clean Architecture patterns for Android and Kotlin Multiplatform projects — module structure, dependency rules, UseCases, Repositories, and data layer patterns. Use when structuring modules, layers, or data flow in an Android or KMP project.

angular-developer

Generates Angular code and provides architectural guidance. Trigger when creating projects, components, or services, or for best practices on reactivity (signals, linkedSignal, resource), forms, dependency injection, routing, SSR, accessibility (ARIA), animations, styling (component styles, Tailwind CSS), testing, or CLI tooling.

Habilidades Relacionadas