Endpoint

Vincular processo

PUT/api/v1/{escritorio}/processos/{id}/vinculo

Liga o processo a uma origem do mesmo cliente principal, ou troca o tipo de relação ou a origem; os relacionados dele vão junto. Se só este processo tem Financeiro ou Análise IA, eles passam para a raiz da árvore de destino. Devolve os processos afetados que a pessoa vê. Erros: 409 RELACAO_CICLO (a origem é ele mesmo ou um relacionado dele), RELACAO_OUTRO_CLIENTE, FINANCEIRO_NOS_DOIS (os dois têm valores no Financeiro; nada muda), LITISCONSORTE_FORA_DA_ORIGEM, ANALISE_EM_ANDAMENTO; 400 CASO_SEM_RELACIONADOS. A origem, e ao trocar também a antiga, precisa estar nos departamentos da pessoa: 404 senão.

Permissão exigida

Operacional: Alterar

Só leitura recusa com 403

Parâmetros de caminho

escritoriotextoobrigatório
Código do escritório, com 5 dígitos. Os escritórios em que o token vale estão em GET /api/v1/eu.
idtextoobrigatório
Identificador do processo.

Corpo

origemIdtextoobrigatório
Identificador do processo de origem.
tipoRelacaotextoobrigatório
Cumprimento de sentença, recurso, agravo de instrumento, RPV, precatório, alvará ou outro.
Valores: CUMPRIMENTO_SENTENCARECURSOAGRAVO_INSTRUMENTORPVPRECATORIOALVARAOUTRO

Testar

Exemplo

cURL

curl -X PUT "https://developer.jur.ia2s.com.br/api/v1/10345/processos/SEU_ID/vinculo" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "origemId": "0190a000-0000-7000-8000-000000000001",
  "tipoRelacao": "CUMPRIMENTO_SENTENCA"
}'

Node

// Node 18 ou mais novo, em um arquivo .mjs
const resposta = await fetch("https://developer.jur.ia2s.com.br/api/v1/10345/processos/SEU_ID/vinculo", {
  method: "PUT",
  headers: {
    Authorization: "Bearer SEU_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "origemId": "0190a000-0000-7000-8000-000000000001",
    "tipoRelacao": "CUMPRIMENTO_SENTENCA"
  }),
});
console.log(resposta.status, await resposta.json());

Python

import requests

resposta = requests.put(
    "https://developer.jur.ia2s.com.br/api/v1/10345/processos/SEU_ID/vinculo",
    headers={"Authorization": "Bearer SEU_TOKEN"},
    json={
        "origemId": "0190a000-0000-7000-8000-000000000001",
        "tipoRelacao": "CUMPRIMENTO_SENTENCA",
    },
)
print(resposta.status_code)
print(resposta.json())

Respostas

200

Sucesso.

{
  "itens": [
    {
      "id": "0190a000-0000-7000-8000-000000000001",
      "clienteCodigo": "EX-0001",
      "clientes": [
        {
          "codigo": "EX-0001",
          "nome": "Maria Oliveira",
          "principal": true
        }
      ],
      "departamentoId": "0190a000-0000-7000-8000-000000000002",
      "natureza": "JUDICIAL",
      "origemId": null,
      "raizId": null,
      "tipoRelacao": null,
      "statusId": "0190a000-0000-7000-8000-000000000003",
      "descricao": "Horas extras",
      "assunto": null,
      "numeroCnj": "00012342720265020001",
      "tribunalSigla": "TRT2",
      "grau": "PRIMEIRO_GRAU",
      "justica": "TRABALHO",
      "enteDevedor": null,
      "comarca": "São Paulo",
      "vara": null,
      "magistrado": null,
      "classe": null,
      "autor": "Maria Oliveira",
      "autorDoc": null,
      "reu": "Empresa Exemplo Ltda.",
      "reuDoc": null,
      "partes": [],
      "dtDistribuicao": "2026-02-10",
      "dtSentenca": null,
      "resultadoSentenca": null,
      "dtTransito": null,
      "dtArquivamento": null,
      "numeroAdm": null,
      "orgao": null,
      "dtDer": null,
      "tipoBeneficio": null,
      "statusGerid": null,
      "etiquetas": [],
      "contagens": {
        "andamentos": 3,
        "prazosAbertos": 1,
        "trabalhosAbertos": 0
      },
      "criadoEm": "2026-11-06T12:00:00.000Z"
    },
    {
      "id": "0190a000-0000-7000-8000-000000000005",
      "clienteCodigo": "EX-0001",
      "clientes": [
        {
          "codigo": "EX-0001",
          "nome": "Maria Oliveira",
          "principal": true
        }
      ],
      "departamentoId": "0190a000-0000-7000-8000-000000000002",
      "natureza": "JUDICIAL",
      "origemId": "0190a000-0000-7000-8000-000000000001",
      "raizId": "0190a000-0000-7000-8000-000000000001",
      "tipoRelacao": "CUMPRIMENTO_SENTENCA",
      "statusId": "0190a000-0000-7000-8000-000000000003",
      "descricao": null,
      "assunto": null,
      "numeroCnj": "00056780620265020001",
      "tribunalSigla": "TRT2",
      "grau": "PRIMEIRO_GRAU",
      "justica": "TRABALHO",
      "enteDevedor": null,
      "comarca": "São Paulo",
      "vara": null,
      "magistrado": null,
      "classe": null,
      "autor": "Maria Oliveira",
      "autorDoc": null,
      "reu": "Empresa Exemplo Ltda.",
      "reuDoc": null,
      "partes": [],
      "dtDistribuicao": null,
      "dtSentenca": null,
      "resultadoSentenca": null,
      "dtTransito": null,
      "dtArquivamento": null,
      "numeroAdm": null,
      "orgao": null,
      "dtDer": null,
      "tipoBeneficio": null,
      "statusGerid": null,
      "etiquetas": [],
      "contagens": {
        "andamentos": 1,
        "prazosAbertos": 0,
        "trabalhosAbertos": 0
      },
      "criadoEm": "2026-11-06T12:00:00.000Z"
    }
  ]
}

