Serviços de dados

Catálogo e schemas

Cada serviço tem um código (query), parâmetros e um schema Lanet de resposta em `dados`. Preços e limites da sua empresa aparecem na documentação da integração, no portal.

Entrega por webhook

Sem redirecionamentos: respostas 3xx são tratadas como falha

A Lanet não segue redirecionamentos ao entregar eventos ao seu endpoint: qualquer resposta 3xx conta como falha de entrega (entra na escada de retentativas — 1 min, 5 min, 30 min, 2 h e 12 h — e, após 24 h de falhas, o endpoint é marcado como failing). Responda 2xx diretamente na URL cadastrada, com https, host público e sem redirecionar para outra URL.

O mesmo vale para o evento integracao.verificacao: o desafio precisa ser respondido em 2xx na própria URL, em até 10 s.

query 10assíncrono (202 + callback/polling)

Débitos Veiculares — Consulta

Serviço 10 — Débitos Veiculares (consulta).

Parâmetros (ParametrosDebitos)

Campo	Tipo	Obrig.	Descrição e regras
placa	Placa	Sim
renavam	string	Sim	RENAVAM do veículo — exigido pela origem do serviço 10. padrão ^[0-9]{9,11}$
uf	string	Sim	UF de registro do veículo — exigida pela origem do serviço 10. padrão ^[A-Z]{2}$

Resposta (dados — DadosDebitos)

Campo	Tipo	Obrig.
veiculo	VeiculoBasico	Sim
debitos	array<object>	Sim
tipo string · obrigatório · ipva \| licenciamento \| multa \| dpvat \| outros descricao string · obrigatório valor_cents integer (int64) · obrigatório vencimento string \| null (date) exercicio integer \| null orgao string \| null referencia string \| null · Identificador do débito na origem (usado pelo serviço de quitação, quando disponível). pagavel boolean · obrigatório
total_cents	integer (int64)	Sim
quantidade	integer	Sim
consultado_em	string (date-time)	Sim

query 30síncrono (200/206 ou 202)

Consulta Veicular Completa

Serviço 30 — Consulta Veicular Completa.

Parâmetros (ParametrosPlaca)

Campo	Tipo	Obrig.	Descrição e regras
placa	Placa	Sim

Resposta (dados — DadosVeiculoCompleto)

Campo	Tipo	Obrig.	Descrição e regras
veiculo	VeiculoBasico+object	Sim
restricoes	array<object>	Sim
tipo string · obrigatório descricao string · obrigatório
gravame	object \| null	Sim
situacao string agente string \| null tipo string \| null data string \| null (date)
roubo_furto	object	Sim
indicio boolean · obrigatório ocorrencias array<object> · obrigatório data string \| null (date) descricao string
leilao	object	Sim
indicio boolean · obrigatório registros array<object> · obrigatório data string \| null (date) descricao string
sinistro	object	Sim
indicio boolean · obrigatório registros array<object> · obrigatório data string \| null (date) descricao string
historico	object	Sim
proprietarios integer \| null ultimo_licenciamento integer \| null · Exercício.
referencia_mercado	object \| null	Sim	Valor de referência de tabela de preços do modelo.
codigo string · Código de referência do modelo na tabela de preços. valor_cents integer (int64) mes_referencia string · ex.: "2026-09"
debitos_resumo	object \| null	Não	Resumo dos débitos informado pela base estadual no momento da consulta (valores de referência; para consulta detalhada/quitação use o serviço 10). Campo aditivo; `null` quando a origem não informa.
ipva_cents integer \| null (int64) licenciamento_cents integer \| null (int64) multas_cents integer \| null (int64) dpvat_cents integer \| null (int64) total_cents integer \| null (int64)
multas	array<object>	Não	Infrações registradas para o veículo (campo aditivo; lista vazia quando não há).
data string \| null (date) descricao string · obrigatório orgao string \| null uf string \| null valor_cents integer \| null (int64)

query 40síncrono (200/206 ou 202)

Proprietário Atual e Dados Cadastrais do Veículo

Serviço 40 — Proprietário Atual e Dados Cadastrais do Veículo.

Parâmetros (ParametrosPlaca)

Campo	Tipo	Obrig.	Descrição e regras
placa	Placa	Sim

Resposta (dados — DadosProprietario)

