> ## 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
> Contratación pública del Perú (SEACE, publicado por el OECE): busca procedimientos por texto, entidad, RUC del proveedor, departamento, categoría y fechas, y consulta uno por su id OCDS.
Los procedimientos de contratación pública del Perú tal como los publica el
OECE (Organismo Especializado para las Contrataciones Públicas Eficientes,
antes OSCE) bajo el Estándar de Datos de Contrataciones Abiertas: la
convocatoria, la entidad contratante, el valor referencial, los ítems, las
bases, las adjudicaciones y los contratos que siguieron.
Croma mantiene su propia copia del corpus (procedimientos convocados desde
2020\), la actualiza cada día y responde desde ella. Eso es lo que convierte una
búsqueda de texto completo sobre todos los procedimientos, o todas las
adjudicaciones a un RUC a lo largo de los años, en una sola llamada rápida.
## Buscar procesos
`POST /pe/oece/processes-search/v1`
Busca los procedimientos por cualquier combinación de texto, entidad, proveedor
adjudicado, departamento, categoría, tipo de procedimiento y fechas. Los más
recientes primero.
| Campo | Tipo | Notas |
| --------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query` | string | Opcional. Palabras a buscar en el título y la descripción (búsqueda de texto completo en español). |
| `buyer_ruc` | string | Opcional. Solo procedimientos de la entidad contratante con este RUC. |
| `supplier_ruc` | string | Opcional. Solo procedimientos con una adjudicación al proveedor con este RUC. |
| `department` | string | Opcional. Departamento de la entidad tal como lo escribe la fuente, p. ej. `LIMA`, `CUSCO`. |
| `category` | enum | Opcional. `goods`, `services` o `works`. |
| `method` | string | Opcional. Tipo de procedimiento exactamente como lo nombra la fuente, p. ej. `Licitación Pública`, `Adjudicación Simplificada`, `Subasta Inversa Electrónica`. |
| `from_date` | string | Opcional. Límite inferior de la fecha de convocatoria (`yyyy-mm-dd`, inclusive). |
| `to_date` | string | Opcional. Límite superior de la fecha de convocatoria (`yyyy-mm-dd`, inclusive). |
| `updated_after` | string | Opcional. Solo procedimientos que la fuente modificó en esta fecha o después: lo que cambió desde tu última consulta. |
| `page` | integer | Opcional. Página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-50. Por defecto `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 desde un dataset de Croma: una copia de la fuente que Croma mantiene y actualiza según un cronograma en lugar de leerse en vivo en cada llamada. Cada respuesta incluye `as_of`, el momento en que el dataset se actualizó por última vez.
Devuelve `as_of`, los filtros aplicados, `total` (coincidencias en todas las
páginas), `page`, `per_page`, `total_pages`, `count` y `processes[]` (ver abajo).
## Proceso por OCID
`POST /pe/oece/process/v1` Resuelve un procedimiento por su id OCDS y devuelve el registro completo.
| Campo | Tipo | Notas |
| ------ | ------ | -------------------------------------------------------------------------------------------------------- |
| `ocid` | string | **Obligatorio.** Id OCDS del proceso, p. ej. `ocds-dgv273-seacev3-873200`, como lo devuelve la búsqueda. |
```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 desde un dataset de Croma: una copia de la fuente que Croma mantiene y actualiza según un cronograma en lugar de leerse en vivo en cada llamada. Cada respuesta incluye `as_of`, el momento en que el dataset se actualizó por última vez.
Devuelve `found`, `ocid`, `as_of` y `process` (null cuando no se encuentra).
## Respuesta
Cada respuesta incluye `as_of`: el momento en que la copia de la fuente que mantiene Croma se actualizó por última vez.
### `processes[]` (búsqueda)
| Campo | Notas |
| ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| `ocid` | Id OCDS del proceso, p. ej. `ocds-dgv273-seacev3-873200`. Úsalo en la consulta por proceso. |
| `source` | Qué generación del SEACE lo publicó (`seace_v2`, `seace_v3`). |
| `tender_id` | El número de procedimiento propio de la fuente. |
| `title`, `description` | La nomenclatura del procedimiento y el objeto de la contratación. |
| `buyer` | `{ id, name, ruc }` de la entidad contratante. |
| `department` | Departamento (región) de la entidad, p. ej. `LIMA`. |
| `procurement_method_details` | El tipo de procedimiento tal como lo nombra la fuente (`Licitación Pública`, `Adjudicación Simplificada`, ...). |
| `category` | `goods`, `services` o `works`. |
| `value` | `{ amount, currency, amount_pen }`: el valor referencial. |
| `published_date` | `yyyy-mm-dd` de la convocatoria. |
| `status_details` | Las etapas distintas entre los ítems, como las nombra la fuente (`CONVOCADO`, `ADJUDICADO`, `CONTRATADO`, `DESIERTO`, `NULO`, ...). |
| `award_count`, `contract_count`, `awarded_amount_pen` | Hasta dónde llegó el procedimiento y por cuánto. |
| `suppliers[]` | Proveedores adjudicados distintos, `{ id, name, ruc }`. |
| `updated_at` | Cuándo modificó la fuente el registro por última vez. |
### `process` (consulta)
El registro completo: todo lo anterior más `procurement_method`, `additional_categories`, `tender_start_date`, `tender_end_date`, `number_of_tenderers`, `items[]` (descripción, cantidad, unidad, clasificación CUBSO/UNSPSC, estado, limitado a 100 con `items_capped`), `documents[]` (título, tipo, formato, url, fechas, limitado a 50 con `documents_capped`), `awards[]` (id, fecha, valor, proveedores, item\_count), `contracts[]` (id, award\_id, título, fechas, estado, valor), `supplier_rucs[]` y `segment` (el mes de publicación de la fuente).
Los valores vacíos o de relleno se normalizan a `null`. Los montos son números; las fechas son `yyyy-mm-dd`; las marcas de tiempo conservan el desfase horario de la fuente.
La copia cubre los procedimientos convocados desde enero de 2020. Los
procedimientos anteriores existen en la fuente pero no forman parte de estas
respuestas.
Esquemas, todos los campos de respuesta y un playground interactivo.