Operador Nacional do Sistema de Registro Eletrônico de Imóveis (ONR)
Matrícula do imóvel — visualização (RI Digital/ONR)
Conteúdo da matrícula (proprietário, ônus, penhoras, área e cadeia de atos) em PDF do cartório. Vale para imóvel urbano ou rural.
Integração por API em construção. Esta consulta já roda hoje na plataforma, pela tela. O contrato abaixo é o que a API vai expor quando abrir.
Ficha
Estado medido agora, no mesmo lugar de onde a venda decide — não numa tabela mantida à parte.
- Identificador
- registradores_matricula
- Preço
- R$ 12,84 a partir de — o valor final depende do cartório
- Aceita
- Matrícula + cartório
- Esfera
- Cartórios e registros
- Procedência
- Parceiro de integração
- Na plataforma
- Disponível
Parâmetros
O que a consulta exige para rodar. Parâmetro obrigatório que falta é recusado antes de qualquer cobrança — não vira consulta paga que volta vazia.
| Parâmetro | Obrigatório | O que é |
|---|---|---|
| cpf_cnpj | Sim | CPF (11 dígitos) ou CNPJ (14 dígitos) do alvo. |
| imovel_matricula | Sim | Número da matrícula do imóvel. |
| imovel_cartorio | Sim | Cartório de registro de imóveis onde a matrícula está registrada. |
| imovel_municipio | Sim | Município do imóvel. |
| imovel_uf | Sim | UF do imóvel. |
Comportamento
O que esta fonte faz de diferente das outras — prazo, cobrança, repetição, recusa. Cada cláusula aqui saiu de um caso real que custou dinheiro; está publicada para que a sua integração não pague por ele de novo.
- Repetir cobra de novo Cada chamada protocola um ato na origem e debita o emolumento. Não existe estorno depois do ato: repetir por retry automático paga duas vezes. Esta fonte exige chave de idempotência.
- Preço varia por alvo O preço depende do alvo (emolumento fixado por lei estadual e variável por município). O valor anunciado é o piso: orce antes de chamar.
- Duas etapas A primeira etapa protocola o pedido e devolve o número; a segunda obtém o documento depois, em dias úteis.
- Recusa antes de cobrar Quando a origem recusaria o pedido — por exemplo, um pedido anterior da mesma matrícula ainda vigente —, a resposta vem antes de qualquer cobrança, dizendo quando libera.
- Bloqueio estornado Se a origem bloquear sem entregar nada, o valor é estornado, mesmo quando o provedor fatura a chamada.
- Saldo na origem O custo sai de um saldo pré-pago nosso na origem. Sem caixa, o pedido fica represado e avisado — nunca falha como se o problema fosse seu.
- Códigos reinterpretados Esta fonte reinterpreta pelo menos um código de retorno: o mesmo número significa coisas diferentes em origens diferentes.
Antes de integrar
Ressalvas sobre o que esta consulta é — e o que ela não é.
- 2 etapas Sai em 2 etapas: o pedido é protocolado e o documento é emitido depois. Pode levar alguns dias úteis — avisamos quando ficar pronto.
- Exige matrícula Exige número da matrícula, cartório (1 = 1º RI), município e UF — e o município é o do CARTÓRIO, não o do imóvel. Se você não tem a matrícula, a Pesquisa Prévia ("Imóveis do titular — busca por CPF/CNPJ") localiza as matrículas do alvo na UF escolhida; sendo imóvel rural com CAR, o mapa do ONR aponta a serventia.
- Simples consulta O documento sai carimbado "PARA SIMPLES CONSULTA — NÃO VALE COMO CERTIDÃO". Serve para investigar e decidir; para escritura ou financiamento é preciso a certidão de inteiro teor.
- PDF digitalizado A matrícula vem como imagem escaneada pelo cartório, do jeito que o livro foi registrado — leitura humana, sem campos pesquisáveis.
- Urbano e rural Vale para imóvel urbano e rural: a matrícula é do registro de imóveis da comarca, seja apartamento, terreno ou fazenda.
- Cobertura parcial Só sai onde o cartório está integrado ao ONR — a maior parte do país, não o país inteiro. E a visualização alcança MENOS municípios que a certidão de inteiro teor: há comarca que emite certidão e não oferece visualização. O município que vale é o do CARTÓRIO onde a matrícula está registrada, que pode não ser o do imóvel.
Códigos de retorno
A resposta HTTP é sempre 200; o resultado real está no campo code. A coluna de estorno faz parte do contrato: nem toda falha devolve o dinheiro, e você tem direito de saber quais antes de integrar.
| Classe | Códigos | O que significa | Estorna | Retenta |
|---|---|---|---|---|
| sucesso | 200 | A origem respondeu e entregou. | — | — |
| nao_encontrado | 612 | A origem respondeu: nada consta para este alvo. | Não | Não |
| indeterminado | 611 | A origem não conseguiu emitir pela internet. Não é irregularidade. | Não | Não |
| erro_participante | 608, 619, 620 | A origem recusou os DADOS do pedido. | Não | Sim |
| retry | 600, 605, 609, 610, 613, 614, 615, 618 | Instabilidade momentânea da origem ou do transporte. | Sim | Sim |
| fatal | 601, 602, 603, 604, 606, 607, 617, 621, 622 | Defeito de integração — nosso, não seu. | Sim | Não |
Permanentes: 602 e 603 não se curam sozinhos — a fonte sai do ar na hora e um humano é avisado.
Precisa desta consulta por API?
Diga qual volume você espera. A ordem de liberação segue a demanda real.
Falar sobre integração