OECE Contrataciones Abiertas

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. Todos los procedimientos convocados desde 2020, organizados y listos para consultar. 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.

La fuente entera, organizada y lista para consultar: cada endpoint de esta página responde en milisegundos. Cada respuesta incluye as_of: qué tan actualizados están los datos. Cómo funcionan los datasets.

Buscar procesos

POST /pe/oece/processes-search/v1 Dataset 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`.

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" }'

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 Dataset 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.

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" }'

Devuelve found, ocid, as_of y process (null cuando no se encuentra).

Respuesta

Cada respuesta incluye as_of: qué tan actualizados están los datos.

`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.

Estas respuestas cubren los procedimientos convocados desde enero de 2020. Los procedimientos anteriores existen en la fuente pero no forman parte de ellas.

Referencia completa

Esquemas, todos los campos de respuesta y un playground interactivo.

Primeros pasos

Tipos de solicitud

Países

OECE Contrataciones Abiertas

Buscar procesos

Proceso por OCID

Respuesta

`processes[]` (búsqueda)

`process` (consulta)

Referencia completa

​Buscar procesos

​Proceso por OCID

​Respuesta

​processes[] (búsqueda)

​process (consulta)

Referencia completa

Buscar procesos

Proceso por OCID

Respuesta

`processes[]` (búsqueda)

`process` (consulta)