Campos da resposta

itenslista de objetosobrigatório
- idtextoobrigatório
- clienteCodigotextoobrigatório
  Código do cliente principal.
- clienteslista de objetosobrigatório
  O cliente principal e os litisconsortes.
  - codigotextoobrigatório
  - nometextoobrigatório
  - principalverdadeiro ou falsoobrigatório
- departamentoIdtextoobrigatório
- naturezatextoobrigatório
  Valores: JUDICIALADMINISTRATIVOCONSULTIVO
- origemIdtexto ou nuloobrigatório
  Processo de origem, quando este é um processo relacionado.
- raizIdtexto ou nuloobrigatório
  Processo raiz da árvore; nulo na própria raiz e em processo sem relacionados.
- tipoRelacaotexto ou nuloobrigatório
  Tipo de relação com o processo de origem; nulo na raiz e em processo sem relacionados.
  Valores: CUMPRIMENTO_SENTENCARECURSOAGRAVO_INSTRUMENTORPVPRECATORIOALVARAOUTRO
- statusIdtextoobrigatório
- descricaotexto ou nuloobrigatório
- assuntotexto ou nuloobrigatório
  Pedido no caso consultivo.
- numeroCnjtexto ou nuloobrigatório
  Só os 20 dígitos.
- tribunalSiglatexto ou nuloobrigatório
- grautexto ou nuloobrigatório
  Valores: PRIMEIRO_GRAUSEGUNDO_GRAU
- justicatexto ou nuloobrigatório
  Valores: SUPERIORFEDERALTRABALHOELEITORALMILITAR_UNIAOESTADUALMILITAR_ESTADUAL
- enteDevedortexto ou nuloobrigatório
  Valores: FEDERALESTADUALMUNICIPALPARTICULAR
- comarcatexto ou nuloobrigatório
- varatexto ou nuloobrigatório
- magistradotexto ou nuloobrigatório
- classetexto ou nuloobrigatório
- autortexto ou nuloobrigatório
- autorDoctexto ou nuloobrigatório
- reutexto ou nuloobrigatório
- reuDoctexto ou nuloobrigatório
- parteslista de objetosobrigatório
  - idtextoobrigatório
  - polotextoobrigatório
    Valores: ATIVOPASSIVO
  - nometextoobrigatório
  - documentotexto ou nuloobrigatório
  - ordemnúmero inteiroobrigatório
- dtDistribuicaotexto ou nuloobrigatório
  AAAA-MM-DD.
- dtSentencatexto ou nuloobrigatório
  AAAA-MM-DD.
- resultadoSentencatexto ou nuloobrigatório
  Valores: PROCEDENTEPARCIALMENTE_PROCEDENTEIMPROCEDENTE
- dtTransitotexto ou nuloobrigatório
  AAAA-MM-DD.
- dtArquivamentotexto ou nuloobrigatório
  AAAA-MM-DD.
