Prefeitura SP - Certidão de Dados Cadastrais do Imóvel - IPTU

O que é

 

Sobre a requisição:

Método: POST

Endereço: URL Base + /api/maestro/prefeitura-sp/certidao-dados-cadastrais-imovel-iptu

URL Base:

Parâmetros do header

Nome

Tipo

Obrigatório?

Descrição

Nome

Tipo

Obrigatório?

Descrição

Authorization

String

Sim

Chave de API gerada no cadastro no Plexi, prefixada com Bearer

Callback

String

Não

URL para onde o resultado da requisição será enviado via HTTP POST.

Parâmetros do body

Nome

Tipo

Obrigatório?

Descrição

Nome

Tipo

Obrigatório?

Descrição

cpfCnpj

string

Sim

CPF ou CNPJ de login

senha

string

Sim

Senha para login

sql

string

Sim

Número do cadastro do imóvel (também chamado de número do contribuinte ou SQL)

anoExercicio

string

Sim

Ano de exercício do IPTU

 

Estrutura da resposta

Status

Significado

Descrição

Informações retornadas

Status

Significado

Descrição

Informações retornadas

201

Created

Solicitação criada

Campo requestId, com o ID da requisição criada.

422

Unprocessable Entity

A solicitação contém erro

Em quais campos houve erro.

Exemplos de retornos quando você faz a requisição:

Status 201

Status 422

Exemplos de retornos do resultado da pesquisa

Valores possíveis do campo “status“

Status

Significado

Status

Significado

cadastrado

Imóvel encontrado

erro

Erro ao buscar informações, seja por SQL inválido ou outro dado incorreto

 

Respostas com registro encontrado

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 { "status": "cadastrado", "dataEmissao": "30/08/2021", "dataValidade": "28/11/2021", "numeroDocumento": "1.2021.002912714-1", "solicitante": "FULANO DA SILVA (CPF 99.999.999-99)", "localImovel": { "endereco": "R DA CONSOLACAO, 9999 - /9999", "cep": "99999-999" }, "enderecoEntregaNotificacao": { "endereco": "R DA CONSOLACAO, 9999 - 20 ANDAR SALA 99 AGUA BRANCA SAO PAULO SP", "cep": "99999-999" }, "contribuintes": [ { "cpfCnpj": "99.999.999/9999-99", "nome": "CONSTRUTORA ANDALUZIA LTDA." }, { "cpfCnpj": "99.999.999-99", "nome": "FULANO DA SILVA" } ], "dadosCadastraisTerreno": { "areaIncorporada": 171, "areaNaoIncorporada": 0, "areaTotal": 171, "testada": "7,39", "fracaoIdeal": "1,0000" }, "dadosCadastraisConstrucao": { "mensagem": "Terreno sem construção", "dados": null }, "valoresMetroQuadrado": { "terreno": 7417, "construcao": 0 }, "valoresCalculoIPTU": { "areaIncorporada": 1268307, "areaNaoIncorporada": 0, "construcao": 0, "baseCalculoIPTU": 1268307 }, "pdf": "JVBERi0xLjQKMSAwIG9iago8..." }
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 { "status": "cadastrado", "dataEmissao": "30/08/2021", "dataValidade": "28/11/2021", "numeroDocumento": "1.2021.002912719-1", "solicitante": "FULANO DA SILVA (CPF 99.999.999-99)", "localImovel": { "endereco": "R DA CONSOLACAO, 9999 - /9999 E 9999", "cep": "99999-999" }, "enderecoEntregaNotificacao": { "endereco": "AVENIDA BRASIL, 9999 - TORRE TORINO 20A AGUA BRANCA SAO PAULO", "cep": "99999-999" }, "contribuintes": [ { "cpfCnpj": "999.999.999-99", "nome": "FULANO DA SILVA" } ], "dadosCadastraisTerreno": { "areaIncorporada": 191, "areaNaoIncorporada": 0, "areaTotal": 191, "testada": "22,70", "fracaoIdeal": "1,0000" }, "dadosCadastraisConstrucao": { "mensagem": "", "dados": { "areaConstruida": 250, "areaOcupadaConstrucao": 190, "anoConstrucaoCorrigido": 1970, "uso": "comercial", "padraoConstrucao": "3-B" } }, "valoresMetroQuadrado": { "terreno": 7417, "construcao": 1726 }, "valoresCalculoIPTU": { "areaIncorporada": 1001712, "areaNaoIncorporada": 0, "construcao": 159655, "baseCalculoIPTU": 1161367 }, "pdf": "JVBERi0xLjQKMSAwIG9iago8..." }

 

Resposta com erro

1 2 3 4 5 { "status": "erro", "mensagem": "Notificações de Lançamento inexistentes para os dados informados", "pdf": "JVBERi0xLjQKMSAwIG9iago8..." }
1 2 3 4 5 { "status": "erro", "mensagem": "Número do cadastro do imóvel inválido", "pdf": "JVBERi0xLjQKMSAwIG9iago8..." }
1 2 3 4 5 { "status": "erro", "mensagem": "Não é possível gerar o documento. Verifique o Número do Cadastro do Imóvel.", "pdf": "JVBERi0xLjQKMSAwIG9iago8..." }