Campo	Tipo	Obrig.
veiculo	VeiculoBasico	Sim
proprietario	object \| null	Sim
nome string · obrigatório documento string · obrigatório · CPF/CNPJ conforme a origem (tratamento LGPD: base legal por requisição). tipo_pessoa string · obrigatório · fisica \| juridica municipio string \| null uf string \| null

query 70síncrono (200/206 ou 202)valor de referência de tabela de preços

Dados do Veículo + valor de referência de tabela de preços (leitura de placa)

Serviço 70 — Dados do Veículo + valor de referência de tabela de preços (leitura de placa). veiculo na forma estendida (decodificação) e referencia com a versão principal, todas as versões com histórico e os candidatos. Não inclui proprietário (serviço 40) nem ficha técnica (serviço 50).

O que o serviço 70 devolve

Consulta síncrona por placa: veiculo (decodificação do veículo — marca, modelo, versão, anos, motor, câmbio, combustível, procedência; pbt e capacidade_maxima_tracao vêm como a fonte os informa, sem unidade declarada) e referencia — o valor de referência de tabela de preços da versão identificada, com codigo_referencia, competencia (mês/ano da tabela), valor_referencia_cents e versoes[], cada uma com o historico[] mensal.

Quando a placa corresponde a mais de uma versão de referência e nenhuma casa com a decodificação, valor_referencia_cents vem null, versoes[] traz todas e observacao explica — a Lanet nunca escolhe um valor por você. Em formato=pdf, o laudo traz as seções “Dados do veículo” e “Valor de referência de tabela de preços” (com o histórico).

Exemplo: POST /v1/consultas

requisição do serviço 70

{
  "query": 70,
  "parametros": {
    "placa": "ABC1D23"
  }
}

Parâmetros (ParametrosPlaca)

Campo	Tipo	Obrig.	Descrição e regras
placa	Placa	Sim

Resposta (dados — DadosVeiculoReferencia)

Campo	Tipo	Obrig.	Descrição e regras
veiculo	VeiculoReferencia	Sim
referencia	ReferenciaTabelaPrecos	Sim

Bloco veiculo (VeiculoReferencia)

Identificação do veículo na forma estendida do serviço 70 (e do pacote 90): os campos de VeiculoBasico mais a decodificação. Tudo é o que a origem informa para a placa — campo sem informação vem null (renavam, municipio e uf não são devolvidos por este serviço). pbt e capacidade_maxima_tracao são propagados como a fonte os informa (a origem não declara a unidade — não assuma kg).

Campo	Tipo	Obrig.	Descrição e regras
placa	Placa	Sim
renavam	string \| null	Não
chassi	string \| null	Não
marca	string \| null	Não
modelo	string \| null	Não
versao	string \| null	Não
ano_fabricacao	integer \| null	Não
ano_modelo	integer \| null	Não
cor	string \| null	Não
combustivel	string \| null	Não
municipio	string \| null	Não
uf	string \| null	Não
tipo	string \| null	Não	Tipo do veículo (ex.: AUTOMOVEL).
especie	string \| null	Não	Espécie (ex.: PASSAGEIRO).
carroceria	string \| null	Não
portas	integer \| null	Não
eixos	integer \| null	Não
motor	object	Sim
potencia_cv number \| null · obrigatório cilindradas_cm3 integer \| null · obrigatório tipo string \| null · obrigatório numero string \| null · obrigatório · Número do motor, como a fonte informa.
cambio	string \| null	Não
tracao	string \| null	Não
pbt	integer \| null	Não	Peso bruto total conforme informado pela fonte (a origem não declara a unidade; não assuma kg).
capacidade_maxima_tracao	integer \| null	Não	Capacidade máxima de tração conforme informada pela fonte (mesma ressalva de unidade).
capacidade_passageiros	integer \| null	Não
capacidade_carga	integer \| null	Não
procedencia	string \| null	Não	`NACIONAL` ou `IMPORTADO`; quando a origem informa outra grafia, ela é devolvida em maiúsculas.
pais	string \| null	Não
local_fabricacao	string \| null	Não
categoria	string \| null	Não

Bloco referencia (ReferenciaTabelaPrecos)

Valor de referência de tabela de preços do modelo. A versão principal é a que casa com a decodificação do veículo; com uma única versão, é ela. Quando há mais de uma versão e nenhuma casa, codigo_referencia, competencia e valor_referencia_cents vêm null, versoes[] vem completa e observacao explica — a Lanet nunca escolhe uma versão por você. null quando a origem não tem nenhuma versão nem candidato para a placa.

