## SEFAZ / MS / IPVA Pesquisa dados de Imposto sobre Propriedades de Veículos Automotores (IPVA) no Estado de Mato Grosso do Sul (MS). ### URL do site - https://servicos.efazenda.ms.gov.br/ipvapublico/Home ### Requisição URL para POST: `https://api.infosimples.com/api/v2/consultas/sefaz/ms/ipva` | Parâmetro | Descrição | | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | token* | Chave de autenticação da API. É com o token que a API reconhece e autoriza quem está fazendo a consulta. | | placa* | Placa do veículo a ser consultado. | | renavam* | RENAVAM do veículo a ser consultado. | | numero_parcela** | Insira o número das parcelas que deseja gerar, sendo o valor de 1 até 5.
Exemplos:
| > * Parâmetro obrigatório. > ** Parâmetro opcional. Pode ser necessário informar algum dos parâmetros opcionais para que a consulta funcione adequadamente. ### Exemplos de respostas (OK) ```json { "code": 200, "code_message": "A requisição foi processada com sucesso.", "errors": [], "header": { "api_version": "v2", "api_version_full": "2.2.33-20260105120442", "product": "Consultas", "service": "sefaz/ms/ipva", "parameters": { "placa": "AAA1111", "renavam": "1111111111" }, "client_name": "Minha Empresa", "token_name": "Token de Produção", "billable": true, "price": "0.24", "requested_at": "2026-01-07T10:17:39.000-03:00", "elapsed_time_in_milliseconds": 240, "remote_ip": "111.111.111.111", "signature": "mHFUfrCd0/qtkuA629mG0NRIs88g44QFuAL3oWfSEX975HrLif4rBqItOoFCn+/gKMZkM0OJe33WeEN7DFcsT9TUsM7rZoyyglU1MA==" }, "data_count": 1, "data": [ { "ano": 2026, "daems": { "titulo": "210 - IPVA - Cota Única", "data_vencimento": "11/11/1111", "data_limite_pagamento": "11/11/1111", "total_debitos": "1", "ano_referencia": "2026", "parcela": "Cota Única", "valor_tributo": "1.111,11", "normalizado_valor_tributo": 1111.11, "valor_multa": "R$ 0,00", "normalizado_valor_multa": 0.0, "valor_juros": "R$ 0,00", "normalizado_valor_juros": 0.0, "valor_total": "R$ 3.099,63", "normalizado_valor_total": 3099.63, "numero_daems": "000000000000", "nome": "Exemplo de Nome", "codigo_tributo": "111", "vencimento": "08/01/2026", "referencia": "00/2026", "documento": "111111111", "valor_correcao_monetaria": "0,00", "normalizado_valor_correcao_monetaria": 0.0, "codigo_municipio": "35012-2 - SÃO PAULO", "reservado": "Exemplo de Reservado", "historico": "01/01/2001", "codigo_pix": "Exemplo de Codigo Pix", "codigo_barra": "123456789012345678901234567890123456789012345678", "renavam": "1111111111" }, "parcelas": [ { "parcela": "Cota Única", "vencimento": "08/01/2026", "valor_principal": "3.099,63", "normalizado_valor_principal": 3099.63, "valor_multa": "0,00", "normalizado_valor_multa": 0.0, "valor_juros": "0,00", "normalizado_valor_juros": 0.0, "valor_total": "3.099,63", "normalizado_valor_total": 3099.63 }, { "parcela": "1", "vencimento": "30/01/2026", "valor_principal": "729,34", "normalizado_valor_principal": 729.34, "valor_multa": "0,00", "normalizado_valor_multa": 0.0, "valor_juros": "0,00", "normalizado_valor_juros": 0.0, "valor_total": "729,34", "normalizado_valor_total": 729.34 }, { "parcela": "2", "vencimento": "27/02/2026", "valor_principal": "729,32", "normalizado_valor_principal": 729.32, "valor_multa": "0,00", "normalizado_valor_multa": 0.0, "valor_juros": "0,00", "normalizado_valor_juros": 0.0, "valor_total": "729,32", "normalizado_valor_total": 729.32 }, { "parcela": "3", "vencimento": "31/03/2026", "valor_principal": "729,32", "normalizado_valor_principal": 729.32, "valor_multa": "0,00", "normalizado_valor_multa": 0.0, "valor_juros": "0,00", "normalizado_valor_juros": 0.0, "valor_total": "729,32", "normalizado_valor_total": 729.32 }, { "parcela": "4", "vencimento": "30/04/2026", "valor_principal": "729,32", "normalizado_valor_principal": 729.32, "valor_multa": "0,00", "normalizado_valor_multa": 0.0, "valor_juros": "0,00", "normalizado_valor_juros": 0.0, "valor_total": "729,32", "normalizado_valor_total": 729.32 }, { "parcela": "5", "vencimento": "29/05/2026", "valor_principal": "729,32", "normalizado_valor_principal": 729.32, "valor_multa": "0,00", "normalizado_valor_multa": 0.0, "valor_juros": "0,00", "normalizado_valor_juros": 0.0, "valor_total": "729,32", "normalizado_valor_total": 729.32 } ], "placa": "AAA1111", "renavam": "1111111111", "site_receipt": "https://www.exemplo.com/exemplo-de-url" } ], "site_receipts": [ "https://www.exemplo.com/exemplo-de-url" ] } ``` ### Arquivo de visualização de consulta O arquivo de visualização de consulta (`site_receipts`) disponibilizado no retorno da API é **emitido pela fonte original**. ### Exemplos de códigos para integração com a API #### Python ```python # Testado com: Python 3.10.19, Python 3.14.0 import requests url = 'https://api.infosimples.com/api/v2/consultas/sefaz/ms/ipva' args = { "placa": "VALOR_DO_PARAMETRO_PLACA", "renavam": "VALOR_DO_PARAMETRO_RENAVAM", "numero_parcela": "VALOR_DO_PARAMETRO_NUMERO_PARCELA", "token": "INFORME_AQUI_O_TOKEN_DA_CHAVE_DE_ACESSO", "timeout": "300" } response = requests.post(url, args) response_json = response.json() response.close() if response_json['code'] == 200: print("Retorno com sucesso: ", response_json['data']) elif response_json['code'] in range(600, 799): mensagem = "Resultado sem sucesso. Leia para saber mais: \n" mensagem += "Código: {} ({})\n".format(response_json['code'], response_json['code_message']) mensagem += "; ".join(response_json['errors']) print(mensagem) print("Cabeçalho da consulta: ", response_json['header']) print("URLs com arquivos de visualização (HTML/PDF): ", response_json['site_receipts']) ``` ## Estamos prontos para ajudar Ainda tem alguma dúvida ou precisa de ajuda na sua integração? Entre em contato em [suporte@infosimples.com.br](mailto:suporte@infosimples.com.br) e receba ajuda da nossa equipe técnica altamente qualificada.