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

# CATSER - Catalogo de Servicos

> Como consultar o catalogo de servicos do governo

O CATSER (Catalogo de Servicos) e o sistema de classificacao de servicos do governo federal brasileiro. Ele organiza mais de 3.000 servicos em uma hierarquia de 3 niveis.

## Hierarquia

```
Grupo (147)
  └── Classe (~900)
        └── Item (3.000+)
```

| Nivel  | Quantidade | Exemplo                                    |
| ------ | ---------- | ------------------------------------------ |
| Grupo  | 147        | "SERVICOS DE LIMPEZA"                      |
| Classe | \~900      | "LIMPEZA PREDIAL"                          |
| Item   | 3.000+     | "SERVICO DE LIMPEZA E CONSERVACAO PREDIAL" |

<Note>
  Diferente do CATMAT, o CATSER nao possui o nivel PDM.
</Note>

## Endpoints

### Listar Grupos

```bash theme={null}
GET /api/catser/grupos
```

Retorna todos os grupos de servicos (147 total).

<ParamField query="page" type="number" default="1">
  Pagina atual
</ParamField>

<ParamField query="limit" type="number" default="20">
  Itens por pagina (max 100)
</ParamField>

**Exemplo:**

```bash theme={null}
curl "https://api.ata360.com.br/api/catser/grupos?limit=5" \
  -H "Authorization: Bearer $API_KEY"
```

### Listar Classes

```bash theme={null}
GET /api/catser/classes
```

Retorna classes de servicos. Filtre por grupo.

<ParamField query="grupo" type="number">
  Codigo do grupo para filtrar
</ParamField>

**Exemplo:**

```bash theme={null}
# Classes do grupo 111 (Desenvolvimento de Software)
curl "https://api.ata360.com.br/api/catser/classes?grupo=111" \
  -H "Authorization: Bearer $API_KEY"
```

### Buscar Itens

```bash theme={null}
GET /api/catser/itens
```

Busca itens de servicos. Use `q` para busca por texto.

<ParamField query="classe" type="number">
  Codigo da classe para filtrar
</ParamField>

<ParamField query="q" type="string">
  Busca por descricao (min 3 caracteres)
</ParamField>

**Exemplo:**

```bash theme={null}
# Buscar servicos de "limpeza"
curl "https://api.ata360.com.br/api/catser/itens?q=limpeza&limit=5" \
  -H "Authorization: Bearer $API_KEY"
```

## Resposta de Item

```json theme={null}
{
  "data": [
    {
      "codigo": 14397,
      "codigoClasse": 9311,
      "descricao": "SERVICO DE LIMPEZA E CONSERVACAO PREDIAL",
      "unidadeMedida": "METRO QUADRADO",
      "status": 1
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 5,
    "total": 89,
    "totalPages": 18
  }
}
```

## Casos de uso

<AccordionGroup>
  <Accordion title="Encontrar servicos de TI">
    ```bash theme={null}
    # Buscar servicos com "software"
    curl ".../api/catser/itens?q=software"

    # Ou navegue pelos grupos de TI (111, 112)
    curl ".../api/catser/classes?grupo=111"
    ```
  </Accordion>

  <Accordion title="Listar todos servicos de uma categoria">
    ```bash theme={null}
    # 1. Liste grupos
    curl ".../api/catser/grupos"

    # 2. Liste classes do grupo
    curl ".../api/catser/classes?grupo=111"

    # 3. Liste itens
    curl ".../api/catser/itens?classe=11101"
    ```
  </Accordion>
</AccordionGroup>

## Grupos mais comuns

| Codigo | Descricao                                |
| ------ | ---------------------------------------- |
| 111    | Desenvolvimento e Manutencao de Software |
| 112    | Manutencao e Sustentacao de Software     |
| 182    | Servicos de Limpeza e Conservacao        |
| 222    | Servicos de Vigilancia                   |
| 232    | Servicos de Transporte                   |