Códigos de Erro

Todos os erros dos endpoints /processo/* seguem o formato padrão do XJUR Connect:

{
  "codigo": "CODIGO_DO_ERRO",
  "descricao": "Descrição legível do que ocorreu.",
  "detalhes": "Mensagem original do Xjur, quando disponível."
}

Tabela de erros

HTTP	Código	Quando ocorre
400	DADOS_INVALIDOS	Payload inválido: campo obrigatório ausente, JSON malformado, item de catálogo inexistente ou inativo, número de processo ambíguo
401	NAO_AUTORIZADO	Token ausente, inválido ou expirado — ou o usuário não tem a permissão do módulo (veja os pré-requisitos)
404	NAO_ENCONTRADO	Processo, andamento, audiência, sentença ou pedido não encontrado para o usuário do token, ou catálogo inexistente
422	REGRA_NEGOCIO	O Xjur recusou a gravação por uma regra de negócio ou de configuração do cliente. descricao traz o motivo
502	ERRO_SERVICO_EXTERNO	O Xjur respondeu com erro interno ou está indisponível
504	TIMEOUT_SERVICO_EXTERNO	O Xjur não respondeu dentro do tempo limite

502 e 504 na criação

Depois de um 502 ou 504 em um POST não é possível saber se o registro foi criado. Repita a chamada com o mesmo codigo: se o registro já existir, ele é devolvido com 200 e jaExistia: true, sem duplicar.

Mensagens mais comuns

400 — Validação

Descrição	Como resolver
Informe processoId ou numeroProcesso.	Identifique o processo
Há mais de um processo com o número X (ids 1, 2). Informe processoId.	O cliente tem o mesmo número em mais de um processo; use o processoId
dataAndamento é obrigatório. / dataAudiencia é obrigatório. / dataSentenca é obrigatório.	Envie a data
tipoAndamentoId ou tipoAndamento é obrigatório.	Informe o tipo — veja GET /processo/catalogos/tipos-andamento
tipoAndamento "X" não encontrado. Consulte GET /processo/catalogos/tipos-andamento.	O nome precisa ser idêntico ao do catálogo (maiúsculas e acentos não importam); prefira o id
tipoAudienciaId 99 não encontrado ou inativo.	Use um id ativo do catálogo
Há mais de um item ativo chamado "X" em tipos-pedido. Informe tipoPedidoId.	Nome repetido no catálogo; use o id
camposPersonalizados[0] deve informar exatamente um valor (...)	Preencha só uma das propriedades de valor
valorCausa não pode ser negativo. / valorCondenacao não pode ser negativo.	Corrija o valor
Informe ao menos um campo para atualizar.	O PATCH veio vazio

404 — Não encontrado

Descrição	Causa
Processo 0009101-11.2026.8.26.0100 não encontrado.	O processo não existe no cliente, é restrito ou não pertence ao escritório do usuário
Audiência 10571 não encontrada. (idem andamento, sentença, pedido)	O id não existe ou é de um processo fora do alcance do usuário

422 — Regra de negócio do Xjur

Exemplo	Como resolver
Nenhum usuário responsável encontrado para a fase 'Análise da Decisão'. Verifique o responsável configurado na fase do fluxo.	Configuração do fluxo do cliente no Xjur. Acione o cliente ou a equipe Xjur; reenviar não resolve
Tipo de pedido não encontrado / Risco não encontrado	O id deixou de existir; consulte o catálogo novamente