API Receita Federal pour consulter CPF et CNPJ en temps réel
Chez CPF.CNPJ, nous simplifions et accélérons l'accès aux informations essentielles des personnes physiques et morales.
Le défi : accéder aux données de la Receita Federal de manière directe et légale
La Receita Federal gère les bases officielles de CPF et CNPJ du Brésil, mais elle ne propose pas d’API publique unifiée de consultation pour l’intégration dans les systèmes. Les alternatives courantes — formulaires web avec captcha, extraction de données (scraping) et portails avec limites d’usage — sont fragiles, instables et juridiquement risquées pour les opérations qui doivent valider des documents à grande échelle.
Les entreprises qui exécutent le KYC (Know Your Customer), le KYB (Know Your Business) et des processus de compliance ont besoin de données fiables à la source : situation enregistrée du CPF, situation du CNPJ, structure de l’actionnariat (QSA) et CNAE. Lorsque ces données proviennent de copies obsolètes ou de scraping sujet à des blocages, le résultat est un onboarding bloqué, des faux positifs et une exposition réglementaire.
CPF.CNPJ résout cela en offrant une couche d’API qui livre les données officielles de la Receita Federal de CPF et CNPJ de manière programmatique, en temps réel (D+0), sans captcha et sans scraping. Une seule intégration REST couvre les personnes physiques et morales, avec la fiabilité exigée par les flux d’inscription, de crédit et de lutte contre la fraude.
Comment l’API CPF.CNPJ résout le problème
1. CPF et CNPJ dans une seule API
Une seule intégration couvre les deux documents. Pour le CPF, l’API renvoie la situation enregistrée (Régulier, Suspendu, Annulé, En attente de régularisation, Nul, Annulé pour multiplicité ou Titulaire décédé) et le nom officiel lié au document.
Pour le CNPJ, l’API livre la situation enregistrée (Active, Radiée, Inapte, Suspendue, Nulle), la raison sociale, le nom commercial, la date d’ouverture, la taille, le CNAE principal et secondaires, l’adresse et la structure des associés et administrateurs (QSA). Le tout à partir de la source officielle de la Receita Federal.
2. REST et JSON, faciles à intégrer
L’API est RESTful et répond en JSON, sans dépendance à un SDK propriétaire. Tout langage capable d’effectuer une requête HTTP peut consommer les données, ce qui réduit le temps d’intégration à quelques minutes dans les flux de backend, les ETL et les traitements par lots.
La structure de réponse est stable et documentée, permettant de mapper les champs directement vers le moteur de décision de KYC/KYB sans traitements fragiles de HTML.
3. Authentification par token et données en temps réel (D+0)
L’authentification se fait par token, sans besoin de captcha, de certificat numérique ni de date de naissance. Le token identifie l’application et le forfait souscrit à chaque requête.
Les consultations reflètent l’état actuel des bases de la Receita Federal (D+0), garantissant que les décisions d’onboarding, de crédit et de compliance utilisent la situation enregistrée la plus récente disponible à la source officielle.
4. Conformité LGPD
L’accès aux données est structuré pour un usage légitime en prévention de la fraude, validation des inscriptions et respect des obligations légales, avec un traitement conforme à la LGPD (Loi 13.709/2018).
Cela permet aux institutions financières, fintechs, marketplaces et entreprises réglementées de valider CPF et CNPJ à la source officielle sans recourir au scraping ni à des bases informelles d’origine douteuse.
Comment intégrer
L’intégration est un appel REST authentifié par token. L’exemple ci-dessous consulte un CPF et un CNPJ dans la base officielle de la Receita Federal et renvoie la situation enregistrée en JSON :
# Consulta de CPF na Receita Federal
curl -X GET "https://api.cpfcnpj.com.br/SEU_TOKEN/9/00000000000"
# Consulta de CNPJ (situação, QSA, CNAE) na Receita Federal
curl -X GET "https://api.cpfcnpj.com.br/SEU_TOKEN/6/00000000000000"
# Resposta (exemplo simplificado)
# {
# "status": 1,
# "documento": "00000000000000",
# "situacao": "ATIVA",
# "razao_social": "EMPRESA EXEMPLO LTDA",
# "abertura": "2015-03-10",
# "cnae_principal": "62.01-5-01",
# "qsa": [ { "nome": "SOCIO EXEMPLO", "qualificacao": "Sócio-Administrador" } ]
# }Pour les détails des endpoints, les forfaits de consultation, les codes de situation et des exemples dans d’autres langages, consultez la documentation complète sur https://www.cpfcnpj.com.br/dev/.
Pourquoi utiliser l’API CPF.CNPJ
- Source officielle: Données extraites directement des bases de la Receita Federal de CPF et CNPJ.
- D+0 en temps réel: Situation enregistrée à jour, reflétant l’état actuel de la source officielle.
- 99,9 % de uptime: Disponibilité pensée pour les flux critiques d’onboarding et de compliance.
- CPF et CNPJ dans une seule API: Une seule intégration REST couvre les personnes physiques et morales.
