Gestão de Pátio e Agendamento de Carga e Descarga (YMS): O Fim das Filas de Caminhões, Redução de Diárias da Lei 13.103/15, Integração com TMS/WMS e Automação de Portaria

1. Cenário Macroeconômico: O Custo Invisível dos Pátios Ineficientes no Brasil

O transporte rodoviário de cargas movimenta mais de 65% de toda a riqueza produzida no Brasil. Contudo, sob a ótica da produtividade de capital e da eficiência de ativos, o setor padece de uma patologia crônica: o desperdício de tempo em pátios logísticos. Estudos setoriais apontam que um caminhão pesado de longo curso no Brasil gasta em média entre 35% e 45% de todo o seu ciclo mensal de trabalho parado — seja aguardando autorização em acostamentos de rodovias, em bolsões de triagem desestruturados ou aguardando a liberação de docas em centros de distribuição e fábricas.

Esse tempo morto, denominado internacionalmente como dwell time, não apenas encarece o frete em até 18% no valor final ao embarcador, mas também deteriora as condições de trabalho do motorista profissional, desgasta o relacionamento com transportadores autônomos (TACs) e transportadoras terceirizadas (ETCs) e desequilibra a matriz energética nacional pelo consumo ocioso de combustível diesel em manobras erráticas e motores ligados para alimentar climatizadores e geradores.

O custo econômico direto da ineficiência de pátio no Brasil supera R$ 30 bilhões anuais quando somados os custos de capital empatado dos cavalos mecânicos e semirreboques ociosos, as diárias de estadia pagas por expedidores e consignatários, os custos com horas extras de operadores de empilhadeiras e conferentes, e os congestionamentos gerados nas malhas viárias municipais e rodoviárias adjacentes aos grandes polos industriais e logísticos.

2. Fundamentação Jurídica da Estadia: Lei nº 13.103/2015, Art. 11 e Tolerância de 5 Horas

Historicamente, o tempo gasto pelo caminhão nas dependências do embarcador ou do destinatário era absorvido pelo transportador como um custo comercial tácito. Essa assimetria contratual foi expressamente vedada com a promulgação da Lei nº 13.103, de 2 de março de 2015 (conhecida como a Lei do Motorista), que alterou substancialmente a Lei nº 11.442/2007 para estabelecer um marco regulatório rigoroso sobre o tempo de espera para carga e descarga.

O Artigo 11, § 5º da Lei nº 11.442/2007 (com redação dada pela Lei nº 13.103/2015) determina com precisão cirúrgica:

"O prazo máximo para carga e descarga do Veículo de Transporte Rodoviário de Cargas será de 5 (cinco) horas, contadas da chegada do veículo ao endereço de destino, após o qual será devido ao Transportador Autônomo de Cargas - TAC ou à ETC a importância correspondente a R$ 1,38 (um real e trinta e oito centavos) por tonelada/hora ou fração produzida."

É imperativo destacar quatro aspectos jurídicos fundamentais dessa regra que frequentemente geram condenações milionárias na Justiça Comum e na Justiça do Trabalho:

• Atualização Monetária Anual Obrigatória: O valor original de R$ 1,38 por tonelada/hora fixado em 2015 não é estático. O § 6º do mesmo artigo impõe que esse valor deve ser atualizado anualmente pela variação do Índice Nacional de Preços ao Consumidor (INPC), apurado pelo IBGE, mediante resolução publicada pela Agência Nacional de Transportes Terrestres (ANTT). Em valores atuais, a hora de estadia ultrapassa a marca de R$ 2,21 por tonelada/hora. Para uma composição pesada do tipo Rodotrem de 9 eixos com capacidade de carga útil de 50 toneladas, cada hora de atraso além da tolerância custa mais de R$ 110,00 líquidos ao devedor.
• Cálculo Baseado na Capacidade Total e Não na Carga Transportada: A lei fala explicitamente em "capacidade total do veículo de transporte", e não no volume efetivamente carregado na viagem. Isso impede manobras contratuais que tentavam minimizar a penalidade em viagens com lotação fracionada ou veículos parcialmente preenchidos.
• Responsabilidade Solidária Plena: O Artigo 11, § 7º estabelece a responsabilidade civil solidária entre o expedidor (embarcador) e o consignatário (destinatário da carga) pelo pagamento da indenização por tempo de espera. Ou seja, se o destinatário final atrasar o descarregamento em seu armazém por 20 horas, o transportador pode demandar a cobrança integral diretamente contra o embarcador que contratou o frete, cabendo a este mover ação regressiva se assim desejar.
• Obrigação Legal do Comprovante de Chegada e Saída: O § 8º do dispositivo impõe que o embarcador e o destinatário são legalmente obrigados a fornecer ao motorista documento formal e inequívoco comprobatório do horário de chegada e da saída das dependências do estabelecimento. A recusa em emitir o protocolo ou a falsificação do registro constitui infração grave sujeita a sanções administrativas da ANTT e inversão do ônus da prova em favor do transportador em juízo.

