> ## 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.

# Normas tributárias municipais

> Busque as normas tributárias que as fazendas das cidades da Colômbia publicam, hoje Medellín e Cali: acuerdos, decretos, resoluções e circulares sobre predial, indústria e comércio, retenções e o calendário tributário, cada um com seu documento original; consulte qualquer um.

As cidades da Colômbia cobram seus próprios impostos (predial, indústria e comércio e suas retenções, avisos e letreiros, iluminação pública, delineação urbana, estampilhas) com regras que cada cidade escreve por conta própria: os acuerdos de seu Concejo, que expedem e alteram o estatuto tributário da cidade, os decretos de seu Alcalde, que os regulamentam, e as resoluções e circulares de sua Secretaría de Hacienda, que nomeiam os agentes de retenção, fixam o calendário tributário e as alíquotas de autorretenção, e abrem e fecham prazos. Cada cidade publica sua própria lista em seu próprio site, e em nenhum outro lugar.

Este endpoint reúne essas listas em um só corpus, com uma cópia de cada documento original. Hoje cobre Medellín (cerca de 120 atos desde 2003, entre eles o estatuto do Acuerdo 093 de 2023) e Cali (cerca de 40 atos desde 2020, entre eles o estatuto do Acuerdo 643 de 2026); mais cidades virão. Busque por texto livre sobre o rótulo de cada ato e a descrição da cidade, ou por cidade, tipo, número, ano ou data, e consulte qualquer um com o link para seu documento.

> [!NOTE]
>
> A fonte inteira, organizada e pronta para consultar: cada endpoint desta página responde em milissegundos. Cada resposta traz `as_of`: o quão atuais são os dados. [Como funcionam os datasets](https://docs.usecroma.com/pt/datasets.md).

## Buscar normas

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

Uma única busca sobre cada ato que as cidades cobertas listam, filtrada por cidade, tipo, número, ano ou data.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palavras opcionais buscadas no rótulo de cada ato e na descrição da cidade, p. ex. `calendario tributario` ou `autorretenedores`. |
| `city` | enum | Opcional: `medellin` ou `cali`. |
| `kind` | enum | Tipo opcional: `acuerdo` (do Concejo), `decreto` (do Alcalde), `resolucion` (da fazenda da cidade), `circular` ou `otro`. Padrão `any`. Por padrão `any`. |
| `number` | string | Número opcional do ato como a cidade o escreve, p. ex. `067`, `202550098566` ou `SH18-007`. Zeros à esquerda não importam. |
| `year` | integer | Ano opcional do ato, 1990 ou posterior. 0 busca em todos os anos. Por padrão `0`. |
| `issued_from` | string | Opcional: só atos datados neste dia ou depois, `yyyy-mm-dd`. |
| `issued_to` | string | Opcional: só atos datados neste dia ou antes, `yyyy-mm-dd`. |
| `page` | integer | Número da página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Resultados por página (1-50). Por padrão `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" }'
```

Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total` e `total_is_exact`, `page`, `per_page`, `total_pages`, `count` e `results[]`, do ano mais recente ao mais antigo (do mais pertinente ao menos quando `query` é enviada). Cada resultado traz `id`, `city` (`medellin` ou `cali`), `city_name`, `entity` (o órgão que o publica), `kind` (`acuerdo`, `decreto`, `resolucion`, `circular` ou `otro`), `number`, `year`, `issued_at` (a data do ato, quando o rótulo da cidade traz uma completa), `published_at` (quando a cidade colocou o documento em sua página, quando a página informa), `title` (como a cidade o rotula), `summary` (a descrição de uma linha da cidade, quando a dá), `section` (o título sob o qual está na página da cidade), `official_url` (a página da cidade que o lista), `document_name`, `document_format`, `document_bytes`, `document_url` e `source_document_url`. `document_url` é a cópia da Croma do documento, idêntica byte a byte à que a cidade publicou, que continua disponível aconteça o que acontecer com o link da cidade (nula enquanto a cópia ainda está pendente); `source_document_url` é o documento no site da cidade.

## Uma norma

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

| Campo | Tipo | Notas |
| - | - | - |
| `regulation_id` | string | **Obrigatório.** O `id` do ato retornado pela busca, p. ex. `medellin-b5327fbf73247a8c`, ou sua `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" }'
```

Retorna `as_of`, `found`, `regulation_id` e `regulation`. Cada resultado traz `id`, `city` (`medellin` ou `cali`), `city_name`, `entity` (o órgão que o publica), `kind` (`acuerdo`, `decreto`, `resolucion`, `circular` ou `otro`), `number`, `year`, `issued_at` (a data do ato, quando o rótulo da cidade traz uma completa), `published_at` (quando a cidade colocou o documento em sua página, quando a página informa), `title` (como a cidade o rotula), `summary` (a descrição de uma linha da cidade, quando a dá), `section` (o título sob o qual está na página da cidade), `official_url` (a página da cidade que o lista), `document_name`, `document_format`, `document_bytes`, `document_url` e `source_document_url`. `document_url` é a cópia da Croma do documento, idêntica byte a byte à que a cidade publicou, que continua disponível aconteça o que acontecer com o link da cidade (nula enquanto a cópia ainda está pendente); `source_document_url` é o documento no site da cidade.

> [!NOTE]
>
> Um `id` ou link que nenhuma das páginas das cidades tem retorna `found: false` com HTTP 200, não um erro.

> [card] [Referência completa](https://docs.usecroma.com/pt/api-reference/overview.md)
>
> Esquemas, todos os campos de resposta e um playground interativo.


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