跳转到主要内容
POST
通过 CNPJ 在 Receita Federal 登记库中查询巴西企业,返回法定名称和商号、登记状态、成立日期、法律性质、主要经营活动以及总部所在州。Didit 通过 POST /v3/database-validation/ 提供此服务,便于您将提交的数据与权威数据源进行核对,并获得标准化的匹配结果。

覆盖范围

  • 覆盖范围: ~ 100%
  • 国家/地区:巴西
  • 服务 ID:bra_company_registry
  • 数据领域:政府
  • 类别:CompanyRegister

输入

  • 必填输入:company_registration_number
  • 可选输入:vendor_data
  • 同意:无需
  • 工作流可用性:可在工作流中使用,但需要进行字段映射
  • 覆盖范围: ~ 100%
  • 价格:每次成功查询 $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}。

调用方法

返回数据

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 从验证数据源收到结论性结果时计费。
  • 单次调用价格:$0.20 USD。
  • 计费:按成功查询计费。登记库无法访问、必填字段缺失,或请求在到达数据源之前即被拒绝时,不收取费用。
  • 延迟:典型 p95 低于 2 秒。
  • 可用性:Didit 侧每季度 99.9%;下游数据源的可用性因国家和数据集而异。

延伸阅读

最后修改于 2026年11月7日