Códigos de erro completos

Este artigo é a referência dos códigos de erro que podem aparecer na aplicação móvel ou no backoffice do CheckBiz360. Quando o sistema mostra uma mensagem de erro, o código que a acompanha permite identificar a causa exata e a ação corretiva.

Artigo 100 de 11615 min de leituraAtualizado a 22 out 2026

Os códigos seguem sempre o formato módulo/motivo. Em seguida agrupam-se por módulo.

Registo e jornada (checklog)

Os erros mais frequentes na utilização diária. Salvo indicação em contrário, são vistos pelo funcionário na aplicação.

Código	O que significa	O que fazer
`checklog/out_of_radius`	O funcionário não está dentro do raio de registo da sucursal selecionada	Verificar que está fisicamente no local de trabalho e que o GPS tem boa precisão. Se se repetir, rever coordenadas e raio da sucursal
`checklog/out_of_schedule`	O registo cai fora do horário do turno atribuído	Rever o horário efetivo e o fuso horário da sucursal, e o turno atribuído ao funcionário
`checklog/day_disabled`	O dia está desativado no calendário efetivo (feriado, dia livre do funcionário ou dia não útil)	Se o dia devia ser útil, corrigir o calendário. Caso contrário, registar as horas através de jornada manual
`checklog/absence`	O funcionário tem registada uma ausência que abrange esse dia	Se a ausência não estiver correta, retirá-la do seu calendário e voltar a registar
`checklog/different_branches`	Tenta-se registar a pausa ou a saída numa sucursal diferente da da entrada	Registar na sucursal da entrada; se houve mudança de local, fechar a jornada e abrir outra
`checklog_update/future_not_allowed`	A correção proposta tem data ou hora futura	Indicar uma hora que já tenha passado
`checklog/calendar_not_resolved`	Não há calendário efetivo resolvido para essa data	Rever o calendário da entidade, da sucursal e do funcionário para essa data. Entretanto, introduzir as horas manualmente
`checklog/branch_geo_required`	A sucursal não tem localização configurada	O Owner ou Manager deve acrescentar as coordenadas da sucursal no backoffice
`checklog/two_type_followed`	Tentou-se iniciar a jornada duas vezes seguidas	Fechar a jornada aberta antes de iniciar uma nova
`checklog/overlap_detected`	Já existe uma jornada válida que se sobrepõe a esse horário	Rever o histórico do funcionário e corrigir o registo sobreposto antes de tentar de novo
`checklog/duplicate_pending`	Já há um pedido pendente para esse funcionário nessa data	Aguardar que o responsável resolva o pedido existente em vez de criar outro
`checklog/checkin_not_found`	Não se encontra a entrada de referência para a operação	Verificar que existe o registo de entrada ao qual se pretende associar a saída
`checklog/checkin_not_open`	A entrada não pode ser fechada manualmente devido ao seu estado atual	Rever o estado do registo; se já estiver fechado ou anulado, não admite fecho manual
`checklog/checkout_already_exists`	Já existe um fecho pendente ou válido para essa entrada	Rever o registo: a jornada já tem saída
`checklog/invalid_checki`	Registo de entrada inválido	Tentar de novo o registo. Se persistir, atualizar a aplicação
`checklog/invalid_checkout`	Registo de saída inválido	Verificar que há uma entrada aberta para fechar
`checklog/invalid_restin` / `checklog/invalid_restout`	Início ou fim de pausa inválido	Verificar a ordem dos registos: a pausa deve abrir-se e fechar-se dentro de uma jornada ativa
`checklog/unknown_type`	Tipo de registo desconhecido	Atualizar a aplicação para a última versão
`checklog/invalid`	Não se encontra o registo relacionado	Atualizar o ecrã e tentar de novo
`checklog/bad_request`	Os dados do registo não estão corretos ou estão incompletos	Atualizar a aplicação; se continuar, reinstalar e iniciar sessão de novo
`checklog/internal_error`	Erro interno do servidor ao processar o registo	Tentar de novo passados alguns minutos. Se durar mais de 30 minutos, abrir incidência com a hora exata e o funcionário afetado

Acesso e sessão (auth)

