Os preços desta página são de tabela, sem assinatura — plano reduz o valor por consulta, e fonte de repasse cobra o emolumento da UF do alvo. O número que vale é o do POST /v1/orcamento/siam-processos-mg, calculado sobre o alvo real e sem cobrar.

Documentação

Secretaria de Estado de Meio Ambiente e Desenvolvimento Sustentável de Minas Gerais (SEMAD)

Processos ambientais — SIAM/MG

Processos ambientais de um CPF/CNPJ no SIAM de Minas Gerais, agrupados pelos cadastros de empreendedor.

Site oficial da fonte ↗
Em construção
POST /v1/consultas/siam-processos-mg v1

Tempo típico

não medido

A partir de

R$ 1,00

por consulta, varia por UF

Visão geral

Responde "o que este empreendedor tem no sistema ambiental de Minas": processos de licenciamento, autorizações e o andamento de cada um, no SIAM da SEMAD.

É a contraparte mineira da consulta de licenciamento da CETESB, e serve à mesma pergunta de due diligence: passivo ambiental não aparece em certidão de débito.

Origem pública e gratuita. O preço cobre a automação, o parsing e o arquivamento.

Antes de começar

1 crítico · 1 de atenção · 1 de contexto

Cada item aqui saiu de um caso real que custou dinheiro. Ler isto é mais barato do que descobrir depois.

Crítico

Um documento, vários cadastros — e um teto

O mesmo CNPJ costuma ter mais de um cadastro de empreendedor no SIAM: uma por unidade, por município, por época. A relação de cadastros vem COMPLETA sempre.

O detalhamento dos processos tem teto — acima dele o retorno é marcado como truncado, nunca silenciosamente cortado. É pausa e teto por educação com servidor público gratuito: é o que mantém a porta aberta.

Atenção

A origem busca por semelhança de texto

A consulta do portal casa substring, não igualdade de documento. Confira o cadastro devolvido antes de atribuir um processo ao seu alvo.

Contexto

Não é certidão

O SIAM não emite documento por esta via. O que volta é a leitura estruturada das telas públicas, com a data em que foi feita — serve para investigar e instruir.

Requisição

Autenticação por token no cabeçalho. Parâmetro obrigatório que falta é recusado antes de qualquer cobrança — não vira consulta paga que volta vazia.

cpf_cnpj string obrigatório

CPF (11 dígitos) ou CNPJ (14 dígitos) do empreendedor. Com ou sem máscara.

curl -X POST https://api.oficialdata.com.br/v1/consultas/siam-processos-mg \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "cpf_cnpj": "12345678000190"
}'

O HTTP é sempre 200 quando a requisição chegou. O resultado real está em code, no corpo — trate code, nunca o status.

Resposta

Dentro de data[]: 6 campos em 1 blocos.

6

Campo que a origem não informou volta null — nunca 0 nem string vazia. Um zero inventado vira "nada consta" num laudo.

data[] object
6 campos
status_consulta string

SUCESSO, NAO_ENCONTRADO ou INDISPONIVEL. Empreendedor sem processo é resposta, não falha.

total_empreendedores integer

Quantos cadastros de empreendedor a origem devolveu para o documento. Costuma ser mais de um: filial e matriz têm cadastros distintos.

total_processos integer

Soma dos processos de todos os cadastros lidos.

registros[] array

Uma entrada por processo: número, tipo, situação, município e o cadastro de empreendedor a que pertence.

mensagem string

Frase pronta para tela e laudo, já dizendo quando o detalhamento veio truncado.

consultado_em datetime

Quando consultamos a origem, em ISO-8601.

Códigos de erro

O mesmo mapa que o motor usa em produção. As colunas de estorno e retentativa fazem parte do contrato: nem toda falha devolve o dinheiro, e você tem direito de saber quais antes de integrar.

Classe Códigos 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

A pegadinha do estorno: erro_participante é a única classe que não devolve o dinheiro — nela a origem respondeu, recusando os dados do pedido. Falha nossa é fatal e sempre estorna.

Permanentes: 602 e 603 não se curam sozinhos — não vale retentar. A fonte sai do ar na hora e um humano é avisado.

Preço por UF

É emolumento de cartório, fixado por lei estadual. Orçar antes de disparar em lote não é boa prática, é requisito.

Mais barata

R$ 1,00

MG

Mediana

R$ 1,00

1 UFs vendáveis

Mais cara

R$ 1,00

MG — 1,0× a mais barata

Estes são os preços da sua conta. O valor é o emolumento do cartório mais a nossa margem, e a margem varia conforme o seu plano — planos maiores pagam menos por consulta.

MG

1,00

Limites e desempenho

Números medidos em produção. Onde está "não medido", é porque não medimos — e um número chutado aqui viraria SLA que ninguém verificou.

Tempo típico

não medido

p95

não medido

Teto por hora

Timeout máximo

De onde vem o tempo: dos ~s típicos, cerca de 85% é a origem varrendo os cartórios. Essa parte é intocável — não há otimização nossa que a reduza.

Sobre o teto: a origem exige sessão única por conta, então as corridas são serializadas. O número acima é o limite real de uma conta, não uma cota comercial. Volume acima disso exige combinar antes — não adianta paralelizar do seu lado.

Versionamento

O contrato de resposta é v1, e a versão viaja em header.api_version em toda resposta.

  • Campo novo opcional pode entrar a qualquer momento e não muda a versão. Seu parser precisa ignorar campo que não conhece.
  • Remover campo, renomear campo ou mudar tipo é versão nova, publicada em paralelo, com prazo de desligamento anunciado da anterior.
  • Nunca alteramos o significado de um campo existente mantendo o nome. Se o significado muda, o nome muda junto.

Quer ser dos primeiros a integrar?

A ordem de liberação segue a demanda real. Diga o volume que você espera e em quais UFs.

Falar com a gente →