Registre d'empreses del Brasil (CNPJ): API de consulta

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=BRA" \
  -F "services=bra_company_registry" \
  -F "vendor_data=user-1234" \
  -F "company_registration_number=11222333000181"

{
  "request_id": "req_01H…",
  "status": "Approved",
  "issuing_state": "BRA",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "bra_company_registry",
      "service_name": "Brazil - Company Registry Lookup (CNPJ)",
      "source_data": {
        "company_name": "EMPRESA EXEMPLO LTDA",
        "company_status": "ATIVA",
        "company_status_date": "2025-01-10",
        "headquarters_state": "SP",
        "legal_nature": "SOCIEDADE EMPRESARIA LIMITADA",
        "main_activity": "DESENVOLVIMENTO DE PROGRAMAS DE COMPUTADOR SOB ENCOMENDA",
        "main_activity_code": "6201501",
        "registration_date": "2010-03-15",
        "registration_number": "11222333000181",
        "trade_name": "EXEMPLO"
      },
      "validation": {}
    }
  ]
}

{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "BRA",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "DOCUMENT_NOT_FOUND",
      "service_id": "bra_company_registry",
      "service_name": "Brazil - Company Registry Lookup (CNPJ)",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {}
    }
  ]
}

POST

database-validation

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=BRA" \
  -F "services=bra_company_registry" \
  -F "vendor_data=user-1234" \
  -F "company_registration_number=11222333000181"

{
  "request_id": "req_01H…",
  "status": "Approved",
  "issuing_state": "BRA",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "bra_company_registry",
      "service_name": "Brazil - Company Registry Lookup (CNPJ)",
      "source_data": {
        "company_name": "EMPRESA EXEMPLO LTDA",
        "company_status": "ATIVA",
        "company_status_date": "2025-01-10",
        "headquarters_state": "SP",
        "legal_nature": "SOCIEDADE EMPRESARIA LIMITADA",
        "main_activity": "DESENVOLVIMENTO DE PROGRAMAS DE COMPUTADOR SOB ENCOMENDA",
        "main_activity_code": "6201501",
        "registration_date": "2010-03-15",
        "registration_number": "11222333000181",
        "trade_name": "EXEMPLO"
      },
      "validation": {}
    }
  ]
}

{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "BRA",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "DOCUMENT_NOT_FOUND",
      "service_id": "bra_company_registry",
      "service_name": "Brazil - Company Registry Lookup (CNPJ)",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {}
    }
  ]
}

Consulta una empresa brasilera mitjançant el CNPJ al registre de la Receita Federal: raó social i nom comercial, estat registral, data de fundació, naturalesa jurídica, activitat principal i estat de la seu central. Didit ofereix aquest servei a través de POST /v3/database-validation/ perquè puguis verificar les dades enviades amb la font oficial i rebre resultats de coincidència normalitzats.

Cobertura

Cobertura: ~ 100%
País: Brasil
ID del servei: bra_company_registry
Domini de dades: Govern
Categoria: CompanyRegister

Entrades

Camp	Obligatori	Exemple
`company_registration_number`	Sí	`11222333000181`
`vendor_data`	No	`user-1234`

Entrades obligatòries: company_registration_number
Entrades opcionals: vendor_data
Consentiment: No cal
Disponibilitat en el flux de treball: Disponible en el flux de treball amb mapatge de camps
Cobertura: ~ 100%
Preu: $0.20 per consulta satisfactòria

En un flux de treball, company_registration_number no apareix imprès en cap document d’identitat, de manera que cap pas no el produeix per si sol. Recull-lo d’una resposta obtinguda amb Qüestionaris, d’un camp d’extracció de Document AI o d’un valor que enviïs en crear la sessió, i mapa’l al pas de Validació en bases de dades. Mentre no estigui mapat, l’editor del flux de treball mostra aquest servei desactivat i indica quina entrada falta; en execució, una entrada que falta fa que la comprovació s’ometi abans de cap consulta, de manera que mai no et cobren per una base de dades que no s’ha pogut consultar.

Paràmetres del cos

string

predeterminat:"BRA"

requerit

