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

# Enviar documentos comerciales

> Cargar documentación de respaldo para una cuenta comercial — en el registro para empresas unipersonales, o cuando la revisión KYB solicite más información.

## Descripción general

Los documentos comerciales se envían mediante un **endpoint REST de carga de archivos**, no a través de la API GraphQL. El endpoint almacena el archivo y devuelve una URL que luego referencias desde una mutación de GraphQL o entregas a tu account manager.

Hay dos momentos en el ciclo de vida de un negocio donde entran en juego los documentos:

| Situación                                            | Qué hacer                                                                                                                                                 |
| ---------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Registrando una **empresa unipersonal**              | Carga el documento **antes** de llamar a `registerBusiness`, luego pasa la URL devuelta en `soleProprietorshipDocumentUrl`. El registro fallará sin esto. |
| La revisión KYB solicita **documentación adicional** | La cuenta permanece en `PENDING`. Sube los archivos solicitados y proporciona las URLs a tu account manager junto con el `accountId`.                     |

<Note>
  Las LLCs, corporaciones, sociedades y cooperativas **no** requieren carga de documentos en el registro. Fluz verifica esas entidades a partir de los datos enviados en [registerBusiness](/business-registration). Los documentos solo se solicitan si las verificaciones automáticas no se aprueban.
</Note>

***

## Endpoint de carga

| Propiedad            | Valor                                              |
| -------------------- | -------------------------------------------------- |
| Método               | `POST`                                             |
| Ruta                 | `/api/v1/file-upload/sole-proprietorship-document` |
| Tipo de contenido    | `multipart/form-data`                              |
| Campo del formulario | `file`                                             |
| Autenticación        | OAuth Bearer Token                                 |

URL base de staging: `https://transactional-graph.staging.fluzapp.com`

```bash theme={null}
curl -X POST https://transactional-graph.staging.fluzapp.com/api/v1/file-upload/sole-proprietorship-document \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -F "file=@/path/to/document.pdf"
```

El endpoint devuelve una URL. Guárdala y pásala directamente a `registerBusiness`:

```json theme={null}
{
  "input": {
    "businessName": "Jane Doe Design",
    "businessStructure": "SOLE_PROPRIETORSHIP",
    "soleProprietorshipDocumentUrl": "<URL RETURNED BY THE UPLOAD ENDPOINT>",
    "...": "..."
  }
}
```

<Warning>
  Carga primero, registra después. No hay forma de adjuntar un documento a un registro existente — si envías una empresa unipersonal sin `soleProprietorshipDocumentUrl`, la mutación se rechaza y el usuario no puede iniciar una segunda solicitud hasta que la primera se cierre (`BS-0007`).
</Warning>

<Info>
  **Requisitos de archivo** — formatos aceptados, tamaño máximo de archivo y límites de páginas: confirma los límites actuales con tu account manager antes de construir la validación del lado del cliente.
</Info>

***

## Documentos para empresas unipersonales

Debido a que una empresa unipersonal no es una entidad legal registrada por separado, el documento debe establecer dos cosas: que el nombre comercial existe y que el propietario es la persona detrás de él.

Documentos que generalmente satisfacen esto:

* **Registro de nombre comercial ficticio / DBA** — el registro del condado o estado para el nombre comercial
* **Licencia comercial** — emitida al propietario por la ciudad, el condado o el estado
* **Carta de asignación de EIN del IRS** (CP 575 o 147C) — cuando la empresa unipersonal tiene su propio EIN

Guía práctica:

* El nombre en el documento debe coincidir con el `businessName` que envías. Una discrepancia es la razón más común por la que una revisión de empresa unipersonal se estanca.
* Envía un escaneo completo y legible o un PDF del documento entero, no una captura recortada de una línea.
* No se aceptan licencias y registros vencidos — el documento debe estar vigente.

## Documentación adicional durante la revisión KYB

Si el equipo de cumplimiento de Fluz necesita más de lo que proporciona el payload de registro, el caso KYB permanece `PENDING` mientras la solicitud se realiza a través de tu account manager. Elementos solicitados con frecuencia:

* Documentos de constitución (estatutos de organización o incorporación, acuerdo operativo, acuerdo de sociedad)
* Prueba de la dirección comercial
* Identificación emitida por el gobierno para un beneficiario final o persona de control
* Una explicación o detalle de respaldo sobre la naturaleza del negocio, cuando `natureOfBusiness` se dejó en blanco o fue demasiado general

Qué hacer de tu lado:

1. Mantén la cuenta en un estado de "en revisión" en tu UI. No vuelvas a enviar `registerBusiness` — una segunda solicitud está bloqueada por `BS-0007`, y los casos duplicados ralentizan la revisión.
2. Sube los archivos solicitados y envía las URLs junto con el `accountId` a tu account manager.
3. Consulta el estado de la cuenta comercial con una frecuencia baja y actualiza tu UI cuando pase a aprobada o rechazada. Ver [Ciclo de vida del estado KYB](/business-registration#kyb-status-lifecycle).

<Note>
  Enviar información completa de beneficiarios finales en el registro es la forma más efectiva de evitar una solicitud de documentos. Ver [Requisitos de beneficiarios finales](/business-registration#beneficial-ownership-requirements).
</Note>

## Páginas relacionadas

<CardGroup cols={2}>
  <Card title="Registrar y verificar negocios" href="/business-registration">
    La mutación `registerBusiness`, parámetros y códigos de error.
  </Card>

  <Card title="Categorías de negocios" href="/business-categories">
    Obtén los IDs de categoría y subcategoría requeridos en el registro.
  </Card>

  <Card title="Verificación KYC de usuario" href="/user-kyc-verification">
    Verificación de identidad para los propietarios individuales detrás del negocio.
  </Card>

  <Card title="Entorno de staging vs. live" href="/concepts/environments">
    URLs base para el endpoint de carga en cada entorno.
  </Card>
</CardGroup>
