Receita Federal - Quadro de Sócios e Administradores
O que é
A Receita Federal do Brasil (RFB), em cumprimento às determinações contidas no Decreto nº 8.777, de 11 de maio de 2016, disponibiliza, os dados referentes aos quadros societários e de administradores das pessoas jurídicas.
Sobre a requisição:
Método: POST
Endereço: URL Base + /api/maestro/receita/qsa
URL Base:
Parâmetros do header
Authorization | String | Sim | Chave de API gerada no cadastro no Plexi, prefixada com |
Callback | String | Não | URL para onde o resultado da requisição será enviado via HTTP POST. |
Parâmetros do body
cnpj | string | Sim se o campo | CNPJ da empresa |
cnpjBase | string | Sim se o campo | CNPJ base da empresa |
Estrutura da resposta
201 | Created | Solicitação criada | Campo requestId, com o ID da requisição criada. |
422 | Unprocessable Entity | A solicitação contém erro | Em quais campos houve erro. |
Exemplos de retornos quando você faz a requisição:
Status 201
Status 422
Exemplos de retornos do resultado da pesquisa
Valores possíveis do campo “status“
cadastrado | Empresa encontrada |
erro | Empresa não encontrada. |
Respostas com registro encontrado
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
{
"status": "cadastrado",
"empresa": {
"cnpjBasico": "99999999",
"naturezaJuridica": "Sociedade Empresária Limitada",
"porte": "DEMAIS",
"qualificacaoResponsavel": "Administrador",
"razaoSocial": "EMPRESA LTDA.",
"capitalSocial": 9999999.00
},
"socios": [
{
"cpfCnpjRepresentanteLegal": "***000000**",
"identificadorSocio": "PESSOA FÍSICA",
"faixaEtaria": "Entre 41 a 50 anos",
"cnpjBasico": "99999999",
"qualificacaoSocio": "Administrador",
"qualificacaoRepresentante": "Não informada",
"nome": "FULANO FERRAZ",
"dataEntradaSociedade": "20220502",
"cpfCnpj": "***999999**"
},
{
"cpfCnpjRepresentanteLegal": "***000000**",
"identificadorSocio": "PESSOA FÍSICA",
"faixaEtaria": "Entre 31 a 40 anos",
"cnpjBasico": "99999999",
"qualificacaoSocio": "Administrador",
"qualificacaoRepresentante": "Não informada",
"nome": "FULANO PILOTO",
"dataEntradaSociedade": "20211116",
"cpfCnpj": "***999999**"
},
{
"cpfCnpjRepresentanteLegal": "***000000**",
"identificadorSocio": "PESSOA FÍSICA",
"faixaEtaria": "Entre 31 a 40 anos",
"cnpjBasico": "99999999",
"qualificacaoSocio": "Administrador",
"qualificacaoRepresentante": "Não informada",
"nome": "FULANO OLDHAM",
"dataEntradaSociedade": "20211116",
"cpfCnpj": "***999999**"
},
{
"cpfCnpjRepresentanteLegal": "***000000**",
"identificadorSocio": "PESSOA FÍSICA",
"faixaEtaria": "Entre 41 a 50 anos",
"cnpjBasico": "99999999",
"qualificacaoSocio": "Administrador",
"qualificacaoRepresentante": "Não informada",
"nome": "FULANO CIRNE",
"dataEntradaSociedade": "20210824",
"cpfCnpj": "***999999**"
},
{
"cpfCnpjRepresentanteLegal": "***000000**",
"identificadorSocio": "PESSOA FÍSICA",
"faixaEtaria": "Entre 31 a 40 anos",
"cnpjBasico": "99999999",
"qualificacaoSocio": "Administrador",
"qualificacaoRepresentante": "Não informada",
"nome": "FULANO NAZAR",
"dataEntradaSociedade": "20210824",
"cpfCnpj": "***999999**"
},
{
"cpfCnpjRepresentanteLegal": "***000000**",
"identificadorSocio": "PESSOA FÍSICA",
"faixaEtaria": "Entre 31 a 40 anos",
"cnpjBasico": "99999999",
"qualificacaoSocio": "Administrador",
"qualificacaoRepresentante": "Não informada",
"nome": "FULANO DE MELO",
"dataEntradaSociedade": "20191114",
"cpfCnpj": "***999999**"
},
{
"cpfCnpjRepresentanteLegal": "***000000**",
"identificadorSocio": "PESSOA FÍSICA",
"faixaEtaria": "Entre 31 a 40 anos",
"cnpjBasico": "99999999",
"qualificacaoSocio": "Administrador",
"qualificacaoRepresentante": "Não informada",
"nome": "FULANO REIS",
"dataEntradaSociedade": "20191114",
"cpfCnpj": "***999999**"
},
{
"cpfCnpjRepresentanteLegal": "***000000**",
"identificadorSocio": "PESSOA FÍSICA",
"faixaEtaria": "Entre 31 a 40 anos",
"cnpjBasico": "99999999",
"qualificacaoSocio": "Administrador",
"qualificacaoRepresentante": "Não informada",
"nome": "FULANO HUBER",
"dataEntradaSociedade": "20180919",
"cpfCnpj": "***999999**"
},
{
"cpfCnpjRepresentanteLegal": "***000000**",
"identificadorSocio": "PESSOA FÍSICA",
"faixaEtaria": "Entre 31 a 40 anos",
"cnpjBasico": "99999999",
"qualificacaoSocio": "Administrador",
"qualificacaoRepresentante": "Não informada",
"nome": "FULANO GRIGOLETTO",
"dataEntradaSociedade": "20180919",
"cpfCnpj": "***999999**"
},
{
"cpfCnpjRepresentanteLegal": "***000000**",
"identificadorSocio": "PESSOA FÍSICA",
"faixaEtaria": "Entre 31 a 40 anos",
"cnpjBasico": "99999999",
"qualificacaoSocio": "Administrador",
"qualificacaoRepresentante": "Não informada",
"nome": "FULANO PENCZ",
"dataEntradaSociedade": "20180919",
"cpfCnpj": "***999999**"
},
{
"cpfCnpjRepresentanteLegal": "***999999**",
"nomeRepresentante": "FULANO HAGENBUCH",
"identificadorSocio": "PESSOA JURÍDICA",
"faixaEtaria": "Não se aplica",
"cnpjBasico": "99999999",
"qualificacaoSocio": "Sócio Pessoa Jurídica Domiciliado no Exterior",
"qualificacaoRepresentante": "Procurador",
"nome": "EMPRESA LLC",
"dataEntradaSociedade": "20180710",
"cpfCnpj": "99999999999999",
"pais": "ESTADOS UNIDOS"
},
{
"cpfCnpjRepresentanteLegal": "***000000**",
"identificadorSocio": "PESSOA FÍSICA",
"faixaEtaria": "Entre 31 a 40 anos",
"cnpjBasico": "99999999",
"qualificacaoSocio": "Administrador",
"qualificacaoRepresentante": "Não informada",
"nome": "FULANO HAGENBUCH",
"dataEntradaSociedade": "20180611",
"cpfCnpj": "***999999**"
}
],
"pdf": "JVBERi0xLjQKMSAwIG9iago8..."
}1
2
3
4
5
6
7
8
9
10
11
12
{
"status": "cadastrado",
"empresa": {
"cnpjBasico": "99999999",
"naturezaJuridica": "Empresa Domiciliada no Exterior",
"qualificacaoResponsavel": "Procurador",
"razaoSocial": "EMPRESA LLC",
"capitalSocial": 0
},
"socios": [],
"pdf": "JVBERi0xLjQKMSAwIG9iago8..."
}1
2
3
4
5
6
7
8
9
10
11
12
13
{
"status": "cadastrado",
"empresa": {
"cnpjBasico": "99999999",
"naturezaJuridica": "Empresário (Individual)",
"porte": "MICRO EMPRESA",
"qualificacaoResponsavel": "Empresário",
"razaoSocial": "FULANO DA SILVA 99999999999",
"capitalSocial": 2000
},
"socios": [],
"pdf": "JVBERi0xLjQKMSAwIG9iago8..."
}
Resposta com erro
1
2
3
4
5
{
"status": "erro",
"mensagem": "Empresa não encontrada.",
"pdf": "JVBERi0xLjQKMSAwIG9iago8..."
}