# Propostas do ComprasGov

Este repositório permite consultar as propostas apresentadas por fornecedores nas contratações realizadas pelo ComprasGov.

Este repositório contempla propostas registradas a partir da data de inclusão, desde que o respectivo item esteja devidamente homologado.

São considerados somente itens incluídos a partir de 1º de janeiro de 2022.

## Arquivos disponíveis

- `propostas-{ano}-{mes}.csv.zip`: propostas apresentadas pelos fornecedores aos itens das contratações.

Os arquivos estão organizados por ano e mês, por exemplo:

```text
propostas/2026/01/propostas-2026-01.csv.zip
propostas/2026/02/propostas-2026-02.csv.zip
```

O particionamento utiliza o ano e o mês da coluna `data_hora_inclusao` do item. Cada linha representa a proposta de um fornecedor para um item homologado de uma contratação.

## Atualização dos dados

A atualização ocorre semanalmente, aos domingos, às 8h. O arquivo do mês vigente é gerado novamente em todas as atualizações.

Arquivos de meses anteriores também são substituídos quando houver alteração nos dados da compra, do item, da participação ou da proposta do item. Portanto, o conteúdo de um arquivo já baixado pode ficar diferente da versão mais recente disponível neste repositório.

## Como utilizar

Escolha a pasta correspondente ao ano e ao mês de inclusão do item, baixe o arquivo `.zip` e extraia o CSV. Os arquivos usam codificação UTF-8, possuem os nomes das colunas na primeira linha e utilizam ponto e vírgula (`;`) como separador.

A coluna `classificacao` informa a posição da proposta no item. O valor `1` identifica a proposta vencedora; os demais valores representam as outras colocações.

Para identificar o valor final, utilize `valor_negociado_julgamento_calculado` quando estiver preenchido. Caso contrário, utilize `valor_lance_calculado` e, se este também estiver vazio, `valor_proposta_calculado`.

As colunas `aplicabilidade_margem_pref`, `perc_normal_margem_pref`, `perc_adicional_margem_pref` e `id_proposta_base_margem_pref` referem-se ao item e indicam se a margem de preferência se aplica (`S` ou `N`), os percentuais da margem normal e da margem adicional e a proposta usada como base para o cálculo da margem. Esta última é raramente preenchida.

As colunas `declaracao_margem_pref` e `pais_origem` referem-se à proposta, inclusive às não vencedoras, e são preenchidas apenas em itens com margem de preferência. Os valores de `declaracao_margem_pref` são:

- `0`: não faz jus à margem de preferência;
- `1`: faz jus à margem de preferência normal;
- `2`: faz jus à margem de preferência adicional.