Skip to main content

​
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:
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. Los documentos solo se solicitan si las verificaciones automáticas no se aprueban.

​
Endpoint de carga

URL base de staging: https://transactional-graph.staging.fluzapp.com
El endpoint devuelve una URL. Guárdala y pásala directamente a registerBusiness:
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).
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.

​
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.
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.

​
Páginas relacionadas

Registrar y verificar negocios

La mutación registerBusiness, parámetros y códigos de error.

Categorías de negocios

Obtén los IDs de categoría y subcategoría requeridos en el registro.

Verificación KYC de usuario

Verificación de identidad para los propietarios individuales detrás del negocio.

Entorno de staging vs. live

URLs base para el endpoint de carga en cada entorno.