​

Documentación de la API de Revisión de Documentos y Consultas de Onboarding

Trébol permite la creación y verificación de documentos y consultas para el proceso de onboarding de empresas y validación de documentos. A continuación se listan los tipos de documentos soportados, organizados por país y tipo, así como los ítems disponibles para consultas, widgets, integraciones y funcionalidades en beta.

Importante:
Para la mayoría de los documentos, se recomienda crear los ítems utilizando el tipo generic. La plataforma Trebol clasificará automáticamente el documento al tipo específico correspondiente (por ejemplo, ac_mx o csf_mx). Los ítems de tipo consulta no cambian su valor después de ser creados.

​

Tipos de Documentos por País

​

México

Estos ítems son soportados por Trébol para el proceso de onboarding de empresas y validación de documentos. En el proceso de onboarding, se recomienda crear cada item con el tipo generic para que Trébol clasifique el documento al tipo específico correspondiente.

Ítem	Descripción
aa_mx	Actas de asamblea.
fme_mx	Folio mercantil electrónico del Registro Público de la Propiedad y de Comercio (RPPyC).
csf_mx	Constancia de situación fiscal.
pw_mx	Poder notarial.
ac_mx	Acta constitutiva.
em_mx	Escritura de compraventa de inmuebles en México. (Beta)

​

Colombia

Ítem	Descripción
rut_co	Documento del RUT (Registro Único Tributario) proporcionado.
cc_co	Certificado de representación legal (Cámara de Comercio).
em_co	Escritura de compraventa de inmuebles en Colombia. (Beta)

​

Brasil

Ítem	Descripción
ac_br	Acto constitutivo de empresas en Brasil. (Beta)

​

España

Ítem	Descripción
em_es	Escritura de compraventa de inmuebles en España.

​

Soportados en todos los países

Estos ítems no están asociados a un país en específico y pueden utilizarse en múltiples contextos.

Ítem	Descripción
bank_statement	Estado de cuenta bancario.
proof_address	Comprobante de domicilio.
person_id	Documento de identidad de persona física/natural.
generic	Documento genérico. Usar preferentemente al crear una verificación para que Trebol clasifique.
unknown	Documento desconocido o no procesable por Trebol.
corrupted_file	Documento dañado (no legible o corrupto).

​

Ítems de Tipo Consulta

Los siguientes ítems están orientados a la consulta de información ante entidades o fuentes externas. Su valor no cambia una vez creados.

​

México

Ítem	Descripción
siger	Consulta del SIGER (Sistema Integral de Gestión Registral).
public_sat_signatures	Consulta de firmas y sellos (FIEL) ante el SAT.

​

Colombia

Ítem	Descripción
rues	Consulta de NIT en el Registro Único Empresarial (RUES).
public_address_cc_co	Consulta de NIT para obtener dirección y contacto (Cámara de Comercio pública).
public_rut_co	Consulta del NIT en la DIAN (RUT público).
cc_co_ops	Certificado de representación legal (Cámara de Comercio - variación “ops”).

​

Ítems de Widget

Estos ítems son parte del widget utilizado en el proceso de onboarding:

Ítem	Descripción
ubos	Formulario de declaración de propietarios reales (beneficiarios finales).
forms	Formularios de cuestionarios de onboarding.

​

Ítems de Integraciones

Estos ítems corresponden a integraciones con otros sistemas o servicios:

Ítem	Descripción
aml_validation	Consulta en listas de sanciones (OFAC, CNBV, etc).
signatory_validation	Validación biométrica de firmantes.

​

Ítems en Beta

Los siguientes ítems están actualmente en fase beta y pueden estar sujetos a cambios:

Ítem	Descripción
financial_statements_any	Estados financieros de empresas en cualquier país.
ac_br	Acto constitutivo en Brasil.
em_mx	Escritura de compraventa de inmuebles en México.
em_co	Escritura de compraventa de inmuebles en Colombia.
em_es	Escritura de compraventa de inmuebles en España.
payroll_proof	Comprobante de nómina en cualquier país.
ac_br	Acto constitutivo de empresas en Brasil.

​

Workflow de Clasificación de Documentos

Para la mayoría de los documentos, se recomienda crear los ítems utilizando el tipo generic. A continuación, Trebol clasificará automáticamente el documento al tipo específico correspondiente, como ac_mx para actas constitutivas en México o csf_mx para constancias de situación fiscal en México. Este flujo simplifica la integración y asegura una clasificación precisa sin intervención manual.

Pasos del Workflow:

1. Creación del Ítem:

   • Enviar el documento utilizando el tipo generic.

2. Procesamiento por Trebol:

   • Trebol analiza el documento y determina su tipo específico.

3. Actualización del Ítem:

   • El ítem inicialmente creado como generic se actualiza automáticamente al tipo correspondiente, como ac_mx, csf_mx, etc.
   • Si Trebol no puede clasificar el documento, el ítem se actualiza a unknown o corrupted_file según corresponda.

Para los ítems de tipo consulta, su valor permanece constante y no se modifican después de la creación.

​

Ejemplos de Manejo de Errores

​

Ejemplo: Documento Genérico que Termina siendo unknown o corrupted_file

Imaginemos que una empresa está realizando el onboarding y sube un documento, este documento es de tipo generic. Una vez enviado, Trebol procesa el documento para determinar su tipo específico.

• Caso 1: Documento Termina siendo unknown

  Después del procesamiento, Trebol no reconoce el tipo de documento proporcionado. En este caso, el ítem creado como generic se actualiza automáticamente a unknown.

  Manejo del Error:

  • La aplicación debe verificar el estado del ítem y detectar que su tipo es unknown.
  • Se puede notificar al usuario que el documento subido no fue reconocido.
  • Se puede solicitar al usuario que proporcione un nuevo documento o que intente con otro tipo de archivo compatible.

• Caso 2: Documento Termina siendo corrupted_file

  Si Trebol detecta que el archivo subido está dañado o no es legible, el ítem creado como generic se actualiza automáticamente a corrupted_file.

  Manejo del Error:

  • La aplicación debe identificar que el ítem tiene el tipo corrupted_file.
  • Informar al usuario que el archivo cargado está dañado o corrupto.
  • Solicitar al usuario que vuelva a subir el documento en un formato legible y sin errores.