Documentação Técnica

Dados de Categoria Comercial - MCC

Descrição

O dataset de Dados de Categoria Comercial entrega informações a respeito da categorização da empresa consultada de acordo com o MCC (Merchant Category Code). O MCC é um número de quatro dígitos utilizado na classificação de serviços financeiros de varejo, que leva em consideração os tipos de bens ou serviços fornecidos.

Origem da Informação

Os dados deste dataset são obtidos da Associação Brasileira das Empresas de Cartão (ABECs), que disponibiliza mensalmente os dados de associação de empresas cadastradas com suas categorias comerciais (MCC). Caso a empresa não tenha registro na ABECs, são utilizados dados da Receita Federal para obter seus códigos CNAE e relacionar essas informações com um MCC através de dados também fornecidos pela ABECs.

Tabela de preços para esse dataset

Consultas Realizadas no MêsValor por consulta
1 - 10000R$ 0,050
10001 - 50000R$ 0,048
50001 - 100000R$ 0,046
100001 - 500000R$ 0,044
500001 - 1000000R$ 0,042
1000001 - 5000000R$ 34.000,00 (preço fixo)
5000001 e acimaEntre em contato

Parâmetros de consulta

A tabela abaixo detalha os campos aceitos na consulta a este dataset.

CampoDescriçãoValores PossíveisTipo de Campo
docDocumento de identificaçãoCNPJ🛑 Obrigatório

Clique aqui para saber mais sobre os parâmetros de consulta da Plataforma de Dados.

Abaixo está um exemplo de como realizar a chamada apenas com os parâmetros obrigatórios:

{  
    "Datasets": "merchant_category_data",
    "q": "doc{CNPJ}"  
}  

Retorno dos Dados

Este dataset possui duas listas de saída, MerchantCategories e CNAECategories, cada uma delas pode possuir múltiplos registros. Caso sejam encontrados registros de associação direta da empresa com a ABECs, a lista MerchantCategories será preenchida - isso é sinalizado através do indicador HasDirectAssociationData, que neste caso será true. A lista CNAECategories sempre será preenchida. Ela contém registros de associação dos códigos CNAE da empresa com os números de MCC.

Veja os detalhes sobre os campos dos registros de cada lista na descrição do objeto de resultado do dataset ao final desta página.

Language
Credentials
Click Try It! to start a request and see the response here!