3. Anatomia do Yard Management System (YMS): O Elo Perdido entre TMS, WMS e ERP

Durante décadas, a arquitetura de sistemas corporativos de logística focou seus investimentos em duas grandes pontas: o WMS (Warehouse Management System) para o gerenciamento intramuros da armazenagem, separação de pedidos e estoque; e o TMS (Transportation Management System) para o despacho rodoviário, auditoria de conhecimentos de transporte (CT-e) e monitoramento de rotas.

Entre a cancela de entrada e a porta das docas de carregamento, no entanto, existe uma área geográfica cinzenta de milhares de metros quadrados onde reina a descoordenação física: o pátio logístico. É nessa "terra de ninguém" que o YMS (Yard Management System) opera como a espinha dorsal de orquestração em tempo real.

4. Agendamento Inteligente e Gestão de Janelas (Dock Scheduling & Slotting)

O agendamento de docas (Dock Scheduling) é o alicerce preventivo de qualquer estratégia de pátio bem-sucedida. Operações que trabalham no regime de chegada por livre demanda (first-come, first-served) invariavelmente colapsam nos picos sazonais ou no início das manhãs, quando dezenas de veículos se aglomeram simultaneamente nas vias de acesso.

Um motor de agendamento moderno opera sobre o conceito de Slotting Dinâmico, que calcula a duração de cada janela de carregamento ou descarregamento a partir dos seguintes parâmetros técnicos objetivos:

1. Perfil da Unidade de Carga: Cargas 100% paletizadas com padrão PBR (1.000 x 1.200 mm) descarregadas por paleteiras elétricas exigem em média de 35 a 45 minutos em uma carreta de 28 a 30 paletes. Já cargas batidas ou fracionadas (caixas soltas, sacarias ou fardos despaletizados) demandam mão de obra braçal intensiva e levam de 4 a 7 horas, exigindo janelas estendidas ou docas especializadas com esteiras telescópicas.
2. Tipologia do Veículo e Carroceria: Caminhões do tipo Baú com doca niveladora requerem procedimentos diferentes de carretas Sider (lonadas laterais) que exigem pátio aberto para destolamento e empilhadeiras operando pelas laterais, ou carretas Graneleiras e Basculantes que dependem de tombadores ou moegas de descarga.
3. Tempo Padrão de Operação (TPO): O sistema deve decompor o tempo total de doca em subetapas auditáveis: (a) manobra e acoplamento na bolsa de vedação; (b) abertura de lacres e conferência cega inicial; (c) movimentação física de carga; (d) conferência física, validação fiscal de NF-e e devoluções; (e) fechamento de portas, lacração e desocupação da baia.

A inteligência do agendamento deve impedir que os transportadores reservem janelas de forma fictícia para "garantir vaga". Isso é mitigado com a aplicação de taxas de no-show contratualizadas e pontuações de confiabilidade (Score de Pontualidade do Transportador), onde fornecedores com altos índices de cancelamento perdem a prioridade na escolha de horários nobres de operação.

5. Automação da Portaria e Acesso com OCR/LPR, RFID e Balanças Dinâmicas

A portaria de acesso é o primeiro funil físico de qualquer pátio. Em sistemas tradicionais, a verificação manual de documentos em papel, a digitação de números de notas fiscais, a anotação de placas em cadernos e a checagem manual de CNH criam filas desnecessárias de até 20 minutos por veículo. Se um centro de distribuição recebe 150 caminhões por turno, a fila acumulada no portão torna-se matematicamente inevitável.

A engenharia moderna de portaria sem paradas fundamenta-se em quatro pilares tecnológicos integrados:

• Leitura Automática de Placas por Visão Computacional (LPR/OCR): Câmeras com iluminação infravermelha e sensores neurais na borda capturam simultaneamente as placas dianteira e traseira do veículo (identificando a placa do cavalo trator e a placa do semirreboque, inclusive com reconhecimento das novas placas padrão Mercosul e antigas cinzas).
• Cruzamento Pré-Despacho com a Base de Documentos Eletrônicos: Ao reconhecer a placa, o sistema bate instantaneamente os dados com o Manifesto Eletrônico de Documentos Fiscais (MDF-e) e os Conhecimentos de Transporte Eletrônicos (CT-e) emitidos contra aquele CNPJ na SEFAZ. Se a placa possui agendamento ativo para aquela janela e os documentos fiscais estão autorizados, a cancela abre automaticamente em menos de 15 segundos.
• Balanças Dinâmicas de Baixa Velocidade (Low-Speed WIM): Instaladas logo na pista de entrada da portaria, as células de carga aferem o peso bruto total (PBT) e o peso por eixo enquanto o veículo roda a até 10 km/h. O peso aferido é comparado em tempo real com o peso teórico constante nas notas fiscais do MDF-e. Divergências superiores à margem de tolerância (ex: 2%) disparam um desvio automático do caminhão para uma baia de auditoria física, impedindo que veículos com sobrepeso ou divergência de carga entrem no fluxo regular do armazém.
• Validação de Compliance ANTT em Tempo Real: A portaria automatizada conecta-se à API de RNTRC do Geodagio para verificar se o transportador (seja TAC, ETC ou CTC) está com a situação cadastral ativa e regular perante a ANTT, além de confirmar a regularidade do CIOT (Resolução ANTT nº 5.862/2019), blindando o embarcador contra multas administrativas e responsabilidade por contratar operadores irregulares.

6. Geofencing e Telemetria: Abertura Inviolável do Relógio da Estadia e Comunicação

O maior ponto de atrito jurídico entre embarcadores e transportadores na cobrança de diárias de estadia reside na divergência do momento exato de início da contagem das 5 horas de tolerância. O transportador alega que chegou às 07:00 no acostamento da rodovia; a portaria do embarcador alega que o caminhão só deu entrada na guarita às 11:30 após ser chamado pelo rádio.

Essa vulnerabilidade probatória é completamente eliminada com o emprego de Geofencing de Alta Precisão (cerca virtual geográfica) integrado à telemetria do caminhão ou ao aplicativo móvel do condutor:

1. Cerca Perimétrica de Aproximação (Buffer Externo): Definida em um raio de 2 km a 5 km do centro logístico. Quando o caminhão cruza essa linha imaginária, o YMS recebe o evento telemático de aproximação, pré-aloca a doca ou a vaga no bolsão de triagem e atualiza o painel da torre de controle com a confirmação de chegada iminente.
2. Cerca de Pátio (Início Legal da Estadia): Definida exatamente sobre os limites territoriais do imóvel do expedidor/destinatário. Ao cruzar este polígono, o sistema gera um evento assinado digitalmente com coordenadas GPS e timestamp UTC imutável. Esse carimbo de tempo é enviado via webhook para o TMS da transportadora e para o ERP do embarcador, inaugurando a contagem oficial das 5 horas regulamentares do Artigo 11 da Lei nº 13.103/2015.
3. Comunicação Direta com o Motorista por Canais Digitais: O motorista não precisa descer da cabine para saber quando entrar. O YMS aciona mensageria bidirecional via WhatsApp, SMS ou notificações push em aplicativo proprietário: "Olá Motorista Carlos, sua carreta placa ABC-1234 foi direcionada para a Doca 14. Por favor, estacione em marcha a ré na vaga correspondente e aguarde a chamada do conferente."

7. O Modelo Drop-and-Hook (Pátio Desatrelado): Engenharia para Giro Máximo de Frotas

Nas operações de transporte de alta densidade (como bens de consumo de rápido giro - FMCG, bebidas, e-commerce e papel/celulose), reter o cavalo mecânico (trator) atrelado à carreta enquanto ela é carregada ou descarregada representa uma anomalia econômica. O cavalo mecânico representa de 65% a 70% do custo de aquisição do conjunto e seu motorista deve ter seu tempo de direção aproveitado ao máximo dentro dos limites da Lei do Motorista.

A solução de engenharia logística mais eficiente para esse gargalo é a implantação do modelo Drop-and-Hook (também chamado no Brasil de Pátio Desatrelado ou Troca de Carretas):