Código	O que significa	O que fazer
`auth/invalid-credential`	Credenciais incorretas	Rever correio e palavra-passe; usar a recuperação de palavra-passe se necessário
`auth/invalid-email`	O endereço de correio não tem um formato válido	Corrigir o correio introduzido
`auth/missing-email` / `auth/missing-password`	Falta o correio ou a palavra-passe	Preencher o campo em falta
`auth/email-already-exists` / `auth/email-already-in-use`	Esse correio já está em uso	Iniciar sessão com essa conta ou usar outro correio
`auth/weak-password`	A palavra-passe não cumpre os requisitos mínimos	Escolher uma palavra-passe mais segura
`auth/too-many-requests`	Demasiadas tentativas em pouco tempo	Aguardar alguns minutos antes de tentar de novo
`auth/user-disabled`	A conta está desativada	Contactar o Owner da entidade ou o apoio
`auth/operation-not-allowed`	O acesso por correio e palavra-passe não está ativado	Contactar o apoio
`auth/network-request-failed`	Erro de rede	Verificar a ligação à internet e tentar de novo
`auth/unauthorized`	Acesso não autorizado ao recurso, ou sessão caducada	Terminar sessão e voltar a entrar. Se a conta foi desativada, contactar o Owner
`auth/untrusted_device`	O dispositivo não está autorizado e exige verificação adicional	O Owner ou Manager deve autorizar o dispositivo a partir do perfil do funcionário
`employee/invalid_token`	A validação do funcionário caducou ou não é válida. Caduca ao fim de 30 dias, tal como a sessão do funcionário na aplicação	A aplicação volta a iniciar sessão por si só. Se o aviso persistir, terminar sessão na aplicação e entrar de novo
`turnstile/failed`	Não foi possível confirmar que quem se regista ou recupera a palavra-passe é uma pessoa	Recarregar a página e repetir o desafio de verificação

Verificação em dois passos (twofactor)

Código	O que significa	O que fazer
`twofactor/invalid_code`	O código TOTP introduzido não é válido	Verificar que a hora do dispositivo está correta e gerar um código novo
`twofactor/invalid_token`	A sessão expirou	Voltar a iniciar sessão
`twofactor/not_activated`	O funcionário não tem a verificação em dois passos ativada	Ativá-la a partir do perfil do funcionário
`twofactor/user_not_activated`	A conta de utilizador não tem 2FA ativada	Ativar a 2FA a partir do perfil de utilizador
`twofactor/unauthorized`	A operação exige um token 2FA	Completar a verificação em dois passos para continuar
`twofactor/internal`	Erro interno ao processar a verificação	Tentar de novo; se persistir, abrir incidência

Funcionários (employee) e sucursais (branch)

Código	O que significa	O que fazer
`employee/not_found`	O funcionário indicado não existe na entidade	Verificar que o funcionário continua registado
`employee/exist_employee`	Já existe um funcionário com esse correio ou telefone	Procurar o funcionário existente em vez de criar um novo
`employee/branchId_required`	Falta a sucursal, que é obrigatória	Atribuir pelo menos uma sucursal antes de guardar
`employee/bad_request`	Falta o identificador do funcionário na operação	Repetir a ação a partir da ficha do funcionário
`branch/not_found`	A sucursal indicada não existe	Verificar que a sucursal existe e não foi eliminada
`employee/fired`	O funcionário saiu da empresa e não pode ser adicionado a uma equipa	Escolher outra pessoa ou reativar a sua ficha
`team/not_found`	A equipa já não existe	Atualizar a lista de equipas
`team/name_taken`	Já existe uma equipa com esse nome (ignorando maiúsculas, acentos e espaços)	Escolher outro nome
`team/member_exists`	Essa pessoa já está na equipa	Editar a sua função ou o seu valor em vez de a adicionar outra vez
`team/member_not_found`	Essa pessoa já não está na equipa	Atualizar a ficha da equipa
`team/branch_without_staff`	A sucursal não tem ninguém ativo para guardar como equipa	Adicionar pessoal à sucursal ou criar a equipa do zero
`team/apply_conflict`	Alguém adicionou um dos membros a essa sucursal enquanto a equipa era aplicada; não se alterou nada	Voltar a aplicar a equipa: essa pessoa será ignorada
`team/too_large`	São demasiadas pessoas para uma só operação	Dividir a equipa em duas e aplicá-las em separado
`team/bad_request`	Os dados da equipa não são válidos	Rever o nome, a função e que o valor seja um número

