> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gu1.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Requisitos de Dados KYB

> Campos de dados obrigatórios e opcionais para verificação de empresas — no fluxo KYB da gu1 para verificação empresarial, com exemplos para data requirements.

## 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

```json theme={null}
{
  "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](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:

```json theme={null}
{
  "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:

```json theme={null}
{
  "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:

1. **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)

2. **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

3. **Certificado de Registro Fiscal**
   * Tipo de arquivo: PDF
   * Tamanho máximo: 10MB
   * Deve mostrar: ID fiscal, data de registro, situação atual

4. **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:

5. **Demonstrações Financeiras**
   * Tipo de arquivo: PDF
   * Período: Últimos 2 anos
   * Deve ser: Auditada ou certificada por contador

6. **Declaração de Beneficiários Finais**
   * Tipo de arquivo: PDF
   * Tamanho máximo: 10MB
   * Deve incluir: Nomes, % de propriedade, IDs de todos os UBOs

7. **Resolução do Conselho / Autorização**
   * Tipo de arquivo: PDF
   * Tamanho máximo: 5MB
   * Finalidade: Autorizando relacionamento comercial

8. **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:

9. **Aprovações Regulatórias**
   * Específico da indústria (serviços financeiros, saúde, etc.)
   * Deve estar atual e válido

10. **Documentação de Política AML**
    * Procedimentos internos de AML/CFT
    * Informações do responsável pela conformidade

11. **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

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

### Brasil

```json theme={null}
{
  "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

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

### Argentina

```json theme={null}
{
  "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

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

### Relacionamentos Comerciais

```json theme={null}
{
  "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

```json theme={null}
{
  "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

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

### Jogos / Apostas

```json theme={null}
{
  "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:

1. **Completude**: Sem campos obrigatórios ausentes
2. **Precisão**: Dados correspondem aos documentos oficiais
3. **Consistência**: Validação cruzada de campos aprovada
4. **Atualidade**: Documentos com menos de 6 meses
5. **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:

```json theme={null}
{
  "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

<CardGroup cols={2}>
  <Card title="Exemplo Completo" icon="code" href="/use-cases/kyb/example">
    Implementação funcional completa com todos os dados necessários
  </Card>

  <Card title="Referência da API" icon="book" href="/api-reference/entities/create">
    Documentação detalhada da API
  </Card>

  <Card title="Fluxo de Trabalho KYB" icon="flow" href="/use-cases/kyb/workflow">
    Processo de verificação passo a passo
  </Card>

  <Card title="Upload de Documentos" icon="upload" href="/en/api-reference/documents/upload">
    Como fazer upload de documentos de verificação
  </Card>
</CardGroup>