- numeroAdmtexto ou nuloobrigatório
- orgaotexto ou nuloobrigatório
- dtDertexto ou nuloobrigatório
  AAAA-MM-DD.
- tipoBeneficiotexto ou nuloobrigatório
- statusGeridtexto ou nuloobrigatório
- etiquetaslista de textosobrigatório
  Identificadores das etiquetas.
- contagensobjetoobrigatório
  - andamentosnúmero inteiroobrigatório
  - prazosAbertosnúmero inteiroobrigatório
  - trabalhosAbertosnúmero inteiroobrigatório
    Só os do caso, no consultivo.
- criadoEmtextoobrigatório

400

Corpo ou parâmetro inválido.

INVALIDO

{
  "codigo": "INVALIDO",
  "mensagem": "Confira os dados informados.",
  "campos": {
    "departamentoId": "Valor inválido."
  }
}

CHAVE_IDEMPOTENCIA_INVALIDA

{
  "codigo": "CHAVE_IDEMPOTENCIA_INVALIDA",
  "mensagem": "A Idempotency-Key deve ter de 1 a 255 caracteres visíveis, sem espaços."
}

Campos da resposta

codigotextoobrigatório
Código estável do erro.
mensagemtextoobrigatório
Mensagem em português.
camposobjeto
No 400, a mensagem de cada campo inválido.
clienteobjeto
No 409 CPF_EM_USO/CNPJ_EM_USO, o outro cliente, quando a pessoa dona do token pode vê-lo.
- codigotextoobrigatório
- nometextoobrigatório
processoobjeto
No 409 NUMERO_EM_USO, o outro processo, quando a pessoa dona do token pode vê-lo.
- idtextoobrigatório
- clienteCodigotextoobrigatório
- clienteNometextoobrigatório

401

Sem token, ou token revogado ou expirado, ou pessoa desativada.

TOKEN_INVALIDO

{
  "codigo": "TOKEN_INVALIDO",
  "mensagem": "Token de API inválido, expirado ou revogado."
}

Campos da resposta

codigotextoobrigatório
Código estável do erro.
mensagemtextoobrigatório
Mensagem em português.
camposobjeto
No 400, a mensagem de cada campo inválido.
clienteobjeto
No 409 CPF_EM_USO/CNPJ_EM_USO, o outro cliente, quando a pessoa dona do token pode vê-lo.
- codigotextoobrigatório
- nometextoobrigatório
processoobjeto
No 409 NUMERO_EM_USO, o outro processo, quando a pessoa dona do token pode vê-lo.
- idtextoobrigatório
- clienteCodigotextoobrigatório
- clienteNometextoobrigatório

403

A pessoa não pode fazer isto, o token é só de leitura, foi bloqueado neste escritório, não tem esta operação, quem o gerou saiu do escritório ou o acesso ao escritório está suspenso.

SEM_PERMISSAO

{
  "codigo": "SEM_PERMISSAO",
  "mensagem": "Sem permissão para esta alteração."
}

TOKEN_SO_LEITURA

{
  "codigo": "TOKEN_SO_LEITURA",
  "mensagem": "Este token é só de leitura."
}

TOKEN_SEM_ESCOPO

{
  "codigo": "TOKEN_SEM_ESCOPO",
  "mensagem": "Este token não tem permissão para esta operação."
}

TOKEN_BLOQUEADO

{
  "codigo": "TOKEN_BLOQUEADO",
  "mensagem": "Este token foi bloqueado pela administração deste escritório."
}

TOKEN_AUTOR_INATIVO

{
  "codigo": "TOKEN_AUTOR_INATIVO",
  "mensagem": "Quem gerou este token não está mais ativo neste escritório."
}

ESCRITORIO_SUSPENSO

{
  "codigo": "ESCRITORIO_SUSPENSO",
  "mensagem": "O acesso a este escritório está suspenso. Fale com a IA2S."
}

Campos da resposta

codigotextoobrigatório
Código estável do erro.
mensagemtextoobrigatório
Mensagem em português.
camposobjeto
No 400, a mensagem de cada campo inválido.
clienteobjeto
No 409 CPF_EM_USO/CNPJ_EM_USO, o outro cliente, quando a pessoa dona do token pode vê-lo.
- codigotextoobrigatório
- nometextoobrigatório
processoobjeto
No 409 NUMERO_EM_USO, o outro processo, quando a pessoa dona do token pode vê-lo.
- idtextoobrigatório
- clienteCodigotextoobrigatório
- clienteNometextoobrigatório