Documentos (documents)

Código	O que significa	O que fazer
`documents/unauthorized`	Sem permissões para aceder ao documento	Rever a visibilidade por perfil do documento
`documents/storage_full`	A empresa chegou aos 2 GB incluídos e tem a ampliação de armazenamento desativada	Ativar Ampliar armazenamento em Entidade → Subscrições, ou libertar espaço
`documents/not_found`	O documento não existe ou não é visível para esse utilizador	Verificar que não está arquivado e que o perfil tem visibilidade
`documents/file_required`	Não foi anexado qualquer ficheiro	Anexar o ficheiro antes de guardar
`documents/file_too_large`	O ficheiro ultrapassa o máximo permitido de 10 MB	Comprimir o documento ou dividi-lo
`documents/invalid_mime_type`	Formato de ficheiro não permitido	Converter o documento para um formato admitido
`documents/invalid_visibility_roles`	A configuração de visibilidade não é válida	Rever os perfis selecionados
`documents/invalid_acknowledgement_mode`	A configuração de confirmação de leitura não é válida	Rever o modo de confirmação escolhido face ao âmbito do documento
`documents/acknowledgement_not_required`	O documento não exige confirmação de leitura	Não é necessária qualquer ação
`documents/acknowledgement_not_allowed`	Esse utilizador não pode confirmar a leitura do documento	Verificar que o documento se dirige a esse funcionário
`documents/restricted_document_type`	Sem permissões para esse tipo de documento	Rever o perfil necessário para esse tipo
`documents/already_archived`	O documento já está arquivado	Não é necessária qualquer ação
`documents/branch_not_found`	A sucursal ou projeto indicado não é válido	Selecionar uma sucursal existente
`documents/employee_not_found`	O funcionário indicado não é válido	Selecionar um funcionário existente
`documents/employee_not_in_branch`	O funcionário não pertence à sucursal selecionada	Corrigir a sucursal ou a atribuição do funcionário
`documents/bad_request`	Os dados do documento não são válidos	Rever os campos obrigatórios do formulário

Tarefas (task)

Código	O que significa	O que fazer
`task/not_found`	A tarefa não existe ou foi eliminada	Atualizar a listagem de tarefas
`task/evidence_required`	A tarefa exige carregar evidência antes de a concluir	Anexar pelo menos uma foto ou vídeo e voltar a concluir
`task/forbidden`	Sem permissões para essa ação sobre a tarefa	Rever o nível de responsabilidade exigido
`task/unauthorized`	Sem permissões para realizar a ação	Solicitar a ação a um responsável com nível suficiente
`task/invalid_mime_type`	O formato do ficheiro anexado não é permitido	Carregar a evidência como foto ou vídeo num formato padrão
`task/file_too_large`	O ficheiro ultrapassa o tamanho máximo permitido	Reduzir a resolução ou a duração do ficheiro
`task/bad_request`	A informação da tarefa não é válida	Rever os campos obrigatórios: título, sucursal e prazo
`task/no_open_session`	Para iniciar, retomar ou concluir a tarefa é preciso ter a jornada aberta	Registar a entrada e voltar a tentar
`task/geo_required`	A tarefa tem local de trabalho próprio e é precisa a localização; o backoffice não a envia	Iniciar, retomar ou concluir a tarefa a partir da aplicação, estando no local
`task/out_of_worksite`	O funcionário está fora da margem do local de trabalho da tarefa. O aviso indica a distância e a margem	Aproximar-se da morada da tarefa. Se a margem for demasiado estreita para esse local, alargá-la na tarefa
`task/worksite_imprecise`	A morada do local de trabalho só foi localizada de forma aproximada (por exemplo, ao nível da cidade)	Acrescentar o número da porta e voltar a escolher a morada na pesquisa
`task/worksite_invalid`	Não foi possível situar a morada no mapa	Escolher a morada na pesquisa em vez de a escrever à mão
`task/not_in_progress`	Só se pode pausar uma tarefa em curso	Iniciar a tarefa antes de a pausar
`task/already_paused`	A tarefa já está em pausa; é possível que outro atribuído a tenha pausado antes	Atualizar a tarefa
`task/not_paused`	Tentou-se retomar uma tarefa que não está em pausa	Atualizar a tarefa
`task/invalid_transition`	A mudança de estado não é permitida a partir do estado atual; por exemplo, concluir uma tarefa recusada	Reabrir a tarefa devolvendo-a a Atribuída a partir de Editar
`task/invalid_status`	A ação exige outro estado; por exemplo, validar uma tarefa que não está concluída	Rever o estado da tarefa
`task/invalid_employees`	Algum funcionário não pode ser atribuído: não trabalha na sucursal da tarefa ou não está ativo	Atribuí-lo a essa sucursal e confirmar que está ativo
`task/branch_inactive`	A sucursal da tarefa está inativa e não admite tarefas novas nem cópias	Ativar a sucursal ou usar outra
`task/source_config_invalid`	A tarefa que se tenta duplicar tem uma configuração que já não é válida	Abrir a tarefa original, guardá-la de novo e voltar a duplicá-la