Campo	Tipo	Obrig.	Descrição e regras
codigo_referencia	string \| null	Sim	Código de referência do modelo na tabela de preços (versão principal), no formato em que a fonte o informa.
competencia	string \| null	Sim	Mês/ano de referência da tabela (`AAAA-MM`) do valor principal — o último mês observado do histórico. padrão ^[0-9]{4}-(0[1-9]\|1[0-2])$ · ex.: "2026-08"
valor_referencia_cents	integer \| null (int64)	Sim	Valor de referência da versão principal, em centavos.
observacao	string \| null	Sim	Só quando não há valor principal: `mais de uma versão de referência para a placa` ou `sem valor de referência de tabela de preços para a placa`.
versoes	array<object>	Sim	Todas as versões da tabela de preços associadas à placa (a principal inclusive), cada uma com o histórico mensal.
codigo_referencia string · obrigatório marca string \| null · obrigatório modelo string \| null · obrigatório versao string \| null · obrigatório combustivel string \| null · obrigatório ano_modelo integer \| null · obrigatório valor_cents integer \| null (int64) · obrigatório · Valor atual da versão, em centavos. historico array<object> · obrigatório · Valores por mês, na ordem da tabela (do mais antigo ao mais recente). competencia string · obrigatório · padrão ^[0-9]{4}-(0[1-9]\|1[0-2])$ · ex.: "2026-08" valor_cents integer (int64) · obrigatório previsto boolean · obrigatório · `true` = valor projetado pela tabela (não observado).
candidatos	array<object>	Sim	Versões decodificadas para a placa (sem valor) — úteis para conferir a escolha da versão principal.
codigo_referencia string · obrigatório marca string \| null · obrigatório modelo string \| null · obrigatório versao string \| null · obrigatório

Dados do veículo — como a resposta é lida

Veículo: MARCA EXEMPLO MODELO EXEMPLO 1.0 DRIVE 1.0 6V FLEX
Placa: ABC1D23
Ano de fabricação/modelo: 2020/2021
Combustível · cor: FLEX · BRANCA
Motor: 77 cv · 999 cm³
Número do motor: MTR0004321
Câmbio · tração: manual · dianteira
Peso bruto total (PBT): 1.450 — conforme informado pela fonte
Capacidade máxima de tração: 1.450 — conforme informado pela fonte
Passageiros: 5
Procedência: NACIONAL

pbt e capacidade_maxima_tracao são propagados como a fonte os informa — a origem não declara a unidade; não assuma quilogramas.

Valor de referência de tabela de preços — como a resposta é lida

Competência da tabela: agosto de 2026
Código de referência: 001523-4
Valor de referência: R$ 68.900,00

Marca Exemplo Modelo Exemplo DRIVE 1.0 6V FLEX · 2021 · FLEX 001523-4 · R$ 68.900,00

Histórico mensal do valor de referência (`versoes[].historico[]`). Competências marcadas como previstas ainda não fecharam.
Competência	Valor de referência	Situação
junho de 2026	R$ 69.310,00	apurado
julho de 2026	R$ 69.040,00	apurado
agosto de 2026	R$ 68.900,00	apurado
setembro de 2026	R$ 68.750,00	previsto

Exemplo: consulta do serviço 70 concluída

200 OK