404

Não existe, está fora do alcance da pessoa, ou o escritório do caminho não é dela.

NAO_ENCONTRADO

{
  "codigo": "NAO_ENCONTRADO",
  "mensagem": "Não encontrado."
}

ESCRITORIO_NAO_ENCONTRADO

{
  "codigo": "ESCRITORIO_NAO_ENCONTRADO",
  "mensagem": "Escritório não encontrado."
}

Campos da resposta

codigotextoobrigatório
Código estável do erro.
mensagemtextoobrigatório
Mensagem em português.
camposobjeto
No 400, a mensagem de cada campo inválido.
clienteobjeto
No 409 CPF_EM_USO/CNPJ_EM_USO, o outro cliente, quando a pessoa dona do token pode vê-lo.
- codigotextoobrigatório
- nometextoobrigatório
processoobjeto
No 409 NUMERO_EM_USO, o outro processo, quando a pessoa dona do token pode vê-lo.
- idtextoobrigatório
- clienteCodigotextoobrigatório
- clienteNometextoobrigatório

409

Conflito: veja o campo `codigo`.

TENTE_NOVAMENTE

{
  "codigo": "TENTE_NOVAMENTE",
  "mensagem": "Outra pessoa alterou isto ao mesmo tempo. Tente novamente."
}

Campos da resposta

codigotextoobrigatório
Código estável do erro.
mensagemtextoobrigatório
Mensagem em português.
camposobjeto
No 400, a mensagem de cada campo inválido.
clienteobjeto
No 409 CPF_EM_USO/CNPJ_EM_USO, o outro cliente, quando a pessoa dona do token pode vê-lo.
- codigotextoobrigatório
- nometextoobrigatório
processoobjeto
No 409 NUMERO_EM_USO, o outro processo, quando a pessoa dona do token pode vê-lo.
- idtextoobrigatório
- clienteCodigotextoobrigatório
- clienteNometextoobrigatório

413

Corpo da requisição grande demais.

CORPO_GRANDE

{
  "codigo": "CORPO_GRANDE",
  "mensagem": "O corpo da requisição é grande demais."
}

Campos da resposta

codigotextoobrigatório
Código estável do erro.
mensagemtextoobrigatório
Mensagem em português.
camposobjeto
No 400, a mensagem de cada campo inválido.
clienteobjeto
No 409 CPF_EM_USO/CNPJ_EM_USO, o outro cliente, quando a pessoa dona do token pode vê-lo.
- codigotextoobrigatório
- nometextoobrigatório
processoobjeto
No 409 NUMERO_EM_USO, o outro processo, quando a pessoa dona do token pode vê-lo.
- idtextoobrigatório
- clienteCodigotextoobrigatório
- clienteNometextoobrigatório

429

Limite de 120 requisições por minuto.

Cabeçalho Retry-After: Segundos até poder tentar de novo.

LIMITE_TOKEN

{
  "codigo": "LIMITE_TOKEN",
  "mensagem": "Muitas requisições com este token. Tente de novo em um minuto."
}

Campos da resposta

codigotextoobrigatório
Código estável do erro.
mensagemtextoobrigatório
Mensagem em português.
camposobjeto
No 400, a mensagem de cada campo inválido.
clienteobjeto
No 409 CPF_EM_USO/CNPJ_EM_USO, o outro cliente, quando a pessoa dona do token pode vê-lo.
- codigotextoobrigatório
- nometextoobrigatório
processoobjeto
No 409 NUMERO_EM_USO, o outro processo, quando a pessoa dona do token pode vê-lo.
- idtextoobrigatório
- clienteCodigotextoobrigatório
- clienteNometextoobrigatório

503

O sistema está ocupado. Tente em instantes.

SISTEMA_OCUPADO

{
  "codigo": "SISTEMA_OCUPADO",
  "mensagem": "O sistema está ocupado. Tente em instantes."
}

Campos da resposta

codigotextoobrigatório
Código estável do erro.
mensagemtextoobrigatório
Mensagem em português.
camposobjeto
No 400, a mensagem de cada campo inválido.
clienteobjeto
No 409 CPF_EM_USO/CNPJ_EM_USO, o outro cliente, quando a pessoa dona do token pode vê-lo.
- codigotextoobrigatório
- nometextoobrigatório
processoobjeto
No 409 NUMERO_EM_USO, o outro processo, quando a pessoa dona do token pode vê-lo.
- idtextoobrigatório
- clienteCodigotextoobrigatório
- clienteNometextoobrigatório