Pátio (YMS — Yard Management System)

O módulo de pátio gerencia tudo o que acontece dentro do CD/terminal: agendamentos de chegada, portaria (gate-in/out), ocupação de docas e tempo de permanência (dwell time). Funciona tanto para embarcadores quanto para transportadoras.

Conceitos

• Yard (pátio) — local físico (CD, fábrica, terminal).
• Doca — posição de carga/descarga. Tipo: carga, descarga ou ambos.
• Agendamento — janela reservada de um veículo numa doca. Pode ou não estar ligado a um frete.
• Visita — ciclo gate-in → operação → gate-out. Mede o dwell time.

Fluxo padrão

1. Cadastre seu pátio em /yms/yards e crie suas docas.
2. Crie agendamentos no calendário /yms/agenda. Vincule a um frete existente ou deixe walk-in.
3. Compartilhe o link de check-in (QR) com o motorista.
4. Na chegada, motorista faz check-in pelo QR ou portaria registra manualmente em /yms/portaria.
5. Operador atribui doca e ao final faz gate-out.

Walk-in

Veículos sem agendamento podem ser registrados direto na portaria via "Check-in walk-in". Útil para devoluções, visitas técnicas ou contingências.

Webhooks

O YMS dispara estes eventos no outbox:

• yard.appointment.created
• yard.appointment.status_changed
• yard.gate.checked_in
• yard.dock.operation.completed
• yard.visit.completed (com dwell_seconds)

Integração com frete

Quando uma visita vinculada a um frete é concluída via gate-out (descarga), o frete é automaticamente marcado como entregue.