Enviar documentos comerciales

Descripción general

Algunas solicitudes comerciales necesitan un documento de respaldo. Cárguelo primero en Fluz y luego pase la URL devuelta en el campo correspondiente en registerBusiness. Hay dos tipos de documentos, y solo uno es obligatorio:

`documentType`	Cuándo lo necesita
`AUTHORIZED_SIGNER`	Obligatorio cuando el solicitante posee menos del 25% del negocio y no es la persona de control
`SOLE_PROPRIETORSHIP`	Opcional documentación de respaldo para una empresa unipersonal. El registro no lo requiere

El documento de empresa unipersonal solía ser obligatorio para negocios SOLE_PROPRIETORSHIP. Ya no lo es: envíelo solo si lo tiene.

Documentos de firmante autorizado

Un firmante autorizado es alguien que presenta en nombre del negocio sin ser un beneficiario final ni la persona de control. Cargue el documento que le otorga esa autoridad — una resolución corporativa, poder notarial o equivalente — y pase su URL como authorizedSignerDocumentUrl.

Alcances requeridos

Propiedad	Valor
Endpoint	REST — `POST /api/v1/file-upload/business-application-document`
Autenticación	OAuth Bearer Token
Content-Type	`multipart/form-data`
Scopes requeridos	`REGISTER_BUSINESS`

A diferencia de las operaciones GraphQL de KYB, este endpoint no aplica scope ni tipo de cuenta: se acepta cualquier credencial de aplicación válida. Use el token de consumidor del solicitante para mantener la coherencia.

Parámetros

Enviados como campos multipart/form-data:

Campo	Tipo	Requerido	Descripción
`file`	`File`	Sí	`application/pdf`, `image/jpeg`, o `image/png`. Tamaño máximo 5 MB
`documentType`	`String`	Sí	`AUTHORIZED_SIGNER` o `SOLE_PROPRIETORSHIP`

Cargue un archivo por llamada. Si envía ambos tipos de documentos, llame al endpoint dos veces y conserve ambas URLs.

Ejemplo cURL

curl -X POST https://transactional-graph.staging.fluzapp.com/api/v1/file-upload/business-application-document \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -F "file=@/path/to/document.pdf" \
  -F "documentType=AUTHORIZED_SIGNER"

Detalles de la respuesta

Éxito — `200 OK`

Campo	Tipo	Descripción
`url`	`String`	URL pública del documento almacenado. Pase esto a `registerBusiness`

{
  "url": "https://storage.googleapis.com/.../business-applications/9f8e7d6c-..."
}

Pase la url devuelta a registerBusiness como:

authorizedSignerDocumentUrl — para solicitantes firmantes autorizados
soleProprietorshipDocumentUrl — para empresas unipersonales

Pásela sin cambios. registerBusiness requiere una URL absoluta http/https de máximo 255 caracteres y rechaza cualquier otra cosa con ARG-0001.

Error — `400 Bad Request`

{
  "error": {
    "message": "Invalid arguments received - invalid document type.",
    "code": "ARG-0001"
  }
}

Códigos de error

Código	Nombre	Descripción	Cómo resolver
`ARG-0002`	MissingArguments	No se incluyó `file` en la solicitud	Envíe el archivo como un campo `multipart/form-data` llamado `file`
`ARG-0001`	InvalidArguments	`documentType` ausente o inválido, o el tipo MIME del archivo no es `application/pdf`, `image/jpeg`, o `image/png`	Verifique el valor de `documentType` y convierta el archivo a un formato compatible
`G-0001`	InternalError	Falló la carga al almacenamiento	Reintente una vez. Si persiste, contacte soporte con la marca de tiempo

Un encabezado Authorization ausente o mal formado devuelve 401; un Bearer token vencido devuelve 498. Archivos de más de 5 MB son rechazados por la capa de carga antes de que se ejecute el manejador.

Documentación solicitada durante la revisión

Cualquier estructura empresarial puede recibir solicitudes de documentación adicional mientras su caso KYB está en revisión — comúnmente documentos de constitución, comprobante de domicilio o un diagrama de propiedad cuando una entidad posee participación. Estas solicitudes no se muestran a través del API. El caso permanece PENDING y su account manager se pondrá en contacto. No reenvíe la solicitud en respuesta: un segundo envío es bloqueado por BS-0007 y crea un caso duplicado.

La falta de beneficiarios finales es la razón más común por la que una revisión se detiene para documentación adicional. Completar el roster de propiedad en el primer envío es la mejor manera de evitar este paso por completo.

Notas

Este es un endpoint único y consolidado para ambos tipos de documentos — pase documentType en el cuerpo del formulario en lugar de usar una ruta específica por tipo.
La carga se almacena de inmediato y la URL no expira. No está vinculada a ninguna solicitud hasta que envíe registerBusiness.
Nada verifica que documentType coincida con el campo de URL que luego pasa a registerBusiness. Mantenga claras ambas URLs de su lado.
Cargue inmediatamente antes de registrar, para que no haya ambigüedad sobre qué documento pertenece a qué solicitud.

Crea una plataforma

Enviar documentos comerciales

Descripción general

Documentos de firmante autorizado

Alcances requeridos

Parámetros

Ejemplo cURL

Detalles de la respuesta

Éxito — `200 OK`

Error — `400 Bad Request`

Códigos de error

Documentación solicitada durante la revisión

Notas

Páginas relacionadas

Resumen de KYB

Registrar un negocio

​Descripción general

​Documentos de firmante autorizado

​Alcances requeridos

​Parámetros

​Ejemplo cURL

​Detalles de la respuesta

​Éxito — 200 OK

​Error — 400 Bad Request

​Códigos de error

​Documentación solicitada durante la revisión

​Notas

​Páginas relacionadas

Resumen de KYB

Registrar un negocio

Descripción general

Documentos de firmante autorizado

Alcances requeridos

Parámetros

Ejemplo cURL

Detalles de la respuesta

Éxito — `200 OK`

Error — `400 Bad Request`

Códigos de error

Documentación solicitada durante la revisión

Notas

Páginas relacionadas