Andamentos

Andamentos são as movimentações do processo — publicações, despachos, juntadas, certidões. Cada andamento enviado aparece na linha do tempo do processo no Xjur e pode disparar o fluxo de trabalho do cliente (por exemplo, criar uma tarefa para analisar uma publicação).

Registrar

POST /processo/andamentos HTTP/1.1
Authorization: Bearer <token>
X-XJUR-SUBSCRIPTION-KEY: <subscription-key>
Content-Type: application/json

{
  "numeroProcesso": "0009101-11.2026.8.26.0100",
  "tipoAndamento": "Juntada de Petição",
  "dataAndamento": "2026-09-29T10:15:00",
  "descricao": "Juntada da contestação pelo réu.",
  "codigo": "ESC-AND-889123"
}

Campo	Tipo	Obrigatório	Descrição
`processoId`	`integer`	Um dos dois	Id do processo no Xjur
`numeroProcesso`	`string`	Um dos dois	Número CNJ, com ou sem máscara
`tipoAndamentoId`	`integer`	Um dos dois	`GET /processo/catalogos/tipos-andamento`
`tipoAndamento`	`string`	Um dos dois	Nome exato do tipo
`dataAndamento`	`datetime`	Sim	Data do andamento no processo (não a data do envio)
`descricao`	`string`	Não	Texto do andamento
`restrito`	`boolean`	Não	Padrão `false`. Andamento restrito só é visto por quem tem esse acesso no Xjur
`codigo`	`string`	Recomendado	Id do andamento no seu sistema (até 100 caracteres). Chave de idempotência
`camposPersonalizados`	`array`	Não	Ver Campos personalizados

Resposta 201:

{
  "andamentoId": 30528166,
  "processoId": 748610,
  "tipoAndamentoId": 12,
  "tipoAndamento": "Juntada de Petição",
  "dataAndamento": "2026-09-29T10:15:00",
  "descricao": "Juntada da contestação pelo réu.",
  "restrito": false,
  "status": "Pendente",
  "codigo": "ESC-AND-889123",
  "dataCadastro": "2026-09-29T10:16:02",
  "jaExistia": false
}

Reenviar o mesmo codigo devolve 200 com o andamento existente e jaExistia: true.

Status

Status	Significado
`Pendente`	Recém-criado, ainda não lido pela equipe do cliente
`Lido`	A equipe do cliente leu o andamento no Xjur
`Descartado`	Descartado (por você, com `DELETE`, ou pela equipe do cliente)

Listar

GET /processo/andamentos?numeroProcesso=0009101-11.2026.8.26.0100&dataInicio=2026-09-01&dataFim=2026-09-30 HTTP/1.1

Parâmetro	Descrição
`processoId` / `numeroProcesso`	Processo (um dos dois)
`dataInicio` / `dataFim`	Período da data do andamento, inclusive
`incluirDescartados`	Padrão `false`
`pagina` / `limite`	Paginação (padrão 1 / 50, máximo 200)

Resposta: { totalPaginas, totalRegistros, data: [andamento...] }, do mais recente para o mais antigo. Inclui também os andamentos cadastrados pela equipe do cliente ou por outras integrações.

Descartar

DELETE /processo/andamentos/30528166 HTTP/1.1

Marca o andamento como Descartado e devolve o andamento atualizado (200). Ele continua no histórico do Xjur. Exige a permissão de Exclusão no módulo Andamentos.

Não há alteração de andamento: para corrigir, descarte e envie de novo com outro codigo.

Campos personalizados

Quando o cliente criou campos próprios para andamentos, eles são enviados em camposPersonalizados, com o id do campo (campoId, informado pela equipe Xjur na configuração da integração) e exatamente um valor:

Propriedade	Para campos do tipo
`texto`	Texto
`valor`	Moeda / decimal
`inteiro`	Número inteiro
`data`	Data
`booleano`	Sim/Não
`opcaoId`	Lista (opção escolhida)
`usuarioId`	Usuário do Xjur

"camposPersonalizados": [
  { "campoId": 4410, "texto": "Publicação DJE 29/09" }
]

O mesmo formato vale para audiências, sentenças e pedidos.