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

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.

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

Referencia completa

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

Primeros pasos

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)