{
  "id": "01J9Z4A0V5K0Y9Q0Z6X7K8M2R3",
  "query": 70,
  "servico": "Dados do Veículo + valor de referência de tabela de preços (leitura de placa)",
  "status": "concluida",
  "modo": "live",
  "formato": "json",
  "parametros": {
    "placa": "ABC1D23"
  },
  "encontrado": true,
  "dados": {
    "veiculo": {
      "placa": "ABC1D23",
      "renavam": null,
      "chassi": "9BD00000000000000",
      "marca": "MARCA EXEMPLO",
      "modelo": "MODELO EXEMPLO 1.0",
      "versao": "DRIVE 1.0 6V FLEX",
      "ano_fabricacao": 2020,
      "ano_modelo": 2021,
      "cor": "BRANCA",
      "combustivel": "FLEX",
      "municipio": null,
      "uf": null,
      "tipo": "AUTOMOVEL",
      "especie": "PASSAGEIRO",
      "carroceria": "HATCH",
      "portas": 4,
      "eixos": 2,
      "motor": {
        "potencia_cv": 77,
        "cilindradas_cm3": 999,
        "tipo": "3 cilindros em linha",
        "numero": "MTR0004321"
      },
      "cambio": "manual",
      "tracao": "dianteira",
      "pbt": 1450,
      "capacidade_maxima_tracao": 1450,
      "capacidade_passageiros": 5,
      "capacidade_carga": null,
      "procedencia": "NACIONAL",
      "pais": "BRASIL",
      "local_fabricacao": "Betim / MG",
      "categoria": "PARTICULAR"
    },
    "referencia": {
      "codigo_referencia": "001523-4",
      "competencia": "2026-08",
      "valor_referencia_cents": 6890000,
      "observacao": null,
      "versoes": [
        {
          "codigo_referencia": "001523-4",
          "marca": "Marca Exemplo",
          "modelo": "Modelo Exemplo",
          "versao": "DRIVE 1.0 6V FLEX",
          "combustivel": "FLEX",
          "ano_modelo": 2021,
          "valor_cents": 6890000,
          "historico": [
            {
              "competencia": "2026-06",
              "valor_cents": 6931000,
              "previsto": false
            },
            {
              "competencia": "2026-07",
              "valor_cents": 6904000,
              "previsto": false
            },
            {
              "competencia": "2026-08",
              "valor_cents": 6890000,
              "previsto": false
            },
            {
              "competencia": "2026-09",
              "valor_cents": 6875000,
              "previsto": true
            }
          ]
        }
      ],
      "candidatos": [
        {
          "codigo_referencia": "001523-4",
          "marca": "Marca Exemplo",
          "modelo": "Modelo Exemplo 4P (2020 => 2023)",
          "versao": "Drive 1.0 6v Flex"
        }
      ]
    }
  },
  "secoes_indisponiveis": [],
  "laudo": null,
  "erro": null,
  "cobrada": true,
  "criada_em": "2026-09-11T12:10:00.100Z",
  "concluida_em": "2026-09-11T12:10:09.900Z",
  "request_id": "01J9Z4A0V5K0Y9Q0Z6X7K8M2R3"
}

query 50síncrono (200/206 ou 202)

Ficha Técnica do Veículo

Serviço 50 — Ficha Técnica do Veículo.

Parâmetros (ParametrosPlaca)

Campo	Tipo	Obrig.	Descrição e regras
placa	Placa	Sim

Resposta (dados — DadosFichaTecnica)

Campo	Tipo	Obrig.
veiculo	VeiculoBasico	Sim
ficha_tecnica	object	Sim
motor object cilindradas_cm3 integer \| null potencia_cv number \| null torque_kgfm number \| null cilindros integer \| null valvulas integer \| null alimentacao string \| null combustivel string \| null cambio object tipo string \| null marchas integer \| null tracao string \| null carroceria object tipo string \| null portas integer \| null lugares integer \| null dimensoes_mm object comprimento integer \| null largura integer \| null altura integer \| null entre_eixos integer \| null peso_kg integer \| null tanque_litros integer \| null porta_malas_litros integer \| null desempenho object \| null velocidade_maxima_kmh integer \| null aceleracao_0_100_s number \| null consumo_kml object \| null urbano number \| null rodoviario number \| null
equipamentos	array<string>	Sim

query 90síncrono (200/206 ou 202)pacote 70 + 50valor de referência de tabela de preços

Dados do Veículo + Ficha Técnica + Valor de Referência de Tabela de Preços

Serviço 90 — pacote 70 + 50 (1.7.0-m5b; até 1.6.0-m5b era 40 + 50 e trazia proprietario): as seções do 70 (veiculo estendido, referencia) e as do 50 (ficha_tecnica, equipamentos) em um único objeto, obtidas por duas consultas na origem de dados e cobradas como uma requisição. veiculo é a identificação unida das duas partes: a decodificação do 70 prevalece e o 50 preenche o que só ele traz. Os blocos são exatamente os mesmos dos serviços 70 e 50 — o que você já consome deles vale aqui sem alteração. O proprietário atual é exclusivo do serviço 40.

Como o pacote é cobrado e o que acontece se uma parte falhar

Uma requisição sua vira duas consultas na origem de dados, feitas em paralelo, e é cobrada como uma só: o preço do serviço 90 no seu contrato — não a soma do 70 com o 50.

As duas partes são obrigatórias: se qualquer uma delas falhar, a consulta inteira termina como falhou e não é cobrada. Se uma parte concluir sem encontrar registro para a placa, a resposta é 206 com a seção em secoes_indisponiveis — e é cobrada, como em qualquer parcial.

