Requisitos de Dados KYB

Visão Geral

Este guia detalha todos os campos de dados necessários para uma verificação KYB (Know Your Business) abrangente usando a plataforma da gu1. Os requisitos de dados variam de acordo com a jurisdição, tipo de empresa e nível de risco.

Informações Básicas da Empresa

Campos Obrigatórios

Estes campos são obrigatórios para todas as entidades empresariais:

Campo	Tipo	Descrição	Exemplo
`legalName`	string	Nome empresarial registrado oficial	”Tech Solutions Sociedade Anônima”
`tradeName`	string	Nome comercial da empresa	”Tech Solutions”
`taxId`	string	Número de identificação fiscal	”12.345.678/0001-90” (CNPJ - Brasil)
`countryCode`	string	Código ISO 3166-1 alpha-2	”BR”, “US”, “MX”, “AR”
`incorporationDate`	date	Data de constituição da empresa	”2020-06-15”
`industry`	string	Atividade empresarial principal	”Software Development”
`registeredAddress`	object	Endereço empresarial oficial	Veja estrutura de endereço abaixo

Estrutura de Endereço

{
  "street": "Av. Paulista, 1000",
  "city": "São Paulo",
  "state": "SP",
  "postalCode": "01310-100",
  "country": "BR"
}

Detalhes da Empresa

Campos Altamente Recomendados

Estes campos melhoram significativamente a precisão da avaliação de risco:

Campo	Tipo	Descrição	Exemplo
`registrationNumber`	string	ID de registro empresarial governamental	”NIRE 35.300.123456”
`businessType`	string	Estrutura jurídica	”LLC”, “Corporation”, “Partnership”
`website`	string	Site oficial da empresa	”https://techsolutions.com.br”
`employeeCount`	number	Número de funcionários	50
`annualRevenue`	number	Receita anual em USD	5000000
`foundingYear`	number	Ano de fundação da empresa	2020
`businessDescription`	string	O que a empresa faz	”B2B SaaS for enterprises”

Campos Opcionais

Úteis para due diligence aprimorada:

Campo	Tipo	Descrição
`phoneNumber`	string	Telefone empresarial principal
`email`	string	E-mail de contato oficial
`parentCompany`	string	Nome da empresa-mãe (se aplicável)
`subsidiaries`	array	Lista de empresas subsidiárias
`stockSymbol`	string	Símbolo ticker (se negociada publicamente)
`regulatoryLicenses`	array	Licenças e autorizações necessárias

Dados de Beneficiários Finais

Obrigatório para empresas com estruturas de propriedade complexas:

Beneficiários Finais Efetivos (UBOs)

Para cada indivíduo que possui >25% da empresa:

{
  "beneficialOwners": [
    {
      "firstName": "Carlos",
      "lastName": "Silva",
      "dateOfBirth": "1975-08-22",
      "nationality": "BR",
      "ownershipPercentage": 60,
      "isPEP": false,
      "idNumber": "123.456.789-00",
      "address": {
        "street": "Rua das Flores, 500",
        "city": "São Paulo",
        "state": "SP",
        "postalCode": "01234-567",
        "country": "BR"
      }
    }
  ]
}

Estrutura Corporativa

Para propriedade complexa:

{
  "ownershipStructure": {
    "type": "multi_tier",
    "layers": [
      {
        "level": 1,
        "owners": [
          {
            "type": "person",
            "name": "Carlos Silva",
            "ownership": 60
          },
          {
            "type": "company",
            "name": "Investment Holdings Inc",
            "ownership": 40
          }
        ]
      }
    ]
  }
}

Documentos Obrigatórios

Nível 1: Documentos Essenciais

Obrigatórios para todas as empresas:

Contrato Social / Certidão de Constituição
- Tipo de arquivo: PDF
- Tamanho máximo: 10MB
- Deve ser: Emitido pelo governo, recente (dentro de 6 meses)
Licença Comercial / Alvará de Funcionamento
- Tipo de arquivo: PDF, JPG, PNG
- Tamanho máximo: 10MB
- Deve mostrar: Número da licença, data de validade, autoridade emissora
Certificado de Registro Fiscal
- Tipo de arquivo: PDF
- Tamanho máximo: 10MB
- Deve mostrar: ID fiscal, data de registro, situação atual
Comprovante de Endereço Comercial
- Tipo de arquivo: PDF, JPG
- Tamanho máximo: 5MB
- Aceitável: Conta de serviços públicos, extrato bancário (últimos 3 meses)

Nível 2: Due Diligence Aprimorada

Obrigatório para empresas de médio/alto risco:

