CATMAT - Catalogo de Materiais

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+)

Nivel	Quantidade	Exemplo
Grupo	79	”EQUIPAMENTOS DE ESCRITORIO”
Classe	~700	”MAQUINAS DE CALCULAR”
PDM	~20.000	”CALCULADORA CIENTIFICA”
Item	337.000+	“CALCULADORA CIENTIFICA 240 FUNCOES”

Endpoints

Listar Grupos

GET /api/catmat/grupos

Retorna todos os grupos de materiais (79 total).

number

default:"1"

Pagina atual

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.

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.

number

Codigo da classe para filtrar

Buscar Itens

GET /api/catmat/itens

Busca itens de materiais. Use q para busca por texto.

number

Codigo do PDM para filtrar

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

Encontrar codigo de um material

Use a busca por texto para encontrar o codigo do item:

curl ".../api/catmat/itens?q=notebook%20dell"

Listar materiais de uma categoria

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"