Visualização de Matrícula

A visualização entrega o MESMO conteúdo da certidão de inteiro teor, e é aí que mora o risco: o PDF parece um documento oficial, mas não é assinado digitalmente pelo oficial do registro e não declara validade.

Não use para instruir processo, registrar ato, fechar financiamento ou provar titularidade perante terceiro. Para isso existe a Certidão de Inteiro Teor (/v1/consultas/certidao-inteiro-teor), que é o mesmo conteúdo com assinatura do cartório — e custa cerca de 3,3× mais, porque o emolumento é outro.

Use a visualização para o que ela é boa: due diligence, triagem, decisão interna, conferência antes de pedir a certidão paga.

O preço não é tarifa nossa: é o emolumento que o registro de imóveis cobra, fixado por tabela estadual, mais a nossa margem. Ele sai da nossa conta pré-paga no portal no momento do pedido, e ato registral não estorna.

Atenção: Por isso Idempotency-Key é obrigatória. Mesma chave devolve a mesma resposta, sem protocolar de novo e sem cobrar de novo. Chave nova é pedido novo, ainda que o imóvel seja o mesmo.

Cuidado com retry automático de biblioteca HTTP: um timeout do SEU lado não significa que o pedido não saiu do nosso — significa que você não viu a resposta. Reenvie com a MESMA chave.

Não existe tabela nacional. O emolumento muda por estado e por serventia, então o valor publicado no card é PISO ("a partir de"), nunca o preço do seu pedido.

Use POST /v1/orcamento/visualizacao-matricula com os mesmos quatro campos do imóvel: ele cota na origem, não cobra e devolve preco.total com estimado: true. É o único número que bate com a fatura.

Atenção: Cartório que não cota não é vendido. Município escrito errado, serventia inexistente ou tabela indisponível fazem a consulta responder 602 (indisponível) SEM chamar a origem e SEM cobrar — em vez de protocolar um pedido que ninguém sabe quanto custa.

O RI Digital recusa um segundo pedido da mesma matrícula, no mesmo cartório, enquanto o anterior estiver vigente. A recusa vem faturada pela origem e não entrega documento nenhum — por isso nós barramos antes, e a resposta é 602 sem cobrança.

Atenção: A plataforma opera com UMA conta no portal para toda a carteira. Isso significa que um pedido feito por outro cliente nosso, do mesmo imóvel, bloqueia o seu enquanto estiver vigente. A janela em uso é de 7 dias, e ela é estimativa: o portal não devolve o prazo real de vigência.

A resposta diz a data a partir da qual o pedido volta a ser aceito. Se o volume do seu produto tornar isso frequente, o caminho é uma credencial dedicada no portal — fale com o suporte antes de escalar.

A URL do PDF que o cartório devolve é assinada e expira: medido em 2026-08-11, validade de 7 dias. Guardar essa URL e abrir semanas depois entrega link morto de um documento que já custou emolumento.

Nós arquivamos os bytes na entrega. Use documento_url da resposta — ela aponta para o nosso arquivo, autentica com o mesmo Bearer e não expira. site_receipts[] continua trazendo a URL da origem para conferência.

O campo imovel_finalidade é declarado AO CARTÓRIO em nome de quem pede. Não é filtro de busca nem preferência técnica.

Atenção: O valor 3 afirma que o solicitante É titular de direito real registrado sobre o imóvel. Due diligence de imóvel de terceiro não é titularidade — mandar 3 ali é declaração falsa feita em nome do seu cliente. Por isso o padrão é 2, e o 3 só vai à origem se você o enviar explicitamente.

O portal do cartório leva de dezenas de segundos a poucos minutos, e segurar a conexão até lá deixa pedido órfão pago quando o seu HTTP desiste. Por isso o POST responde 202 com data[0].protocolo na hora, e o documento chega depois.

Consulte GET /v1/consultas/{protocolo} para acompanhar. Ele **não cobra e não fala com a origem** — lê a linha que o motor já escreveu, então pode ser consultado à vontade. Enquanto estiver rodando ele responde 202; quando terminar, 200 com o documento (ou um 6xx dizendo o que houve).

O header.billable já vem true no 202: o valor foi debitado na aceitação. Não some o preço de novo quando o 200 chegar.

Quando o portal não responde a tempo (605), a pergunta que fica é de dinheiro: o ato saiu ou não? Nós não chutamos — perguntamos à lista de pedidos da origem antes de decidir.

Achou o protocolo: o valor fica, o documento é entregue e você recebe normalmente. Não achou: o valor é estornado integralmente e a resposta diz que nada foi cobrado pelo cartório. A reconciliação roda sozinha a cada 30 min.

Atenção: Não reenvie com chave de idempotência nova depois de um timeout. É exatamente o caso em que um segundo ato registral seria protocolado e pago.