categoryId. Esta página é o catálogo
completo das 130 categorias usadas pela API, na fonte. Para a lógica de
categorização (regras de cliente, correção manual, enriquecimento por estabelecimento),
veja /concepts/categorization.
Como ler os ids
Os ids têm 8 dígitos e são estáveis — nunca mudam, mesmo que o nome legível (description em inglês ou descriptionTranslated em português) seja ajustado. O id
codifica a posição na árvore de três níveis:
Faça join sempre por
categoryId, nunca por category / description. Os ids são
imutáveis; os nomes em inglês e português podem ser corrigidos a qualquer momento.
Joinar pelo nome quebra a integração silenciosamente.parentId e
parentDescription omitidos (nulos) — elas não têm pai. As colunas categoria-pai
abaixo derivam de parentDescription; um traço (—) indica uma categoria de topo.
As 130 categorias
São 130 categorias no total. O catálogo é versionado: novos ids podem ser adicionados,
mas ids existentes não são reaproveitados nem renumerados.