Dados abertos

Os dados, para fazer as suas contas.

Tudo o que este site mostra pode ser descarregado em CSV ou lido pela API pública, com a ligação ao documento original em cada registo. Esta página descreve os campos, os formatos, a data de extração, a licença e a forma de citar.

Última recolha concluída: 12 nov 2026, 17:39 (hora de Lisboa). A data de cada fonte está em Fontes.

Ficheiro CSV

Em Contratos, o botão «Exportar CSV» descarrega os registos que correspondem aos filtros ativos. Sem filtros, o ficheiro contém todos os registos publicados.

Codificação UTF-8, separador vírgula, todos os campos entre aspas.
Datas em AAAA-MM-DD; valores em euros, arredondados ao euro, sem separador de milhares.
Um campo vazio significa que a fonte não indica esse dado. Nunca é um zero.
Um texto que comece por =, +, - ou @ leva um apóstrofo à frente, para a folha de cálculo não o executar como fórmula.
O nome do ficheiro e a coluna data_extracao registam quando a exportação foi feita.

Colunas do ficheiro CSV
Campo	Formato	O que é
`id`	texto	Identificador curto do registo neste site (8 primeiros caracteres do identificador completo).
`titulo`	texto	Título ou objeto do registo, com a capitalização e os separadores uniformizados pelo site.
`titulo_original`	texto	O mesmo título, tal como a fonte o escreveu.
`entidade`	texto	Adjudicatário. Vazio quando a fonte não o indica ou quando o registo não é de contratação.
`valor`	euros, inteiro	Valor mostrado na lista: preço contratual num contrato, preço base num anúncio ou procedimento, novo preço numa modificação. Não usar para somas — usar preco_contratual.
`data`	AAAA-MM-DD	Data de publicação na fonte. Vazio quando a fonte não a indica.
`fonte`	texto	Fonte onde o registo foi recolhido (BASE.gov, DRE, AnoGov, Portal Municipal).
`tipo`	texto	Tipo do registo, por extenso (Contrato, Anúncio de procedimento, Edital, Ata…).
`estado`	texto	«Em procedimento» para anúncios e procedimentos; «Publicado» para os restantes.
`tipo_codigo`	texto	Tipo do registo em código estável (contrato, anuncio_procedimento, procedimento, modificacao_contrato, edital…). É o campo a usar para filtrar.
`natureza`	contrato \| documento	«contrato» para registos de contratação pública (contratos, anúncios, procedimentos, modificações); «documento» para os restantes.
`adjudicante`	texto	Entidade adjudicante ou responsável pelo documento.
`adjudicante_nif`	texto	NIF da entidade adjudicante, quando a fonte o indica.
`ambito`	municipio \| concelho \| externa	Grupo da entidade adjudicante: «municipio»; «concelho» (outras entidades públicas com sede no concelho: freguesias, agrupamento de escolas); «externa» (entidade de fora com contrato executado só em Mondim de Basto). Vazio quando a fonte não identifica a entidade. Os valores de grupos diferentes não se somam.
`nif`	texto	NIF do adjudicatário, quando a fonte o publica. Vazio para pessoas singulares e quando a fonte não o indica.
`cpv`	texto	Código(s) CPV e designação, separados por «; » quando há mais do que um.
`tipo_procedimento`	texto	Tipo de procedimento tal como a fonte o escreve (Ajuste Direto, Consulta Prévia, Concurso Público…).
`preco_contratual`	euros, inteiro	Preço contratual de um contrato celebrado. Vazio em anúncios, procedimentos e modificações. É a coluna que o total do site soma.
`preco_base`	euros, inteiro	Preço base do procedimento. É um teto de concurso, não um valor contratado.
`data_celebracao`	AAAA-MM-DD	Data de celebração do contrato, segundo a fonte.
`id_contrato`	texto	Identificador do contrato no BASE.gov (idContrato).
`n_anuncio`	texto	Número do anúncio do procedimento (nAnuncio), comum ao anúncio e aos contratos que dele resultam.
`id_processo`	UUID	Identificador do processo neste site: registos com o mesmo valor são passos do mesmo processo (anúncio, contrato, modificações). Vazio quando o registo não está ligado a nenhum.
`ligacao_fonte`	URL	Endereço do documento original na fonte.
`ligacao_site`	URL	Endereço permanente do registo neste site.
`data_recolha`	AAAA-MM-DD	Data em que o registo foi recolhido da fonte.
`data_extracao`	ISO 8601, UTC	Momento em que o ficheiro foi exportado; igual em todas as linhas.

