O que é o QSA do CNPJ e como consultar o quadro societário por API

O que o QSA mostra, e o que não mostra

Para saber a participação de cada sócio, a fonte costuma ser o contrato social, registrado na Junta Comercial. Para chegar ao contato de cada um, é preciso cruzar com bases de contato: o guia de sócios pelo CNPJ mostra como.

O que significa cada qualificação

A qualificação diz qual é o papel da pessoa na empresa. A Receita usa uma tabela de códigos, e estes são os mais comuns:

Em vendas B2B, os sócios-administradores e administradores costumam ser os primeiros a procurar, porque respondem pela empresa. Em grandes empresas, o QSA lista a diretoria, que nem sempre é quem decide a compra do seu produto.

Formas de consultar

Como consultar o QSA pela API da DataX

A ficha do CNPJ traz o quadro societário no campo socios, junto com os dados cadastrais da empresa. Cada consulta consome 1 requisição do limite diário.

curl https://api.datax.plus/v1/empresas/11222333000181 \
  -H "api-key: $DATAX_KEY"

{
  "cnpj": "11222333000181",
  "razaoSocial": "EXEMPLO TECNOLOGIA LTDA",
  "socios": [
    {
      "nome": "JOÃO P. LIMA",
      "qualificacao": "Sócio-Administrador",
      "dataEntrada": "2015-06-02"
    }
  ]
}

O exemplo abaixo, em Python, ordena o quadro para deixar primeiro quem costuma responder pela empresa.

import os
import requests

KEY = os.environ["DATAX_KEY"]
ORDEM = ["administrador", "presidente", "diretor", "titular", "sócio"]


def peso(socio):
    qualificacao = (socio.get("qualificacao") or "").lower()
    return next((i for i, termo in enumerate(ORDEM) if termo in qualificacao), len(ORDEM))


def quadro_societario(cnpj):
    r = requests.get(
        f"https://api.datax.plus/v1/empresas/{cnpj}",
        headers={"api-key": KEY},
        timeout=30,
    )
    r.raise_for_status()
    return sorted(r.json().get("socios") or [], key=peso)


for socio in quadro_societario("11222333000181"):
    print(socio.get("qualificacao"), "|", socio.get("nome"))

Ficha do CNPJ ou consulta de sócios?

Um fluxo comum usa as duas: a ficha para qualificar a empresa e, se ela interessar, a consulta de sócios para chegar ao contato. Se você só quer o contato, a consulta de sócios sozinha já resolve.

Cuidados ao usar o QSA

• Empresa sem sócio pessoa física. Se todos os sócios forem pessoas jurídicas, como numa holding, a consulta de sócios pode voltar sem ninguém. Trate a lista vazia como um resultado normal.
• MEI e empresário individual. Essas empresas têm um único titular e não têm sócios, então o quadro pode vir vazio.
• Mudanças recentes. O QSA mostra o que foi registrado. Uma alteração de sócios pode levar um tempo até aparecer nas bases, então confirme com a empresa antes de uma decisão importante.
• Dados pessoais. Nome e CPF de sócios são dados pessoais, mesmo vindo de um cadastro público. Use os contatos com uma finalidade legítima e clara, ofereça a opção de sair da lista e evite disparos em massa. Na dúvida sobre a LGPD no seu caso, fale com o seu jurídico.

Fontes

• Qualificações: Ato Declaratório Executivo Cocad nº 2/2011, com as tabelas de natureza jurídica e qualificação da Receita Federal.
• Campos do quadro nos dados abertos: conferidos em 4 de novembro de 2026 em APIs públicas que repassam esses arquivos, como a Minha Receita.