Cadastrar Processo

Cadastre no Xjur os processos que chegam ao escritório e ainda não existem no sistema do cliente. Depois do cadastro, o processo recebe andamentos, audiências, sentenças e valores pelas demais rotas.

Passo a passo

1. Escolha a área do direito

Cada área do direito (Cível, Trabalhista…) tem a sua tela de cadastro, com campos obrigatórios e campos personalizados próprios de cada cliente.

GET /processo/areas?nome=trabalh HTTP/1.1

{
  "totalPaginas": 1,
  "totalRegistros": 2,
  "data": [
    { "id": 1, "nome": "Trabalhista" },
    { "id": 35, "nome": "Jurídico Trabalhista", "codigo": "Jurídico Trabalhista" }
  ]
}

2. Descubra os campos da área

GET /processo/areas/34/campos HTTP/1.1

A resposta lista cada campo da tela: se é obrigatório, onde enviá-lo no payload e, nos campos personalizados, as opções. Veja Campos e XCampos.

3. Envie o processo

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

{
  "numeroProcesso": "0009101-11.2026.8.26.0100",
  "codigo": "ESC-PROC-2026-0042",
  "areaDireitoId": 34,
  "esfera": "Judicial",
  "instancia": "1ª Instância",
  "faseProcessual": "Conhecimento",
  "tipoAcao": "Ação de Indenização Cível",
  "cidade": "São Paulo",
  "uf": "SP",
  "dataDistribuicao": "2026-09-15",
  "valorCausa": 85000.00,
  "resumo": "Ação de indenização por danos morais.",
  "partesContrarias": [
    { "documento": "529.982.247-25", "nome": "João da Silva", "formaParticipacao": "Autor" }
  ],
  "empresas": [
    { "documento": "33.337.122/0001-27", "formaParticipacao": "Réu" }
  ],
  "advogadosInternos": [ { "nome": "Andrezza Santos Carneiro" } ],
  "pedidos": [
    { "tipoPedido": "Dano Moral", "risco": "Possível", "valorPedido": 30000.00 }
  ],
  "camposPersonalizados": [
    { "campo": "Área do Direito", "opcao": "Administrativa" },
    { "campo": "ipirangaTipodeCadastro", "opcao": "Pagamento de Custas" },
    { "campo": "Objeto", "tiposPedido": ["Dano Moral"] },
    { "campo": "Área de Origem da Demanda", "niveis": [
        { "opcao": "3072002 - VP Comercial Rede" },
        { "opcao": "4070835 - Diretoria Negócios Rede - Oeste" },
        { "opcao": "6070837 - GN Urbano Goiânia" }
    ] },
    { "campo": "Marcação de Débito", "linhas": [
        { "Tipo de Débito": "Multa", "Valor Histórico": 1500.25, "Prognóstico": "Possível" }
    ] }
  ]
}

Resposta 201: o processo no mesmo formato de GET /processo/{processoId}, com jaExistia: false.

{
  "processoId": 748667,
  "numeroProcesso": "0009101-11.2026.8.26.0100",
  "areaDireito": "Jurídico Operacional",
  "status": "Ativo",
  "tipoAcao": "Ação de Indenização Cível",
  "uf": "SP",
  "cidade": "São Paulo",
  "partesContrarias": [ { "nome": "João da Silva", "documento": "52998224725", "formaParticipacao": "Autor" } ],
  "jaExistia": false
}

O cadastro leva alguns segundos: o Xjur aplica o fluxo do cliente, a numeração da pasta e, em esfera judicial, a comarca pelo número CNJ.

Campos

Os campos de lista aceitam o id (esferaId, tipoAcaoId…) ou o nome exato (esfera, tipoAcao…), sem distinção de maiúsculas e acentos. Os ids estão em GET /processo/catalogos/{catalogo}.

Campo	Catálogo	Descrição
numeroProcesso		Número CNJ. Em esfera judicial é obrigatório e precisa ter 20 dígitos
codigo		Id do processo no seu sistema (até 100 caracteres)
pasta		Pasta. Em clientes com numeração automática, é gerada pelo Xjur
areaDireitoId / areaDireito	areas-direito	Obrigatório
subAreaDireitoId / subAreaDireito	subareas-direito
esferaId / esfera	esferas	Judicial, Administrativa, Extrajudicial…
classificacaoId / classificacao	classificacoes
gestaoProcessoId / gestaoProcesso	gestoes-processo
tipoContingenciaId / tipoContingencia	tipos-contingencia
tipoAcaoId / tipoAcao	tipos-acao
faseProcessualId / faseProcessual	fases-processuais
instanciaId / instancia	instancias
statusProcessoId / statusProcesso	status-processo	Omitido, vale o status inicial do Xjur
riscoId / risco	riscos
escritorioId / escritorio	escritorios
cidadeId ou cidade + uf		Comarca. Em esfera judicial, quando omitida, é deduzida do número CNJ
dataDistribuicao, dataRecebimento, prazoFatal		Datas
valorCausa		Não negativo
descricaoObjetoAcao, resumo, observacoes		Textos
restrito		Padrão false
processoPrincipalId		Processo principal, para apensos e incidentes
partesContrarias		Ver Partes contrárias
empresas	empresas	{ empresaId ou documento (CNPJ), formaParticipacao, principal, percentual }
advogadosInternos	advogados-internos	{ advogadoInternoId ou nome, principal }
centrosCusto	tipos-centro-custo	{ tipoCentroCustoId ou tipoCentroCusto, percentual } — a soma deve ser 100
pedidos	tipos-pedido, riscos	{ tipoPedido, risco, valorPedido, valorCondenacao } — veja Valores
camposPersonalizados		Ver Campos e XCampos
validarCamposObrigatorios		Padrão true. Com false, não confere os obrigatórios da área

Obrigatórios por área

Além de areaDireito, valem os campos marcados como obrigatórios em GET /processo/areas/{areaDireitoId}/campos. Quando falta algum, o cadastro devolve 400 listando todos os que faltam, com o nome da propriedade onde enviar cada um.

Partes contrárias

Campo	Obrigatório	Descrição
documento	Um dos dois	CPF ou CNPJ, com ou sem máscara
pessoaId	Um dos dois	Id da pessoa no Xjur
nome	Para cadastrar	Usado quando a pessoa ainda não existe no cadastro do cliente
formaParticipacaoId / formaParticipacao	Sim	Autor, Réu, Reclamante… (formas-participacao)
tipoParteContrariaId / tipoParteContraria	Não	tipos-parte-contraria
principal	Não	Com uma parte só, ela é a principal
email, telefone, celular, codigo	Não

A pessoa é procurada pelo documento no cadastro do cliente e, quando não existe, é cadastrada com o nome informado.

Idempotência

Reenviar um processo com um numeroProcesso que já existe no cliente devolve o processo existente com 200 e jaExistia: true, sem criar outro. Processos sem número (extrajudiciais, administrativos) não têm essa proteção: confira antes de reenviar depois de um 502/504.

Permissões

Além das permissões gerais, o cadastro usa:

Módulo	Permissão	Para
Contencioso	Escrita	Cadastrar o processo
Pessoas	Leitura e Escrita	Localizar e cadastrar as partes contrárias
Societário	Leitura	Localizar empresas pelo CNPJ
Administração	Leitura	Configuração da tela, XCampos e catálogos