Em formato=pdf, o laudo traz as seções dos dois serviços em um documento só.

O pacote inclui o valor de referência de tabela de preços: a seção referencia vem do serviço 70 (com competencia, codigo_referencia, valor_referencia_cents e o histórico), e ficha_tecnica + equipamentos vêm do serviço 50. O pacote não traz proprietario — para o proprietário atual, use o serviço 40.

Exemplo: POST /v1/consultas

requisição do pacote

{
  "query": 90,
  "parametros": {
    "placa": "ABC1D23"
  }
}

Parâmetros (ParametrosPlaca)

Campo	Tipo	Obrig.	Descrição e regras
placa	Placa	Sim

Resposta (dados — DadosPacoteVeiculo)

Campo	Tipo	Obrig.
veiculo	VeiculoBasico	Sim
referencia	ReferenciaTabelaPrecos	Sim
ficha_tecnica	object	Sim
motor object cilindradas_cm3 integer \| null potencia_cv number \| null torque_kgfm number \| null cilindros integer \| null valvulas integer \| null alimentacao string \| null combustivel string \| null cambio object tipo string \| null marchas integer \| null tracao string \| null carroceria object tipo string \| null portas integer \| null lugares integer \| null dimensoes_mm object comprimento integer \| null largura integer \| null altura integer \| null entre_eixos integer \| null peso_kg integer \| null tanque_litros integer \| null porta_malas_litros integer \| null desempenho object \| null velocidade_maxima_kmh integer \| null aceleracao_0_100_s number \| null consumo_kml object \| null urbano number \| null rodoviario number \| null
equipamentos	array<string>	Sim

Dados do veículo — como a resposta é lida

Veículo: MARCA EXEMPLO MODELO EXEMPLO 1.0 DRIVE 1.0 6V FLEX
Placa: ABC1D23
Ano de fabricação/modelo: 2020/2021
Combustível · cor: FLEX · BRANCA
Motor: 77 cv · 999 cm³
Número do motor: MTR0004321
Câmbio · tração: manual · dianteira
Peso bruto total (PBT): 1.450 — conforme informado pela fonte
Capacidade máxima de tração: 1.450 — conforme informado pela fonte
Passageiros: 5
Procedência: NACIONAL

pbt e capacidade_maxima_tracao são propagados como a fonte os informa — a origem não declara a unidade; não assuma quilogramas.

Valor de referência de tabela de preços — como a resposta é lida

Competência da tabela: agosto de 2026
Código de referência: 001523-4
Valor de referência: R$ 68.900,00

Marca Exemplo Modelo Exemplo DRIVE 1.0 6V FLEX · 2021 · FLEX 001523-4 · R$ 68.900,00

Histórico mensal do valor de referência (`versoes[].historico[]`). Competências marcadas como previstas ainda não fecharam.
Competência	Valor de referência	Situação
julho de 2026	R$ 69.040,00	apurado
agosto de 2026	R$ 68.900,00	apurado

Exemplo: consulta do pacote concluída

200 OK

