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)API
通过 Didit 查询巴西权威数据库中的企业登记信息(CNPJ)。按次计费,起价 $0.20,无需合同,无最低消费。
POST
/
v3
/
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%
- 价格:每次成功查询 $0.20
company_registration_number 不会印在任何身份证件上,因此没有任何步骤能单独生成它。请从问卷答案、Document AI 提取字段,或创建会话时您发送的值中获取该值,并在数据库核验步骤中将其映射过去。在完成映射之前,工作流编辑器会将此服务显示为禁用状态,并指出缺少的输入。运行时若缺少输入,该检查会在任何查询之前被跳过,因此您不会为无法查询的数据库付费。
请求体参数
string
默认值:"BRA"
必填
此数据库服务的 ISO 3166-1 alpha-3 国家代码。示例:
BRAstring
默认值:"bra_company_registry"
必填
包含此服务 ID 的数组。固定服务可使请求仅限于此特定数据库。示例:
bra_company_registrystring
默认值:"11222333000181"
必填
此数据库服务所需的
company_registration_number 值。示例:11222333000181string
默认值:"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_namecompany_statuscompany_status_dateheadquarters_stateidentification_numberlegal_naturemain_activitymain_activity_coderegistration_dateregistration_numbertrade_name
定价与 SLA
巴西企业登记查询(CNPJ)仅在 Didit 从验证数据源收到结论性结果时计费。- 单次调用价格:$0.20 USD。
- 计费:按成功查询计费。登记库无法访问、必填字段缺失,或请求在到达数据源之前即被拒绝时,不收取费用。
- 延迟:典型 p95 低于 2 秒。
- 可用性:Didit 侧每季度 99.9%;下游数据源的可用性因国家和数据集而异。
延伸阅读
最后修改于 2026年11月7日