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

> Campos de datos obligatorios y opcionales para la verificación de empresas — en el flujo KYB de gu1 para verificación empresarial, con ejemplos para data.

## Descripción General

Esta guía detalla todos los campos de datos requeridos para una verificación KYB (Know Your Business) completa utilizando la plataforma de gu1. Los requisitos de datos varían según la jurisdicción, el tipo de empresa y el nivel de riesgo.

## Información Básica de la Empresa

### Campos Obligatorios

Estos campos son obligatorios para todas las entidades empresariales:

| Campo               | Tipo   | Descripción                         | Ejemplo                                    |
| ------------------- | ------ | ----------------------------------- | ------------------------------------------ |
| `legalName`         | string | Nombre comercial oficial registrado | "Tech Solutions Sociedade Anônima"         |
| `tradeName`         | string | Nombre comercial de la empresa      | "Tech Solutions"                           |
| `taxId`             | string | Número de identificación fiscal     | "12.345.678/0001-90" (CNPJ - Brasil)       |
| `countryCode`       | string | Código ISO 3166-1 alfa-2            | "BR", "US", "MX", "AR"                     |
| `incorporationDate` | date   | Fecha de constitución de la empresa | "2020-06-15"                               |
| `industry`          | string | Actividad comercial principal       | "Desarrollo de Software"                   |
| `registeredAddress` | object | Dirección comercial oficial         | Ver estructura de dirección a continuación |

### Estructura de Dirección

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

## Detalles de la Empresa

### Campos Altamente Recomendados

Estos campos mejoran significativamente la precisión de la evaluación de riesgo:

| Campo                 | Tipo   | Descripción                               | Ejemplo                                                        |
| --------------------- | ------ | ----------------------------------------- | -------------------------------------------------------------- |
| `registrationNumber`  | string | ID de registro comercial gubernamental    | "NIRE 35.300.123456"                                           |
| `businessType`        | string | Estructura legal                          | "LLC", "Corporation", "Partnership"                            |
| `website`             | string | Sitio web oficial de la empresa           | "[https://techsolutions.com.br](https://techsolutions.com.br)" |
| `employeeCount`       | number | Número de empleados                       | 50                                                             |
| `annualRevenue`       | number | Ingresos anuales en USD                   | 5000000                                                        |
| `foundingYear`        | number | Año de fundación de la empresa            | 2020                                                           |
| `businessDescription` | string | Descripción de la actividad de la empresa | "SaaS B2B para empresas"                                       |

### Campos Opcionales

Útiles para debida diligencia mejorada:

| Campo                | Tipo   | Descripción                             |
| -------------------- | ------ | --------------------------------------- |
| `phoneNumber`        | string | Teléfono comercial principal            |
| `email`              | string | Correo electrónico de contacto oficial  |
| `parentCompany`      | string | Nombre de la empresa matriz (si aplica) |
| `subsidiaries`       | array  | Lista de empresas subsidiarias          |
| `stockSymbol`        | string | Símbolo bursátil (si cotiza en bolsa)   |
| `regulatoryLicenses` | array  | Licencias y permisos requeridos         |

## Datos de Beneficiarios Finales

Requerido para empresas con estructuras de propiedad complejas:

### Beneficiarios Finales Últimos (UBOs)

Para cada individuo que posea >25% de la 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"
      }
    }
  ]
}
```

### Estructura Corporativa

Para propiedad compleja:

```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 Requeridos

### Nivel 1: Documentos Esenciales

Requeridos para todas las empresas:

1. **Estatutos de Constitución / Certificado de Formación**
   * Tipo de archivo: PDF
   * Tamaño máximo: 10MB
   * Debe ser: Emitido por el gobierno, reciente (dentro de 6 meses)

2. **Licencia Comercial / Permiso de Operación**
   * Tipo de archivo: PDF, JPG, PNG
   * Tamaño máximo: 10MB
   * Debe mostrar: Número de licencia, fecha de vencimiento, autoridad emisora

3. **Certificado de Registro Fiscal**
   * Tipo de archivo: PDF
   * Tamaño máximo: 10MB
   * Debe mostrar: ID fiscal, fecha de registro, estado actual

4. **Comprobante de Domicilio Comercial**
   * Tipo de archivo: PDF, JPG
   * Tamaño máximo: 5MB
   * Aceptable: Factura de servicios, extracto bancario (últimos 3 meses)

### Nivel 2: Debida Diligencia Mejorada

Requerido para empresas de riesgo medio/alto:

5. **Estados Financieros**
   * Tipo de archivo: PDF
   * Período: Últimos 2 años
   * Debe ser: Auditado o certificado por contador