{
  "id": "01J9Z4A0V5K0Y9Q0Z6X7K8M2R2",
  "query": 90,
  "servico": "Dados do Veículo + Ficha Técnica + Valor de Referência de Tabela de Preços",
  "status": "concluida",
  "modo": "live",
  "formato": "json",
  "parametros": {
    "placa": "ABC1D23"
  },
  "encontrado": true,
  "dados": {
    "veiculo": {
      "placa": "ABC1D23",
      "renavam": null,
      "chassi": "9BD00000000000000",
      "marca": "MARCA EXEMPLO",
      "modelo": "MODELO EXEMPLO 1.0",
      "versao": "DRIVE 1.0 6V FLEX",
      "ano_fabricacao": 2020,
      "ano_modelo": 2021,
      "cor": "BRANCA",
      "combustivel": "FLEX",
      "municipio": null,
      "uf": null,
      "tipo": "AUTOMOVEL",
      "especie": "PASSAGEIRO",
      "carroceria": "HATCH",
      "portas": 4,
      "eixos": 2,
      "motor": {
        "potencia_cv": 77,
        "cilindradas_cm3": 999,
        "tipo": "3 cilindros em linha",
        "numero": "MTR0004321"
      },
      "cambio": "manual",
      "tracao": "dianteira",
      "pbt": 1450,
      "capacidade_maxima_tracao": 1450,
      "capacidade_passageiros": 5,
      "capacidade_carga": null,
      "procedencia": "NACIONAL",
      "pais": "BRASIL",
      "local_fabricacao": "Betim / MG",
      "categoria": "PARTICULAR"
    },
    "referencia": {
      "codigo_referencia": "001523-4",
      "competencia": "2026-08",
      "valor_referencia_cents": 6890000,
      "observacao": null,
      "versoes": [
        {
          "codigo_referencia": "001523-4",
          "marca": "Marca Exemplo",
          "modelo": "Modelo Exemplo",
          "versao": "DRIVE 1.0 6V FLEX",
          "combustivel": "FLEX",
          "ano_modelo": 2021,
          "valor_cents": 6890000,
          "historico": [
            {
              "competencia": "2026-07",
              "valor_cents": 6904000,
              "previsto": false
            },
            {
              "competencia": "2026-08",
              "valor_cents": 6890000,
              "previsto": false
            }
          ]
        }
      ],
      "candidatos": [
        {
          "codigo_referencia": "001523-4",
          "marca": "Marca Exemplo",
          "modelo": "Modelo Exemplo 4P (2020 => 2023)",
          "versao": "Drive 1.0 6v Flex"
        }
      ]
    },
    "ficha_tecnica": {
      "motor": {
        "cilindradas_cm3": 999,
        "potencia_cv": 77,
        "torque_kgfm": 10.9,
        "cilindros": 3,
        "valvulas": 12,
        "alimentacao": "injeção eletrônica",
        "combustivel": "FLEX"
      },
      "cambio": {
        "tipo": "Manual",
        "marchas": 5
      },
      "tracao": "Dianteira",
      "carroceria": {
        "tipo": "Hatch",
        "portas": 4,
        "lugares": 5
      },
      "dimensoes_mm": {
        "comprimento": 3998,
        "largura": 1724,
        "altura": 1507,
        "entre_eixos": 2521
      },
      "peso_kg": 1035,
      "tanque_litros": 48,
      "porta_malas_litros": 300,
      "desempenho": {
        "velocidade_maxima_kmh": 168,
        "aceleracao_0_100_s": 13.1
      },
      "consumo_kml": {
        "urbano": 9.4,
        "rodoviario": 10.6
      }
    },
    "equipamentos": [
      "ar-condicionado",
      "direção elétrica",
      "airbag duplo",
      "freios ABS"
    ]
  },
  "secoes_indisponiveis": [],
  "laudo": null,
  "erro": null,
  "cobrada": true,
  "criada_em": "2026-09-10T12:10:00.100Z",
  "concluida_em": "2026-09-10T12:10:09.900Z",
  "request_id": "01J9Z4A0V5K0Y9Q0Z6X7K8M2R2"
}

serviço 60por evento (assinatura) · xlsx

Arquivo de Tabela de Preços (assinatura)

Arquivo mensal publicado (formato Lanet .xlsx).

Endpoints da assinatura

Método	Caminho	Resumo
GET	/v1/files	Arquivos mensais publicados (Arquivo de Tabela de Preços — assinatura)
GET	/v1/files/{file_id}	Download do arquivo — redireciona para uma URL temporária (5 min)

Download

Responde `302` com Location = URL temporária de download, válida por 5 minutos, sem corpo. Siga o redirecionamento com GET sem reenviar os headers de autenticação Lanet (a URL já está assinada; muitos clientes HTTP fazem isso automaticamente — desligue o reenvio de Authorization no redirecionamento) e confira o sha256 do arquivo recebido com o valor informado no evento ou em GET /v1/files.

Exige assinatura ativa do serviço 60 (403 LAN-403-SERVICE-DISABLED caso contrário — verificado antes de procurar o arquivo). Arquivo inexistente, não publicado ou rejeitado → 404 LAN-404-FILE. Versões substituido continuam baixáveis. Cada chamada gera um registro de download (rastreio/auditoria) e uma linha de uso com valor 0 — o Arquivo de Tabela de Preços é um item fixo mensal da assinatura, nunca cobrado por download.

Evento (dados — EventoArquivoTabelaPrecos)

dados dos eventos arquivo_tabela_precos.disponivel (primeira versão publicada do mês) e arquivo_tabela_precos.atualizado (nova versão do mesmo mês). Não contém URL de download: baixe por GET /v1/files/{file_id} (HMAC + allowlist).

