Prefeitura de São Paulo
Prefeitura de São Paulo — Valor de Referência
Valor Venal de Referência (base de cálculo do ITBI) de um imóvel de São Paulo.
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
- pref_sp_valor_referencia
- Preço
- R$ 1,00
- Aceita
- CPF/CNPJ + imóvel
- Esfera
- Municipais
- 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. |
| sql | Sim | Número do SQL do imóvel na Prefeitura de São Paulo (11 dígitos). |
Antes de integrar
Ressalvas sobre o que esta consulta é — e o que ela não é.
- Exige SQL Exige o SQL do imóvel (11 dígitos); não atesta regularidade.
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