Audiências

Audiências aparecem na agenda do processo no Xjur e podem disparar o fluxo de trabalho do cliente (por exemplo, a designação de preposto). O ciclo típico é:

Agendar a audiência assim que ela é designada (POST).
Redesignar se a data mudar (PATCH com a nova dataAudiencia).
Informar o resultado depois de realizada (PATCH com resultadoAudiencia).

Agendar

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

{
  "numeroProcesso": "0009101-11.2026.8.26.0100",
  "dataAudiencia": "2026-11-13T14:00:00",
  "tipoAudiencia": "Audiência de Conciliação",
  "preposto": "Maria Souza",
  "observacao": "Audiência por videoconferência. Link enviado por e-mail.",
  "codigo": "ESC-AUD-5521"
}

Campo	Tipo	Obrigatório	Descrição
`processoId` / `numeroProcesso`		Um dos dois	Processo
`dataAudiencia`	`datetime`	Sim	Data e hora da audiência
`tipoAudienciaId` / `tipoAudiencia`		Não	`GET /processo/catalogos/tipos-audiencia`
`statusAudienciaId` / `statusAudiencia`		Não	`GET /processo/catalogos/status-audiencia`. Omitido, vale o status inicial do Xjur
`preposto`	`string`	Não	Nome do preposto
`testemunha`	`string`	Não	Testemunhas
`observacao`	`string`	Não	Observações (local, link, orientações)
`codigo`	`string`	Recomendado	Id da audiência no seu sistema. Chave de idempotência
`camposPersonalizados`	`array`	Não	Mesmo formato dos andamentos

Resposta 201:

{
  "audienciaId": 10571,
  "processoId": 748610,
  "dataAudiencia": "2026-11-13T14:00:00",
  "tipoAudienciaId": 4,
  "tipoAudiencia": "Audiência de Conciliação",
  "statusAudienciaId": 1,
  "statusAudiencia": "Ativo",
  "resultadoAudienciaId": null,
  "resultadoAudiencia": null,
  "preposto": "Maria Souza",
  "observacao": "Audiência por videoconferência. Link enviado por e-mail.",
  "codigo": "ESC-AUD-5521",
  "dataCadastro": "2026-09-29T10:20:11",
  "jaExistia": false
}

Guarde o audienciaId para as atualizações. Reenviar o mesmo codigo devolve 200 com a audiência existente e jaExistia: true.

Atualizar

PATCH /processo/audiencias/10571 HTTP/1.1
Content-Type: application/json

{
  "resultadoAudiencia": "Acordo",
  "observacao": "Acordo homologado em audiência: R$ 12.000,00 em 3 parcelas."
}

Só os campos enviados são alterados. Campos aceitos:

Campo	Descrição
`dataAudiencia`	Nova data — redesignação
`tipoAudienciaId` / `tipoAudiencia`	Tipo
`statusAudienciaId` / `statusAudiencia`	Status
`resultadoAudienciaId` / `resultadoAudiencia`	Resultado (`GET /processo/catalogos/resultados-audiencia`)
`preposto`, `testemunha`, `observacao`	Textos

Resposta 200 com a audiência completa.

Listar

GET /processo/audiencias?processoId=748610&dataInicio=2026-11-01 HTTP/1.1

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

Resposta: { totalPaginas, totalRegistros, data: [audiência...] }, da mais recente para a mais antiga.