• Como Funciona a Operação: O caminhão trator chega ao centro de distribuição trazendo um semirreboque carregado. Ele entra no pátio, desengata a carreta em uma vaga demarcada do pulmão de descarregamento (Drop) e manobra até outra área onde engata um semirreboque que já foi previamente carregado, conferido e lacrado pela equipe do armazém (Hook). O ciclo completo de entrada, desengate, engate e saída consome de 15 a 25 minutos.
• Relação Ótima de Equipamentos (Fleet Ratio): O sucesso do modelo desatrelado depende da correta proporção entre semirreboques e cavalos mecânicos. A literatura e a prática industrial recomendam uma razão entre 2,2:1 e 3,0:1 (isto é, cerca de 2 a 3 semirreboques para cada cavalo trator em operação na malha dedicada).
• O Papel dos Tratores de Manobra (Tuggers / Shunters): A movimentação das carretas desatreladas entre o bolsão de estacionamento e as docas de carga/descarga é realizada exclusivamente por veículos especializados de pátio (tratores de terminal com quinta roda de elevação hidráulica, que engatam sem necessidade de girar manualmente as pernas de apoio da carreta). O motorista de estrada não gasta energia nem tempo em manobras intramuros.
• Rastreamento e Inventário de Carretas por IoT e Sensores BLE: Carretas não possuem motor próprio para alimentar rastreadores comuns. O controle de pátio desatrelado exige tags de identificação por radiofrequência (RFID) passiva nas portas ou beacons Bluetooth Low Energy (BLE) solares instalados no teto do baú, que transmitem periodicamente sua posição para antenas receptoras distribuídas pelos postes de iluminação do pátio, mantendo o inventário de cada baú atualizado no software YMS.

8. Integração Sistêmica Tripartite: YMS, TMS e WMS Orientados a Eventos

Um Yard Management System isolado transforma-se rapidamente em mais um silo de informações. O seu potencial máximo manifesta-se quando ele funciona como o polo integrador em tempo real de uma tríade arquitetural conectada:

Essa arquitetura deve preferencialmente ser orientada a eventos (Event-Driven Architecture - EDA), utilizando mensageria de baixa latência como Apache Kafka, RabbitMQ ou AWS SNS/SQS. Desta forma, se o caminhão sofre um atraso na rodovia detectado pela API de rotas do TMS, o YMS automaticamente recalcula a esteira de docas sem intervenção humana, liberando aquele slot vago para outro veículo que já esteja no pátio aguardando chamada.

9. Roteirização Just-in-Time Conectada às Janelas de Doca: O Papel das APIs Geodagio

Um dos maiores erros da gestão logística é dissociar o planejamento de transportes na rodovia do agendamento de pátio no destino. Se a viagem entre uma fábrica em Betim (MG) e um centro de distribuição em Cajamar (SP) leva em média 8 horas para uma carreta pesada, agendar o descarregamento para as 14:00 e liberar a saída do veículo às 06:00 da manhã ignora variáveis que fatalmente quebrarão o compromisso:

• Curvas de Aceleração e Velocidades Médias Reais: Uma composição de 45 a 74 toneladas não desenvolve a velocidade de um automóvel leve. Em trechos sinuosos de serra (como a Rodovia Fernão Dias, BR-381), a velocidade média em aclives cai para 30 a 40 km/h.
• Passagem por Praças de Pedágio e Free Flow: Filas em cabines manuais de pedágio acumulam de 5 a 15 minutos por praça em horários de pico. Em rotas com 8 a 12 praças, o tempo adicional de pedágio ultrapassa 1 hora e meia de viagem.
• Paradas Obrigatórias da Lei do Descanso: O Artigo 67-C do Código de Trânsito Brasileiro (CTB) impõe parada inegociável de 30 minutos a cada 5 horas e meia de direção contínua para motoristas profissionais, exigindo descanso em Ponto de Parada e Descanso (PPD) credenciado.

Ao consumir a API de Rotas e Pedágios do Geodagio, a torre de controle da transportadora e o motor de agendamento do embarcador realizam o cálculo reverso de partida Just-in-Time: o sistema fixa o horário do slot agendado na doca e projeta retroativamente o momento exato em que o caminhão deve acionar a ignição, considerando pedágios reais por eixo, postos ideais para abastecimento com menor preço de diesel da base ANP e paradas legais em PPDs.

10. Gestão de Exceções no Pátio: No-Show, Atrasos, Divergências e Avarias

