Skip to main content
O CATMAT (Catalogo de Materiais) e o sistema de classificacao de materiais do governo federal brasileiro. Ele organiza mais de 337.000 itens em uma hierarquia de 4 niveis.

​
Hierarquia

Grupo (79)
  └── Classe (~700)
        └── PDM (~20.000)
              └── Item (337.000+)
NivelQuantidadeExemplo
Grupo79”EQUIPAMENTOS DE ESCRITORIO”
Classe~700”MAQUINAS DE CALCULAR”
PDM~20.000”CALCULADORA CIENTIFICA”
Item337.000+“CALCULADORA CIENTIFICA 240 FUNCOES”

​
Endpoints

​
Listar Grupos

GET /api/catmat/grupos
Retorna todos os grupos de materiais (79 total).
​
page
number
default:"1"
Pagina atual
​
limit
number
default:"20"
Itens por pagina (max 100)
Exemplo: 
curl "https://api.ata360.com.br/api/catmat/grupos?limit=5" \
  -H "Authorization: Bearer $API_KEY"

​
Listar Classes

GET /api/catmat/classes
Retorna classes de materiais. Filtre por grupo.
​
grupo
number
Codigo do grupo para filtrar
Exemplo: 
# Classes do grupo 75 (Equipamentos de Escritorio)
curl "https://api.ata360.com.br/api/catmat/classes?grupo=75" \
  -H "Authorization: Bearer $API_KEY"

​
Listar PDMs

GET /api/catmat/pdm
Retorna PDMs (Padrao Descritivo de Material). Filtre por classe.
​
classe
number
Codigo da classe para filtrar

​
Buscar Itens

GET /api/catmat/itens
Busca itens de materiais. Use q para busca por texto.
​
pdm
number
Codigo do PDM para filtrar
​
q
string
Busca por descricao (min 3 caracteres)
Exemplo: 
# Buscar itens com "papel a4"
curl "https://api.ata360.com.br/api/catmat/itens?q=papel%20a4&limit=5" \
  -H "Authorization: Bearer $API_KEY"

​
Resposta de Item

{
  "data": [
    {
      "codigo": 150233,
      "codigoPdm": 1234,
      "descricao": "PAPEL A4 75G/M2 BRANCO",
      "unidadeFornecimento": "RESMA",
      "ncmCodigo": "4802.56.99",
      "ncmDescricao": "OUTROS PAPEIS E CARTOES",
      "sustentavel": 0,
      "status": 1
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 5,
    "total": 1250,
    "totalPages": 250
  }
}

​
Detalhes de um Item CATMAT

​
Dados do Item + PDM + Unidades

GET /api/catmat/item/{codigoItem}/details
Retorna informacoes completas do item, incluindo o PDM pai e as unidades de fornecimento permitidas. 
curl "https://api.ata360.com.br/api/catmat/item/214367/details" \
  -H "Authorization: Bearer $API_KEY"

{
  "item": {
    "codigo": 214367,
    "descricao": "PREGO ARDOX COM CABECA 19 X 36",
    "unidadeFornecimento": "UNIDADE",
    "ncmCodigo": "7317.00.90",
    "ncmDescricao": "OUTROS ARTIGOS SEMELHANTES DE FERRO FUNDIDO",
    "sustentavel": false
  },
  "pdm": {
    "codigo": 632,
    "descricao": "PREGO ARDOX COM CABECA"
  },
  "unidades": [
    { "sigla": "UN", "nome": "UNIDADE", "siglaUnidadeMedida": null, "capacidade": 0 },
    { "sigla": "KG", "nome": "QUILOGRAMA", "siglaUnidadeMedida": "kg", "capacidade": 0 },
    { "sigla": "PCT", "nome": "PACOTE", "siglaUnidadeMedida": null, "capacidade": 0 }
  ]
}
Um mesmo PDM pode ter multiplas unidades de fornecimento. Por exemplo, pregos podem ser comprados por unidade (UN), peso (KG) ou pacote (PCT). Essas unidades sao sincronizadas semanalmente da API Compras.gov.

​
Caracteristicas do Item

GET /api/catmat/item/{codigoItem}/caracteristicas
Retorna as caracteristicas detalhadas de um item CATMAT (consultado on-demand na API Compras.gov). 
curl "https://api.ata360.com.br/api/catmat/item/214367/caracteristicas" \
  -H "Authorization: Bearer $API_KEY"

{
  "codigoItem": 214367,
  "caracteristicas": [
    { "chave": "MATERIAL", "valor": "ARAME DE ACO", "codigo": "C001", "unidadeMedida": null },
    { "chave": "TIPO CABECA", "valor": "ARDOX", "codigo": "C002", "unidadeMedida": null },
    { "chave": "BITOLA", "valor": "19 X 36", "codigo": "C003", "unidadeMedida": "mm" }
  ]
}
As caracteristicas sao consultadas sob demanda na API Compras.gov (nao sao armazenadas localmente). A primeira chamada pode levar 1-2 segundos.

​
Unidades de Fornecimento por PDM

GET /api/catmat/pdm/{codigoPdm}/details
Consulta direta por codigo PDM (sem precisar do item). 
curl "https://api.ata360.com.br/api/catmat/pdm/632/details" \
  -H "Authorization: Bearer $API_KEY"

​
Casos de uso

Use a busca por texto para encontrar o codigo do item:
curl ".../api/catmat/itens?q=notebook%20dell"
Navegue pela hierarquia: grupo → classe → pdm → itens
# 1. Liste grupos
curl ".../api/catmat/grupos"

# 2. Liste classes do grupo escolhido
curl ".../api/catmat/classes?grupo=75"

# 3. Liste itens da classe
curl ".../api/catmat/itens?classe=7510"