Refazer as contas do site

O valor total mostrado na página inicial é a soma dos preços contratuais dos contratos celebrados pelo Município. Os contratos de outras entidades do concelho e de entidades externas são contados à parte e nunca entram nesse número. Para o reproduzir a partir do CSV exportado sem filtros:

Ficar só com as linhas em que tipo_codigo é contrato e natureza é contrato.
Dessas, ficar com as linhas em que ambito é municipio. Com concelho ou externa obtêm-se, pelos mesmos passos, os valores dos outros dois grupos em scopeTotals.
Contar cada id_contrato uma única vez. Se o mesmo contrato aparecer em duas linhas, fica o maior preco_contratual. Linhas sem id_contrato contam individualmente.
Somar preco_contratual. Linhas com esse campo vazio não entram.

O resultado deve coincidir com totalValue em /api/public/stats. Cada parcela confere-se abrindo ligacao_fonte.

Preços base de anúncios e procedimentos (preco_base) não entram nesse total e não devem ser somados a preços contratuais: um procedimento não é um contrato celebrado. Um contrato publicado também não é despesa paga. A coluna data é a data de publicação na fonte; o ano em que o contrato foi celebrado está em data_celebracao.

API pública

A API é só de leitura, não exige registo nem chave e responde em JSON (UTF-8). É a mesma que alimenta este site. Endereço de base: https://mondimtransparente.pt/api/public.

Endereços da API pública
Pedido	O que devolve
`GET /api/public/contracts`	Todos os registos publicados (contratos, anúncios, procedimentos, modificações e documentos), do mais recente para o mais antigo. Resposta: { generatedAt, contracts: [...] }.
`GET /api/public/contracts/{id}`	Um registo, pelo identificador completo (fullId) ou pelo curto (id). Inclui o bloco process com a cronologia do processo, quando existe. Devolve 404 se o registo não existir.
`GET /api/public/stats`	Contadores do site: totalContracts (n.º de registos), totalValue (soma dos preços contratuais dos contratos celebrados pelo Município), scopeTotals (contratos celebrados e respetivo valor por grupo de entidade adjudicante: Município, outras entidades do concelho, entidades externas com execução local — nunca somados entre si), lastUpdate (última recolha concluída) e sourcesCount.
`GET /api/public/sources`	Última consulta bem-sucedida a cada fonte (lastCheckedAt); null quando ainda não há nenhuma registada.
`GET /api/public/erratas`	Fé de erratas: correções já aplicadas a conteúdo publicado.
`GET /api/public/costs`	Custos do próprio projeto, com total e data da última atualização.

As respostas podem ficar em cache até 5 minutos (Cache-Control: public, max-age=300).
Pode ser chamada a partir de outros sítios (Access-Control-Allow-Origin: *).
Há um limite de pedidos por minuto por endereço IP. Ultrapassado, a resposta é 429 com o cabeçalho Retry-After. Para uma cópia completa basta um pedido a /api/public/contracts.

Cada elemento de contracts tem os campos seguintes. Os nomes estão em inglês por serem os que o site usa internamente; o CSV traz os mesmos dados com nomes em português.

