Ocorrências

A ocorrência registra um imprevisto do campo: chuva durante o serviço, pneu furado, problema no trator ou no implemento, funcionário que faltou. Ela explica por que uma ordem de serviço atrasou ou parou e fica guardada no histórico da OS.

No Produtor, você registra e consulta as ocorrências pela ordem de serviço: no detalhe da OS e na tela de execução. Não há item próprio de ocorrências no menu.

Cada ocorrência pode apontar o recurso que teve o problema, como o trator 03. Assim você enxerga, no cadastro do recurso, quantas vezes ele parou o serviço.

Antes de começar

Para registrar uma ocorrência, você deve:

Ter uma OS na situação Planejada, Em execução, Pausada ou Concluída. Em Rascunho e Cancelada a opção não aparece.
Ter a permissão de criar ocorrências, ou ser o responsável pela OS, ou estar entre os recursos da OS como pessoa vinculada ao seu usuário. Veja Permissões.

Número da ocorrência

Toda ocorrência recebe um número no formato OCO-00023.

A sequência é da conta, não da propriedade. Uma conta com três fazendas tem uma única série: a OCO-00024 vem depois da OCO-00023, mesmo que as duas sejam de fazendas diferentes.
Excluir uma ocorrência não libera o número. A série fica com um buraco, como acontece com as OS.
Editar a ocorrência não muda o número.

Sem internet, o app mostra um número provisório, em itálico e com o ícone de nuvem. Ao parar o dedo ou o mouse sobre ele, aparece a dica “Número provisório até sincronizar”. Depois da sincronização, o número definitivo substitui o provisório. Dois aparelhos sem conexão podem mostrar o mesmo número provisório por alguns minutos; depois do sync, cada ocorrência tem o seu.

Registrar uma ocorrência

Abra a OS.

Você pode registrar pelo detalhe da OS ou pela tela de execução:
- Na execução, toque em Registrar ocorrência. No celular, o botão fica acima de Pausar e Concluir. No computador, fica no cabeçalho, ao lado das ações da execução.
- No detalhe da OS, no celular, abra o botão de ações e escolha Registrar ocorrência. No computador, o botão fica no cabeçalho, junto das ações da OS.
- Na aba Ocorrências do detalhe, use o botão Registrar ocorrência do topo da aba.
Preencha os dados.

A propriedade e a ordem de serviço já vêm preenchidas e bloqueadas. Escolha o Tipo de ocorrência, confira a Data e hora e escreva a Descrição. Se o problema foi de um recurso específico, escolha-o em Recurso. Informe o Tempo perdido, se houver.
Toque em Salvar.

O app mostra “Ocorrência OCO-00023 registrada.” e volta para a tela de onde você veio. A ocorrência aparece na aba Ocorrências da OS na hora, sem recarregar.

Nota: registrar a ocorrência não pausa a execução. O cronômetro continua enquanto você preenche o formulário, como avisa a frase “O cronômetro continua enquanto você registra a ocorrência.” Se o imprevisto parou o serviço, pause a OS pelo botão Pausar.

Campos da ocorrência

Campo	Descrição
Propriedade	A propriedade da OS. Vem preenchida e bloqueada, com a dica “Definida pela ordem de serviço.”
Ordem de serviço	A OS de onde você abriu o registro. Vem preenchida e bloqueada.
Tipo de ocorrência	Obrigatório. A classificação do imprevisto, como Pneu furado ou Clima. Só aparecem os tipos ativos. Veja Tipos de ocorrência.
Tipo de serviço	O tipo de serviço da OS. Preenchido automaticamente e não editável.
Recurso	Opcional. O recurso que teve o problema, entre os recursos já definidos na OS (pessoas, máquinas, insumos e serviços). Escolha Nenhum (a OS inteira) quando o imprevisto atinge o serviço todo, como a chuva.
Tipo de recurso	Com um Recurso escolhido, é o tipo dele, preenchido e bloqueado. Sem recurso, é opcional e mostra os tipos de recurso da OS. Use quando o problema é do tipo e não de alguém em particular, como “faltaram operadores” numa linha ainda sem pessoa definida.
Data e hora	Obrigatória. Vem com o momento atual. Pode ser recuada, mas não pode ser futura.
Tempo perdido	Opcional. Quanto tempo o imprevisto tomou, em horas e minutos (`hh:mm`, por exemplo `01:30`). Um número sozinho vale como minutos: `90` é o mesmo que `01:30`.
Descrição	Obrigatória. O que aconteceu, com as palavras de quem estava lá.

