# LicitIA Abierto

> Datos públicos de contrataciones del gobierno federal mexicano que el Estado publica para
> consulta y reutilización en ComprasMX y https://comprasmx.buengobierno.gob.mx/datos-abiertos, normalizados: procedimientos,
> adjudicaciones, proveedores, dependencias, unidades compradoras y precios unitarios por clave
> CUCOP. 367,756 procedimientos distintos, publicados desde
> 2023.

## Gramática de URLs

El identificador de un procedimiento es su número, en minúsculas. El prefijo determina el tipo,
y el tipo va en la ruta porque llamar «licitación» a una adjudicación directa sería falso:

  LA/LO/LE → https://licitia.com.mx/licitacion/{numero}
  IA/IO/IE → https://licitia.com.mx/invitacion/{numero}
  AA/AO/AE → https://licitia.com.mx/adjudicacion/{numero}
  AM       → https://licitia.com.mx/acuerdo-marco/{numero}

Ejemplo: https://licitia.com.mx/adjudicacion/aa-50-gyr-050gyr028-n-114-2024

Si tienes el número pero no sabes de qué tipo es, hay un alias permanente que redirige 301 a la
ruta canónica:

  https://licitia.com.mx/p/{numero}

Entidades:

  https://licitia.com.mx/proveedor/{slug}
  https://licitia.com.mx/dependencia/{slug}
  https://licitia.com.mx/unidad/{slug}
  https://licitia.com.mx/categoria/{clave_cucop}

El historial completo de cualquier entidad se recorre por cursor y puede filtrarse por ejercicio,
tipo o estatus:

  https://licitia.com.mx/proveedor/{slug}/procedimientos
  https://licitia.com.mx/dependencia/{slug}/procedimientos
  https://licitia.com.mx/unidad/{slug}/procedimientos
  https://licitia.com.mx/categoria/{clave_cucop}/procedimientos

Índices y agrupaciones, cada uno con sus totales y su desglose:

  https://licitia.com.mx/abierto                  vestíbulo del plano público
  https://licitia.com.mx/licitaciones             todos los procedimientos, por tipo y estatus
  https://licitia.com.mx/licitaciones/{anio}      un ejercicio fiscal (2022–2026)
  https://licitia.com.mx/licitaciones/seccion/{vigente|seguimiento|concluido}
                                             etapa operativa normalizada por LicitIA
  https://licitia.com.mx/licitaciones/estatus/{slug}
                                             estatus exacto reportado por ComprasMX
  https://licitia.com.mx/estado/{slug}            una de las 32 entidades federativas
  https://licitia.com.mx/ramo/{slug}              un ramo del Presupuesto de Egresos
  https://licitia.com.mx/dependencias             directorio de instituciones
  https://licitia.com.mx/unidades                 directorio de unidades compradoras
  https://licitia.com.mx/proveedores              directorio de empresas
  https://licitia.com.mx/categorias               catálogo CUCOP

La clave de entidad federativa es la de ComprasMX, no la del INEGI: la Ciudad de México es 7,
Michoacán 15 y el Estado de México 17. En las URLs se usa el nombre en minúsculas y sin acentos.

## Formatos por página

Los procedimientos aceptan tres representaciones, o negociación por cabecera `Accept`
sobre la URL HTML:

  Accept: text/markdown        Markdown limpio (~4 KB en vez de ~180 KB de HTML)
  Accept: application/json     el registro completo
  .ocds.json                   Open Contracting Data Standard 1.1

Los perfiles y sus historiales de proveedor, dependencia, unidad y categoría aceptan
Markdown y JSON por `Accept` o, como alias, los sufijos `.md` y `.json`.
Los anexos son descargables para verificación, pero no forman una superficie indexable.

**Cita siempre la URL HTML, sin sufijo.** `.md`, `.json` y `.ocds.json` son para leer,
no para referenciar.

## API

  https://api.licitia.com.mx/api/open/v1
  https://api.licitia.com.mx/api/open/v1/openapi.json

Sin autenticación. Paginación **sólo por cursor**: los parámetros `page` y `offset` se
rechazan con un error explicativo. Usa `page_info.next_cursor`. El cursor queda ligado al orden
y a la combinación exacta de filtros que lo generó; no lo reutilices con otros filtros.

Para mantenerte al día no vuelvas a recorrer el corpus: usa el feed de cambios.

  https://api.licitia.com.mx/api/open/v1/licitaciones/cambios?desde={iso8601}

## Descargas masivas

Si quieres el corpus entero, descárgalo en vez de rastrearlo. Es más rápido para ti y más barato
para los dos. NDJSON, un registro por línea, CC BY 4.0.

  https://api.licitia.com.mx/api/open/v1/descargas                        qué hay y en cuántos lotes
  https://api.licitia.com.mx/api/open/v1/descargas/{entidad}/{lote}       un lote

Las entidades son licitaciones, proveedores, compradores y categorias. Los lotes usan las mismas
fronteras que los fragmentos del sitemap.

## Qué NO contienen estos datos

- No se sabe quién presentará propuesta antes del acto de apertura. Nadie lo sabe.
- No se publican datos de contacto de servidores públicos ni RFC de personas físicas.
- No se publican montos estimados por modelos, sólo importes de la fuente.
- Los importes suman únicamente MXN. Hay contratos en USD, EUR, CAD, GBP y JPY; se cuentan
  aparte y no se convierten, porque el tipo de cambio de la fecha de fallo no está en la fuente.
- Se excluyen de los totales los importes atípicos (un contrato registrado con 498 mil millones
  de pesos, 1,335 veces el siguiente). Se cuentan y se declaran en la página.
- Un mismo nombre comercial puede corresponder a varias razones sociales. Cuando se detecta, el
  perfil se marca como ambiguo, se dice cuántas grafías agrupa y se excluye del índice.
- Algunas de las 21,393 claves CUCOP en uso no existen en el catálogo oficial
  y van sin descripción.

## Licencia y cita

CC BY 4.0. Cita como «LicitIA Abierto» e incluye la URL HTML del recurso, sin `.json`,
`.md` ni `.ocds.json`. La fuente
primaria es ComprasMX y su portal de Datos Abiertos; esta es una plataforma privada e
independiente, sin afiliación con el Gobierno de México. LicitIA es un producto de Global
Tech Operations, LLC.

Metodología y correcciones: https://licitia.com.mx/datos