Español
EspañolEnglishFilipinoPortuguês
Crear clave gratis
Perú — licitaciones · getTenderByOcid
OpenAPI

Consultar una contratación por OCID

GET https://api.latinfo.dev/pe/oece/tenders/ocid/{ocid}

Devuelve un registro compiledRelease de OCDS de OECE/SEACE por identificador OCID.

Contrato de la fuente

Publicador
OECE, Perú
Cobertura
Procesos OCDS de contratación publicados en la copia oficial importada.
Qué representa un registro
Proceso OCDS completo por OCID; los siete campos del índice son una proyección para búsqueda, no el esquema de respuesta HTTP.
Identificador
Consulta por ocid como texto, conservando ceros iniciales. El contrato siguiente define la sintaxis y normalización admitidas.
Patrón admitido
^ocds-dgv273-seacev[23]-
Cantidad de registros
one
Licencia
No se ha verificado el permiso de reutilización. El acceso público no equivale a una licencia de reutilización.

Limitaciones conocidas

  • La API elimina las partes que son personas naturales; los documentos siguen como enlaces externos del publicador.
  • Usa el esquema de respuesta OCDS de OpenAPI. Los importes de proceso o presupuesto no son automáticamente valores de contratos del proveedor.
  • amount en el índice de búsqueda no tiene moneda declarada de forma independiente. Los objetos amount/currency del OCDS completo son la referencia autorizada.

Contrato de la fuente para agentes · Documentación de la fuente

Requiere autenticación. Las solicitudes REST usan una clave de api de Latinfo. La consola agrega el encabezado de autorización y no guarda la clave.

Parámetros

ocidstringRutaobligatorio

Identificador de contratación abierta (OCID)

Example: ocds-dgv273-seacev3-2026-273-3

Ejemplo de solicitud

curl https://api.latinfo.dev/pe/oece/tenders/ocid/ocds-dgv273-seacev3-2026-273-3 \
  -H "Authorization: Bearer $LATINFO_API_KEY"

Respuestas

200Registro compiledRelease de OCDS 1.1
Content-Type: application/json

Campos de la respuesta

ocid string

Identificador de contratación abierta (OCID)

date string

Fecha de compilación

date-time

url string

Enlace al portal oficial de OECE

uri

buyer object
Campos internos
buyer.id string
buyer.name string
tender object
Campos internos
tender.title string

Título breve de la licitación

tender.description string

Descripción completa de la licitación

tender.datePublished string

date-time

tender.value object
Campos internos
tender.value.amount number
tender.value.currency string
tender.mainProcurementCategory string

goods · services · works

tender.procurementMethodDetails string
tender.tenderPeriod object
Campos internos
tender.tenderPeriod.startDate string

date-time

tender.tenderPeriod.endDate string

date-time

tender.items array
Campos internos
tender.items[].description string
tender.items[].statusDetails string

Estado por ítem de OECE/SEACE, conservado tal como se publica. Es un vocabulario abierto de la fuente, no el estado general del contrato ni una enumeración cerrada.

tender.documents array
Campos internos
tender.documents[].title string
tender.documents[].url string

uri

awards array
Campos internos
awards[].status string
awards[].value object
Campos internos
awards[].value.amount number
awards[].value.currency string
awards[].suppliers array
Campos internos
awards[].suppliers[].name string
awards[].suppliers[].id string
contracts array
Campos internos
contracts[].status string
contracts[].value object
Campos internos
contracts[].value.amount number
contracts[].period object
Campos internos
contracts[].period.startDate string

date-time

contracts[].period.endDate string

date-time

