ブラジル企業の出資者・取締役(QSA)照会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_directors" \
  -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_directors",
      "service_name": "Brazil - Company Partners and Directors (QSA)",
      "source_data": {
        "directors": [
          {
            "document_number": "***.456.789-**",
            "entity_type": "person",
            "name": "MARIA EXEMPLO DA SILVA",
            "role": "SOCIO-ADMINISTRADOR",
            "start_date": "2010-03-15"
          },
          {
            "document_number": "11444777000161",
            "entity_type": "company",
            "name": "HOLDING EXEMPLO S A",
            "role": "SOCIO",
            "start_date": "2018-06-01"
          }
        ],
        "registration_number": "11222333000181"
      },
      "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_directors" \
  -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_directors",
      "service_name": "Brazil - Company Partners and Directors (QSA)",
      "source_data": {
        "directors": [
          {
            "document_number": "***.456.789-**",
            "entity_type": "person",
            "name": "MARIA EXEMPLO DA SILVA",
            "role": "SOCIO-ADMINISTRADOR",
            "start_date": "2010-03-15"
          },
          {
            "document_number": "11444777000161",
            "entity_type": "company",
            "name": "HOLDING EXEMPLO S A",
            "role": "SOCIO",
            "start_date": "2018-06-01"
          }
        ],
        "registration_number": "11222333000181"
      },
      "validation": {}
    }
  ]
}

Receita Federalの登記簿から、ブラジル企業の現在のパートナーおよび取締役(QSA)を、それぞれの役割と就任日とともに返します。個人のCPFは、Receita Federalが公開しているとおりマスクされています。DiditはこのサービスをPOST /v3/database-validation/を通じて提供しており、送信されたデータを公式の情報源と照合し、正規化された照合結果を受け取ることができます。

対象範囲

カバー率: ~ 100%
国: ブラジル
サービスID: bra_company_directors
データドメイン: 政府
カテゴリ: 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_directors"

必須

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

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_directors" \
  -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_directors",
      "service_name": "Brazil - Company Partners and Directors (QSA)",
      "source_data": {
        "directors": [
          {
            "document_number": "***.456.789-**",
            "entity_type": "person",
            "name": "MARIA EXEMPLO DA SILVA",
            "role": "SOCIO-ADMINISTRADOR",
            "start_date": "2010-03-15"
          },
          {
            "document_number": "11444777000161",
            "entity_type": "company",
            "name": "HOLDING EXEMPLO S A",
            "role": "SOCIO",
            "start_date": "2018-06-01"
          }
        ],
        "registration_number": "11222333000181"
      },
      "validation": {}
    }
  ]
}

返されるデータ

source_dataに表示される具体的なフィールドは、法人登記が返す内容によって異なります。bra_company_directorsの生成された例では、現在次の正規化された構造が記載されています。

directors
registration_number

料金とSLA

ブラジル - 企業のパートナーおよび取締役(QSA)のクエリは、Diditが検証元から確定的な結果を受け取った場合にのみ請求されます。

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

​対象範囲

​入力

​ボディパラメーター

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

​呼び出し方法

​返されるデータ

​料金とSLA

​関連情報

対象範囲

入力

ボディパラメーター

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

呼び出し方法

返されるデータ

料金とSLA

関連情報