Desenvolvedores

API e integrações

Conecte seu ERP, CRM ou sistema financeiro à Central Jurídica Digital. Envie cobranças em lote, consulte status e receba atualizações via webhook.

Solicitar acesso à API Importar via CSV (disponível)
⚙ API em desenvolvimento — a API REST está em implementação para clientes empresariais. Enquanto isso, use a importação por CSV para adicionar sua carteira em lote. Preencha o formulário de contato para acesso antecipado e acompanhar o roadmap.

Autenticação

A API usa Bearer Tokens (OAuth 2.0 Client Credentials). Cada cliente empresarial recebe um client_id e client_secret após ativação da conta.

Obter token

POST /oauth/token
Content-Type: application/json

{
  "grant_type": "client_credentials",
  "client_id":  "cj_live_xxxxxxxxxxxx",
  "client_secret": "cs_xxxxxxxxxxxx"
}

// Resposta
{
  "access_token": "eyJhbGci...",
  "token_type":  "Bearer",
  "expires_in":  3600
}

Use o token no cabeçalho de todas as requisições:

Authorization: Bearer eyJhbGci...

Base URL

// Produção
https://api.centraljuridicadigital.com.br/v1

// Sandbox (testes — sem efeito real)
https://api-sandbox.centraljuridicadigital.com.br/v1

URLs provisórias — pendentes de aprovação e configuração de infraestrutura.

Códigos de erro

Código HTTPCódigo internoSignificado
400invalid_requestCorpo da requisição inválido ou campo obrigatório ausente
401unauthorizedToken ausente, expirado ou inválido
403forbiddenToken sem permissão para este recurso
404not_foundRecurso não encontrado
422validation_errorDados válidos mas com conflito de negócio
429rate_limitedLimite de requisições excedido (100/min por cliente)
500server_errorErro interno — aguarde e tente novamente

Cobranças

POST
/cobrancas
Cria uma nova cobrança avulsa
GET
/cobrancas
Lista cobranças com filtros (status, credor, data)
GET
/cobrancas/{protocolo}
Detalha uma cobrança pelo protocolo CJ-
PUT
/cobrancas/{protocolo}/status
Atualiza status da cobrança

Corpo — criar cobrança

CampoTipoReq.Descrição
devedorstringobr.Nome completo ou razão social do devedor
valornumberobr.Valor original em reais (ex.: 1500.00)
cpf_cnpj_devedorstringopc.CPF (11 dígitos) ou CNPJ (14 dígitos), apenas números
email_devedorstringopc.E-mail para envio de notificação ao devedor
telefone_devedorstringopc.Telefone com DDD, apenas números
origem_dividastringopc.Descrição da origem (ex.: "Contrato de aluguel jan/2026")
vencimentodateopc.Data de vencimento original no formato YYYY-MM-DD
referencia_externastringopc.ID do sistema de origem para rastreamento

Exemplo

POST /v1/cobrancas
Authorization: Bearer eyJhbGci...
Content-Type: application/json

{
  "devedor":            "João Silva",
  "valor":             1500.00,
  "cpf_cnpj_devedor":  "12345678900",
  "email_devedor":      "joao@email.com",
  "origem_divida":      "Prestação de serviços – contrato 123",
  "vencimento":        "2025-12-01",
  "referencia_externa": "ERP-99887"
}

// Resposta 201 Created
{
  "protocolo": "CJ-20260619-0042",
  "status":    "aguardando_triagem",
  "criado_em": "2026-06-19T14:23:00Z"
}

Envio em lote em breve

POST
/cobrancas/lote
Envia até 1.000 cobranças por requisição (processamento assíncrono)
POST /v1/cobrancas/lote

{
  "registros": [
    { "devedor": "Ana Souza", "valor": 800.00 },
    { "devedor": "Carlos Mota", "valor": 3200.00 }
  ]
}

// Resposta 202 Accepted
{
  "lote_id":   "batch_abc123",
  "total":     2,
  "status":    "processando",
  "consultar": "/v1/lotes/batch_abc123"
}

Consulta de status

GET /v1/cobrancas/CJ-20260619-0042

// Resposta
{
  "protocolo":           "CJ-20260619-0042",
  "devedor":             "João Silva",
  "valor_original":      1500.00,
  "status":              "notificacao_enviada",
  "atualizado_em":       "2026-06-20T09:14:00Z",
  "referencia_externa":  "ERP-99887"
}

Status possíveis

StatusDescrição
aguardando_triagemRecebida, aguardando processamento interno
em_andamentoNotificação ao devedor em curso
respondidaDevedor respondeu à notificação
acordo_firmadoPartes chegaram a um acordo de pagamento (direto ao credor)
encerradaCiclo encerrado sem acordo ou por solicitação do credor

Documentos em breve

POST
/documentos/gerar
Gera um documento a partir de um modelo e retorna o PDF em base64
GET
/documentos/{codigo}/verificar
Verifica a emissão de um documento pelo código de verificação

Webhooks

Receba eventos em tempo real no endpoint HTTPS de sua escolha. Configure via painel empresarial ou pela API:

POST
/webhooks
Registra um endpoint para receber eventos
GET
/webhooks
Lista endpoints configurados
DEL
/webhooks/{id}
Remove um endpoint
// Payload recebido no seu endpoint (POST)
{
  "evento":     "cobranca.status_alterado",
  "ocorrido_em":"2026-06-20T09:14:00Z",
  "dados": {
    "protocolo": "CJ-20260619-0042",
    "status_anterior": "em_andamento",
    "status_atual":    "acordo_firmado"
  }
}

Eventos disponíveis

EventoDisparado quando
cobranca.criadaNova cobrança registrada
cobranca.status_alteradoStatus da cobrança muda
cobranca.acordo_firmadoAcordo de pagamento estabelecido (pagamento direto ao credor)
cobranca.encerradaCiclo encerrado
lote.processadoImportação em lote concluída
documento.emitidoDocumento gerado via API

Conectores prontos em desenvolvimento

Além da API REST, estamos desenvolvendo conectores nativos para as principais plataformas:

SAPem breve
Totvsem breve
Salesforceem breve
HubSpotem breve
Zapierem breve
Makeem breve

Para integrações prioritárias ou desenvolvimento sob medida, entre em contato pelo formulário empresarial.

Quer acesso antecipado à API?

Clientes empresariais em fase de implantação têm prioridade no acesso ao programa beta.

Solicitar acesso antecipado