Subscrição e faturação

Código	O que significa	O que fazer
`subscription/limit_off`	O plano atingiu o limite de operações permitidas	Rever o estado da subscrição ou contactar o apoio
`suscription/entity_not_configured`	A entidade não tem a configuração necessária para contratar	Completar os dados legais e o método de pagamento em Entidade
`suscription_checkinbiz/entity_legal_not_configured`	Faltam os dados legais da entidade para o CheckBiz	Completar os dados da empresa antes de contratar
`suscription/already_subscribed_into_plan`	A entidade já está subscrita a esse plano	Não é necessária qualquer ação
`suscription/ko`	A subscrição não pôde ser concluída	Rever o método de pagamento e tentar de novo
`subscribe/not_found`	O serviço indicado não existe	Tentar de novo a partir do ecrã de planos
`subscribe/invalid_entity_service`	A entidade ou o serviço não estão corretos	Verificar a entidade selecionada
`subscribe/internal`	Erro interno do serviço de subscrições	Tentar mais tarde; se persistir, abrir incidência
`subscribe/plan_not_available`	O plano escolhido não está disponível para contratar	Escolher outro dos planos que o ecrã de planos oferece
`sub/bad_request`	Os dados enviados não são válidos	Rever o formulário e tentar de novo
`sub/entity_not_found`	A entidade não existe	Verificar a entidade selecionada
`payment/pending`	Há pagamentos pendentes na conta	Regularizar o pagamento a partir da secção de faturação

Férias e licenças (absence_request)

Pedidos a partir da aplicação, «O meu calendário» (aprovam os administradores no painel, Contacto → Pedidos).

Código	Causa
`absence_request/invalid_type`	O tipo não é `vacation`, `personal`, `medical` nem `other`.
`absence_request/invalid_dates`	Datas não válidas ou fim anterior ao início.
`absence_request/past`	O pedido começa antes de hoje. O passado é registado pela empresa a partir do painel.
`absence_request/too_long`	Mais de 60 dias num só pedido.
`absence_request/note_too_long`	A nota ultrapassa os 500 caracteres.
`absence_request/overlap`	Sobrepõe-se a outro pedido pendente ou aprovado, ou a uma ausência já registada.
`absence_request/not_found`	O pedido não existe ou não é desta pessoa.
`absence_request/not_pending`	Já foi decidido ou cancelado: não se pode cancelar, aprovar nem recusar.
`calendar/forbidden`	A conta não tem ficha de funcionário ativa (rotas da pessoa) ou não tem lugar de administrador (rotas do painel).

Escala de turnos (calendar)

Ao carregar turnos por data a quem está Por turnos.

Código	O que significa	O que fazer
`calendar/days_require_calendar_mode`	A pessoa não está Por turnos: está em Semana tipo ou Por tarefas	Passá-la para Por turnos na sua ficha ou na da sua sucursal
`calendar/day_in_the_past`	Tentou-se alterar um dia anterior a hoje	Os dias passados não se alteram; o de hoje sim
`calendar/bad_request`	Um turno não é válido: a saída não é posterior à entrada, dois turnos cruzam-se ou a data está demasiado longe	Rever as horas do dia indicado
`calendar/invalid_range` / `calendar/range_too_long`	O período pedido não é válido ou é demasiado longo	Consultar um período mais curto
`calendar/schedule_mode_employee_only`	Por tarefas só se escolhe na ficha de uma pessoa	Defini-lo na pessoa, não na sucursal nem na empresa

