Segurança
pública: Sinesp VDE.

Motivação

O Ministério da Justiça publica a base do Sinesp VDE em um xlsx por ano, de 20 MB e cerca de 600 mil linhas. Jornalistas, prefeituras, pesquisadores e empresas de seguro precisam do município, do mês e da comparação com o ano anterior sem abrir a planilha: o DataX faz a leitura, conserva a fonte e entrega o recorte por API e página.

Composição

Unidade

Evento em um município, em um mês, por abrangência (Estadual, Polícia Federal, Polícia Rodoviária Federal) e, quando existir, por agente, arma e faixa etária.

Campos

uf, municipio, evento, mes (AAAA-MM), agente, arma, faixa, fem, masc, ni (sexo da vítima), vitimas (total_vitima), total e abrangencia.

Valor do registro

Eventos com vítima (homicídio doloso, feminicídio, latrocínio etc.) trazem o número de vítimas; eventos sem vítima (mandados, apreensões, veículos) trazem o total registrado. Zero é omitido do estado: ausência vale 0.

Partição

Um arquivo por ano e UF (seguranca/sinesp-vde/{ANO}/{UF}.json) e um índice com o último mês de cada UF.

Cobertura: 27 UFs, mensal, de 2015 (carga histórica noturna) até o último mês publicado; a resposta informa o último mês e os anos disponíveis. Nem todo município informa todos os eventos.

Como é coletado

Fonte oficial

MJSP, página "Base de dados e notas metodológicas dos gestores estaduais (Sinesp VDE)" e arquivos bancovde-{ano}.xlsx em gov.br/mj.

Método

Coletor próprio (lib/sinesp-vde.ts) identificado no User-Agent como "PIRANOT-DataX/1.0". Lê a data "Atualizado em" da página e só baixa o ano corrente se ela mudou; ano fechado é baixado uma vez, com uma conferência final se a página mudar depois de 31/01 do ano seguinte. O xlsx é lido em streaming, sem planilha em memória. A API e a página leem só do estado.

Cadência

A fonte é mensal, com cerca de 1 mês de defasagem. A checagem roda todo dia às 05h30 e só baixa quando a página da fonte muda. Carga histórica 2015-2024: uma vez, de madrugada (01h-06h), retomável.

Orçamento de requisições

Por rodada: 1 (página) + 1 download por ano que precisa baixar; normalmente 1 por dia e, quando o MJSP publica, 2. No máximo 12 por dia; 1 por segundo; timeout de 120 s; 3 tentativas com backoff em 429 e 5xx. Recheque noturno: 1 download do ano corrente.

Túnel

Não há. Resposta 403 da fonte interrompe a coleta; o DataX não troca o User-Agent.

Pré-processamento e limpeza

• A data de referência (serial do Excel) vira o mês AAAA-MM: 1899-12-30 mais o número de dias.
• Linhas com total e total_vitima iguais a zero ou ausentes não são gravadas; células de sexo ausentes valem 0, mas total e total_vitima ausentes ficam nulos.
• O Distrito Federal publica várias linhas "Brasília" com a mesma chave; elas são somadas e a contagem fica no índice (mescladasDF). Fora do DF, chave repetida reprova o ano.
• Variação: percentual simples sobre o mesmo período do ano anterior; sem base (zero), não é calculada. Nenhum valor da fonte é alterado.

Checks de qualidade aplicados

• Esquema: cabeçalho exato do xlsx, UF conhecida, mês válido e do ano do arquivo; arquivo com sharedStrings é recusado.
• Cobertura: as 27 UFs presentes no ano corrente; nenhum mês futuro; nenhuma contagem negativa.
• Unicidade: chave (uf, município, evento, mês, agente, arma, faixa, abrangência) sem repetição fora do DF.
• Aviso: total_vitima menor que feminino+masculino+não informado é registrado, mas não bloqueia.
• Salto: em ano fechado, o homicídio doloso de uma UF não pode mudar mais de 25% contra a versão já servida; se mudar, o ano fica em quarentena e a última versão boa segue no ar.
• Verificação antes de publicar e recheque noturno: 5 registros do ano mais recente são conferidos contra um novo download da fonte; divergência vira correção com errata. Toda resposta informa o resumo qualidade.

Licença e usos

Licença

O site gov.br do MJSP está sob Creative Commons Atribuição-SemDerivações 3.0 (CC BY-ND 3.0). Citar "Sinesp VDE/MJSP" com link. Os valores são reproduzidos sem alteração; somas e variações são cálculos PIRANOT, identificados como tais.

Usos

Acompanhar a violência letal e os crimes patrimoniais de um município contra a UF e o Brasil, pautas e relatórios. Não é taxa por 100 mil habitantes nem comparação entre municípios de populações diferentes.

Limitações conhecidas

• Os números são os enviados pelos gestores estaduais; o DataX não audita os microdados.
• Estupro, roubo e furto de veículo e outros eventos vêm de poucos municípios; a ausência não prova que não ocorreu.
• O último mês pode ser revisado pelos estados; a revisão entra na coleta seguinte e vira errata.
• Município sem nenhuma ocorrência no período não aparece na lista, porque o estado não guarda zeros.

Distribuição

Metadados (DCAT / schema.org Dataset)

dct:identifier

sinesp-vde

dct:publisher

PIRANOT

dct:source

Sinesp VDE/MJSP

dct:license

CC BY-ND 3.0 (site gov.br)

dct:temporal

2015 ao último mês publicado

dct:spatial

Brasil, por UF e município

dct:accrualPeriodicity

mensal

dcat:distribution

JSON via API v1

Histórico de versões

Reportar erro

POST /api/v1/qualidade/reportar com dataset, chave_registro, valor_visto, valor_esperado e fonte_esperada (detalhes em /docs/qualidade). Correções confirmadas aparecem em /erratas. Sem chave, escreva para [email protected].

Aviso. O DataX PIRANOT organiza dados de fontes oficiais e pode conter erros ou atrasos. Confira na fonte oficial, indicada em cada dado, antes de qualquer decisão importante. Respostas geradas por IA podem errar.DataX PIRANOT organises data from official sources and may contain errors or delays. Check the official source, linked with each dataset, before any important decision. AI-generated answers can be wrong.