OECE Contrataciones Abiertas

Os procedimentos de contratação pública do Peru como publicados pelo OECE (Organismo Especializado para las Contrataciones Públicas Eficientes, antes OSCE) sob o Open Contracting Data Standard: a convocatória, a entidade contratante, o valor referencial, os itens, os editais, as adjudicações e os contratos que se seguiram. A Croma mantém sua própria cópia do corpus (procedimentos convocados a partir de 2020), a atualiza todos os dias e responde a partir dela. É isso que transforma uma busca de texto completo em todos os procedimentos, ou todas as adjudicações a um RUC ao longo dos anos, em uma única chamada rápida.

Buscar processos

POST /pe/oece/processes-search/v1 Busca os procedimentos por qualquer combinação de texto, entidade, fornecedor adjudicado, departamento, categoria, tipo de procedimento e datas. Os mais recentes primeiro.

Campo	Tipo	Notas
`query`	string	Opcional. Palavras a buscar no título e na descrição (busca de texto completo em espanhol).
`buyer_ruc`	string	Opcional. Apenas procedimentos da entidade contratante com este RUC.
`supplier_ruc`	string	Opcional. Apenas procedimentos com uma adjudicação ao fornecedor com este RUC.
`department`	string	Opcional. Departamento da entidade como a fonte o escreve, p. ex. `LIMA`, `CUSCO`.
`category`	enum	Opcional. `goods`, `services` ou `works`.
`method`	string	Opcional. Tipo de procedimento exatamente como a fonte o nomeia, p. ex. `Licitación Pública`, `Adjudicación Simplificada`, `Subasta Inversa Electrónica`.
`from_date`	string	Opcional. Limite inferior da data de convocatória (`yyyy-mm-dd`, inclusive).
`to_date`	string	Opcional. Limite superior da data de convocatória (`yyyy-mm-dd`, inclusive).
`updated_after`	string	Opcional. Apenas procedimentos que a fonte modificou nesta data ou depois: o que mudou desde a sua última consulta.
`page`	integer	Opcional. Página, começa em 1. Por padrão `1`.
`per_page`	integer	Opcional. Resultados por página, 1-50. Por padrão `20`.

curl https://api.croma.run/pe/oece/processes-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "laptops", "department": "LIMA", "from_date": "2025-01-01" }'

Este endpoint responde a partir de um dataset da Croma: uma cópia da fonte mantida pela Croma e atualizada conforme um cronograma em vez de ser lida ao vivo a cada chamada. Cada resposta traz as_of, o momento em que o dataset foi atualizado pela última vez.

Retorna as_of, os filtros aplicados, total (correspondências em todas as páginas), page, per_page, total_pages, count e processes[] (ver abaixo).

Processo por OCID

POST /pe/oece/process/v1 Resolve um procedimento pelo seu id OCDS e retorna o registro completo.

Campo	Tipo	Notas
`ocid`	string	Obrigatório. Id OCDS do processo, p. ex. `ocds-dgv273-seacev3-873200`, como retornado pela busca.

curl https://api.croma.run/pe/oece/process/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "ocid": "ocds-dgv273-seacev3-873200" }'

Retorna found, ocid, as_of e process (null quando não encontrado).

Resposta

Cada resposta traz as_of: o momento em que a cópia da fonte mantida pela Croma foi atualizada pela última vez.

`processes[]` (busca)

Campo	Notas
`ocid`	Id OCDS do processo, p. ex. `ocds-dgv273-seacev3-873200`. Use-o na consulta por processo.
`source`	Qual geração do SEACE o publicou (`seace_v2`, `seace_v3`).
`tender_id`	O número de procedimento próprio da fonte.
`title`, `description`	A nomenclatura do procedimento e o objeto da contratação.
`buyer`	`{ id, name, ruc }` da entidade contratante.
`department`	Departamento (região) da entidade, p. ex. `LIMA`.
`procurement_method_details`	O tipo de procedimento como a fonte o nomeia (`Licitación Pública`, `Adjudicación Simplificada`, …).
`category`	`goods`, `services` ou `works`.
`value`	`{ amount, currency, amount_pen }`: o valor referencial.
`published_date`	`yyyy-mm-dd` da convocatória.
`status_details`	As etapas distintas entre os itens, como a fonte as nomeia (`CONVOCADO`, `ADJUDICADO`, `CONTRATADO`, `DESIERTO`, `NULO`, …).
`award_count`, `contract_count`, `awarded_amount_pen`	Até onde o procedimento chegou e por quanto.
`suppliers[]`	Fornecedores adjudicados distintos, `{ id, name, ruc }`.
`updated_at`	Quando a fonte modificou o registro pela última vez.

`process` (consulta)

O registro completo: tudo acima mais procurement_method, additional_categories, tender_start_date, tender_end_date, number_of_tenderers, items[] (descrição, quantidade, unidade, classificação CUBSO/UNSPSC, status, limitado a 100 com items_capped), documents[] (título, tipo, formato, url, datas, limitado a 50 com documents_capped), awards[] (id, data, valor, fornecedores, item_count), contracts[] (id, award_id, título, datas, status, valor), supplier_rucs[] e segment (o mês de publicação da fonte). Os valores vazios ou de preenchimento são normalizados para null. Os montantes são números; as datas são yyyy-mm-dd; os carimbos de tempo mantêm o fuso da fonte.

A cópia cobre os procedimentos convocados a partir de janeiro de 2020. Os procedimentos anteriores existem na fonte, mas não fazem parte destas respostas.

Referência completa

Esquemas, todos os campos de resposta e um playground interativo.

Primeiros passos

Países

OECE Contrataciones Abiertas

Buscar processos

Processo por OCID

Resposta

`processes[]` (busca)

`process` (consulta)

Referência completa

​Buscar processos

​Processo por OCID

​Resposta

​processes[] (busca)

​process (consulta)

Referência completa

Buscar processos

Processo por OCID

Resposta

`processes[]` (busca)

`process` (consulta)