ブラジル法人登記照会(CNPJ)API

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": {}
    }
  ]
}

ブラジル企業をCNPJでReceita Federalの登録簿から照会し、法定名称と商号、登録ステータス、設立日、法的形態、主たる事業、本社所在州を取得します。Didit はこのサービスをPOST /v3/database-validation/で提供しているため、提出されたデータを公式の情報源と照合し、正規化された照合結果を受け取ることができます。

対象範囲

カバー率： 約100%
国：ブラジル
サービスID： bra_company_registry
データ領域： 政府
カテゴリ： CompanyRegister

入力

フィールド	必須	例
`company_registration_number`	はい	`11222333000181`
`vendor_data`	いいえ	`user-1234`

必須入力： company_registration_number
任意入力： vendor_data
同意： 不要
ワークフローでの利用： フィールドマッピングによりワークフローで利用可能
カバー率： 約100%
料金： 成功したクエリ1件あたり$0.20

ワークフローでは、company_registration_numberは本人確認書類に記載されていないため、単独でこの値を生成するステップはありません。アンケートの回答、Document AIの抽出フィールド、またはセッション作成時に送信する値から取得し、データベース検証ステップでマッピングしてください。マッピングされるまで、ワークフローエディターではこのサービスが無効と表示され、不足している入力が示されます。実行時に入力が不足している場合はクエリ前にチェックがスキップされるため、照会できなかったデータベースについて課金されることはありません。

ボディパラメーター

string

デフォルト:"BRA"

必須

このデータベースサービスのISO 3166-1 alpha-3国コードです。例：BRA

string

デフォルト:"bra_company_registry"

必須

このサービスIDを含む配列です。サービスを固定することで、リクエストの対象をこのデータベースのみに限定できます。例：bra_company_registry

string

デフォルト:"11222333000181"

必須

このデータベースサービスで必須となるcompany_registration_numberの値です。例：11222333000181

string

デフォルト:"user-1234"

この人物を識別するための、社内ユーザーIDなどの一貫した参照値です。Didit はこれを使用して単体のチェックを同一のエンドユーザーに紐付け、重複検出のノイズを減らします。例：user-1234

入力ルールと検証に関する注意事項

company_registration_numberは[0-9A-Za-z]{2}\.?[0-9A-Za-z]{3}\.?[0-9A-Za-z]{3}/?[0-9A-Za-z]{4}-?\d{2}に一致する必要があります。

呼び出し方法

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"

成功した呼び出しはすべてHTTP 200を返します。実際に何が起きたかはoutcome_codeフィールドで判断できます。たとえば、実際の生体情報の不一致(BIOMETRIC_NO_MATCH)と、セルフィーを読み取れなかった場合(BIOMETRIC_IMAGE_UNUSABLE)を区別できます。表示されるstatusは機能のデフォルトステータスであり、設定した部分一致/不一致時のアクションによって上書きされる場合があります。

MATCH：登録簿で本人確認ができ、確認対象のすべてのフィールドが一致しました。

{
  "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：提出された書類番号に該当するレコードが登録簿に存在しません。

{
  "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": {}
    }
  ]
}

返却されるデータ

source_dataに含まれる具体的なフィールドは、登録簿が返す内容によって異なります。bra_company_registryの生成済みサンプルでは、現在以下の正規化された形式が記載されています。

company_name
company_status
company_status_date
headquarters_state
identification_number
legal_nature
main_activity
main_activity_code
registration_date
registration_number
trade_name

料金とSLA

ブラジル - 法人登記照会(CNPJ)のクエリは、Didit が検証元から確定した結果を受け取った場合にのみ課金されます。

呼び出し1件あたりの料金： $0.20 USD。
請求： 成功したクエリ1件あたり。登録簿に到達できない場合、必須フィールドが不足している場合、またはリクエストが情報源に到達する前に拒否された場合は課金されません。
レイテンシ： 通常p95で2秒未満。
可用性： Didit側で四半期あたり99.9%。下流のデータソースの可用性は国やデータセットによって異なります。

​対象範囲

​入力

​ボディパラメーター

​入力ルールと検証に関する注意事項

​呼び出し方法

​返却されるデータ

​料金とSLA

​関連情報

対象範囲

入力

ボディパラメーター

入力ルールと検証に関する注意事項

呼び出し方法

返却されるデータ

料金とSLA

関連情報