6. **Declaración de Beneficiarios Finales**
   * Tipo de archivo: PDF
   * Tamaño máximo: 10MB
   * Debe incluir: Nombres, % de propiedad, IDs de todos los UBOs

7. **Resolución del Consejo / Autorización**
   * Tipo de archivo: PDF
   * Tamaño máximo: 5MB
   * Propósito: Autorización de relación comercial

8. **Documentación de Origen de Fondos**
   * Tipo de archivo: PDF
   * Tamaño máximo: 10MB
   * Ejemplos: Acuerdos de inversión, extractos bancarios

### Nivel 3: Requisitos Adicionales de Alto Riesgo

Requerido para industrias o jurisdicciones de alto riesgo:

9. **Aprobaciones Regulatorias**
   * Específicas de la industria (servicios financieros, salud, etc.)
   * Deben estar vigentes y válidas

10. **Documentación de Política AML**
    * Procedimientos internos AML/CFT
    * Información del oficial de cumplimiento

11. **Certificado de Cumplimiento de Sanciones**
    * Declaración de no violaciones de sanciones
    * Historial de cumplimiento de los últimos 5 años

## 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"
  ]
}
```

## Datos de Transacciones y Actividad

### Patrones de Transacciones Esperados

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

### Relaciones Comerciales

```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 Basados en Riesgo

### Riesgo Bajo (Puntuación \< 30)

* Información básica de la empresa
* Solo documentos de Nivel 1
* Verificación de propiedad de una sola capa

### Riesgo Medio (Puntuación 30-70)

* Información completa de la empresa
* Documentos de Nivel 1 + Nivel 2
* Verificación completa de beneficiarios finales
* Configuración de monitoreo de transacciones

### Riesgo Alto (Puntuación > 70)

* Información exhaustiva de la empresa
* Todos los documentos de Nivel 1, 2 y 3
* Verificación mejorada de beneficiarios finales
* Documentación de origen de patrimonio
* Monitoreo continuo mejorado

## Requisitos Específicos por Industria

### Servicios Financieros

```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"]
    }
  }
}
```

### Criptomonedas / Blockchain

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

### Juegos / Apuestas

```json theme={null}
{
  "industry": "gaming",
  "additionalRequirements": {
    "gamingLicense": true,
    "licensingAuthority": "Malta Gaming Authority",
    "fairnessVerification": "third_party_certified",
    "responsibleGamingPolicy": true
  }
}
```

## Estándares de Calidad de Datos

### Reglas de Validación

Todos los datos deben cumplir con estos estándares de calidad:

1. **Completitud**: Sin campos obligatorios faltantes
2. **Exactitud**: Los datos coinciden con los documentos oficiales
3. **Consistencia**: La validación cruzada de campos es exitosa
4. **Vigencia**: Documentos de menos de 6 meses de antigüedad
5. **Legibilidad**: Documentos claramente legibles (mín. 300 DPI)

### Errores de Validación Comunes

| Error                         | Causa                                         | Solución                                     |
| ----------------------------- | --------------------------------------------- | -------------------------------------------- |
| Formato de ID fiscal inválido | Formato incorrecto para el país               | Usar validador específico del país           |
| Documento demasiado antiguo   | Fecha de emisión > 6 meses                    | Solicitar documento actualizado              |
| Discrepancia de nombre        | Nombre legal ≠ nombre en documento            | Verificar nombre legal correcto              |
| UBO faltante                  | No hay propietarios listados                  | Proporcionar estructura de propiedad         |
| Dirección no verificable      | No se puede confirmar que la dirección existe | Proporcionar factura de servicios o extracto |

## Formato de Envío de Datos

### Estructura JSON

Ejemplo completo de envío de datos 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 de API para Envío de Datos

* **Crear Entidad**: `POST /entities`
* **Subir Documentos**: `POST /documents`
* **Agregar UBOs**: `POST /entities/{id}/beneficial-owners`
* **Actualizar Información Comercial**: `PATCH /entities/{id}`

## Próximos Pasos

<CardGroup cols={2}>
  <Card title="Ejemplo Completo" icon="code" href="/use-cases/kyb/example">
    Implementación funcional completa con todos los datos requeridos
  </Card>

  <Card title="Referencia de API" icon="book" href="/api-reference/entities/create">
    Documentación detallada de la API
  </Card>

  <Card title="Flujo de Trabajo KYB" icon="flow" href="/use-cases/kyb/workflow">
    Proceso de verificación paso a paso
  </Card>

  <Card title="Carga de Documentos" icon="upload" href="/es/api-reference/documents/upload">
    Cómo subir documentos de verificación
  </Card>
</CardGroup>