Demonstrações Financeiras
- Tipo de arquivo: PDF
- Período: Últimos 2 anos
- Deve ser: Auditada ou certificada por contador
Declaração de Beneficiários Finais
- Tipo de arquivo: PDF
- Tamanho máximo: 10MB
- Deve incluir: Nomes, % de propriedade, IDs de todos os UBOs
Resolução do Conselho / Autorização
- Tipo de arquivo: PDF
- Tamanho máximo: 5MB
- Finalidade: Autorizando relacionamento comercial
Documentação de Origem de Fundos
- Tipo de arquivo: PDF
- Tamanho máximo: 10MB
- Exemplos: Contratos de investimento, extratos bancários

Nível 3: Requisitos Adicionais de Alto Risco

Obrigatório para indústrias ou jurisdições de alto risco:

Aprovações Regulatórias
- Específico da indústria (serviços financeiros, saúde, etc.)
- Deve estar atual e válido
Documentação de Política AML
- Procedimentos internos de AML/CFT
- Informações do responsável pela conformidade
Certificado de Conformidade com Sanções
- Declaração de ausência de violações de sanções
- Histórico de conformidade dos últimos 5 anos

Requisitos Específicos por País

Estados Unidos

{
  "countryCode": "US",
  "requiredFields": {
    "ein": "12-3456789",
    "stateOfIncorporation": "Delaware",
    "businessStructure": "LLC",
    "duns": "012345678"
  },
  "documents": [
    "articles_of_incorporation",
    "ein_letter",
    "state_business_license",
    "w9_form"
  ]
}

Brasil

{
  "countryCode": "BR",
  "requiredFields": {
    "cnpj": "12.345.678/0001-90",
    "nire": "35.300.123456",
    "capitalSocial": 1000000,
    "municipalRegistration": "123456-7"
  },
  "documents": [
    "contrato_social",
    "cartao_cnpj",
    "certidao_federal",
    "certidao_estadual",
    "alvara_funcionamento"
  ]
}

México

{
  "countryCode": "MX",
  "requiredFields": {
    "rfc": "ABC123456ABC",
    "curp": "SABC750822HDFNLR09",
    "folioMercantil": "123456"
  },
  "documents": [
    "acta_constitutiva",
    "cedula_rfc",
    "comprobante_domicilio"
  ]
}

Argentina

{
  "countryCode": "AR",
  "requiredFields": {
    "cuit": "20-12345678-9",
    "inscripcionIgj": "123456",
    "iibb": "901-234567-8"
  },
  "documents": [
    "estatuto_social",
    "constancia_cuit",
    "certificado_vigencia"
  ]
}

Dados de Transações e Atividades

Padrões de Transação Esperados

{
  "transactionProfile": {
    "expectedMonthlyVolume": 250000,
    "expectedMonthlyTransactions": 150,
    "averageTransactionSize": 1667,
    "primaryCurrencies": ["USD", "BRL"],
    "geographicFocus": ["BR", "AR", "MX"],
    "businessModel": "subscription_saas"
  }
}

Relacionamentos Comerciais

{
  "businessRelationships": {
    "majorCustomers": [
      {
        "name": "Enterprise Corp",
        "country": "BR",
        "monthlyVolume": 50000
      }
    ],
    "majorSuppliers": [
      {
        "name": "Cloud Provider Inc",
        "country": "US",
        "monthlyVolume": 30000
      }
    ],
    "bankingPartners": [
      {
        "bankName": "Banco do Brasil",
        "accountType": "business_checking",
        "since": "2020-07-01"
      }
    ]
  }
}

Requisitos Baseados em Risco

Baixo Risco (Score < 30)

Informações empresariais básicas
Apenas documentos de Nível 1
Verificação de propriedade de camada única

Médio Risco (Score 30-70)

Informações empresariais completas
Documentos de Nível 1 + Nível 2
Verificação completa de beneficiários finais
Configuração de monitoramento de transações

Alto Risco (Score > 70)

Informações empresariais exaustivas
Todos os documentos de Nível 1, 2 e 3
Verificação aprimorada de beneficiários finais
Documentação de origem de riqueza
Monitoramento contínuo aprimorado

Requisitos Específicos por Setor

Serviços Financeiros

{
  "industry": "financial_services",
  "additionalRequirements": {
    "regulatoryLicenses": ["banking_license", "payment_processor_license"],
    "capitalRequirement": 1000000,
    "amlPolicyRequired": true,
    "complianceOfficer": {
      "name": "João Santos",
      "email": "compliance@company.com",
      "certifications": ["CAMS", "CFE"]
    }
  }
}

Criptomoeda / Blockchain

{
  "industry": "cryptocurrency",
  "additionalRequirements": {
    "virtualAssetLicense": true,
    "blockchainWallets": ["0x1234..."],
    "amlProgram": "documented",
    "travelRuleCompliance": true,
    "coldStoragePolicy": "documented"
  }
}

Jogos / Apostas

{
  "industry": "gaming",
  "additionalRequirements": {
    "gamingLicense": true,
    "licensingAuthority": "Malta Gaming Authority",
    "fairnessVerification": "third_party_certified",
    "responsibleGamingPolicy": true
  }
}

