> ## 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.
# SIC
> Busque no registro normativo e no Boletín Jurídico da Superintendencia de Industria y Comercio da Colômbia: suas resoluções, circulares, a Circular Única, sua doutrina e as decisões e conceitos que destaca, com cada arquivo original; consulte qualquer um.
A Superintendencia de Industria y Comercio (SIC) é a autoridade colombiana de proteção ao consumidor, dados pessoais, propriedade industrial, concorrência e regulamentos técnicos, e a maior jurisdição de direito do consumidor do país. Aqui estão duas de suas publicações. Seu registro normativo reúne cerca de 7.600 atos: as leis e decretos que aplica, suas resoluções e circulares, cada título da Circular Única à medida que é reexpedido, a doutrina de sua relatoria de concorrência, seus projetos de resolução e suas nomeações, cada um com suas datas de expedição e publicação, o resumo da Superintendencia e cada arquivo anexo. Seu Boletín Jurídico reúne cerca de 750 itens desde 2019: as decisões e conceitos que a Oficina Asesora Jurídica decide destacar, por área, com um resumo e o documento de fundo, mais os conceitos que publica junto a eles.
Busque em qualquer um dos dois por tipo, área, data ou texto livre sobre os títulos e resumos. Os itens novos aparecem no dia seguinte ao que a Superintendencia os publica.
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](/pt/datasets).
## Buscar no registro
`POST /co/sic-normativa/regulations-search/v1` Dataset
Uma única busca sobre cada ato do registro normativo da Superintendencia, filtrada por tipo, área, data de expedição ou data de publicação.
| Campo | Tipo | Notas |
| ---------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query` | string | Palavras opcionais buscadas no título e no resumo. |
| `kind` | string | Tipo opcional como o registro o classifica, p. ex. `Resoluciones`, `Circulares`, `Títulos Circular única`, `Leyes`, `Decretos`, `Doctrina`, `Nombramientos`, `Proyectos de resolución`. Maiúsculas e acentos são ignorados. |
| `topic` | string | Área opcional da Superintendencia, p. ex. `Protección al Consumidor`, `Protección de Datos Personales`, `Propiedad Industrial`, `Protección a la Competencia`, comparada desde o início. Maiúsculas e acentos são ignorados. |
| `issued_from` | string | Opcional: só atos expedidos nesta data ou depois, `yyyy-mm-dd`. |
| `issued_to` | string | Opcional: só atos expedidos nesta data ou antes, `yyyy-mm-dd`. |
| `published_from` | string | Opcional: só atos publicados nesta data ou depois, `yyyy-mm-dd`. |
| `published_to` | string | Opcional: só atos publicados nesta data 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/sic-normativa/regulations-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "query": "habeas data", "kind": "Circulares" }'
```
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 publicado mais recentemente ao mais antigo. Cada resultado traz `id` (o número permanente do ato no registro), `title`, `kinds[]` (como o registro o classifica: `Resoluciones`, `Circulares`, `Títulos Circular única`, `Leyes`, `Decretos`, `Doctrina`, `Nombramientos`, ...), `topic` (a área da Superintendencia), `summary` (nas palavras dela), `issued_at`, `published_at`, `official_url` (o ato no registro), `document_url`, `source_document_url` e `documents[]`. `document_url` é a cópia da Croma do arquivo principal do item, idêntica byte a byte à que a Superintendencia publicou, que continua disponível aconteça o que acontecer com o link da Superintendencia; `source_document_url` é o arquivo no site dela; `documents[]` lista cada arquivo anexo com seu `name`, `format`, `document_url`, `source_document_url` e `bytes`.
## Um ato do registro
`POST /co/sic-normativa/regulation/v1` Dataset
| Campo | Tipo | Notas |
| --------------- | ------ | ------------------------------------------------------------------------------------------- |
| `regulation_id` | string | **Obrigatório.** O `id` do ato retornado pela busca, p. ex. `24968`, ou sua `official_url`. |
```bash theme={"dark"}
curl https://api.croma.run/co/sic-normativa/regulation/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "regulation_id": "24968" }'
```
Retorna `as_of`, `found`, `regulation_id` e `regulation`. Cada resultado traz `id` (o número permanente do ato no registro), `title`, `kinds[]` (como o registro o classifica: `Resoluciones`, `Circulares`, `Títulos Circular única`, `Leyes`, `Decretos`, `Doctrina`, `Nombramientos`, ...), `topic` (a área da Superintendencia), `summary` (nas palavras dela), `issued_at`, `published_at`, `official_url` (o ato no registro), `document_url`, `source_document_url` e `documents[]`. `document_url` é a cópia da Croma do arquivo principal do item, idêntica byte a byte à que a Superintendencia publicou, que continua disponível aconteça o que acontecer com o link da Superintendencia; `source_document_url` é o arquivo no site dela; `documents[]` lista cada arquivo anexo com seu `name`, `format`, `document_url`, `source_document_url` e `bytes`.
Um `id` que o site da Superintendencia não tem retorna `found: false` com HTTP 200, não um erro.
## Buscar no Boletín Jurídico
`POST /co/sic-normativa/bulletins-search/v1` Dataset
Uma única busca sobre cada item do Boletín Jurídico e seus conceitos, filtrada por seção, área ou data de publicação.
| Campo | Tipo | Notas |
| ---------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query` | string | Palavras opcionais buscadas no título, no resumo e nas etiquetas. |
| `section` | enum | Seção opcional: `bulletin` (um item do Boletín) ou `opinion` (um conceito). Padrão `any`. Por padrão `any`. |
| `topic` | string | Área opcional da Superintendencia, p. ex. `Protección al Consumidor`, `Asuntos Jurisdiccionales`, `Propiedad Industrial`, comparada desde o início. Maiúsculas e acentos são ignorados. |
| `published_from` | string | Opcional: só itens publicados nesta data ou depois, `yyyy-mm-dd`. |
| `published_to` | string | Opcional: só itens publicados nesta data 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/sic-normativa/bulletins-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "query": "retracto", "topic": "Protección al Consumidor" }'
```
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 publicado mais recentemente ao mais antigo. Cada resultado traz `id`, `section` (`bulletin` ou `opinion`), `title`, `topic` (a área da Superintendencia), `tags[]`, `published_at`, `summary` (o resumo da Superintendencia da decisão ou do conceito), `official_url` (o item no site dela), `document_url`, `source_document_url` e `documents[]`. `document_url` é a cópia da Croma do arquivo principal do item, idêntica byte a byte à que a Superintendencia publicou, que continua disponível aconteça o que acontecer com o link da Superintendencia; `source_document_url` é o arquivo no site dela; `documents[]` lista cada arquivo anexo com seu `name`, `format`, `document_url`, `source_document_url` e `bytes`.
## Um item do Boletín
`POST /co/sic-normativa/bulletin/v1` Dataset
| Campo | Tipo | Notas |
| ------------- | ------ | -------------------------------------------------------------------------------------------- |
| `bulletin_id` | string | **Obrigatório.** O `id` do item retornado pela busca, p. ex. `24896`, ou sua `official_url`. |
```bash theme={"dark"}
curl https://api.croma.run/co/sic-normativa/bulletin/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "bulletin_id": "24896" }'
```
Retorna `as_of`, `found`, `bulletin_id` e `bulletin`. Cada resultado traz `id`, `section` (`bulletin` ou `opinion`), `title`, `topic` (a área da Superintendencia), `tags[]`, `published_at`, `summary` (o resumo da Superintendencia da decisão ou do conceito), `official_url` (o item no site dela), `document_url`, `source_document_url` e `documents[]`. `document_url` é a cópia da Croma do arquivo principal do item, idêntica byte a byte à que a Superintendencia publicou, que continua disponível aconteça o que acontecer com o link da Superintendencia; `source_document_url` é o arquivo no site dela; `documents[]` lista cada arquivo anexo com seu `name`, `format`, `document_url`, `source_document_url` e `bytes`.
Um `id` que o site da Superintendencia não tem retorna `found: false` com HTTP 200, não um erro.
Esquemas, todos os campos de resposta e um playground interativo.