Inclusão de evento

Esta é a tela em que você registra o que aconteceu com o marítimo num determinado dia: embarque, desembarque, hotel, ASO, curso, troca de centro de custo ou outros eventos do RM. É a parte central do dia a dia de quem tem o perfil de edição.

Como abrir o modal

A inclusão começa sempre por uma célula do calendário. Para que o botão "+" apareça na célula, três condições precisam ser atendidas ao mesmo tempo:

1. Perfil de edição — você precisa pertencer ao grupo controle_maritimo_edit (ver Acesso e permissões).
2. Período aberto — precisa existir um período de contabilização aberto para edição (ver Administração de períodos). Sem período aberto, o "+" não aparece e o banner no topo fica amarelo.
3. Ação possível para aquela data/status — a célula precisa ter pelo menos uma ação aplicável. Dias de Férias e Afastamento (importados do RM) não abrem ações; datas futuras só aceitam observação.

Ao clicar no "+", abre-se o modal "Incluir evento — Nome do marítimo (data)".

A ação determina o formulário

O primeiro campo do modal é a lista Ação. As ações oferecidas dependem do contexto da célula (data e status), seguindo esta precedência: data futura → mês anterior ao período aberto → status atual da célula.

Contexto da célula	Ações disponíveis
Data futura (depois de hoje)	apenas Observação
Data anterior ao período aberto (lançamento de "meses anteriores")	ASO, Curso, Geral
Status Disponível (passado/hoje)	Hotel, Embarque, ASO, Curso, Geral
Status Folga (passado/hoje)	Embarque (gera dobra), Curso
Status Embarcado / Dobra / Hotel (passado/hoje)	Desembarque, Troca de Centro de Custo, Curso
Status Férias / Afastamento	nenhuma — a célula informa "Não há ações disponíveis para este dia"

Depois de escolher a ação, o formulário mostra apenas os campos daquela ação. A Observação é um campo de texto livre e aparece em todas as ações.

Ação	Campos específicos	Impacto na folha
Hotel	(só observação)	conta como 1º dia de embarque
Embarque	Porto de Embarque, Centro de Custo, Quantidade de dias de embarque	calcula a previsão de folga
Desembarque	Horário do desembarque	só gera folha em critério de dobra
Troca de Centro de Custo	Centro de Custo	não gera folha
Curso	(só observação)	sempre gera folha (inclusive "curso em folga")
ASO	"Gerar folha de pagamento" (sim/não)	opcional
Geral	Evento de folha (RM); "Gerar folha"; Valor (quando o evento exigir)	conforme o evento
Observação (data futura)	(só observação)	—

No rodapé do modal ficam Cancelar e Salvar. Ao salvar com sucesso, aparece o toast "Evento incluído com sucesso." e o calendário é recarregado.

---

Exemplo — Embarque

Numa célula com status Disponível (data passada ou hoje), escolha a ação Embarque:

1. Porto de Embarque — campo de zoom (consulta ds_porto_rm); selecione o porto.
2. Centro de Custo — campo de zoom (ds_centro_custo_rm); selecione o centro de custo do embarque.
3. Quantidade de dias de embarque — número inteiro, mínimo 1.
4. Observação — opcional.
5. Salvar.

O sistema grava o status Embarcado e usa a quantidade de dias para calcular a previsão de folga (ver as regras do ciclo 42+42 no Glossário).

:::tip Embarque a partir de uma Folga Quando a célula está em Folga, a ação Embarque continua disponível — é assim que se registra um reembarque (que pode gerar dobra ou folga indenizada, conforme a regra Sindimar). :::

Exemplo — Desembarque

Numa célula Embarcado / Dobra / Hotel, escolha a ação Desembarque:

1. Horário do desembarque — no formato HH:mm.
2. Observação — opcional.
3. Salvar.

O horário define como o dia é contabilizado, conforme o aviso exibido no próprio campo:

• Até 18:00 → o dia já conta como 1º dia de folga.
• A partir de 18:01 → o dia ainda conta como embarcado (e folga começa no dia seguinte).

Exemplo — Geral com Valor

A ação Geral cobre os demais eventos de folha do RM (prêmio, falta, suspensão, ajuda de custo, etc.):

1. Evento de folha (RM) — campo de zoom (ds_evento_rm_query). A lista já exclui os eventos que têm tratamento próprio no sistema (dobras, folgas indenizadas e lançamentos de meses anteriores).
2. Valor — este campo só aparece quando o evento selecionado exige um valor: Prêmio (328), Diária de viagem exterior (366), Prêmio inspeção (422) e Gratificação especial (539). Para os demais eventos, o campo não é mostrado.
3. Gerar folha de pagamento — caixa de seleção opcional.
4. Observação — opcional.
5. Salvar.

Exemplo — ASO, Curso ou Geral em meses anteriores

Quando a célula está num mês anterior ao período aberto (lançamento de "meses anteriores"), independentemente do status, as únicas ações são ASO, Curso e Geral:

• ASO — exibe a opção "Gerar folha de pagamento" (você escolhe se o atestado gera ou não evento de folha).
• Curso — exibe o aviso "O curso gera impacto na folha de pagamento." (o curso sempre gera folha, inclusive quando o marítimo está em folga/disponível).
• Geral — igual ao exemplo acima (evento do RM + Valor quando aplicável).

Mensagens de erro

A validação acontece ao clicar em Salvar. As mensagens aparecem em vermelho dentro do próprio modal:

Situação	Mensagem
Embarque sem quantidade de dias	"Informe a quantidade de dias de embarque."
Quantidade de dias menor que 1	"A quantidade de dias deve ser ao menos 1."
Desembarque sem horário válido	"Informe o horário do desembarque (HH:mm)."
Geral com evento que exige Valor, sem valor	"Informe o valor para este evento."
Usuário sem matrícula identificada	"Usuário não identificado (matrícula ausente)."

Quando o servidor recusa a gravação (regra de negócio ou indisponibilidade), o modal exibe a mensagem devolvida pelo serviço e mostra um toast vermelho; o evento não é gravado e você pode corrigir e tentar de novo.

:::note Sem período aberto Se não houver período aberto, o botão "+" nem aparece na célula — a inclusão fica indisponível até que um período seja aberto na Administração de períodos. :::

Próximos passos

• Para conferir o que foi gravado numa célula, veja Detalhe da célula e Férias/Afastamento.
• Para entender o cálculo (ciclo 42+42, dobra, folga indenizada), veja o Glossário de status e regras.