Padrões de Qualidade de Dados

Regras de Validação

Todos os dados devem atender a estes padrões de qualidade:

Completude: Sem campos obrigatórios ausentes
Precisão: Dados correspondem aos documentos oficiais
Consistência: Validação cruzada de campos aprovada
Atualidade: Documentos com menos de 6 meses
Legibilidade: Documentos claramente legíveis (mínimo 300 DPI)

Erros Comuns de Validação

Erro	Causa	Solução
Formato de ID fiscal inválido	Formato incorreto para o país	Use validador específico do país
Documento muito antigo	Data de emissão > 6 meses atrás	Solicite documento atualizado
Nome não corresponde	Nome legal ≠ nome do documento	Verifique o nome legal correto
UBO ausente	Nenhum proprietário listado	Forneça estrutura de propriedade
Endereço não verificável	Não é possível confirmar que o endereço existe	Forneça conta de serviços públicos ou extrato

Formato de Envio de Dados

Estrutura JSON

Exemplo completo de envio de dados KYB:

{
  "entity": {
    "type": "company",
    "externalId": "business_12345",
    "name": "Tech Solutions Sociedade Anônima",
    "taxId": "12.345.678/0001-90",
    "countryCode": "BR",
    "entityData": {
      "company": {
        "legalName": "Tech Solutions Sociedade Anônima",
        "tradeName": "Tech Solutions",
        "incorporationDate": "2020-06-15",
        "industry": "Software Development",
        "businessType": "LLC",
        "employeeCount": 50,
        "revenue": 5000000,
        "website": "https://techsolutions.com.br"
      }
    },
    "attributes": {
      "registrationNumber": "NIRE 35.300.123456",
      "registeredAddress": {
        "street": "Av. Paulista, 1000",
        "city": "São Paulo",
        "state": "SP",
        "postalCode": "01310-100",
        "country": "BR"
      },
      "expectedMonthlyVolume": 250000,
      "businessDescription": "B2B SaaS platform for enterprise resource planning"
    }
  },
  "beneficialOwners": [
    {
      "firstName": "Carlos",
      "lastName": "Silva",
      "dateOfBirth": "1975-08-22",
      "nationality": "BR",
      "ownershipPercentage": 60,
      "isPEP": false
    }
  ],
  "documents": [
    {
      "type": "articles_of_incorporation",
      "fileName": "contrato_social.pdf",
      "uploadUrl": "https://..."
    },
    {
      "type": "tax_certificate",
      "fileName": "cnpj_certificate.pdf",
      "uploadUrl": "https://..."
    }
  ]
}

Endpoints da API para Envio de Dados

Criar Entidade: POST /entities
Upload de Documentos: POST /documents
Adicionar UBOs: POST /entities/{id}/beneficial-owners
Atualizar Informações da Empresa: PATCH /entities/{id}

Próximos Passos

Exemplo Completo

Implementação funcional completa com todos os dados necessários

Referência da API

Documentação detalhada da API

Fluxo de Trabalho KYB

Processo de verificação passo a passo

Upload de Documentos

Como fazer upload de documentos de verificação

Começando

Casos de Uso

Webhooks

Workflows

Monitoramento (entidades)

Pessoa

Mensagens

Empresa

Dispositivos

Eventos

Conheça Seu Cliente (KYC)

Transações

Métodos de Pagamento

Regras

Matriz de Risco

Alertas

Investigações

Ingestão de Dados

Enriquecimento

Integrações

Tutoriais Interativos

Documentation Index

​Visão Geral

​Informações Básicas da Empresa

​Campos Obrigatórios

​Estrutura de Endereço

​Detalhes da Empresa

​Campos Altamente Recomendados

​Campos Opcionais

​Dados de Beneficiários Finais

​Beneficiários Finais Efetivos (UBOs)

​Estrutura Corporativa

​Documentos Obrigatórios

​Nível 1: Documentos Essenciais

​Nível 2: Due Diligence Aprimorada

​Nível 3: Requisitos Adicionais de Alto Risco

​Requisitos Específicos por País

​Estados Unidos

​Brasil

​México

​Argentina

​Dados de Transações e Atividades

​Padrões de Transação Esperados

​Relacionamentos Comerciais

​Requisitos Baseados em Risco

​Baixo Risco (Score < 30)

​Médio Risco (Score 30-70)

​Alto Risco (Score > 70)

​Requisitos Específicos por Setor

​Serviços Financeiros

​Criptomoeda / Blockchain

​Jogos / Apostas

​Padrões de Qualidade de Dados

​Regras de Validação

​Erros Comuns de Validação

​Formato de Envio de Dados

​Estrutura JSON

​Endpoints da API para Envio de Dados

​Próximos Passos