Em um cenário logístico perfeito, todos os veículos chegariam pontualmente em suas janelas de agendamento. No mundo real do transporte rodoviário, as exceções operacionais ocorrem diariamente. Um YMS de classe mundial diferencia-se justamente pela capacidade algorítmica de absorver o imprevisto sem paralisar a esteira do armazém.

A governança de pátio deve definir quatro procedimentos operacionais padrão (SOPs) para as principais exceções:

1. Veículo com Atraso Crítico (Late Arrival): Se o caminhão ultrapassar 30 minutos de tolerância após o início de sua janela sem justificativa prévia de telemetria, o YMS cancela automaticamente o slot reservado e realoca a doca para a próxima carga prioritária. O veículo atrasado é transferido para a fila de encaixe estocástico, perdendo a preferência e sendo convocado apenas quando surgir uma ociosidade imprevista.
2. Chegada Antecipada com Horas de Vantagem (Early Arrival): Ocorre frequentemente quando motoristas viajam à noite para evitar congestionamentos. O veículo tem seu acesso liberado ao bolsão de estacionamento (garantindo segurança e infraestrutura sanitária ao condutor), mas o sistema registra formalmente que a chegada antecipada decorreu de conveniência do transportador. O relógio legal da tolerância de 5 horas passa a contar estritamente a partir do horário originalmente agendado, e não do momento do check-in físico não solicitado.
3. Carga com Avaria ou Divergência na Conferência Cega: Quando a conferência identifica paletes tombados, caixas amassadas ou divergência física de contagem perante a nota fiscal, a carreta não pode permanecer ocupando a doca principal de expedição. O YMS ordena a interrupção do processo e comanda o trator de manobra para transferir a carreta para uma Doca de Exceção e Triagem (Red Dock), liberando a doca nobre para continuar operando o fluxo contínuo.
4. Recusa Total de Carga e Retorno: Quando a carga é rejeitada integralmente pelo destinatário, o YMS emite imediatamente o Termo de Recusa Eletrônico com registro fotográfico, notificando a seguradora e a torre de controle para emissão da NF-e de retorno e planejamento da rota reversa com cálculo automático de pedágios de volta via Geodagio.

11. A Conexão Crítica com Pátios Portuários, Porto Sem Papel e Demurrage Rodoviária

Nenhum ecossistema de transporte ilustra tão dramaticamente a necessidade de gestão de pátio do que os corredores de exportação agrícola e industrial conectados aos principais portos brasileiros — especialmente o Porto de Santos (SP), Paranaguá (PR), Rio Grande (RS) e os terminais do Arco Norte (Itaituba/Barcarena).

No passado recente, as safras de soja e milho provocavam filas de mais de 40 quilômetros de caminhões parados na Rodovia dos Imigrantes e na BR-277, gerando caos de trânsito, acidentes fatais e poluição extrema. A resposta governamental e dos operadores portuários foi a criação do sistema Porto Sem Papel e dos Pátios Reguladores Externos:

• O Mecanismo dos Pátios Reguladores: Nenhum caminhão carregado de granéis ou contêineres tem autorização para descer a serra ou se aproximar dos gates portuários sem ter passado previamente por um pátio regulador homologado (localizados a dezenas de quilômetros do porto, como nos pátios de Cubatão ou no pátio de triagem de Paranaguá).
• A Convocação Eletrônica para o Gate do Porto: O caminhão permanece no pátio regulador até que o terminal portuário confirme via sistema que o navio atracou e que o berço de atracação está apto a receber a carga. A convocação do caminhão gera um passe eletrônico com código de barras/QR Code temporalmente restrito (janela de 2 horas).
• O Custo da Demurrage de Contêineres e Estadias: Se a gestão de pátio falha na coordenação de carretas porta-contêineres, o exportador é atingido por duas penalidades financeiras pesadas: a estadia do motorista rodoviário (Lei 13.103/2015) e a demurrage cobrada pelo armador marítimo pelo atraso na devolução do contêiner vazio, que varia de US$ 50 a US$ 200 por dia por unidade.

12. Modelagem Matemática e Teoria das Filas (M/M/c) no Dimensionamento de Docas