Ponto de registo (kiosk)

Código	O que significa	O que fazer
`kiosk/not_subscribed`	A empresa não tem o ponto de registo contratado	Contratá-lo a partir de Ponto de registo
`kiosk/disabled`	O ponto de registo dessa sucursal está desativado	Ativá-lo a partir do painel
`kiosk/no_branch_geo`	A sucursal não tem a morada geolocalizada	Completar a morada da sucursal
`kiosk/no_branch_kiosk`	A pessoa não tem nenhuma sucursal com ponto de registo, por isso não há cartão para lhe enviar	Ativar o ponto de registo numa das suas sucursais
`kiosk/device_not_eligible`	O dispositivo não cumpre os requisitos: localização, precisão, câmara frontal ou sistema	Ler o motivo no ecrã e corrigi-lo, ou usar outro dispositivo
`kiosk/out_of_radius`	O dispositivo está mais longe do local do que o permitido	Levá-lo para o local, rever a morada ou alargar o raio
`kiosk/suspended`	O ponto de registo está em pausa porque o dispositivo saiu do raio ou perdeu precisão	Volta sozinho quando voltar a cumprir
`kiosk/replaced`	Entrou-se com as mesmas credenciais noutro dispositivo	Normal ao trocar de tablet; caso contrário, regenerar as credenciais
`kiosk/revoked`	A sessão do dispositivo foi terminada a partir do painel	Voltar a entrar com as credenciais
`kiosk/code_not_found`	O QR ou o código não é de ninguém nesta empresa, ou foi regenerado	Entregar o cartão ou o código atuais
`kiosk/too_many_attempts`	Vários códigos errados seguidos	Aguardar os segundos que o ecrã indica
`kiosk/employee_not_in_branch`	A pessoa não está atribuída a essa sucursal	Atribuí-la a partir da sua ficha
`kiosk/session_expired`	Passou demasiado tempo entre identificar-se e registar	Voltar a aproximar o QR ou a escrever o código
`kiosk/photo_required` / `kiosk/photo_upload_failed`	Falta a foto, ou não foi possível guardá-la e o registo não foi feito	Repetir o registo olhando para a câmara
`kiosk/unlock_invalid`	O PIN para sair do modo quiosque não está correto	Consultar o PIN em Ver credenciais
`kiosk/invalid_radius`	O raio está fora do intervalo permitido	Escolher um valor dentro do intervalo que o painel indica

Outros módulos

Código	O que significa	O que fazer
`entity/not_found`	A entidade não existe	Verificar a entidade selecionada no backoffice
`user/not_found`	Não há qualquer utilizador com esse correio	Rever o correio introduzido
`user/internal`	Erro interno do serviço de utilizadores	Tentar de novo; se persistir, abrir incidência
`report/internal_error`	Erro interno ao gerar o relatório	Tentar de novo com um intervalo de datas menor; se persistir, abrir incidência
`stats/range_and_groupBy_tolong`	O intervalo de datas ou o agrupamento produzem demasiados dados para representar	Selecionar um intervalo menor ou outro agrupamento
`analyze/insufficient_data`	Não há dados suficientes para calcular os indicadores	Aguardar a acumulação de mais histórico de registos e tarefas
`media/not_found`	O ficheiro não existe	Voltar a carregar o ficheiro
`media/invalid_meda_type`	Tipo de ficheiro não permitido	Usar um formato admitido
`media/invalid_dimesions`	As dimensões da imagem não são válidas	Ajustar o tamanho da imagem
`media/error`	Erro interno de armazenamento	Tentar de novo; se persistir, abrir incidência
`internal`	Erro interno do servidor	Tentar de novo; se persistir, abrir incidência com a hora exata
`unavailable`	Serviço temporariamente indisponível	Tentar de novo passados alguns minutos

Nota de perfil

Este artigo é de consulta para Owner e Manager, responsáveis por diagnosticar e resolver erros operacionais. Os funcionários com perfil Worker que vejam um código de erro na aplicação devem comunicá-lo ao seu responsável com o código exato que aparece no ecrã.

Este artigo foi útil?