Campos de um registo na API pública
Campo	Formato	O que é
`id`	texto	Identificador curto (8 primeiros caracteres de fullId).
`fullId`	UUID	Identificador completo e permanente do registo neste site.
`url`	URL \| null	Endereço do documento original na fonte.
`category`	contrato \| documento	Natureza: contratação pública ou outro documento.
`type`	texto	Tipo em código estável: contrato, anuncio_procedimento, procedimento, modificacao_contrato, edital, ata, aviso…
`typeLabel`	texto	O mesmo tipo, por extenso.
`state`	pending \| published	pending para anúncios e procedimentos; published para os restantes.
`title`	texto	Título ou objeto, com a capitalização e os separadores uniformizados pelo site.
`titleRaw`	texto	O mesmo título, tal como a fonte o escreveu.
`entity`	texto	Adjudicatário; «—» quando desconhecido.
`nif`	texto	NIF do adjudicatário; «—» quando a fonte não o publica.
`buyer`	texto	Entidade adjudicante ou responsável pelo documento.
`buyerNif`	texto \| null	NIF da entidade adjudicante, quando a fonte o indica.
`scope`	municipio \| concelho \| externa \| null	Grupo da entidade adjudicante: o Município; outra entidade pública com sede no concelho (freguesias, agrupamento de escolas); ou entidade de fora com contrato executado só em Mondim de Basto. null quando a fonte não identifica a entidade.
`scopeLabel`	texto \| null	O mesmo grupo, por extenso.
`value`	inteiro (euros) \| null	Valor mostrado no site: preço contratual, preço base ou novo preço, consoante o tipo. Não usar para somas.
`contractPrice`	inteiro (euros) \| null	Preço contratual de um contrato celebrado.
`basePrice`	inteiro (euros) \| null	Preço base do procedimento.
`procedureType`	texto \| null	Tipo de procedimento, tal como a fonte o escreve.
`cpv`	texto	Código(s) CPV e designação; «—» quando desconhecido.
`date`	AAAA-MM-DD \| ""	Data de publicação na fonte; vazio quando a fonte não a indica.
`signingDate`	AAAA-MM-DD \| null	Data de celebração do contrato.
`capturedAt`	AAAA-MM-DD	Data em que o registo foi recolhido da fonte.
`contractId`	texto \| null	Identificador do contrato no BASE.gov (idContrato).
`announcementId`	texto \| null	Número do anúncio do procedimento (nAnuncio).
`processId`	UUID \| null	Processo a que o registo está ligado; igual nos passos do mesmo processo.
`source`	texto	BASE.gov, DRE, AnoGov ou Portal Municipal.
`duration`	texto	Prazo de execução, com a unidade que a fonte declara; «—» quando desconhecido.
`localexec`	texto	Local de execução declarado na fonte; «—» quando a fonte não o indica.
`summary`	texto	Resumo factual do registo, redigido por este site a partir do documento original.

Data de extração

Os dados mudam sempre que há uma recolha. Quem guarda uma cópia deve guardar também a data em que a tirou:

no CSV, a coluna data_extracao e o nome do ficheiro;
na API, o campo generatedAt de /api/public/contracts;
em cada registo, data_recolha (CSV) ou capturedAt (API) indica quando foi recolhido da fonte.

Registos corrigidos depois de publicados ficam na fé de erratas.

Licença e como citar

A compilação feita por este site (o CSV, as respostas da API e os resumos) é disponibilizada sob a licença Creative Commons Atribuição 4.0 Internacional (CC BY 4.0): pode ser copiada, redistribuída e adaptada, para qualquer fim, desde que se indique a origem.

Os documentos originais são das entidades que os publicam (BASE.gov, Diário da República, Município de Mondim de Basto, AnoGov) e mantêm as condições de cada fonte. Este site não representa o Município nem qualquer entidade pública.

Para citar o conjunto de dados:

Mondim + Transparente, «Contratos e publicações do Município de Mondim de Basto», https://mondimtransparente.pt/dados, extraído em [data de extração]. Dados recolhidos de BASE.gov, Diário da República, Portal Municipal e AnoGov.

Para citar um registo:

[Título do registo], [fonte], [data de publicação]. Original: [ligacao_fonte]. Consultado em Mondim + Transparente, [ligacao_site], em [data da consulta].

Ao citar um valor, indique se é preço contratual ou preço base. Se encontrar um erro, peça a correção em Correções e participação.