A engenharia de pátio não pode se apoiar em estimativas intuitivas. Para planejar quantas docas físicas devem ser construídas e quantas equipes de conferentes devem ser alocadas em cada turno de trabalho para garantir que a tolerância de 5 horas da Lei nº 13.103/2015 nunca seja violada, aplica-se a Teoria das Filas, notadamente o modelo multicanal com chegadas Poissonianas e tempos de atendimento exponenciais, classificado pela Notação de Kendall como um sistema M/M/c.

Seja:

• $\lambda$ (Lambda): Taxa média de chegada de caminhões por hora ao centro de distribuição;
• $\mu$ (Mu): Taxa média de atendimento de uma doca (caminhões descarregados por hora por doca);
• $c$: Número de docas ativas em operação paralela;
• $\rho$ (Rô): Taxa de utilização média do sistema de docas, dada por:
  
  $$\rho = \frac{\lambda}{c \cdot \mu}$$
  Para que o sistema seja estável e a fila não cresça para o infinito, é matematicamente obrigatório que $\rho < 1$.

A probabilidade de que todas as docas estejam ociosas ($P_0$) em um sistema M/M/c é dada pela fórmula analítica:

A partir de $P_0$, calcula-se o número médio de caminhões em espera no pátio ($L_q$) e, fundamentalmente, pela Lei de Little ($L_q = \lambda \cdot W_q$), calcula-se o tempo médio de espera do caminhão no bolsão antes de atracar na doca ($W_q$):

O tempo total de permanência no complexo logístico ($W$) é a soma do tempo de espera na fila ($W_q$) com o tempo médio de descarregamento na doca ($1 / \mu$):

O Objetivo Matemático do YMS: Ajustar dinamicamente a taxa de chegadas ($\lambda$) através de janelas de agendamento forçadas e aumentar a taxa de serviço ($\mu$) por meio de conferência prévia automatizada de CT-e, garantindo que o tempo total $W$ permaneça estritamente abaixo do limiar crítico:

13. Estudo de Caso Real: Retorno sobre o Investimento (ROI) em um Centro de Distribuição

Para materializar os ganhos financeiros e operacionais obtidos com a transição de um modelo analógico para um YMS de última geração, examinemos os resultados consolidados de um projeto executado em um grande Centro de Distribuição de bens de consumo localizado na Região Metropolitana de Campinas (SP):

Retorno Financeiro sobre o Investimento (Payback): O investimento total no projeto — englobando licenças de software, instalação de 4 câmeras OCR LPR nos portões de entrada e saída, 2 cancelas de alta velocidade, totens de autoatendimento touch-screen e integração via webhooks com o ERP SAP e o WMS — totalizou R$ 680.000,00. Considerando apenas a economia direta na eliminação das diárias de estadia (R$ 204.600/mês), o investimento foi 100% amortizado em 3,3 meses de operação, gerando a partir de então um benefício líquido recorrente de mais de R$ 2,4 milhões por ano.

14. Arquitetura de Software: Modelagem de Dados, APIs e Scripts Práticos (Node.js & Python)

Abaixo apresentamos a arquitetura de engenharia de software para orquestração de pátio em tempo real, integrando a recepção do veículo com a API de Rotas e Pedágios do Geodagio e a modelagem matemática de filas.

14.1. Script de Automação de Check-in e Cálculo de Estadia em Node.js / TypeScript

import axios from 'axios';

interface TruckCheckInPayload {
  plateTruck: string;       // Placa do cavalo mecânico
  plateTrailer: string;     // Placa do semirreboque
  carrierRntrc: string;     // Registro ANTT
  mdfKey: string;           // Chave do Manifesto Eletrônico
  capacityTons: number;     // Capacidade de carga em toneladas
  scheduledSlotUtc: string; // Janela agendada (ISO string)
}

interface DwellTimeEvaluation {
  plateTruck: string;
  checkInTimeUtc: string;
  hoursElapsed: number;
  isOvertime: boolean;
  penaltyAmountBrl: number;
}

export class YardOrchestrator {
  private readonly INPC_HOURLY_RATE_PER_TON = 2.21; // Valor atualizado conforme ANTT
  private readonly LEGAL_TOLERANCE_HOURS = 5.0;

