API de Consultation de CNPJ auprès de la Receita Federal
Chez CPF.CNPJ, nous simplifions et accélérons l'accès aux informations essentielles des personnes physiques et morales.
Le Défi : Valider les Entreprises et Réduire le Risque dans les Opérations B2B
Avant de signer un contrat, d'accorder un crédit ou de débloquer un paiement, toute entreprise doit savoir avec qui elle traite. Valider les fournisseurs, les partenaires et les clients personnes morales exige de vérifier la situation administrative du CNPJ auprès de la Receita Federal, de confirmer la raison sociale et l'adresse, et de comprendre la structure de l'actionnariat. Effectué manuellement — en ouvrant le site de la Receita, en résolvant un captcha et en copiant les données à chaque consultation — ce processus est lent, sujet aux erreurs et impossible à mettre à l'échelle pour des centaines ou des milliers d'entreprises.
Le processus de KYB (Know Your Business) est le socle de la conformité, de la prévention de la fraude d'entreprise et de la gestion du risque de crédit. Traiter avec un CNPJ Radié, Inapte ou Suspendu peut signifier une facture invalide, un fournisseur inexistant, ou une exposition à des schémas de fraude impliquant des sociétés écrans. Sans automatisation, l'équipe d'enregistrement et de conformité devient un goulot d'étranglement et l'opération se bloque.
La solution consiste à interroger le CNPJ directement à la source officielle via une API : confirmer que l'entreprise existe, est active et habilitée, et enrichir la fiche avec des données d'actionnariat complètes — le tout de façon programmatique, intégré à l'ERP, au CRM ou à la plateforme d'onboarding, sans intervention manuelle.
Comment l'API CPF.CNPJ Résout le Problème
1. Identification Complète de l'Entreprise
L'API renvoie les données d'identification de l'entreprise directement depuis la base de la Receita Federal : raison sociale, nom commercial, situation administrative (Active, Radiée, Inapte, Suspendue), date de la situation, date d'ouverture, nature juridique et adresse complète (rue, numéro, quartier, commune, état et code postal).
Avec la situation administrative en main, le système décide automatiquement s'il autorise ou bloque l'opération : seuls les CNPJ Actifs poursuivent le flux ; les autres situations déclenchent une révision ou un rejet, éliminant le risque de transiger avec des entreprises irrégulières.
2. CNAE, Taille et Régime Fiscal
Pour l'analyse de risque et la segmentation, l'API fournit le CNAE principal et les CNAE secondaires (activités économiques), la taille de l'entreprise (ME, EPP, Autres) et le capital social déclaré.
Elle renvoie également le régime fiscal : si l'entreprise est optante au Simples Nacional et si elle est MEI (Micro-entrepreneur Individuel). Ces champs alimentent les moteurs de scoring, les règles de plafond de crédit et le routage des propositions commerciales.
3. Tableau des Associés et Administrateurs (QSA)
La consultation inclut le tableau de l'actionnariat (QSA) avec la liste des associés et administrateurs, la qualification de chacun et sa participation dans l'entreprise. Cette donnée est essentielle pour le KYB, la due diligence et l'identification du bénéficiaire effectif dans les processus de conformité et de prévention du blanchiment d'argent.
Croiser le QSA avec des listes restrictives et des bases de fraude permet de détecter les prête-noms, les sociétés écrans et les conflits d'intérêts avant de conclure une affaire.
4. Prise en Charge du CNPJ Alphanumérique (2026)
À partir de 2026, les nouveaux CNPJ seront émis au format alphanumérique par la Receita Federal. L'API CPF.CNPJ est déjà prête à recevoir et à valider aussi bien le CNPJ numérique traditionnel que le nouveau CNPJ alphanumérique, garantissant que votre intégration continue de fonctionner sans reprise pendant la transition.
Comment Intégrer : Consultation de CNPJ via API
L'intégration est un simple appel HTTP. Authentifiez-vous avec votre token via Bearer et effectuez un GET en passant le CNPJ. La réponse arrive en JSON avec tous les champs administratifs et d'actionnariat :
# Consulta de CNPJ na Receita Federal via API
curl -X GET "https://api.cpfcnpj.com.br/v3/cnpj/27272134000118" \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Accept: application/json"
# Resposta (JSON)
{
"cnpj": "27272134000118",
"razao_social": "ALAS TECNOLOGIA LTDA",
"nome_fantasia": "CPF.CNPJ",
"situacao_cadastral": "ATIVA",
"data_abertura": "2017-01-30",
"natureza_juridica": "206-2 - Sociedade Empresária Limitada",
"porte": "DEMAIS",
"capital_social": 100000.00,
"optante_simples": false,
"mei": false,
"cnae_principal": {
"codigo": "6201501",
"descricao": "Desenvolvimento de programas de computador sob encomenda"
},
"cnae_secundarios": [
{ "codigo": "6311900", "descricao": "Tratamento de dados e hospedagem" }
],
"endereco": {
"logradouro": "Avenida Donato Quintino",
"numero": "90",
"bairro": "Cidade Cruzeiro do Sul",
"municipio": "Montes Claros",
"uf": "MG",
"cep": "39401-301"
},
"qsa": [
{
"nome": "Socio Exemplo",
"qualificacao": "Sócio-Administrador",
"participacao": 100
}
]
}Les mêmes champs sont disponibles dans les consultations en lot (bulk) pour la validation de bases entières de fournisseurs et de clients. La documentation complète, avec tous les endpoints, paramètres et exemples de code, est disponible sur cpfcnpj.com.br/dev/.
Pourquoi utiliser l'API de CNPJ
- Données D+0 en temps réel: Consultation mise à jour à la minute, reflétant la situation administrative du jour
- Uptime de 99,9 %: Haute disponibilité pour s'intégrer dans des flux critiques d'enregistrement et d'onboarding
- Source officielle de la Receita Federal: Données extraites directement de la base officielle, sans intermédiaires
- Données d'actionnariat complètes: Raison sociale, situation, CNAE, capital social, taille et tableau des associés (QSA)