Codi de país ISO 3166-1 alpha-3 per a aquest servei de base de dades.Exemple: BRA

string

predeterminat:"bra_company_registry"

requerit

Matriu que conté aquest ID de servei. Fixar el servei manté la sol·licitud limitada a aquesta base de dades exacta.Exemple: bra_company_registry

string

predeterminat:"11222333000181"

requerit

Valor de company_registration_number que requereix aquest servei de base de dades.Exemple: 11222333000181

string

predeterminat:"user-1234"

El teu identificador d’usuari estable per a aquesta persona, com ara el teu ID d’usuari intern. Didit l’utilitza per vincular les verificacions independents amb el mateix usuari final i reduir el soroll de detecció de duplicats.Exemple: user-1234

Regles d’entrada i notes de validació

company_registration_number ha de coincidir amb [0-9A-Za-z]{2}\.?[0-9A-Za-z]{3}\.?[0-9A-Za-z]{3}/?[0-9A-Za-z]{4}-?\d{2}.

Com fer la crida

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=BRA" \
  -F "services=bra_company_registry" \
  -F "vendor_data=user-1234" \
  -F "company_registration_number=11222333000181"

Cada crida satisfactòria retorna HTTP 200. El camp outcome_code indica què ha passat realment, distingint, per exemple, una discrepància biomètrica real (BIOMETRIC_NO_MATCH) d’una selfie que no s’ha pogut llegir (BIOMETRIC_IMAGE_UNUSABLE). L’status que es mostra és l’estat per defecte de la funcionalitat; les teves accions configurades de Partial Match / No Match el poden sobreescriure.

MATCH — El registre va confirmar la identitat i cada camp comprovat va coincidir.

{
  "request_id": "req_01H…",
  "status": "Approved",
  "issuing_state": "BRA",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "bra_company_registry",
      "service_name": "Brazil - Company Registry Lookup (CNPJ)",
      "source_data": {
        "company_name": "EMPRESA EXEMPLO LTDA",
        "company_status": "ATIVA",
        "company_status_date": "2025-01-10",
        "headquarters_state": "SP",
        "legal_nature": "SOCIEDADE EMPRESARIA LIMITADA",
        "main_activity": "DESENVOLVIMENTO DE PROGRAMAS DE COMPUTADOR SOB ENCOMENDA",
        "main_activity_code": "6201501",
        "registration_date": "2010-03-15",
        "registration_number": "11222333000181",
        "trade_name": "EXEMPLO"
      },
      "validation": {}
    }
  ]
}

DOCUMENT_NOT_FOUND — El número de document enviat no correspon a cap registre del registre mercantil.

{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "BRA",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "DOCUMENT_NOT_FOUND",
      "service_id": "bra_company_registry",
      "service_name": "Brazil - Company Registry Lookup (CNPJ)",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {}
    }
  ]
}

Dades retornades

Els camps exactes que apareixen a source_data depenen del que retorni el registre. L’exemple generat per a bra_company_registry documenta actualment aquesta estructura normalitzada:

company_name
company_status
company_status_date
headquarters_state
identification_number
legal_nature
main_activity
main_activity_code
registration_date
registration_number
trade_name

Preus i SLA

Les consultes del registre mercantil del Brasil (CNPJ) només es cobren quan Didit rep un resultat concloent de la font de validació.

Preu per crida: $0.20 USD.
Facturació: per consulta satisfactòria. No et cobren quan el registre no és accessible, quan falten camps obligatoris o quan la sol·licitud es rebutja abans d’arribar a la font.
Latència: p95 típica < 2 s.
Disponibilitat: 99.9% per trimestre per part de Didit; la disponibilitat de la font externa varia segons el país i el conjunt de dades.

Continua llegint

Darrera modificació el 7 de novembre del 2026

​Cobertura

​Entrades

​Paràmetres del cos

​Regles d’entrada i notes de validació

​Com fer la crida

​Dades retornades

​Preus i SLA

​Continua llegint

Cobertura

Entrades

Paràmetres del cos

Regles d’entrada i notes de validació

Com fer la crida

Dades retornades

Preus i SLA

Continua llegint