  // Realiza a triagem automática de portaria cruzando com Geodagio
  public async processGateCheckIn(payload: TruckCheckInPayload): Promise<boolean> {
    console.log(`[YMS-GATE] Iniciando OCR para placas ${payload.plateTruck} / ${payload.plateTrailer}`);

    // 1. Validar regularidade do transportador na API do Geodagio
    const rntrcValidation = await axios.get(
      `https://api.geodagio.com/api/v1/rntrc/${payload.carrierRntrc}`,
      { headers: { 'Authorization': `Bearer ${process.env.GEODAGIO_API_KEY}` } }
    );

    if (rntrcValidation.data?.status !== 'ATIVO') {
      console.error(`[YMS-GATE] Bloqueio: RNTRC ${payload.carrierRntrc} irregular na ANTT.`);
      return false;
    }

    // 2. Registrar evento de check-in com carimbo temporal imutável
    const checkInTimestamp = new Date().toISOString();
    console.log(`[YMS-GATE] Acesso autorizado. Check-in registrado em ${checkInTimestamp}`);
    
    // Inicia o monitoramento de estadia da Lei 13.103/2015
    return true;
  }

  // Avalia o risco e valor da diária de estadia em tempo real
  public evaluateDwellTime(
    checkInTime: Date,
    capacityTons: number,
    currentTime: Date = new Date()
  ): DwellTimeEvaluation {
    const elapsedMilliseconds = currentTime.getTime() - checkInTime.getTime();
    const hoursElapsed = elapsedMilliseconds / (1000 * 60 * 60);

    const isOvertime = hoursElapsed > this.LEGAL_TOLERANCE_HOURS;
    let penaltyAmountBrl = 0;

    if (isOvertime) {
      const billableHours = hoursElapsed - this.LEGAL_TOLERANCE_HOURS;
      penaltyAmountBrl = billableHours * capacityTons * this.INPC_HOURLY_RATE_PER_TON;
    }

    return {
      plateTruck: 'ABC1D23',
      checkInTimeUtc: checkInTime.toISOString(),
      hoursElapsed: Number(hoursElapsed.toFixed(2)),
      isOvertime,
      penaltyAmountBrl: Number(penaltyAmountBrl.toFixed(2)),
    };
  }
}

14.2. Script em Python para Simulação de Filas de Docas e Prevenção de Gargalos

import math

def calculate_mmc_queue(arrival_rate_lambda: float, service_rate_mu: float, num_docks_c: int):
    """
    Simula um sistema de pátio M/M/c via Teoria das Filas.
    arrival_rate_lambda: Carretas chegando por hora (ex: 8 carretas/hora)
    service_rate_mu: Carretas descarregadas por doca por hora (ex: 1.5 carretas/hora/doca)
    num_docks_c: Número de docas em operação física (ex: 7 docas)
    """
    rho = arrival_rate_lambda / (num_docks_c * service_rate_mu)
    if rho >= 1.0:
        return {"error": "Sistema instável: a fila cresce indefinidamente. Aumente o número de docas."}

    # Cálculo da probabilidade de pátio vazio (P0)
    sum_terms = sum([( (arrival_rate_lambda / service_rate_mu) ** n ) / math.factorial(n) for n in range(num_docks_c)])
    c_term = ((arrival_rate_lambda / service_rate_mu) ** num_docks_c) / (math.factorial(num_docks_c) * (1.0 - rho))
    p0 = 1.0 / (sum_terms + c_term)

    # Número médio de carretas na fila (Lq)
    lq = (p0 * ((arrival_rate_lambda / service_rate_mu) ** num_docks_c) * rho) / (math.factorial(num_docks_c) * ((1.0 - rho) ** 2))
    
    # Tempo médio de espera na fila em horas (Wq) - Lei de Little
    wq = lq / arrival_rate_lambda
    
    # Tempo total de permanência no pátio (W = Wq + 1/mu)
    total_dwell_hours = wq + (1.0 / service_rate_mu)

    return {
        "taxa_utilizacao_docas_pct": round(rho * 100, 2),
        "caminhoes_medios_em_fila": round(lq, 2),
        "tempo_medio_espera_fila_horas": round(wq, 2),
        "tempo_total_permanencia_horas": round(total_dwell_hours, 2),
        "risco_estourar_tolerancia_5h": total_dwell_hours > 4.0 # Margem de alerta
    }

# Exemplo de simulação: CD de médio porte
resultado = calculate_mmc_queue(arrival_rate_lambda=10.0, service_rate_mu=1.8, num_docks_c=7)
print("Diagnóstico de Capacidade de Pátio:", resultado)

15. Perguntas Frequentes Avançadas (FAQ Técnico & Jurídico)

16. Checklist Estratégico de Implementação em 12 Ações para Diretorias de Logística