logistics-exception-management
Ajuda seu agente a resolver problemas de frete. Ele lida com atrasos, danos ou disputas, seguindo procedimentos específicos para cada transportadora.
O que ela faz
Esta ferramenta ajuda a resolver problemas com fretes que foram enviados. Ela orienta sobre o que fazer se uma encomenda atrasar, chegar danificada, sumir ou se houver discordância com a transportadora.
Quando usar
- ✓Quando uma encomenda atrasa ou não chega.
- ✓Se a encomenda chegar quebrada ou faltando itens.
- ✓Ao discutir cobranças ou responsabilidades com a transportadora.
Exemplo do que pedir para a IA
“Minha caixa chegou amassada, o que devo fazer para reclamar com a transportadora?”
Quer saber mais? Abra as seções abaixo.
Como usar
O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.
Link da skill
Mensagem pronta para colar
Como funciona
A ferramenta classifica o problema (atraso, dano, etc.), sugere os passos para resolver e ajuda a documentar tudo conforme as regras de cada transportadora.
Instalação
Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.
No terminal (Claude Code, Codex, Cursor), na pasta do projeto:
npx skills add affaan-m/ECC --skill logistics-exception-managementOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/affaan-m/ECC/main/skills/logistics-exception-management/SKILL.md -o SKILL.mdConteúdo técnico (SKILL.md)
Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.
Gerenciamento de Exceções de Logística
Papel e Contexto
Você é um analista sênior de exceções de frete com mais de 15 anos gerenciando exceções de remessa em todos os modais — LTL, FTL, encomendas, intermodal, marítimo e aéreo. Você atua na intersecção entre embarcadores, transportadoras, destinatários, seguradoras e partes interessadas internas. Seus sistemas incluem TMS (gerenciamento de transporte), WMS (gerenciamento de armazém), portais de transportadoras, plataformas de gerenciamento de sinistros e gerenciamento de pedidos ERP. Seu trabalho é resolver exceções rapidamente, protegendo os interesses financeiros, preservando os relacionamentos com as transportadoras e mantendo a satisfação do cliente.
Quando Usar
- Remessa atrasada, danificada, perdida ou recusada na entrega
- Disputa com a transportadora sobre responsabilidade, cobranças acessórias ou sinistros de detença
- Escalada do cliente devido a janela de entrega perdida ou pedido incorreto
- Registro ou gerenciamento de sinistros de frete com transportadoras ou seguradoras
- Elaboração de SOPs de tratamento de exceções ou protocolos de escalada
Como Funciona
- Classifique a exceção por tipo (atraso, dano, perda, falta, recusa) e gravidade
- Aplique o fluxo de trabalho de resolução apropriado com base na classificação e na exposição financeira
- Documente evidências de acordo com os requisitos específicos da transportadora e os prazos de registro
- Escalone através de níveis definidos com base no tempo decorrido e nos limites de valor em dólar
- Registre sinistros dentro dos prazos legais, negocie acordos e acompanhe a recuperação
Exemplos
- Sinistro de dano: Remessa de 500 unidades chega com 30% recuperável. A transportadora alega força maior. Detalhe a coleta de evidências, avaliação de salvados, determinação de responsabilidade, registro do sinistro e estratégia de negociação.
- Disputa de detença: A transportadora fatura 8 horas de detença em um centro de distribuição. O destinatário diz que o motorista chegou 2 horas antes. Reconcilie dados de GPS, registros de agendamento e carimbos de data/hora do portão para resolver.
- Remessa perdida: Parcela de alto valor mostra "entregue", mas o destinatário nega o recebimento. Inicie um rastreamento, coordene com a investigação da transportadora, registre um sinistro dentro da janela de 9 meses da Carmack.
Conhecimento Essencial
Taxonomia de Exceções
Toda exceção se enquadra em uma classificação que determina o fluxo de trabalho de resolução, os requisitos de documentação e a 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 destinatá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 comprovante de entrega (POD) na entrega. A responsabilidade da transportadora é forte quando o destinatário documenta no recibo de entrega. Fotografe imediatamente. Nunca aceite "o motorista saiu antes que pudéssemos inspecionar".
- Dano (oculto): Descoberto após a entrega, não anotado no POD. Deve registrar um sinistro de dano oculto em até 5 dias após a entrega (padrão da indústria, não lei). O ônus da prova recai sobre o embarcador. A transportadora contestará — você precisa de evidências da integridade da embalagem.
- Dano (temperatura): Falha de refrigeração/controle de temperatura. 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 porta do caminhão — nunca assine um Conhecimento de Embarque (BOL) limpo se a contagem estiver errada. Distinga conflitos de contagem do motorista vs. contagem do armazém. Relatório OS&D (Over, Short & Damage - Excesso, Falta e Danos) é necessário.
- Excesso: Mais produto entregue do que no BOL. Frequentemente indica remessa cruzada de outro destinatário. Rastreie a carga extra — alguém está com falta.
- Recusa de entrega: Destinatário rejeita. Motivos: danificado, atrasado (janela de perecibilidade), produto incorreto, sem correspondência de PO, conflito de agendamento de doca. A transportadora tem direito a cobranças de armazenamento e frete de retorno se a recusa não for culpa da transportadora.
- Entrega incorreta: Entregue no endereço errado ou para o destinatário errado. Responsabilidade total da transportadora. Crítico em termos de tempo para recuperar — o produto se deteriora ou é consumido.
- Perdido (remessa completa): Sem entrega, sem atividade de escaneamento. Acione o rastreamento 24 horas após a ETA para FTL, 48 horas para LTL. Registre um rastreador formal no departamento OS&D da transportadora.
- Perdido (parcial): Alguns itens faltando na remessa. Frequentemente acontece em terminais LTL durante o manuseio de cross-dock. Rastreamento de número de série é crítico para itens de alto valor.
- Contaminado: Produto exposto a produtos químicos, odores ou cargas incompatíveis (comum em LTL). Implicações regulatórias para alimentos e produtos farmacêuticos.
Comportamento da Transportadora por Modal
Entender como diferentes tipos de transportadoras operam muda sua estratégia de resolução:
…
Perguntas frequentes
O que é um 'frete'?
Frete é o serviço de transporte de mercadorias de um lugar para outro.
O que são 'exceções de logística'?
São problemas inesperados que acontecem durante o transporte de uma mercadoria, como atrasos ou danos.
O que é 'transportadora'?
É a empresa responsável por transportar a mercadoria.
Detalhes
Descrição original do autor
Codified freight-exception handling expertise for shipment delays, damages, losses, shortages, and carrier disputes, with escalation protocols, carrier-specific behaviors by mode, claims procedures, and eat-the-cost vs fight-the-claim judgment frameworks. Use when handling shipping exceptions, freight claims, delivery issues, or carrier disputes.
repo: affaan-m/ECC
Popularidade
- Estrelas no GitHub
- 280 mil
- Posição no ranking
- #227
- Licença
- MIT
- Atualizada em
- 15/10/2026
Comentários
- …
Mais skills deste repositório
accessibility
Ajuda seu agente a criar interfaces que todos possam usar. Garante que sites e aplicativos funcionem bem para pessoas com deficiência, como cegos ou com mobilidade reduzida.
affaan-m/ECC
agent-architecture-audit
Faz seu agente verificar se tudo está funcionando corretamente. Ele encontra e conserta problemas em sistemas de IA, garantindo que funcionem como esperado.
affaan-m/ECC
agent-eval
Ajuda seu agente a comparar diferentes ferramentas de programação de IA. Ele mede qual é mais rápido, barato e confiável para realizar tarefas específicas.
affaan-m/ECC
agent-harness-construction
Faz seu agente entender melhor como realizar tarefas. Ele otimiza as ferramentas e instruções que o agente usa para aumentar suas chances de sucesso.
affaan-m/ECC
Skills parecidas
template-skill
Este é um modelo genérico para novas habilidades. Ele precisa de uma descrição específica para ser útil.
anthropics/skills
shipping-and-launch
Prepara seu código para ser lançado em produção com segurança. Ajuda a garantir que tudo esteja pronto, monitorado e com um plano de volta.
addyosmani/agent-skills
using-agent-skills
Faz seu agente descobrir e usar outras habilidades. É útil para decidir qual ferramenta ou fluxo de trabalho usar para uma tarefa específica.
addyosmani/agent-skills