Campo	Tipo	Obrig.	Descrição e regras
tipo	string	Sim	arquivo_tabela_precos.disponivel \| arquivo_tabela_precos.atualizado
arquivo	object	Sim
id Ulid · obrigatório mes_referencia MesReferencia · obrigatório versao integer · obrigatório · intervalo 1–∞ nome string · obrigatório · ex.: "lanet-tabela-precos-2026-08-v1.xlsx" tamanho_bytes integer (int64) · obrigatório sha256 string · obrigatório · padrão ^[0-9a-f]{64}$ sha256_tabela Sha256Tabela codigo_verificacao CodigoVerificacao linhas integer · obrigatório publicado_em string (date-time) · obrigatório
download	ArquivoTabelaPrecosDownload	Sim

Arquivo (ArquivoTabelaPrecos)

Campo	Tipo	Obrig.	Descrição e regras
id	Ulid	Sim
mes_referencia	MesReferencia	Sim
versao	integer	Sim	Versão dentro do mês (republicações incrementam). intervalo 1–∞
status	string	Sim	`publicado` = versão vigente do mês; `substituido` = há versão mais nova (o arquivo continua disponível). publicado \| substituido
nome	string	Sim	ex.: "lanet-tabela-precos-2026-08-v1.xlsx"
tamanho_bytes	integer (int64)	Sim
sha256	string	Sim	SHA-256 (hex) do arquivo `.xlsx` — confira após o download. padrão ^[0-9a-f]{64}$
sha256_tabela	Sha256Tabela	Não
codigo_verificacao	CodigoVerificacao	Não
linhas	integer	Sim	Linhas de dados na aba Tabela.
publicado_em	string (date-time)	Sim
download	ArquivoTabelaPrecosDownload	Sim

Como baixar (ArquivoTabelaPrecosDownload)

Campo	Tipo	Obrig.	Descrição e regras
metodo	string	Sim	= GET
caminho	string	Sim	Caminho de `GET /v1/files/{file_id}` (responde `302` para a URL temporária). ex.: "/v1/files/01J9Z8A0V5K0Y9Q0Z6X7K8M2F0"
validade_link	string	Sim	Validade da URL temporária devolvida em `Location`. = 5 min

Integridade — como conferir o arquivo

Três valores acompanham cada arquivo (lista, evento e headers do 302): sha256 (bytes do .xlsx), sha256_tabela (dados da aba Tabela) e codigo_verificacao (prova de origem emitida pela Lanet).

sha256_tabela

string | null — SHA-256 (hex) do conteúdo da aba Tabela — o mesmo valor impresso em *Metadados › SHA-256 da Tabela*. Permite conferir os dados independentemente do arquivo .xlsx (que muda de bytes a cada geração). Algoritmo, exatamente como implementado: para cada linha de dados da Tabela, na ordem do arquivo (sem a linha de cabeçalho), as 8 colunas na ordem Tipo, Marca, Modelo, Ano-modelo, Combustível, Código de referência, Preço (R$), Mês de referência, separadas por TAB (\t) e terminadas por \n (também na última linha); texto em UTF-8 sem BOM; Ano-modelo como está na célula (Zero km ou o ano, ex.: 2024); Preço (R$) como número com duas casas decimais e ponto, sem separador de milhar (ex.: 45690.00); Mês de referência como YYYY-MM. Ou seja: sha256(concat(linha_i + "\n")) com linha_i = tipo\tmarca\tmodelo\tano\tcombustivel\tcodigo\tpreco\tmes. null só em arquivos publicados antes deste campo existir. padrão ^[0-9a-f]{64}$

codigo_verificacao

