> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.
# OECE Contrataciones Abiertas
> Contratação pública do Peru (SEACE, publicada pelo OECE): busque procedimentos por texto, entidade, RUC do fornecedor, departamento, categoria e datas, e consulte um pelo seu id OCDS.
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`. |
```bash theme={"dark"}
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. |
```bash theme={"dark"}
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" }'
```
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 `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.
Esquemas, todos os campos de resposta e um playground interativo.