Reabrir

Reabre uma negociação encerrada, desde que o tipo de encerramento permita.

POSThttps://external-api.arbitralis.com.br/api/external/v1/extrajudicial/negotiations/{id}/reabrir

AutenticaçãoX-API-KEYSíncrono — a resposta já traz o resultado

Reabre uma negociação encerrada (CLOSED → ACTIVE), desde que o tipo de encerramento permita. Acordos fechados (AGREEMENT_CLOSED) não podem ser reabertos.

A justificativa é obrigatória e fica registrada no histórico do caso.

Parâmetros de rota

iduuidobrigatório

Identificador do caso de negociação.

Body

justificativastringobrigatório

Motivo da reabertura, entre 1 e 2000 caracteres.

manterDadosAnterioresbooleanopcionalpadrão true

Se true, preserva os dados de encerramento e o contexto anterior. Se false, limpa o contexto de IA e os dados de encerramento.

Quem pode ser reaberto

Encerramento anterior	Status	Reabrir
`DESISTENCIA`	`CLOSED`	Sim
`CANCELAMENTO`	`CLOSED`	Sim
`ACORDO_MANUAL`	`AGREEMENT_CLOSED`	Não
`ACORDO_IA`	`AGREEMENT_CLOSED`	Não
Nunca encerrada	qualquer	Não — use Retomar se estiver pausada

Confira permiteReabrir antes

A resposta de Encerrar devolve permiteReabrir. Guarde esse valor no seu sistema para saber, sem uma chamada extra, se o caso ainda pode voltar.

O efeito de `manterDadosAnteriores`

Valor	Efeito
`true` (padrão)	Preserva os dados de encerramento e o contexto de IA da tratativa anterior. O agente retoma sabendo o que já foi conversado
`false`	Limpa o contexto de IA e os dados de encerramento. O agente recomeça do zero

Reabrir com contexto limpo é irreversível

Com manterDadosAnteriores: false, o contexto de IA e os dados de encerramento anteriores são descartados. Use apenas quando a nova tratativa realmente não tem relação com a anterior.

Erros

Código	Causa
`400`	Negociação não encerrada, tipo de encerramento não permite reabertura, ou `justificativa` ausente
`401`	API key ausente, inválida ou inativa
`404`	Negociação não encontrada neste workspace
`429`	Limite de requisições excedido

Requisição

curl -X POST "https://external-api.arbitralis.com.br/api/external/v1/extrajudicial/negotiations/1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d/reabrir" \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: arb_live_SUA_CHAVE" \
  -d '{
    "justificativa": "Devedor voltou a procurar o escritório propondo novo parcelamento",
    "manterDadosAnteriores": true
  }'

const negociacaoId = '1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d';

const response = await fetch(
  `https://external-api.arbitralis.com.br/api/external/v1/extrajudicial/negotiations/${negociacaoId}/reabrir`,
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-KEY': 'arb_live_SUA_CHAVE',
    },
    body: JSON.stringify({
      justificativa: 'Devedor voltou a procurar o escritório propondo novo parcelamento',
      manterDadosAnteriores: true,
    }),
  }
);

const { data } = await response.json();

Resposta

{
  "success": true,
  "data": {
    "negociacaoId": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
    "status": "ACTIVE",
    "dataReabertura": "2026-08-14T10:05:47.000Z",
    "justificativaReabertura": "Devedor voltou a procurar o escritório propondo novo parcelamento"
  }
}

{
  "success": false,
  "error": {
    "code": "BAD_REQUEST",
    "message": "Negociação encerrada com acordo não permite reabertura.",
    "errorEventId": "b1f3c6d8-2a44-4d9e-9f10-7c5b8e2a1d33"
  }
}

Quem pode ser reaberto

O efeito de manterDadosAnteriores

Erros

O efeito de `manterDadosAnteriores`