Os campos Tipo de serviço, Recurso e Tipo de recurso aparecem no bloco Relacionado à OS. Eles alimentam as abas de ocorrências do recurso, do tipo de recurso e do tipo de serviço.

Dica: aponte o recurso sempre que o problema for de uma máquina ou de uma pessoa. É isso que permite, mais tarde, comparar quantas vezes cada trator parou.

Tempo perdido é informativo

O tempo perdido aparece na ocorrência e somado na aba Ocorrências da OS. Ele não desconta o tempo efetivo da execução e não entra no custo da OS. Para tirar do tempo efetivo o período em que o serviço ficou parado, pause a OS durante o imprevisto.

Sem internet

A ocorrência é gravada no aparelho e sobe na próxima sincronização, como as OS. Registrar, editar e excluir funcionam sem conexão. Até sincronizar, o número fica provisório (veja Número da ocorrência).

Consultar as ocorrências da OS

O detalhe da OS tem a aba Ocorrências, entre Mapa e Histórico. Quando há ocorrências, a aba mostra a quantidade: Ocorrências (3).

No topo da aba ficam três números:

Indicador	O que mostra
Ocorrências	Quantas ocorrências a OS tem.
Tempo perdido total	A soma do tempo perdido de todas elas, no formato `1h30`.
Última ocorrência	O número e o tipo da mais recente, como `OCO-00023 · Pneu furado`.

Logo abaixo fica o botão Registrar ocorrência, para quem pode registrar. Em seguida vêm os cartões, da ocorrência mais recente para a mais antiga. Sem nenhum registro, a aba mostra “Nenhuma ocorrência registrada nesta OS.”

Cartão da ocorrência

O mesmo cartão aparece na aba da OS e nas abas do recurso, do tipo de recurso e do tipo de serviço. Ele tem cinco linhas:

Linha	Conteúdo
1	Número e data e hora, como `OCO-00023 · 06/10/2026 14:32`. No celular, a data vem relativa: “Hoje, 14:32” ou “Ontem, 07:20”.
2	Tipo de ocorrência, em destaque.
3	Descrição, em até duas linhas. O que passar disso termina em reticências.
4	Quem registrou. Nas abas do recurso, do tipo de recurso e do tipo de serviço, vem também a propriedade: `Ana Ribeiro · Fazenda Modelo`.
5	Número da OS e tempo perdido, como `OS-00418 · 1h30`. Sem tempo perdido, só a OS.

Toque no cartão para abrir a ocorrência.

Editar e excluir

Ao abrir uma ocorrência, o título é o número dela, e logo abaixo aparece quem a registrou e quando: “Registrada por Ana Ribeiro em 06/10/2026 14:32”.

Quem registrou pode editar e excluir a própria ocorrência, mesmo sem as permissões de editar e excluir.
A ocorrência de outra pessoa só pode ser editada ou excluída com a permissão correspondente. Sem ela, a ocorrência abre somente para leitura, sem o botão Salvar.

Para excluir, abra a ocorrência e toque em ⋮ → Excluir, no celular, ou no botão Excluir, no computador. O app pede confirmação: “Excluir a ocorrência OCO-00023 (Pneu furado, 06/10/2026 14:32)?”. A exclusão é definitiva.

Importante: na edição, os campos Propriedade e Ordem de serviço ficam liberados. Se você trocar a OS e o recurso ou o tipo de recurso escolhido não estiver na nova OS, o app pergunta “Trocar a OS?” antes de limpar esses campos. Não deixe a ordem de serviço em branco: no Produtor, a ocorrência sem OS não aparece em nenhuma aba e fica fora do seu alcance.

Ocorrências no recurso, no tipo de recurso e no tipo de serviço

O detalhe de um recurso, de um tipo de recurso e de um tipo de serviço tem a aba Ocorrências, antes de Histórico. Ela responde perguntas como “este trator dá mais problema que os outros?” sem sair da tela.

Tela	Ocorrências mostradas
Recurso	As que apontaram aquele recurso.
Tipo de recurso	As que apontaram o tipo, com ou sem um recurso escolhido. Uma ocorrência do “Trator 03” entra na aba do tipo “Trator 75-110 cv”.
Tipo de serviço	As das OS daquele tipo de serviço.

A aba reúne todas as propriedades da conta que você acessa, e não só a propriedade selecionada. Por isso cada cartão traz o nome da propriedade, e a aba não muda quando você troca de propriedade. Um trator que trabalha em duas fazendas tem um histórico só.

No topo da aba ficam:

O período: Últimos 30 dias, Últimos 12 meses (o padrão) ou Tudo.
Três números do período: Ocorrências, Tempo perdido total e Tipo mais frequente, com o nome e a quantidade, como Pneu furado (4).

Abaixo vêm os cartões, da ocorrência mais recente para a mais antiga. Toque num cartão para abrir a ocorrência.

Observação: o número no nome da aba, como Ocorrências (5), conta todo o histórico. Os números do topo contam só o período escolhido.

Estas abas não têm o botão Registrar ocorrência. A ocorrência com recurso nasce da OS, que é onde se sabe qual recurso estava em uso.

A aba só aparece para quem tem a permissão de listar ocorrências.

Tipos de ocorrência

O tipo de ocorrência classifica o imprevisto. Toda conta já vem com sete tipos:

Clima
Falta de funcionário
Problema na máquina
Problema no implemento
Pneu furado
Acidente
Outros

Os tipos são da conta inteira, e servem a todas as propriedades. No Produtor, a lista de tipos ainda não tem tela de cadastro: você escolhe entre os tipos existentes ao registrar a ocorrência.

Um tipo inativo não aparece em novas ocorrências. Na ocorrência que já o usa, ele continua aparecendo, marcado como “(inativo)”, para que editar a ocorrência não apague o valor.

Notificações

Quando uma ocorrência é registrada, recebem um aviso:

O responsável pela OS e o gestor que criou a OS.
Os usuários da conta com perfil administrador ou com a permissão de editar ocorrências, desde que tenham acesso à propriedade da ocorrência.

Quem registrou não recebe o próprio aviso, e ninguém recebe o mesmo aviso duas vezes.

O aviso tem o título Nova ocorrência OCO-00023 e um texto como “Pneu furado na OS-00042 (Fazenda Modelo), registrada por Ana Ribeiro.” Ele aparece na tela de Notificações.

Só o registro gera aviso. Editar ou excluir uma ocorrência não notifica ninguém. Uma ocorrência registrada sem internet gera o aviso quando sobe na sincronização.

Permissões

As permissões ficam em Perfis de usuário, nos grupos Ocorrências e Tipos de ocorrência. Os perfis de administrador já vêm com todas.

Permissão	O que libera
Ocorrências: Listar	Ver a aba Ocorrências na OS e nos detalhes de recurso, tipo de recurso e tipo de serviço.
Ocorrências: Exibir	Abrir as ocorrências registradas por outras pessoas. Pelas abas, quem vê o cartão já consegue abrir a ocorrência para leitura.
Ocorrências: Criar	Registrar ocorrência em qualquer OS da propriedade.
Ocorrências: Editar	Editar a ocorrência registrada por outra pessoa. Quem tem esta permissão também recebe o aviso de cada nova ocorrência.
Ocorrências: Excluir	Excluir a ocorrência registrada por outra pessoa.
Tipos de ocorrência: Gerenciar	Reservada ao cadastro de tipos de ocorrência, que ainda não tem tela no Produtor.

Dica: na tela do perfil, marcar Criar, Editar ou Excluir marca também Listar e Exibir.

Além das permissões do perfil, valem três regras:

Quem registrou abre, edita e exclui a própria ocorrência sem precisar de permissão.
O responsável pela OS e quem está entre os recursos da OS (a pessoa vinculada ao seu usuário) registram ocorrência naquela OS e veem a aba Ocorrências dela, mesmo sem as permissões de criar e listar. É a mesma regra de Minhas ordens de serviço.
A ocorrência que você não pode editar abre somente para leitura.

Erros comuns

“Escolha o tipo de ocorrência.”

Causa provável: o campo Tipo de ocorrência ficou vazio.
Como resolver: escolha um tipo da lista e salve de novo.

“Descreva a ocorrência ou grave um áudio.”

Causa provável: a descrição ficou em branco.
Como resolver: escreva o que aconteceu no campo Descrição.

“A data e hora não podem ser futuras.”

Causa provável: a data e a hora escolhidas passam do momento atual.
Como resolver: ajuste para o momento em que o imprevisto aconteceu. Se o horário estiver certo, confira o relógio do aparelho.

“Informe o tempo em hh:mm.”

Causa provável: o Tempo perdido não está no formato de horas e minutos, ou os minutos passam de 59.
Como resolver: digite como 01:30, ou só os minutos, como 90.

O botão Registrar ocorrência não aparece

Causa provável: a OS está em Rascunho ou Cancelada, ou você não tem a permissão de criar ocorrências e não é responsável nem recurso da OS.
Como resolver: planeje a OS antes de registrar, ou peça ao administrador a permissão de criar ocorrências.