Radicado Uno
Colombian company and procurement data by NIT, each field with its official source. Free checks.
Should I use this
Quality & Safety
Findings (29)
- HIGHTool poisoning patterns detected
- MEDIUMTool 'radicadouno_buscar_registro' description contains placeholder textin radicadouno_buscar_registro
- MEDIUMTool 'radicadouno_historial_contratos' description contains placeholder textin radicadouno_historial_contratos
- MEDIUMTool 'radicadouno_resumen_contratacion' description contains placeholder textin radicadouno_resumen_contratacion
- MEDIUMTool 'radicadouno_participaciones' description contains placeholder textin radicadouno_participaciones
- MEDIUMTool 'radicadouno_proceso' description contains placeholder textin radicadouno_proceso
- MEDIUMTool 'radicadouno_evaluacion_proceso' description contains placeholder textin radicadouno_evaluacion_proceso
- MEDIUMTool 'radicadouno_matriz_fuentes' description contains placeholder textin radicadouno_matriz_fuentes
- LOWTool 'radicadouno_buscar_empresa' description lacks action verbin radicadouno_buscar_empresa
- LOWTool 'radicadouno_perfil_empresa' description lacks action verbin radicadouno_perfil_empresa
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"mcp": {
"url": "https://mcp.radicadouno.co/mcp"
}
}
}Remote endpoints
https://mcp.radicadouno.co/mcpstreamable-httpWhat it can do
Tool inventory
Tools (23)
🟢radicadouno_buscar_empresa(texto, limite)
Busca en las 9,3M matrículas del RUES por prefijo de razón social o por NIT exacto. Devuelve candidatos con NIT para usar en las demás tools.
Input Schema
{
"type": "object",
"properties": {
"texto": {
"type": "string",
"minLength": 3,
"description": "Prefijo de la razón social (ej. 'BANCOLOMBIA') o NIT exacto"
},
"limite": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 10
}
},
"required": [
"texto"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"candidatos": {
"type": "array",
"items": {
"type": "object",
"properties": {
"nit": {
"type": [
"string",
"null"
]
},
"razon_social": {
"type": "string"
},
"camara_comercio": {
"type": [
"string",
"null"
]
},
"estado_matricula": {
"type": [
"string",
"null"
]
},
"organizacion_juridica": {
"type": [
"string",
"null"
]
},
"fuente_url": {
"type": "string"
},
"capturado_en": {
"type": "string"
}
},
"required": [
"nit",
"razon_social",
"camara_comercio",
"estado_matricula",
"organizacion_juridica",
"fuente_url",
"capturado_en"
],
"additionalProperties": false
}
},
"aviso": {
"type": "string"
}
},
"required": [
"candidatos"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢radicadouno_perfil_empresa(nit)
Cruce completo por NIT: matrículas RUES (registro mercantil), expediente enriquecido si existe, registro de proveedor estatal y agregados de contratación pública SECOP II. Cada bloque lleva su provenance.
Input Schema
{
"type": "object",
"properties": {
"nit": {
"type": "string",
"description": "NIT sin dígito de verificación, solo dígitos"
}
},
"required": [
"nit"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"nit": {
"type": "string"
},
"matriculas_rues": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": true
}
},
"expedientes_rues": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": true
}
},
"proveedor_secop": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": true
}
},
"finanzas_grandes": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": true
}
},
"sanciones": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": true
}
},
"establecimientos": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"estados_financieros_niif": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": true
}
},
"compras_tvec": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"competencia": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"contratacion_publica": {
"type": "object",
"properties": {},
"additionalProperties": true
}
},
"required": [
"nit",
"matriculas_rues",
"expedientes_rues",
"proveedor_secop",
"finanzas_grandes",
"sanciones",
"establecimientos",
"estados_financieros_niif",
"compras_tvec",
"competencia",
"contratacion_publica"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢radicadouno_contratos_empresa(nit, anio, estado, limite)
Contratos SECOP II donde el NIT es el proveedor adjudicado, con el enlace oficial al expediente de cada contrato (url_proceso). Filtrable por año y estado.
Input Schema
{
"type": "object",
"properties": {
"nit": {
"type": "string",
"description": "NIT del proveedor, solo dígitos"
},
"anio": {
"type": "integer",
"minimum": 2000,
"maximum": 2100
},
"estado": {
"type": "string",
"description": "ej. 'En ejecución', 'Cerrado'"
},
"limite": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 20
}
},
"required": [
"nit"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"contratos": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": true
}
},
"aviso": {
"type": "string"
}
},
"required": [
"contratos"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢radicadouno_estado_fuentes
Qué fuentes están cargadas, cuántas filas (estimación del planificador) y fecha de última captura. Útil para citar la frescura del dato.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"fuentes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"tabla": {
"type": "string"
},
"filas_estimadas": {
"type": "number"
},
"ultima_captura": {
"type": [
"string",
"null"
]
}
},
"required": [
"tabla",
"filas_estimadas",
"ultima_captura"
],
"additionalProperties": false
}
}
},
"required": [
"fuentes"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢radicadouno_senales_empresa(nit)
Indicadores verificables por NIT: presencia física, contratación pública (volumen, clientes, concentración con su mayor cliente), procesos ganados con oferta única, sanciones, compras por acuerdos marco y últimas cifras financieras. NO es un score crediticio (Ley 1266/2008): son hechos con fuente, la interpretación es de quien consulta.
Input Schema
{
"type": "object",
"properties": {
"nit": {
"type": "string",
"description": "NIT sin dígito de verificación, solo dígitos"
}
},
"required": [
"nit"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"senales": {
"anyOf": [
{
"type": "object",
"properties": {},
"additionalProperties": true
},
{
"type": "null"
}
]
},
"aviso": {
"type": "string"
}
},
"required": [
"senales",
"aviso"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢radicadouno_red_empresa(nit, limite)
Recorre el grafo de contratación a dos saltos (empresa → entidad pública → otra empresa) y devuelve quién concurre ante los mismos compradores. La similitud está normalizada por el tamaño de cada cartera: sin eso el resultado lo copan las aseguradoras y la papelería, que venden a todas las entidades del país y no compiten con nadie en particular. No mide calidad ni solvencia: mide coincidencia de clientes.
Input Schema
{
"type": "object",
"properties": {
"nit": {
"type": "string",
"description": "NIT sin dígito de verificación, solo dígitos"
},
"limite": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 10,
"description": "cuántas empresas devolver"
}
},
"required": [
"nit"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"nit": {
"type": "string"
},
"clientes_publicos": {
"type": [
"number",
"null"
]
},
"similares": {
"type": "array",
"items": {
"type": "object",
"properties": {
"nit": {
"type": "string"
},
"razon_social": {
"type": "string"
},
"clientes_comunes": {
"type": "number"
},
"clientes_propios": {
"type": "number"
},
"similitud": {
"type": "number"
}
},
"required": [
"nit",
"razon_social",
"clientes_comunes",
"clientes_propios",
"similitud"
],
"additionalProperties": false
}
},
"aviso": {
"type": "string"
}
},
"required": [
"nit",
"clientes_publicos",
"similares",
"aviso"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢radicadouno_comprobar(nit)
Lo esencial de una empresa por NIT, SIN CLAVE y gratis: identidad registral (si está activa, quién la representa, desde cuándo), si contrata con el Estado, si tiene sanciones y si aparece en listas restrictivas. Tope de 10 al día. Para el detalle completo hace falta clave (radicadouno_contratar); para el documento sellado que sirve ante un tercero, radicadouno_informe.
Input Schema
{
"type": "object",
"properties": {
"nit": {
"type": "string",
"description": "NIT sin dígito de verificación, solo dígitos"
}
},
"required": [
"nit"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"nit": {
"type": "string"
},
"comprobado_en": {
"type": "string"
},
"identidad": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"contratacion": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"sanciones": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"listas": {
"anyOf": [
{
"type": "object",
"properties": {},
"additionalProperties": true
},
{
"type": "null"
}
]
},
"gratis_restantes_hoy": {
"type": "number"
},
"aviso": {
"type": "string"
}
},
"required": [
"nit",
"comprobado_en",
"identidad",
"contratacion",
"sanciones",
"listas"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪radicadouno_informe(nit)
El informe de debida diligencia de una empresa en PDF, con la huella del fichero, sello de tiempo y cada dato enlazado a su publicación oficial. Con clave Pro o Business se DESCUENTA de los 20 informes incluidos al mes, sin pagar nada. Sin clave, o agotados los incluidos, se compra suelto: 89.900 COP, sin suscripción, y devuelve una URL de pago. En los dos casos, radicadouno_estado_contratacion con la referencia devuelve el enlace de descarga.
Input Schema
{
"type": "object",
"properties": {
"nit": {
"type": "string",
"description": "NIT sin dígito de verificación, solo dígitos"
}
},
"required": [
"nit"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"referencia": {
"type": "string"
},
"url_pago": {
"type": "string"
},
"estado": {
"type": "string"
},
"incluidos_restantes": {
"type": "number"
},
"nit": {
"type": "string"
},
"precio": {
"type": "number"
},
"moneda": {
"type": "string"
},
"producto": {
"type": "string"
},
"siguiente_paso": {
"type": "string"
}
},
"required": [
"referencia",
"nit",
"precio",
"moneda",
"producto",
"siguiente_paso"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪radicadouno_contratar
Abre una caja de pago del plan Business (619.900 COP al mes, los primeros 7 días gratis; incluye las 19 herramientas de datos de este servidor, todas las que piden clave) y devuelve la URL de alta y una referencia. No hace falta clave para llamar a esta herramienta. Después se consulta el estado con radicadouno_estado_contratacion para recoger la clave.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"referencia": {
"type": "string"
},
"url_pago": {
"type": "string"
},
"plan": {
"type": "string"
},
"precio": {
"type": "number"
},
"moneda": {
"type": "string"
},
"periodo": {
"type": "string"
},
"prueba_dias": {
"type": "number"
},
"siguiente_paso": {
"type": "string"
}
},
"required": [
"referencia",
"url_pago",
"plan",
"precio",
"moneda",
"periodo",
"siguiente_paso"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪radicadouno_estado_contratacion(referencia)
Estado de una compra, con la referencia que devolvió radicadouno_contratar o radicadouno_informe. Si era una clave: la ENTREGA UNA SOLA VEZ cuando el pago está confirmado (guárdala, no se puede volver a consultar) y se envía como 'Authorization: Bearer <clave>'. Si era un informe: devuelve el enlace de descarga del PDF y el de comprobación pública de su huella, tantas veces como haga falta.
Input Schema
{
"type": "object",
"properties": {
"referencia": {
"type": "string",
"minLength": 16,
"description": "La referencia de radicadouno_contratar o de radicadouno_informe"
}
},
"required": [
"referencia"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"estado": {
"type": "string"
},
"clave": {
"type": "string"
},
"producto": {
"type": "string"
},
"nit": {
"type": "string"
},
"referencia_informe": {
"type": "string"
},
"url_documento": {
"type": "string"
},
"url_comprobacion": {
"type": "string"
},
"aviso": {
"type": "string"
},
"detalle": {
"type": "string"
}
},
"required": [
"estado"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢radicadouno_buscar_registro(q, coincidencia, pagina, por_pagina)
Busca por nombre o razón social, también parcial, entre TODAS las sociedades con matrícula activa del registro mercantil (RUES), tengan o no contratos con el Estado o ficha pública. Sin distinguir tildes ni mayúsculas e ignorando la forma societaria (S.A.S., LTDA…): «avancys» encuentra AVANCYS SAS. Ordena exacta > prefijo > palabra > contiene > parecida (erratas) y luego matrícula activa; `coincidencia` de cada resultado dice cuál. Con coincidencia='literal' solo devuelve exacta, prefijo o palabra completa (sin erratas ni trozos de palabra): úsalo para crear perfiles sin confirmar. Devuelve razón social, NIT (y DV si consta), cámara, estado de la matrícula, último año renovado, ficha_url si tiene ficha pública y la fuente. Una fila por NIT. Nunca devuelve personas naturales. Fuera del universo quedan también los números sin forma de NIT de sociedad, las formas jurídicas fuera de la lista blanca, las matrículas canceladas o inactivas y todo NIT que aparezca alguna vez con cédula (cobertura.nota; recuentos por motivo en radicadouno_matriz_fuentes). Mínimo 3 letras sin contar la forma societaria. Con un NIT, búsqueda exacta. Sirve los 1.000 primeros resultados (pagina × por_pagina): para más, afina la consulta. Para el detalle de las matrículas de un NIT, la API /v1/registro/{nit}.
Input Schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"minLength": 3,
"maxLength": 120,
"description": "Razón social o parte de ella (p. ej. 'avancys'), o un NIT"
},
"coincidencia": {
"type": "string",
"enum": [
"aproximada",
"literal"
],
"description": "aproximada (por defecto): todos los niveles, también erratas. literal: solo exacta, prefijo o palabra completa"
},
"pagina": {
"type": "integer",
"minimum": 1,
"default": 1
},
"por_pagina": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 25
}
},
"required": [
"q"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"resultados": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": true
}
},
"pagina": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"cobertura": {
"type": "object",
"properties": {
"alcance": {
"type": "string",
"enum": [
"completo",
"parcial",
"no_cubierto"
]
},
"fuentes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"dataset": {
"type": "string"
},
"url": {
"type": "string"
},
"ultima_sincronizacion": {
"type": [
"string",
"null"
]
},
"corte": {
"type": [
"string",
"null"
]
},
"capturado_hasta": {
"type": [
"string",
"null"
]
},
"nota_corte": {
"type": [
"string",
"null"
]
}
},
"required": [
"dataset",
"url",
"ultima_sincronizacion",
"corte",
"capturado_hasta",
"nota_corte"
],
"additionalProperties": true
}
},
"nota": {
"type": "string"
}
},
"required": [
"alcance",
"fuentes",
"nota"
],
"additionalProperties": true
},
"q": {
"type": "string"
},
"q_normalizada": {
"type": "string"
},
"coincidencia": {
"type": "string",
"enum": [
"aproximada",
"literal"
]
}
},
"required": [
"resultados",
"pagina",
"cobertura",
"q",
"q_normalizada"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢radicadouno_historial_contratos(nit, fuente, desde, hasta, unspsc, ...)
Todos los contratos con el Estado de una empresa colombiana, SECOP II (desde 2015) y SECOP I (desde 2000) sin duplicar, paginados con el total exacto. Cada contrato trae entidad, objeto, fechas, estado, UNSPSC, lugar de ejecución, valores y valor_calidad. Suma solo valor_confiable (NULL si el valor de la fuente no es fiable: 0, 1, desproporcionado o repetido entre adjudicatarios). valor_inicial, valor_adiciones y valor_final llevan su *_calidad: null y 'no_recuperable' cuando no se puede saber, 0 solo si la fuente publica 0 ('cero_en_fuente') o no consta ninguna modificación ('sin_modificaciones_publicadas'). Cada contrato lleva entidad_id, identificador estable de la entidad compradora también cuando SECOP I no publica su NIT (Ecopetrol): úsalo en entidad_id para filtrar. nombre_entidad es el de la fuente tal cual. entidad_equivalente: la misma entidad con NIT cuando SECOP I la publica sin NIT y se puede acreditar (mismo nombre normalizado, departamento y municipio, un único NIT de entidad en SECOP II para ese nombre y lugar, usado en un solo departamento): {entidad_id, nit, metodo, confianza}; null si no se acredita (varios candidatos, municipio sin definir…). Para totales usa radicadouno_resumen_contratacion. unspsc_principal es siempre un código OFICIAL y unspsc_fuente dice de quién: 'oficial_secop2' (el contrato o proceso de SECOP II) u 'oficial_secop1' (lo que SECOP I publica para la constancia: el segmento siempre, la clase cuando la entidad la puso). unspsc_principal_detalle (y unspsc_adicionales_detalle) dan la jerarquía segmento → familia → clase → producto con los nombres de los datos abiertos de SECOP I (CC BY-SA 4.0; los productos no tienen nombre: null); unspsc_catalogo, licencia y origen. cobertura.fuentes[] dice por fuente ultima_sincronizacion y corte (hasta cuándo está completa; null = no consta, con nota_corte): una lista vacía con alcance completo es «no consta hasta el corte», no un error.
Input Schema
{
"type": "object",
"properties": {
"nit": {
"type": "string",
"pattern": "^[0-9]{5,15}$",
"description": "NIT, solo dígitos, sin dígito de verificación"
},
"fuente": {
"type": "string",
"enum": [
"secop1",
"secop2",
"todas"
],
"default": "todas"
},
"desde": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "AAAA-MM-DD"
},
"hasta": {
"$ref": "#/properties/desde",
"description": "AAAA-MM-DD"
},
"unspsc": {
"type": "string",
"pattern": "^[0-9]{2,8}$",
"description": "Prefijo UNSPSC de 2 a 8 dígitos"
},
"entidad": {
"type": "string",
"pattern": "^[0-9]{5,15}$",
"description": "NIT de la entidad compradora"
},
"entidad_nombre": {
"type": "string",
"minLength": 4,
"description": "Parte del nombre de la entidad (SECOP I trae algunas sin NIT, p. ej. Ecopetrol)"
},
"entidad_id": {
"type": "string",
"pattern": "^ent-[0-9a-f]{16}$",
"description": "entidad_id tal como lo devuelven el historial o el resumen por entidad (ent-…)"
},
"agrupar_equivalentes": {
"type": "boolean",
"default": false,
"description": "true: con entidad_id, incluye también sus equivalentes (la entidad sin NIT de SECOP I y la misma con NIT de SECOP II); con por='entidad', los suma en un grupo"
},
"orden": {
"type": "string",
"enum": [
"fecha",
"valor"
],
"default": "fecha"
},
"pagina": {
"type": "integer",
"minimum": 1,
"default": 1
},
"por_pagina": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 25
}
},
"required": [
"nit"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"resultados": {
"type": "array",
"items": {
"type": "object",
"properties": {
"valor_inicial_calidad": {
"type": "string",
"enum": [
"publicado",
"cero_en_fuente",
"calculado",
"sin_modificaciones_publicadas",
"no_recuperable"
],
"description": "no_recuperable siempre va con el valor a null; 0 solo si la fuente publica 0"
},
"valor_adiciones_calidad": {
"$ref": "#/properties/resultados/items/properties/valor_inicial_calidad"
},
"valor_final_calidad": {
"$ref": "#/properties/resultados/items/properties/valor_inicial_calidad"
},
"unspsc_fuente": {
"anyOf": [
{
"type": "string",
"enum": [
"oficial_secop2",
"oficial_secop1"
]
},
{
"type": "null"
}
]
},
"unspsc_principal_detalle": {
"anyOf": [
{
"type": "object",
"properties": {
"codigo": {
"type": "string",
"pattern": "^[0-9]{8}$"
},
"nivel": {
"type": "string",
"enum": [
"segmento",
"familia",
"clase",
"producto"
]
},
"nombre": {
"type": [
"string",
"null"
]
},
"en_catalogo": {
"type": "boolean",
"description": "false: los datos abiertos no tienen nombre para este código"
},
"segmento": {
"type": "object",
"properties": {
"codigo": {
"type": "string",
"pattern": "^[0-9]{8}$"
},
"prefijo": {
"type": "string",
"pattern": "^[0-9]{2,8}$"
},
"nombre": {
"type": [
"string",
"null"
]
},
"en_catalogo": {
"type": "boolean"
}
},
"required": [
"codigo",
"prefijo",
"nombre",
"en_catalogo"
],
"additionalProperties": false
},
"familia": {
"anyOf": [
{
"$ref": "#/properties/resultados/items/properties/unspsc_principal_detalle/anyOf/0/properties/segmento"
},
{
"type": "null"
}
]
},
"clase": {
"anyOf": [
{
"$ref": "#/properties/resultados/items/properties/unspsc_principal_detalle/anyOf/0/properties/segmento"
},
{
"type": "null"
}
]
},
"producto": {
"anyOf": [
{
"$ref": "#/properties/resultados/items/properties/unspsc_principal_detalle/anyOf/0/properties/segmento"
},
{
"type": "null"
}
]
}
},
"required": [
"codigo",
"nivel",
"nombre",
"en_catalogo",
"segmento",
"familia",
"clase",
"producto"
],
"additionalProperties": false,
"description": "UNSPSC oficial con su jerarquía; null si la fuente no publica código"
},
{
"type": "null"
}
],
"description": "UNSPSC oficial con su jerarquía; null si la fuente no publica código"
},
"unspsc_adicionales_detalle": {
"type": "array",
"items": {
"$ref": "#/properties/resultados/items/properties/unspsc_principal_detalle/anyOf/0"
}
},
"entidad_equivalente": {
"anyOf": [
{
"type": "object",
"properties": {
"entidad_id": {
"type": "string"
},
"nit": {
"type": "string"
},
"metodo": {
"type": "string"
},
"confianza": {
"type": "string"
}
},
"required": [
"entidad_id",
"nit",
"metodo",
"confianza"
],
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "la misma entidad con NIT (SECOP II), solo si se acredita; null si no"
}
},
"required": [
"valor_inicial_calidad",
"valor_adiciones_calidad",
"valor_final_calidad"
],
"additionalProperties": true
}
},
"pagina": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"cobertura": {
"type": "object",
"properties": {
"alcance": {
"type": "string",
"enum": [
"completo",
"parcial",
"no_cubierto"
]
},
"fuentes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"dataset": {
"type": "string"
},
"url": {
"type": "string"
},
"ultima_sincronizacion": {
"type": [
"string",
"null"
]
},
"corte": {
"type": [
"string",
"null"
]
},
"capturado_hasta": {
"type": [
"string",
"null"
]
},
"nota_corte": {
"type": [
"string",
"null"
]
}
},
"required": [
"dataset",
"url",
"ultima_sincronizacion",
"corte",
"capturado_hasta",
"nota_corte"
],
"additionalProperties": true
}
},
"nota": {
"type": "string"
}
},
"required": [
"alcance",
"fuentes",
"nota"
],
"additionalProperties": true
},
"unspsc_catalogo": {
"type": "object",
"properties": {
"nombres": {
"type": "string",
"enum": [
"publicados",
"no_publicados",
"no_disponible"
],
"description": "no_publicados: los nombres van a null y los códigos de cada nivel sí"
},
"licencia": {
"type": "array",
"items": {
"type": "string"
},
"description": "licencia y atribución de los nombres (CC BY-SA 4.0)"
},
"documentos": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"description": "consultas oficiales de las que salen"
},
"nota": {
"type": "string"
}
},
"required": [
"nombres",
"licencia",
"documentos",
"nota"
],
"additionalProperties": true
}
},
"required": [
"resultados",
"pagina",
"cobertura"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢radicadouno_resumen_contratacion(nit, por, nivel, fuente, desde, ...)
Totales de contratación de una empresa agrupados por año, UNSPSC (segmento, familia, clase o producto), modalidad, entidad o fuente. Suma solo valores confiables y dice cuántos contratos se excluyeron de la suma y por qué. Úsala para histogramas y preguntas tipo «cuánto contrató cada año». Con por='entidad' agrupa por entidad_id (también las entidades sin NIT de SECOP I, cada una aparte) y da su nombre, el normalizado, el NIT si consta y las escrituras de la fuente; entidad_id filtra por una entidad. entidad_equivalente: la misma entidad con NIT cuando SECOP I la publica sin NIT y se puede acreditar (mismo nombre normalizado, departamento y municipio, un único NIT de entidad en SECOP II para ese nombre y lugar, usado en un solo departamento): {entidad_id, nit, metodo, confianza}; null si no se acredita (varios candidatos, municipio sin definir…). Con agrupar_equivalentes=true y por='entidad', los grupos equivalentes se suman en uno (clave = el entidad_id con NIT; entidad_ids_agrupados dice cuáles). Con por=unspsc, cada grupo lleva unspsc_detalle: su código de 8 dígitos, su nivel real y el nombre de cada nivel (segmento, familia, clase). Agrupa el UNSPSC oficial de SECOP II y el de SECOP I (contratos_unspsc_secop2 y contratos_unspsc_secop1 por grupo) y nunca más fino de lo publicado: un contrato de SECOP I con solo el segmento queda en su segmento.
Input Schema
{
"type": "object",
"properties": {
"nit": {
"type": "string",
"pattern": "^[0-9]{5,15}$",
"description": "NIT, solo dígitos, sin dígito de verificación"
},
"por": {
"type": "string",
"enum": [
"anio",
"unspsc",
"modalidad",
"entidad",
"fuente"
],
"default": "anio"
},
"nivel": {
"type": "string",
"enum": [
"segmento",
"familia",
"clase",
"producto"
],
"default": "segmento"
},
"fuente": {
"type": "string",
"enum": [
"secop1",
"secop2",
"todas"
],
"default": "todas"
},
"desde": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "AAAA-MM-DD"
},
"hasta": {
"$ref": "#/properties/desde",
"description": "AAAA-MM-DD"
},
"entidad_id": {
"type": "string",
"pattern": "^ent-[0-9a-f]{16}$",
"description": "entidad_id tal como lo devuelven el historial o el resumen por entidad (ent-…)"
},
"agrupar_equivalentes": {
"type": "boolean",
"default": false,
"description": "true: con entidad_id, incluye también sus equivalentes (la entidad sin NIT de SECOP I y la misma con NIT de SECOP II); con por='entidad', los suma en un grupo"
}
},
"required": [
"nit"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"resultados": {
"type": "array",
"items": {
"type": "object",
"properties": {
"unspsc_detalle": {
"anyOf": [
{
"type": "object",
"properties": {
"codigo": {
"type": "string",
"pattern": "^[0-9]{8}$"
},
"nivel": {
"type": "string",
"enum": [
"segmento",
"familia",
"clase",
"producto"
]
},
"nombre": {
"type": [
"string",
"null"
]
},
"en_catalogo": {
"type": "boolean",
"description": "false: los datos abiertos no tienen nombre para este código"
},
"segmento": {
"type": "object",
"properties": {
"codigo": {
"type": "string",
"pattern": "^[0-9]{8}$"
},
"prefijo": {
"type": "string",
"pattern": "^[0-9]{2,8}$"
},
"nombre": {
"type": [
"string",
"null"
]
},
"en_catalogo": {
"type": "boolean"
}
},
"required": [
"codigo",
"prefijo",
"nombre",
"en_catalogo"
],
"additionalProperties": false
},
"familia": {
"anyOf": [
{
"$ref": "#/properties/resultados/items/properties/unspsc_detalle/anyOf/0/properties/segmento"
},
{
"type": "null"
}
]
},
"clase": {
"anyOf": [
{
"$ref": "#/properties/resultados/items/properties/unspsc_detalle/anyOf/0/properties/segmento"
},
{
"type": "null"
}
]
},
"producto": {
"anyOf": [
{
"$ref": "#/properties/resultados/items/properties/unspsc_detalle/anyOf/0/properties/segmento"
},
{
"type": "null"
}
]
}
},
"required": [
"codigo",
"nivel",
"nombre",
"en_catalogo",
"segmento",
"familia",
"clase",
"producto"
],
"additionalProperties": false,
"description": "UNSPSC oficial con su jerarquía; null si la fuente no publica código"
},
{
"type": "null"
}
],
"description": "UNSPSC oficial con su jerarquía; null si la fuente no publica código"
},
"entidad_equivalente": {
"anyOf": [
{
"type": "object",
"properties": {
"entidad_id": {
"type": "string"
},
"nit": {
"type": "string"
},
"metodo": {
"type": "string"
},
"confianza": {
"type": "string"
}
},
"required": [
"entidad_id",
"nit",
"metodo",
"confianza"
],
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "la misma entidad con NIT (SECOP II), solo si se acredita; null si no"
},
"entidad_ids_agrupados": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
]
}
},
"additionalProperties": true
}
},
"cobertura": {
"type": "object",
"properties": {
"alcance": {
"type": "string",
"enum": [
"completo",
"parcial",
"no_cubierto"
]
},
"fuentes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"dataset": {
"type": "string"
},
"url": {
"type": "string"
},
"ultima_sincronizacion": {
"type": [
"string",
"null"
]
},
"corte": {
"type": [
"string",
"null"
]
},
"capturado_hasta": {
"type": [
"string",
"null"
]
},
"nota_corte": {
"type": [
"string",
"null"
]
}
},
"required": [
"dataset",
"url",
"ultima_sincronizacion",
"corte",
"capturado_hasta",
"nota_corte"
],
"additionalProperties": true
}
},
"nota": {
"type": "string"
}
},
"required": [
"alcance",
"fuentes",
"nota"
],
"additionalProperties": true
},
"unspsc_catalogo": {
"type": "object",
"properties": {
"nombres": {
"type": "string",
"enum": [
"publicados",
"no_publicados",
"no_disponible"
],
"description": "no_publicados: los nombres van a null y los códigos de cada nivel sí"
},
"licencia": {
"type": "array",
"items": {
"type": "string"
},
"description": "licencia y atribución de los nombres (CC BY-SA 4.0)"
},
"documentos": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"description": "consultas oficiales de las que salen"
},
"nota": {
"type": "string"
}
},
"required": [
"nombres",
"licencia",
"documentos",
"nota"
],
"additionalProperties": true,
"description": "solo con por=unspsc"
}
},
"required": [
"resultados",
"cobertura"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢radicadouno_participaciones(nit, fuente, resultado, tipo, entidad, ...)
Procesos de contratación pública en los que una empresa se presentó (directamente o en consorcio), con el resultado (ganada, perdida, desierto, cancelado, sin_adjudicar, sin_dato, no_aplica), cuántos proponentes hubo y quién ganó (adjudicatarios: todos, también en procesos por lotes; adjudicatario: el primero). tipo dice si es un proceso de selección o una solicitud de información (sondeo de mercado, resultado no_aplica): las solicitudes salen en la lista pero NO cuentan en por_resultado ni en por_resultado_total salvo incluir_solicitudes_informacion; por_tipo las cuenta. por_resultado y por_tipo respetan los mismos filtros que la lista; por_resultado_total, ninguno. El resultado se deduce de la adjudicación y de los contratos del proceso. puntaje_total, habilitado y causal_rechazo salen del informe de evaluación cuando ya se ha leído y validado (detalle por criterio: radicadouno_evaluacion_proceso); null si no. unspsc_principal_detalle: la jerarquía UNSPSC oficial del proceso, con nombres (unspsc_catalogo). cobertura.fuentes[] dice por fuente ultima_sincronizacion y corte (hasta cuándo está completa; null = no consta, con nota_corte): una lista vacía con alcance completo es «no consta hasta el corte», no un error.
Input Schema
{
"type": "object",
"properties": {
"nit": {
"type": "string",
"pattern": "^[0-9]{5,15}$",
"description": "NIT, solo dígitos, sin dígito de verificación"
},
"fuente": {
"type": "string",
"enum": [
"secop1",
"secop2",
"todas"
],
"default": "todas"
},
"resultado": {
"type": "string",
"enum": [
"ganada",
"perdida",
"desierto",
"cancelado",
"sin_adjudicar",
"sin_dato",
"no_aplica"
]
},
"tipo": {
"type": "string",
"enum": [
"proceso_seleccion",
"solicitud_informacion",
"sin_dato"
],
"description": "proceso_seleccion para ver solo licitaciones y demás procesos competitivos"
},
"entidad": {
"type": "string",
"pattern": "^[0-9]{5,15}$",
"description": "NIT de la entidad compradora"
},
"desde": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "AAAA-MM-DD"
},
"hasta": {
"$ref": "#/properties/desde",
"description": "AAAA-MM-DD"
},
"incluir_solicitudes_informacion": {
"type": "boolean",
"default": false,
"description": "true: las solicitudes de información cuentan en por_resultado (como no_aplica)"
},
"pagina": {
"type": "integer",
"minimum": 1,
"default": 1
},
"por_pagina": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 25
}
},
"required": [
"nit"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"resultados": {
"type": "array",
"items": {
"type": "object",
"properties": {
"tipo": {
"type": "string",
"enum": [
"proceso_seleccion",
"solicitud_informacion",
"sin_dato"
]
},
"resultado": {
"type": "string"
},
"unspsc_fuente": {
"anyOf": [
{
"type": "string",
"enum": [
"oficial_secop2",
"oficial_secop1"
]
},
{
"type": "null"
}
]
},
"unspsc_principal_detalle": {
"anyOf": [
{
"type": "object",
"properties": {
"codigo": {
"type": "string",
"pattern": "^[0-9]{8}$"
},
"nivel": {
"type": "string",
"enum": [
"segmento",
"familia",
"clase",
"producto"
]
},
"nombre": {
"type": [
"string",
"null"
]
},
"en_catalogo": {
"type": "boolean",
"description": "false: los datos abiertos no tienen nombre para este código"
},
"segmento": {
"type": "object",
"properties": {
"codigo": {
"type": "string",
"pattern": "^[0-9]{8}$"
},
"prefijo": {
"type": "string",
"pattern": "^[0-9]{2,8}$"
},
"nombre": {
"type": [
"string",
"null"
]
},
"en_catalogo": {
"type": "boolean"
}
},
"required": [
"codigo",
"prefijo",
"nombre",
"en_catalogo"
],
"additionalProperties": false
},
"familia": {
"anyOf": [
{
"$ref": "#/properties/resultados/items/properties/unspsc_principal_detalle/anyOf/0/properties/segmento"
},
{
"type": "null"
}
]
},
"clase": {
"anyOf": [
{
"$ref": "#/properties/resultados/items/properties/unspsc_principal_detalle/anyOf/0/properties/segmento"
},
{
"type": "null"
}
]
},
"producto": {
"anyOf": [
{
"$ref": "#/properties/resultados/items/properties/unspsc_principal_detalle/anyOf/0/properties/segmento"
},
{
"type": "null"
}
]
}
},
"required": [
"codigo",
"nivel",
"nombre",
"en_catalogo",
"segmento",
"familia",
"clase",
"producto"
],
"additionalProperties": false,
"description": "UNSPSC oficial con su jerarquía; null si la fuente no publica código"
},
{
"type": "null"
}
],
"description": "UNSPSC oficial con su jerarquía; null si la fuente no publica código"
}
},
"required": [
"tipo",
"resultado"
],
"additionalProperties": true
}
},
"pagina": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"cobertura": {
"type": "object",
"properties": {
"alcance": {
"type": "string",
"enum": [
"completo",
"parcial",
"no_cubierto"
]
},
"fuentes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"dataset": {
"type": "string"
},
"url": {
"type": "string"
},
"ultima_sincronizacion": {
"type": [
"string",
"null"
]
},
"corte": {
"type": [
"string",
"null"
]
},
"capturado_hasta": {
"type": [
"string",
"null"
]
},
"nota_corte": {
"type": [
"string",
"null"
]
}
},
"required": [
"dataset",
"url",
"ultima_sincronizacion",
"corte",
"capturado_hasta",
"nota_corte"
],
"additionalProperties": true
}
},
"nota": {
"type": "string"
}
},
"required": [
"alcance",
"fuentes",
"nota"
],
"additionalProperties": true
},
"unspsc_catalogo": {
"type": "object",
"properties": {
"nombres": {
"type": "string",
"enum": [
"publicados",
"no_publicados",
"no_disponible"
],
"description": "no_publicados: los nombres van a null y los códigos de cada nivel sí"
},
"licencia": {
"type": "array",
"items": {
"type": "string"
},
"description": "licencia y atribución de los nombres (CC BY-SA 4.0)"
},
"documentos": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"description": "consultas oficiales de las que salen"
},
"nota": {
"type": "string"
}
},
"required": [
"nombres",
"licencia",
"documentos",
"nota"
],
"additionalProperties": true
},
"por_resultado": {
"type": "object",
"additionalProperties": {
"type": "integer"
},
"description": "con los filtros de la lista"
},
"por_resultado_total": {
"type": "object",
"additionalProperties": {
"$ref": "#/properties/por_resultado/additionalProperties"
},
"description": "todas las participaciones SECOP II, sin filtros"
},
"por_tipo": {
"type": "object",
"additionalProperties": {
"$ref": "#/properties/por_resultado/additionalProperties"
},
"description": "con los filtros de la lista; su suma es pagina.total"
}
},
"required": [
"resultados",
"pagina",
"cobertura",
"por_resultado",
"por_resultado_total",
"por_tipo"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢radicadouno_consorcios(nit, pagina, por_pagina)
Consorcios y uniones temporales de SECOP II de los que forma parte una empresa, con su porcentaje de participación, si lidera, los demás integrantes y los contratos del grupo. Sirve para atribuir experiencia de consorcios.
Input Schema
{
"type": "object",
"properties": {
"nit": {
"type": "string",
"pattern": "^[0-9]{5,15}$",
"description": "NIT, solo dígitos, sin dígito de verificación"
},
"pagina": {
"type": "integer",
"minimum": 1,
"default": 1
},
"por_pagina": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 25
}
},
"required": [
"nit"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"resultados": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": true
}
},
"pagina": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"cobertura": {
"type": "object",
"properties": {
"alcance": {
"type": "string",
"enum": [
"completo",
"parcial",
"no_cubierto"
]
},
"fuentes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"dataset": {
"type": "string"
},
"url": {
"type": "string"
},
"ultima_sincronizacion": {
"type": [
"string",
"null"
]
},
"corte": {
"type": [
"string",
"null"
]
},
"capturado_hasta": {
"type": [
"string",
"null"
]
},
"nota_corte": {
"type": [
"string",
"null"
]
}
},
"required": [
"dataset",
"url",
"ultima_sincronizacion",
"corte",
"capturado_hasta",
"nota_corte"
],
"additionalProperties": true
}
},
"nota": {
"type": "string"
}
},
"required": [
"alcance",
"fuentes",
"nota"
],
"additionalProperties": true
}
},
"required": [
"resultados",
"pagina",
"cobertura"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢radicadouno_procesos(entidad, unspsc, departamento, modalidad, estado, ...)
Busca procesos de SECOP II por entidad compradora (NIT) o por código UNSPSC (al menos 4 dígitos), con filtros de departamento, modalidad, estado y fechas. Devuelve presupuesto, valor adjudicado, número de proponentes y adjudicatarios. Para saber qué compra una entidad o quién compite en un tipo de compra. unspsc_principal es siempre un código OFICIAL y unspsc_fuente dice de quién: 'oficial_secop2' (el contrato o proceso de SECOP II) u 'oficial_secop1' (lo que SECOP I publica para la constancia: el segmento siempre, la clase cuando la entidad la puso). unspsc_principal_detalle (y unspsc_adicionales_detalle) dan la jerarquía segmento → familia → clase → producto con los nombres de los datos abiertos de SECOP I (CC BY-SA 4.0; los productos no tienen nombre: null); unspsc_catalogo, licencia y origen.
Input Schema
{
"type": "object",
"properties": {
"entidad": {
"type": "string",
"pattern": "^[0-9]{5,15}$",
"description": "NIT de la entidad compradora"
},
"unspsc": {
"type": "string",
"pattern": "^[0-9]{2,8}$",
"description": "Prefijo UNSPSC de 2 a 8 dígitos"
},
"departamento": {
"type": "string"
},
"modalidad": {
"type": "string"
},
"estado": {
"type": "string"
},
"desde": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "AAAA-MM-DD"
},
"hasta": {
"$ref": "#/properties/desde",
"description": "AAAA-MM-DD"
},
"pagina": {
"type": "integer",
"minimum": 1,
"default": 1
},
"por_pagina": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 25
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"resultados": {
"type": "array",
"items": {
"type": "object",
"properties": {
"unspsc_fuente": {
"anyOf": [
{
"type": "string",
"enum": [
"oficial_secop2",
"oficial_secop1"
]
},
{
"type": "null"
}
]
},
"unspsc_principal_detalle": {
"anyOf": [
{
"type": "object",
"properties": {
"codigo": {
"type": "string",
"pattern": "^[0-9]{8}$"
},
"nivel": {
"type": "string",
"enum": [
"segmento",
"familia",
"clase",
"producto"
]
},
"nombre": {
"type": [
"string",
"null"
]
},
"en_catalogo": {
"type": "boolean",
"description": "false: los datos abiertos no tienen nombre para este código"
},
"segmento": {
"type": "object",
"properties": {
"codigo": {
"type": "string",
"pattern": "^[0-9]{8}$"
},
"prefijo": {
"type": "string",
"pattern": "^[0-9]{2,8}$"
},
"nombre": {
"type": [
"string",
"null"
]
},
"en_catalogo": {
"type": "boolean"
}
},
"required": [
"codigo",
"prefijo",
"nombre",
"en_catalogo"
],
"additionalProperties": false
},
"familia": {
"anyOf": [
{
"$ref": "#/properties/resultados/items/properties/unspsc_principal_detalle/anyOf/0/properties/segmento"
},
{
"type": "null"
}
]
},
"clase": {
"anyOf": [
{
"$ref": "#/properties/resultados/items/properties/unspsc_principal_detalle/anyOf/0/properties/segmento"
},
{
"type": "null"
}
]
},
"producto": {
"anyOf": [
{
"$ref": "#/properties/resultados/items/properties/unspsc_principal_detalle/anyOf/0/properties/segmento"
},
{
"type": "null"
}
]
}
},
"required": [
"codigo",
"nivel",
"nombre",
"en_catalogo",
"segmento",
"familia",
"clase",
"producto"
],
"additionalProperties": false,
"description": "UNSPSC oficial con su jerarquía; null si la fuente no publica código"
},
{
"type": "null"
}
],
"description": "UNSPSC oficial con su jerarquía; null si la fuente no publica código"
},
"unspsc_adicionales_detalle": {
"type": "array",
"items": {
"$ref": "#/properties/resultados/items/properties/unspsc_principal_detalle/anyOf/0"
}
}
},
"additionalProperties": true
}
},
"pagina": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"cobertura": {
"type": "object",
"properties": {
"alcance": {
"type": "string",
"enum": [
"completo",
"parcial",
"no_cubierto"
]
},
"fuentes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"dataset": {
"type": "string"
},
"url": {
"type": "string"
},
"ultima_sincronizacion": {
"type": [
"string",
"null"
]
},
"corte": {
"type": [
"string",
"null"
]
},
"capturado_hasta": {
"type": [
"string",
"null"
]
},
"nota_corte": {
"type": [
"string",
"null"
]
}
},
"required": [
"dataset",
"url",
"ultima_sincronizacion",
"corte",
"capturado_hasta",
"nota_corte"
],
"additionalProperties": true
}
},
"nota": {
"type": "string"
}
},
"required": [
"alcance",
"fuentes",
"nota"
],
"additionalProperties": true
},
"unspsc_catalogo": {
"type": "object",
"properties": {
"nombres": {
"type": "string",
"enum": [
"publicados",
"no_publicados",
"no_disponible"
],
"description": "no_publicados: los nombres van a null y los códigos de cada nivel sí"
},
"licencia": {
"type": "array",
"items": {
"type": "string"
},
"description": "licencia y atribución de los nombres (CC BY-SA 4.0)"
},
"documentos": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"description": "consultas oficiales de las que salen"
},
"nota": {
"type": "string"
}
},
"required": [
"nombres",
"licencia",
"documentos",
"nota"
],
"additionalProperties": true
}
},
"required": [
"resultados",
"pagina",
"cobertura"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢radicadouno_proceso(portafolio)
Un proceso de SECOP II por su portafolio (CO1.BDOS.n): datos del proceso, lista de proponentes, adjudicatarios (todos, también por lotes) y contratos firmados. unspsc_principal es siempre un código OFICIAL y unspsc_fuente dice de quién: 'oficial_secop2' (el contrato o proceso de SECOP II) u 'oficial_secop1' (lo que SECOP I publica para la constancia: el segmento siempre, la clase cuando la entidad la puso). unspsc_principal_detalle (y unspsc_adicionales_detalle) dan la jerarquía segmento → familia → clase → producto con los nombres de los datos abiertos de SECOP I (CC BY-SA 4.0; los productos no tienen nombre: null); unspsc_catalogo, licencia y origen.
Input Schema
{
"type": "object",
"properties": {
"portafolio": {
"type": "string",
"pattern": "^CO1\\.BDOS\\.[0-9]{1,12}$",
"description": "Identificador de portafolio de SECOP II, CO1.BDOS.<número> (campo id_portafolio)"
}
},
"required": [
"portafolio"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"procesos": {
"type": "array",
"items": {
"type": "object",
"properties": {
"unspsc_fuente": {
"anyOf": [
{
"type": "string",
"enum": [
"oficial_secop2",
"oficial_secop1"
]
},
{
"type": "null"
}
]
},
"unspsc_principal_detalle": {
"anyOf": [
{
"type": "object",
"properties": {
"codigo": {
"type": "string",
"pattern": "^[0-9]{8}$"
},
"nivel": {
"type": "string",
"enum": [
"segmento",
"familia",
"clase",
"producto"
]
},
"nombre": {
"type": [
"string",
"null"
]
},
"en_catalogo": {
"type": "boolean",
"description": "false: los datos abiertos no tienen nombre para este código"
},
"segmento": {
"type": "object",
"properties": {
"codigo": {
"type": "string",
"pattern": "^[0-9]{8}$"
},
"prefijo": {
"type": "string",
"pattern": "^[0-9]{2,8}$"
},
"nombre": {
"type": [
"string",
"null"
]
},
"en_catalogo": {
"type": "boolean"
}
},
"required": [
"codigo",
"prefijo",
"nombre",
"en_catalogo"
],
"additionalProperties": false
},
"familia": {
"anyOf": [
{
"$ref": "#/properties/procesos/items/properties/unspsc_principal_detalle/anyOf/0/properties/segmento"
},
{
"type": "null"
}
]
},
"clase": {
"anyOf": [
{
"$ref": "#/properties/procesos/items/properties/unspsc_principal_detalle/anyOf/0/properties/segmento"
},
{
"type": "null"
}
]
},
"producto": {
"anyOf": [
{
"$ref": "#/properties/procesos/items/properties/unspsc_principal_detalle/anyOf/0/properties/segmento"
},
{
"type": "null"
}
]
}
},
"required": [
"codigo",
"nivel",
"nombre",
"en_catalogo",
"segmento",
"familia",
"clase",
"producto"
],
"additionalProperties": false,
"description": "UNSPSC oficial con su jerarquía; null si la fuente no publica código"
},
{
"type": "null"
}
],
"description": "UNSPSC oficial con su jerarquía; null si la fuente no publica código"
},
"unspsc_adicionales_detalle": {
"type": "array",
"items": {
"$ref": "#/properties/procesos/items/properties/unspsc_principal_detalle/anyOf/0"
}
}
},
"additionalProperties": true
}
},
"contratos": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": true
}
},
"cobertura": {
"type": "object",
"properties": {
"alcance": {
"type": "string",
"enum": [
"completo",
"parcial",
"no_cubierto"
]
},
"fuentes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"dataset": {
"type": "string"
},
"url": {
"type": "string"
},
"ultima_sincronizacion": {
"type": [
"string",
"null"
]
},
"corte": {
"type": [
"string",
"null"
]
},
"capturado_hasta": {
"type": [
"string",
"null"
]
},
"nota_corte": {
"type": [
"string",
"null"
]
}
},
"required": [
"dataset",
"url",
"ultima_sincronizacion",
"corte",
"capturado_hasta",
"nota_corte"
],
"additionalProperties": true
}
},
"nota": {
"type": "string"
}
},
"required": [
"alcance",
"fuentes",
"nota"
],
"additionalProperties": true
},
"unspsc_catalogo": {
"type": "object",
"properties": {
"nombres": {
"type": "string",
"enum": [
"publicados",
"no_publicados",
"no_disponible"
],
"description": "no_publicados: los nombres van a null y los códigos de cada nivel sí"
},
"licencia": {
"type": "array",
"items": {
"type": "string"
},
"description": "licencia y atribución de los nombres (CC BY-SA 4.0)"
},
"documentos": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"description": "consultas oficiales de las que salen"
},
"nota": {
"type": "string"
}
},
"required": [
"nombres",
"licencia",
"documentos",
"nota"
],
"additionalProperties": true
}
},
"required": [
"procesos",
"contratos",
"cobertura"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢radicadouno_documentos_proceso(portafolio)
Enlaces oficiales de descarga de los documentos de un proceso de SECOP II: pliego, estudios previos, evaluación, adjudicación, oferta económica, contrato, modificaciones. Solo tipos de una lista blanca y nunca documentos de personas naturales.
Input Schema
{
"type": "object",
"properties": {
"portafolio": {
"type": "string",
"pattern": "^CO1\\.BDOS\\.[0-9]{1,12}$",
"description": "Identificador de portafolio de SECOP II, CO1.BDOS.<número> (campo id_portafolio)"
}
},
"required": [
"portafolio"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"documentos": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": true
}
},
"cobertura": {
"type": "string"
}
},
"required": [
"documentos",
"cobertura"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢radicadouno_precios_proceso(portafolio, pagina, por_pagina)
Precio por ítem de un proceso de SECOP II (CO1.BDOS.n): descripción, cantidad, unidad, valor unitario, IVA y total de cada línea, leídos del documento de oferta económica y publicados solo si su aritmética cuadra y su total casa al peso con la oferta del proponente (una sociedad), con el contrato o con el presupuesto oficial (tipo_precio 'referencia'). Cada línea lleva el enlace oficial del documento y su huella sha256. El IVA que el documento no trae sale null, nunca 0. iva_calidad (de la línea): 'publicado', 'cero_en_documento' (exento: el documento escribe 0) o 'no_publicado'. iva_tarifa (0.19 = 19 %) y valor_iva_unitario: solo si el documento los escribe. valor_iva_linea, el IVA de la línea entera, con valor_iva_linea_calidad: 'publicado' (el documento lo escribe), 'calculado' (valor_iva_unitario × cantidad, al céntimo, cuando el documento da el unitario y la cantidad pero no el de la línea) o 'no_publicado' (null; nunca se calcula desde la tarifa). `extraccion` dice cuántos documentos de oferta hay, cuántos se leyeron y por qué no los demás (no descargables, plantillas en blanco, no cuadran…).
Input Schema
{
"type": "object",
"properties": {
"portafolio": {
"type": "string",
"pattern": "^CO1\\.BDOS\\.[0-9]{1,12}$",
"description": "Identificador de portafolio de SECOP II, CO1.BDOS.<número> (campo id_portafolio)"
},
"pagina": {
"type": "integer",
"minimum": 1,
"default": 1
},
"por_pagina": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 25
}
},
"required": [
"portafolio"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"resultados": {
"type": "array",
"items": {
"type": "object",
"properties": {
"iva_calidad": {
"type": "string",
"enum": [
"publicado",
"cero_en_documento",
"no_publicado"
]
},
"valor_iva_unitario": {
"anyOf": [
{
"type": [
"number",
"string"
]
},
{
"type": "null"
}
]
},
"valor_iva_linea": {
"anyOf": [
{
"type": [
"number",
"string"
]
},
{
"type": "null"
}
]
},
"valor_iva_linea_calidad": {
"type": "string",
"enum": [
"publicado",
"calculado",
"no_publicado"
]
},
"iva_tarifa": {
"anyOf": [
{
"type": [
"number",
"string"
]
},
{
"type": "null"
}
]
}
},
"required": [
"iva_calidad",
"valor_iva_unitario",
"valor_iva_linea",
"iva_tarifa"
],
"additionalProperties": true
}
},
"pagina": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"cobertura": {
"type": "object",
"properties": {
"alcance": {
"type": "string",
"enum": [
"completo",
"parcial",
"no_cubierto"
]
},
"fuentes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"dataset": {
"type": "string"
},
"url": {
"type": "string"
},
"ultima_sincronizacion": {
"type": [
"string",
"null"
]
},
"corte": {
"type": [
"string",
"null"
]
},
"capturado_hasta": {
"type": [
"string",
"null"
]
},
"nota_corte": {
"type": [
"string",
"null"
]
}
},
"required": [
"dataset",
"url",
"ultima_sincronizacion",
"corte",
"capturado_hasta",
"nota_corte"
],
"additionalProperties": true
}
},
"nota": {
"type": "string"
}
},
"required": [
"alcance",
"fuentes",
"nota"
],
"additionalProperties": true
},
"extraccion": {
"type": "object",
"properties": {},
"additionalProperties": true
}
},
"required": [
"resultados",
"pagina",
"cobertura",
"extraccion"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢radicadouno_evaluacion_proceso(portafolio, solo_vigentes, pagina, por_pagina)
Cómo evaluó la entidad a cada proponente de un proceso de SECOP II (CO1.BDOS.n): habilitación jurídica, técnica y financiera, rechazo y su causa (código de una taxonomía cerrada: experiencia, capacidad_financiera, supera_presupuesto…), retiro, puntaje por criterio y total, orden de elegibilidad y lote, leídos del informe de evaluación o de la resolución de adjudicación. Solo se publica un documento si su aritmética cuadra, el orden es coherente con los puntajes, cada proponente casa con los que registra SECOP y, en los definitivos, el primero es el adjudicatario. Solo sociedades y consorcios. FILAS: una por proponente, por lote y por documento leído (preliminar, definitivo o consolidado, resolución de adjudicación): el mismo proponente sale una vez por cada documento que lo evalúa. clave_proponente (opaca) dice qué filas son del mismo proponente. vigente=true en la del documento más firme de ese proponente y lote (documento.firmeza: adjudicacion > definitivo > sin_etapa > preliminar; a igualdad, el más reciente); las demás son la historia (p. ej. el preliminar ya superado). solo_vigentes=true deja una fila por proponente y lote; conteo dice filas, filas_vigentes y proponentes del proceso. `extraccion` dice cuántos documentos de evaluación hay y por qué no se leyeron los demás. extraccion.estado: 'nunca' = aún no se ha consultado la fuente; 'sin_documentos' = se consultó (ultima_revision dice cuándo) y SECOP II no publica ningún documento de evaluación del proceso (por ahora no hay nada que leer); 'pendiente' = hay documentos sin leer; 'hecha' = todos leídos. documento_url es null si en el proceso hay proponentes que no se publican (la huella sha256 sí va).
Input Schema
{
"type": "object",
"properties": {
"portafolio": {
"type": "string",
"pattern": "^CO1\\.BDOS\\.[0-9]{1,12}$",
"description": "Identificador de portafolio de SECOP II, CO1.BDOS.<número> (campo id_portafolio)"
},
"solo_vigentes": {
"type": "boolean",
"default": false,
"description": "true: solo la fila vigente de cada proponente y lote"
},
"pagina": {
"type": "integer",
"minimum": 1,
"default": 1
},
"por_pagina": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 25
}
},
"required": [
"portafolio"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"resultados": {
"type": "array",
"items": {
"type": "object",
"properties": {
"vigente": {
"type": "boolean"
},
"clave_proponente": {
"type": [
"string",
"null"
]
}
},
"required": [
"vigente"
],
"additionalProperties": true
}
},
"pagina": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"cobertura": {
"type": "object",
"properties": {
"alcance": {
"type": "string",
"enum": [
"completo",
"parcial",
"no_cubierto"
]
},
"fuentes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"dataset": {
"type": "string"
},
"url": {
"type": "string"
},
"ultima_sincronizacion": {
"type": [
"string",
"null"
]
},
"corte": {
"type": [
"string",
"null"
]
},
"capturado_hasta": {
"type": [
"string",
"null"
]
},
"nota_corte": {
"type": [
"string",
"null"
]
}
},
"required": [
"dataset",
"url",
"ultima_sincronizacion",
"corte",
"capturado_hasta",
"nota_corte"
],
"additionalProperties": true
}
},
"nota": {
"type": "string"
}
},
"required": [
"alcance",
"fuentes",
"nota"
],
"additionalProperties": true
},
"conteo": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"extraccion": {
"type": "object",
"properties": {},
"additionalProperties": true
}
},
"required": [
"resultados",
"pagina",
"cobertura",
"extraccion"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢radicadouno_modificaciones_contrato(id_contrato)
Modificaciones publicadas de un contrato de SECOP II (CO1.PCCNTR.n, campo id_contrato del historial): valor tras cada modificación, días extendidos, liquidación, y el resumen valor inicial → adiciones → valor final, cada uno con su *_calidad (null y 'no_recuperable' si no consta: el valor inicial solo se publica desde junio de 2026).
Input Schema
{
"type": "object",
"properties": {
"id_contrato": {
"type": "string",
"pattern": "^CO1\\.PCCNTR\\.[0-9]{1,12}$",
"description": "CO1.PCCNTR.<número>"
}
},
"required": [
"id_contrato"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"resumen": {
"anyOf": [
{
"type": "object",
"properties": {
"valor_inicial_calidad": {
"type": "string",
"enum": [
"publicado",
"cero_en_fuente",
"calculado",
"sin_modificaciones_publicadas",
"no_recuperable"
],
"description": "no_recuperable siempre va con el valor a null; 0 solo si la fuente publica 0"
},
"valor_adiciones_calidad": {
"$ref": "#/properties/resumen/anyOf/0/properties/valor_inicial_calidad"
},
"valor_final_calidad": {
"$ref": "#/properties/resumen/anyOf/0/properties/valor_inicial_calidad"
}
},
"required": [
"valor_inicial_calidad",
"valor_adiciones_calidad",
"valor_final_calidad"
],
"additionalProperties": true
},
{
"type": "null"
}
]
},
"modificaciones": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": true
}
},
"cobertura": {
"type": "object",
"properties": {
"alcance": {
"type": "string",
"enum": [
"completo",
"parcial",
"no_cubierto"
]
},
"fuentes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"dataset": {
"type": "string"
},
"url": {
"type": "string"
},
"ultima_sincronizacion": {
"type": [
"string",
"null"
]
},
"corte": {
"type": [
"string",
"null"
]
},
"capturado_hasta": {
"type": [
"string",
"null"
]
},
"nota_corte": {
"type": [
"string",
"null"
]
}
},
"required": [
"dataset",
"url",
"ultima_sincronizacion",
"corte",
"capturado_hasta",
"nota_corte"
],
"additionalProperties": true
}
},
"nota": {
"type": "string"
}
},
"required": [
"alcance",
"fuentes",
"nota"
],
"additionalProperties": true
}
},
"required": [
"resumen",
"modificaciones",
"cobertura"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢radicadouno_precios_tvec(nit, q, desde, hasta, pagina, ...)
Líneas de las órdenes de compra de la Tienda Virtual del Estado (acuerdos marco) de una empresa: ítem, cantidad, unidad, precio unitario, total, entidad y fecha. Sirve para comparar precios de compras equivalentes. Filtro de texto por ítem (q).
Input Schema
{
"type": "object",
"properties": {
"nit": {
"type": "string",
"pattern": "^[0-9]{5,15}$",
"description": "NIT, solo dígitos, sin dígito de verificación"
},
"q": {
"type": "string",
"minLength": 3,
"description": "Texto del ítem, p. ej. 'archivador'"
},
"desde": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "AAAA-MM-DD"
},
"hasta": {
"$ref": "#/properties/desde",
"description": "AAAA-MM-DD"
},
"pagina": {
"type": "integer",
"minimum": 1,
"default": 1
},
"por_pagina": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 25
}
},
"required": [
"nit"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"resultados": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": true
}
},
"pagina": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"cobertura": {
"type": "object",
"properties": {
"alcance": {
"type": "string",
"enum": [
"completo",
"parcial",
"no_cubierto"
]
},
"fuentes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"dataset": {
"type": "string"
},
"url": {
"type": "string"
},
"ultima_sincronizacion": {
"type": [
"string",
"null"
]
},
"corte": {
"type": [
"string",
"null"
]
},
"capturado_hasta": {
"type": [
"string",
"null"
]
},
"nota_corte": {
"type": [
"string",
"null"
]
}
},
"required": [
"dataset",
"url",
"ultima_sincronizacion",
"corte",
"capturado_hasta",
"nota_corte"
],
"additionalProperties": true
}
},
"nota": {
"type": "string"
}
},
"required": [
"alcance",
"fuentes",
"nota"
],
"additionalProperties": true
}
},
"required": [
"resultados",
"pagina",
"cobertura"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢radicadouno_matriz_fuentes
Por cada dataset de datos.gov.co del que salen las herramientas de licitaciones y del registro: nombre y uso, período cubierto en la base (fecha mínima y máxima del dato de negocio), corte (hasta cuándo la base refleja la fuente entera; null con nota_corte si no se puede verificar, nunca una fecha supuesta), última sincronización correcta, modo (delta, ventana, completa, carga_unica, bajo_demanda, incremental_por_id, foto_diaria), frecuencia (el cron real, en UTC), retraso actual (ahora − corte) y retraso máximo esperado, y cobertura (completa o parcial, con nota). Incluye universo_registral: cuántas matrículas hay y cuántas quedan fuera de la búsqueda registral por cada motivo. Todo instante en UTC, ISO 8601 con «Z». Úsala para decir al usuario hasta qué fecha está al día un dato.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"zona_horaria": {
"type": "string",
"const": "UTC"
},
"generado_en": {
"type": "string"
},
"fuentes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"dataset": {
"type": "string"
},
"nombre": {
"type": "string"
},
"corte": {
"type": [
"string",
"null"
]
},
"nota_corte": {
"type": [
"string",
"null"
]
},
"ultima_sincronizacion": {
"type": [
"string",
"null"
]
},
"modo": {
"type": "string"
},
"periodo": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"retraso_actual": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"retraso_maximo_esperado": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"cobertura": {
"type": "object",
"properties": {
"alcance": {
"type": "string",
"enum": [
"completa",
"parcial"
]
},
"nota": {
"type": "string"
}
},
"required": [
"alcance",
"nota"
],
"additionalProperties": false
}
},
"required": [
"dataset",
"nombre",
"corte",
"nota_corte",
"ultima_sincronizacion",
"modo",
"periodo",
"retraso_actual",
"retraso_maximo_esperado",
"cobertura"
],
"additionalProperties": true
}
},
"universo_registral": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"estadisticas": {
"type": "object",
"properties": {},
"additionalProperties": true
}
},
"required": [
"zona_horaria",
"generado_en",
"fuentes",
"universo_registral",
"estadisticas"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Community
Evidence