> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Normativa tributaria municipal

> Busca la normativa tributaria que publican las haciendas de las ciudades de Colombia, hoy Medellín y Cali: acuerdos, decretos, resoluciones y circulares sobre predial, industria y comercio, retenciones y el calendario tributario, cada uno con su documento original; consulta cualquiera.

Las ciudades de Colombia cobran sus propios impuestos (predial, industria y comercio y sus retenciones, avisos y tableros, alumbrado público, delineación urbana, estampillas) con reglas que cada ciudad escribe por su cuenta: los acuerdos de su Concejo, que expiden y modifican el estatuto tributario de la ciudad, los decretos de su Alcalde, que los reglamentan, y las resoluciones y circulares de su Secretaría de Hacienda, que nombran los agentes de retención, fijan el calendario tributario y las tarifas de autorretención, y abren y cierran plazos. Cada ciudad publica su propia lista en su propio sitio, y en ningún otro lado.

Este endpoint reúne esas listas en un solo corpus, con una copia de cada documento original. Hoy cubre Medellín (unos 120 actos desde 2003, entre ellos el estatuto del Acuerdo 093 de 2023) y Cali (unos 40 actos desde 2020, entre ellos el estatuto del Acuerdo 643 de 2026); vienen más ciudades. Busca por texto libre sobre el rótulo de cada acto y la descripción de la ciudad, o por ciudad, tipo, número, año o fecha, y consulta cualquiera con el enlace a su documento.

> [!NOTE]
>
> La fuente entera, organizada y lista para consultar: cada endpoint de esta página responde en milisegundos. Cada respuesta incluye `as_of`: qué tan actualizados están los datos. [Cómo funcionan los datasets](https://docs.usecroma.com/es/datasets.md).

## Buscar normas

`POST /co/hacienda-municipal/regulations-search/v1` [Dataset](https://docs.usecroma.com/es/datasets.md)

Una sola búsqueda sobre cada acto que listan las ciudades cubiertas, filtrada por ciudad, tipo, número, año o fecha.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palabras opcionales que se buscan en el rótulo de cada acto y en la descripción de la ciudad, p. ej. `calendario tributario` o `autorretenedores`. |
| `city` | enum | Opcional: `medellin` o `cali`. |
| `kind` | enum | Tipo opcional: `acuerdo` (del Concejo), `decreto` (del Alcalde), `resolucion` (de la hacienda de la ciudad), `circular` u `otro`. Por defecto `any`. |
| `number` | string | Número opcional del acto tal como lo escribe la ciudad, p. ej. `067`, `202550098566` o `SH18-007`. Los ceros a la izquierda no importan. |
| `year` | integer | Año opcional del acto, 1990 o posterior. 0 busca en todos los años. Por defecto `0`. |
| `issued_from` | string | Opcional: solo actos fechados en este día o después, `yyyy-mm-dd`. |
| `issued_to` | string | Opcional: solo actos fechados en este día o antes, `yyyy-mm-dd`. |
| `page` | integer | Número de página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Resultados por página (1-50). Por defecto `20`. |

```bash theme={"dark"}
curl https://api.croma.run/co/hacienda-municipal/regulations-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "calendario tributario", "city": "medellin" }'
```

Devuelve `as_of` (qué tan actualizados están los datos), los filtros aplicados, `total` y `total_is_exact`, `page`, `per_page`, `total_pages`, `count` y `results[]`, del año más reciente al más antiguo (del más pertinente al menos cuando se envía `query`). Cada resultado incluye `id`, `city` (`medellin` o `cali`), `city_name`, `entity` (la entidad que lo publica), `kind` (`acuerdo`, `decreto`, `resolucion`, `circular` u `otro`), `number`, `year`, `issued_at` (la fecha del acto, cuando el rótulo de la ciudad trae una completa), `published_at` (cuándo la ciudad puso el documento en su página, cuando la página lo dice), `title` (tal como lo rotula la ciudad), `summary` (la descripción de una línea de la ciudad, cuando la da), `section` (el encabezado bajo el que está en la página de la ciudad), `official_url` (la página de la ciudad que lo lista), `document_name`, `document_format`, `document_bytes`, `document_url` y `source_document_url`. `document_url` es la copia de Croma del documento, idéntica byte a byte a la que publicó la ciudad, que sigue disponible pase lo que pase con el enlace de la ciudad (nula mientras la copia sigue pendiente); `source_document_url` es el documento en el sitio de la ciudad.

## Una norma

`POST /co/hacienda-municipal/regulation/v1` [Dataset](https://docs.usecroma.com/es/datasets.md)

| Campo | Tipo | Notas |
| - | - | - |
| `regulation_id` | string | **Obligatorio.** El `id` del acto que devuelve la búsqueda, p. ej. `medellin-b5327fbf73247a8c`, o su `source_document_url`. |

```bash theme={"dark"}
curl https://api.croma.run/co/hacienda-municipal/regulation/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "regulation_id": "medellin-b5327fbf73247a8c" }'
```

Devuelve `as_of`, `found`, `regulation_id` y `regulation`. Cada resultado incluye `id`, `city` (`medellin` o `cali`), `city_name`, `entity` (la entidad que lo publica), `kind` (`acuerdo`, `decreto`, `resolucion`, `circular` u `otro`), `number`, `year`, `issued_at` (la fecha del acto, cuando el rótulo de la ciudad trae una completa), `published_at` (cuándo la ciudad puso el documento en su página, cuando la página lo dice), `title` (tal como lo rotula la ciudad), `summary` (la descripción de una línea de la ciudad, cuando la da), `section` (el encabezado bajo el que está en la página de la ciudad), `official_url` (la página de la ciudad que lo lista), `document_name`, `document_format`, `document_bytes`, `document_url` y `source_document_url`. `document_url` es la copia de Croma del documento, idéntica byte a byte a la que publicó la ciudad, que sigue disponible pase lo que pase con el enlace de la ciudad (nula mientras la copia sigue pendiente); `source_document_url` es el documento en el sitio de la ciudad.

> [!NOTE]
>
> Un `id` o enlace que ninguna de las páginas de las ciudades tiene devuelve `found: false` con HTTP 200, no un error.

> [card] [Referencia completa](https://docs.usecroma.com/es/api-reference/overview.md)
>
> Esquemas, todos los campos de respuesta y un playground interactivo.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.