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

​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