Colombia · co_cce_secop_procurement_search

Buscar en cce · secop-procurement

GET https://api.latinfo.dev/co/cce/secop-procurement/search

Busca en el índice publicado de search_blob. Los resultados son candidatos, no identidades confirmadas. Confirma país e identificador antes de consultar el perfil. Una lista vacía no prueba ausencia. Para una verificación reproducible, consulta el ejemplo documentado de esta fuente y usa como q una palabra completa de al menos tres letras, separada por espacios, de su valor de search_blob. Elige una palabra con solo letras; evita texto de origen dañado o palabras parciales y limita q a 200 caracteres. La búsqueda devuelve una lista limitada de candidatos, no una exportación exhaustiva. Los nombres y el texto de estado de los candidatos pueden estar recortados. Consulta el registro de la fuente para obtener los datos completos e interpretar su vocabulario de estados; no clasifiques una empresa usando solo el texto del candidato.

Contrato de la fuente

Publicador: Colombia Compra Eficiente
Cobertura: Procesos publicados de SECOP II incluidos en el snapshot preparado; excluye SECOP I y el conjunto de ofertas. No constituye un historial exhaustivo de contratos.
Qué representa un registro: Un proceso de contratación del espacio de nombres REQ. Los contratos se vinculan mediante su identificador de portafolio BDOS; cuando coinciden varios contratos, se conserva solo uno seleccionado.
Identificador: Usa el identificador público del proceso, por ejemplo CO1.REQ.100001. coSecopProcess lo normaliza al identificador almacenado, con la parte numérica primero y ceros iniciales. Los resultados de búsqueda muestran el identificador almacenado; conviértelo al formato público documentado antes de consultar.
Patrón admitido: ^CO\d\.REQ\.\d{1,10}$
Normalización: coSecopProcess
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 identidad empresarial se determina mediante una regla revisada sobre el formato del NIT; no es una confirmación contra RUES ni prueba de la situación jurídica actual.
Se redactan los nombres y documentos de contratistas y adjudicatarios personas naturales y los domicilios de esos contratistas; también se limpia el texto libre afectado. Los campos vacíos pueden corresponder a datos ausentes, no vinculados o redactados y no acreditan un resultado negativo.
Se selecciona un solo contrato por portafolio; sus valores no suman todos los contratos relacionados. bidder_count cuenta NIT distintos con formato empresarial, no todas las ofertas o participantes.
Las fechas de procesos y contratos son marcas de tiempo del publicador, nunca la fecha del import. Los sufijos numéricos de las fechas de fase son nombres originales de campos, no una cronología inferida.
Los valores monetarios como texto conservan los montos originales en COP, sin cambio de escala ni conversión. No se infiere una categoría financiera para el campo truncado valor_pendiente_de.
duracion usa la unidad_de_duracion original; duracion_del_contrato es texto del publicador sin interpretar. Los campos de fuentes de financiación son indicadores, no montos monetarios.
Los campos PPI, PCI, puntos del acuerdo y pilares del acuerdo se conservan sin desarrollar abreviaturas ni categorías no documentadas.
Los datos, estados y redacciones de privacidad de la fuente no acreditan ausencia de impedimentos legales, elegibilidad, propiedad ni cobertura completa de contratación pública.

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

qstringConsultaobligatorio

Consulta de nombre, de 3 a 200 caracteres.

Ejemplo de solicitud

curl https://api.latinfo.dev/co/cce/secop-procurement/search?q=q \
  -H "Authorization: Bearer $LATINFO_API_KEY"

Respuestas

200Registros publicados de la fuente. Los datos faltantes no acreditan ausencia de riesgos ni un hallazgo negativo.

Encabezados de la respuesta

X-Latinfo-Imported-At

Fecha de importación, distinta de la fecha del dato gubernamental.

X-Source-Updated-At

Fecha de actualización del publicador, si se conoce.

X-Latest-Observation-At

Última fecha de observación en esta página, si se conoce. Para el historial paginado completo, conserva la fecha de cada página o toma la máxima entre todas. Nunca uses la fecha de importación como fecha del dato.

X-Freshness-Status

string

CURRENT · DELAYED · STALE · UNKNOWN

X-Credits-Cost

Créditos efectivamente cobrados por esta solicitud.

X-Source-Generation

Generación opaca e inmutable de la fuente. Sigue el Link protegido de siguiente página al obtener un historial.

Content-Type: application/json

Campos de la respuesta

[].id string

[].search_blob string

Texto de búsqueda formado por el título y la descripción del proceso redactados y la entidad contratante, limitado a 2000 caracteres; no es el documento original completo.

[].estado_del_procedimiento string

Estado original del proceso; no es un estado de cumplimiento ni tributario de la empresa.

Esquema de respuesta

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "id": {
        "type": "string"
      },
      "search_blob": {
        "type": "string",
        "description": "Search text assembled from redacted process title, description and buying entity, capped at 2000 characters; not the complete original document.",
        "x-latinfo-meaning": "text"
      },
      "estado_del_procedimiento": {
        "type": "string",
        "description": "Original process status; not a company compliance or tax status.",
        "x-latinfo-meaning": "text"
      }
    }
  }
}

400Identificador o consulta inválidos. Corrige la entrada antes de reintentar.