planning object
Campos internos
planning.budget object
Campos internos
planning.budget.amount object
Campos internos
planning.budget.amount.amount number
planning.budget.amount.currency string
Esquema de respuesta
{
  "type": "object",
  "description": "OCDS 1.1 compiledRelease record with Latinfo-added url field",
  "properties": {
    "ocid": {
      "type": "string",
      "description": "Open Contracting ID",
      "example": "ocds-dgv273-seacev3-2026-273-3"
    },
    "date": {
      "type": "string",
      "format": "date-time",
      "description": "Compilation date"
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Link to official OECE portal",
      "example": "https://contratacionesabiertas.oece.gob.pe/proceso/ocds-dgv273-seacev3-2026-273-3"
    },
    "buyer": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "example": "PE-CONSUCODE-273"
        },
        "name": {
          "type": "string",
          "example": "MUNICIPALIDAD DISTRITAL DE MORO"
        }
      }
    },
    "tender": {
      "type": "object",
      "properties": {
        "title": {
          "type": "string",
          "description": "Short tender title"
        },
        "description": {
          "type": "string",
          "description": "Full tender description"
        },
        "datePublished": {
          "type": "string",
          "format": "date-time"
        },
        "value": {
          "type": "object",
          "properties": {
            "amount": {
              "type": "number",
              "example": 64815.55
            },
            "currency": {
              "type": "string",
              "example": "PEN"
            }
          }
        },
        "mainProcurementCategory": {
          "type": "string",
          "enum": [
            "goods",
            "services",
            "works"
          ]
        },
        "procurementMethodDetails": {
          "type": "string",
          "example": "Concurso Público Abreviado"
        },
        "tenderPeriod": {
          "type": "object",
          "properties": {
            "startDate": {
              "type": "string",
              "format": "date-time"
            },
            "endDate": {
              "type": "string",
              "format": "date-time"
            }
          }
        },
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "description": {
                "type": "string"
              },
              "statusDetails": {
                "type": "string",
                "description": "OECE/SEACE item-level status text, preserved as published. This is an open publisher vocabulary, not an overall contract status or a closed enum.",
                "examples": [
                  "CONVOCADO",
                  "CONTRATADO",
                  "DESIERTO",
                  "NULO",
                  "CONSENTIDO"
                ]
              }
            }
          }
        },
        "documents": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string"
              },
              "url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        }
      }
    },
    "awards": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string"
          },
          "value": {
            "type": "object",
            "properties": {
              "amount": {
                "type": "number"
              },
              "currency": {
                "type": "string"
              }
            }
          },
          "suppliers": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "id": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "contracts": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string"
          },
          "value": {
            "type": "object",
            "properties": {
              "amount": {
                "type": "number"
              }
            }
          },
          "period": {
            "type": "object",
            "properties": {
              "startDate": {
                "type": "string",
                "format": "date-time"
              },
              "endDate": {
                "type": "string",
                "format": "date-time"
              }
            }
          }
        }
      }
    },
    "planning": {
      "type": "object",
      "properties": {
        "budget": {
          "type": "object",
          "properties": {
            "amount": {
              "type": "object",
              "properties": {
                "amount": {
                  "type": "number"
                },
                "currency": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    }
  }
}
400OCID inválido
No se documentó un cuerpo de respuesta.
401Clave de api ausente o inválida
No se documentó un cuerpo de respuesta.
404OCID no encontrado
No se documentó un cuerpo de respuesta.
429Límite de solicitudes excedido
No se documentó un cuerpo de respuesta.
503Índice de contratación no disponible
No se documentó un cuerpo de respuesta.
Ejemplo JSON

Ejemplo ilustrativo del esquema. No es una respuesta en vivo.

{
  "ocid": "ocds-dgv273-seacev3-2026-273-3",
  "date": "2026-08-14T00:00:00Z",
  "url": "https://contratacionesabiertas.oece.gob.pe/proceso/ocds-dgv273-seacev3-2026-273-3",
  "buyer": {
    "id": "PE-CONSUCODE-273",
    "name": "MUNICIPALIDAD DISTRITAL DE MORO"
  },
  "tender": {
    "title": "string",
    "description": "string",
    "datePublished": "2026-08-14T00:00:00Z",
    "value": {
      "amount": 64815.55,
      "currency": "PEN"
    },
    "mainProcurementCategory": "goods",
    "procurementMethodDetails": "Concurso Público Abreviado",
    "tenderPeriod": {
      "startDate": "2026-08-14T00:00:00Z",
      "endDate": "2026-08-14T00:00:00Z"
    },
    "items": [
      {
        "description": "string",
        "statusDetails": "CONVOCADO"
      }
    ],
    "documents": [
      {
        "title": "string",
        "url": "https://example.gov/record"
      }
    ]
  },
  "awards": [
    {
      "status": "string",
      "value": {
        "amount": 1,
        "currency": "string"
      },
      "suppliers": [
        {
          "name": null,
          "id": null
        }
      ]
    }
  ],
  "contracts": [
    {
      "status": "string",
      "value": {
        "amount": 1
      },
      "period": {
        "startDate": "2026-08-14T00:00:00Z",
        "endDate": "2026-08-14T00:00:00Z"
      }
    }
  ],
  "planning": {
    "budget": {
      "amount": {
        "amount": 1,
        "currency": "string"
      }
    }
  }
}

Procedencia y limitaciones

La cobertura varía por país y fuente pública. Un campo ausente no demuestra que el hecho no exista. Los registros públicos pueden tener retrasos o errores; revisa la evidencia y la fecha de la fuente antes de usar un resultado.

Esc