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ês | Valor por consulta |
---|---|
1 - 10000 | R$ 0,050 |
10001 - 50000 | R$ 0,048 |
50001 - 100000 | R$ 0,046 |
100001 - 500000 | R$ 0,044 |
500001 - 1000000 | R$ 0,042 |
1000001 - 5000000 | R$ 34.000,00 (preço fixo) |
5000001 e acima | Entre em contato |
Parâmetros de consulta
A tabela abaixo detalha os campos aceitos na consulta a este dataset.
Campo | Descrição | Valores Possíveis | Tipo de Campo |
---|---|---|---|
doc | Documento de identificação | CNPJ | 🛑 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.