string | null — Código de verificação emitido pela Lanet (o mesmo de *Metadados › Código de verificação*): derivado por HMAC do identificador do arquivo e do SHA-256 da Tabela com uma chave que só a Lanet possui — não é recomputável pelo cliente; serve para conferir com a Lanet (suporte ou a futura página pública de verificação) que um arquivo recebido de terceiros é autêntico. Confira sha256 (arquivo) e sha256_tabela (dados) você mesmo; o código é a prova de origem. null só em arquivos publicados antes deste campo existir. padrão ^[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{4}$ · ex.: "14A2-68DC-75F4"

Exemplo: evento entregue ao webhook

arquivo_tabela_precos.disponivel

{
  "id": "01J9Z8B0V5K0Y9Q0Z6X7K8M2S1",
  "tipo": "arquivo_tabela_precos.disponivel",
  "criado_em": "2026-09-08T18:00:00.000Z",
  "dados": {
    "tipo": "arquivo_tabela_precos.disponivel",
    "arquivo": {
      "id": "01J9Z8A0V5K0Y9Q0Z6X7K8M2F0",
      "mes_referencia": "2026-08",
      "versao": 1,
      "nome": "lanet-tabela-precos-2026-08-v1.xlsx",
      "tamanho_bytes": 1843201,
      "sha256": "9f2c1e8d7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f2e1d0c9b8a7f6e5d4c3b2a1f0e",
      "linhas": 50824,
      "publicado_em": "2026-09-08T18:00:00.000Z"
    },
    "download": {
      "metodo": "GET",
      "caminho": "/v1/files/01J9Z8A0V5K0Y9Q0Z6X7K8M2F0",
      "validade_link": "5 min"
    }
  },
  "entrega": {
    "status": "entregue",
    "tentativas": 1,
    "ultima_tentativa_em": "2026-09-08T18:00:02.000Z",
    "proxima_tentativa_em": null
  }
}

Exemplo: GET /v1/files?mes=2026-08

200 OK

{
  "items": [
    {
      "id": "01J9Z8A0V5K0Y9Q0Z6X7K8M2F1",
      "mes_referencia": "2026-08",
      "versao": 2,
      "status": "publicado",
      "nome": "lanet-tabela-precos-2026-08-v2.xlsx",
      "tamanho_bytes": 1843377,
      "sha256": "1a2b3c4d5e6f708192a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5d6e7f809",
      "sha256_tabela": "7c6880103f2e1d0c9b8a7f6e5d4c3b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c",
      "codigo_verificacao": "14A2-68DC-75F4",
      "linhas": 50824,
      "publicado_em": "2026-09-09T12:30:00.000Z",
      "download": {
        "metodo": "GET",
        "caminho": "/v1/files/01J9Z8A0V5K0Y9Q0Z6X7K8M2F1",
        "validade_link": "5 min"
      }
    },
    {
      "id": "01J9Z8A0V5K0Y9Q0Z6X7K8M2F0",
      "mes_referencia": "2026-08",
      "versao": 1,
      "status": "substituido",
      "nome": "lanet-tabela-precos-2026-08-v1.xlsx",
      "tamanho_bytes": 1843201,
      "sha256": "9f2c1e8d7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f2e1d0c9b8a7f6e5d4c3b2a1f0e",
      "sha256_tabela": "3b9a0c1d2e3f405162738495a6b7c8d9e0f1a2b3c4d5e6f708192a3b4c5d6e7f",
      "codigo_verificacao": "9C0D-1E2F-3A4B",
      "linhas": 50824,
      "publicado_em": "2026-09-08T18:00:00.000Z",
      "download": {
        "metodo": "GET",
        "caminho": "/v1/files/01J9Z8A0V5K0Y9Q0Z6X7K8M2F0",
        "validade_link": "5 min"
      }
    }
  ],
  "next_cursor": null
}

VeiculoBasico

Bloco comum de identificação do veículo presente em todos os serviços.

Campo	Tipo	Obrig.
placa	Placa	Sim
renavam	string \| null	Não
chassi	string \| null	Não
marca	string \| null	Não
modelo	string \| null	Não
versao	string \| null	Não
ano_fabricacao	integer \| null	Não
ano_modelo	integer \| null	Não
cor	string \| null	Não
combustivel	string \| null	Não
municipio	string \| null	Não
uf	string \| null	Não

Exemplo: consulta assíncrona em processamento (202)

202 Accepted

{
  "id": "01J9Z4A0V5K0Y9Q0Z6X7K8M2R1",
  "query": 10,
  "servico": "Débitos Veiculares — Consulta",
  "status": "processando",
  "modo": "live",
  "formato": "json",
  "parametros": {
    "placa": "ABC1D23",
    "renavam": "00123456789",
    "uf": "SC"
  },
  "encontrado": null,
  "dados": null,
  "secoes_indisponiveis": [],
  "laudo": null,
  "erro": null,
  "cobrada": false,
  "criada_em": "2026-09-07T20:59:10.512Z",
  "concluida_em": null,
  "request_id": "01J9Z4A0V5K0Y9Q0Z6X7K8M2R1"
}