Novedades - Trébol

VerificacionesAPI

Los items person_id devuelven el nombre y los apellidos por separado, además del nombre completo

Disponible desde el 7 de agosto de 2026.Qué es. El item_value de los items person_id suma cuatro campos nuevos con el nombre de la persona separado en sus partes: first_name, other_names, first_last_name y other_last_names. El campo names con el nombre completo sigue igual.Para qué sirve. Si necesitas el nombre y los apellidos por separado —para prellenar formularios, cruzar contra tus propios registros o listas de riesgo— ya no tienes que partir names por tu cuenta. La separación se basa en las etiquetas del propio documento (INE, cédula de ciudadanía, pasaporte y tarjeta de residencia), no en la posición dentro del nombre completo, que en la mayoría de las identificaciones viene con los apellidos primero.Campos opcionales. other_names viene en null cuando la persona tiene un solo nombre de pila, y other_last_names cuando tiene un solo apellido. Los items procesados antes de esta fecha devuelven los cuatro campos en null.Es un cambio aditivo: no cambia ni renombra ningún campo existente. Consulta el detalle en Nombre separado en partes.

WidgetAplicativo web

Cinco campos nuevos de branding, un eje de consentimiento con checkbox y dominio personalizado para las ligas de onboarding

Disponible desde el 24 de julio de 2026.Qué es. La pantalla Ajustes → Personalización del aplicativo web suma cinco campos nuevos para la primera ventana del widget y un nuevo eje de consentimiento. Toda la configuración sigue siendo a nivel de cuenta.Campos nuevos. Todos opcionales:

URL de términos y condiciones: se muestra junto a la política de privacidad y agrega los términos al footer.
Correo de contacto: reemplaza el correo de soporte de Trébol en el footer del widget.
Hacer el identificador fiscal (RFC/NIT) obligatorio: vuelve requerido el campo fiscal del primer paso (según el país del flujo).
Requerir aceptación explícita con checkbox: muestra un checkbox que bloquea el botón “Comenzar” hasta que el prospecto acepta.
Remitente de los correos: define el nombre visible del remitente en los correos de onboarding. Es el único campo que afecta los correos, no el widget.

Consentimiento con dos ejes. El consentimiento deja de ser una sola elección. Ahora combinas quién obtiene el consentimiento (Trébol refiere leads o el cliente acepta directamente) con cómo se acepta (implícito al hacer clic o con checkbox explícito).Dominio personalizado de onboarding. También configuras tu propio dominio (por ejemplo verificacion.tuempresa.com) para que el prospecto vea tu marca en la URL durante todo el onboarding. Las ligas nuevas usan tu dominio en cuanto lo verificas. El widget embebido sigue cargando desde el dominio de Trébol.Consulta el detalle en Personalizar el widget y en Dominio personalizado de onboarding.

VerificacionesAPI

Divide un PDF con varios documentos en cortes individuales y crea ítems a partir de cada corte

Disponible desde el 24 de julio de 2026.Qué es. El nuevo tipo de ítem doc_splitter analiza un PDF, identifica los documentos que contiene y devuelve una lista de cortes (splits) con su rango de páginas y clasificación. Sirve para expedientes que agrupan varios documentos en un mismo archivo.Cómo se crea. Igual que cualquier ítem: al crear una verificación (POST /verifications) o al agregar ítems a una existente (PUT /verifications/{id}/add-items), pasando type: "doc_splitter" y una options.file_url con el PDF a dividir.Cómo se consume. Cuando el ítem termina, expone item_value.split_documents con un support_id, page_start, page_end y support_metadata por corte.Cómo se procesan los cortes. Para procesar un corte con otro ítem (doc_validation, ac_mx, aa_mx, cit_*, etc.), llamas otra vez a add-items con:

{
  "type": "ac_mx",
  "options": {
    "file_source": "item",
    "file_source_info": {
      "item_id": 30829,
      "support_id": "ds_9f7d3a1c-..."
    }
  }
}

Trébol resuelve internamente el sub-PDF; no necesitas reenviar la URL.Compatible con tipos personalizados. El allowed_item_types acepta tipos built-in y tipos definidos vía tipos de ítem personalizados (cit_*) en la misma lista.Consulta el detalle en la guía del divisor de documentos.

VerificacionesAPIAplicativo web

Define tus propios tipos de documento con clasificación, validación y extracción configurables

Disponible desde el 22 de julio de 2026.Qué es. Ahora tu cuenta define sus propios tipos de ítem personalizados: tipos de documento que van más allá de los que Trébol trae por defecto. Los creas, configuras y los usas en tus verificaciones igual que cualquier tipo estándar.Procesos. Cada tipo agrupa hasta tres clases de proceso:

Clasificación (obligatorio). Describe el documento para que Trébol lo identifique. Se crea junto con el tipo.
Validación (opcional). Define reglas que el documento debe cumplir.
Extracción (opcional). Define los campos a extraer y produce un esquema de salida.

Cómo se crea. Tienes dos vías:

Por API
Por aplicativo web (administradores)

Gestionas el ciclo de vida completo con el endpoint /v2/custom-item-types y sus procesos: crear, listar, obtener, actualizar y eliminar.

Cómo se usa. Pasas el name del tipo como type del ítem al crear una verificación, igual que un tipo de Trébol. El flujo de la API no cambia; solo cambia el valor del tipo.Consulta el detalle en la guía de tipos de ítem personalizados y en la referencia de la API.

VerificacionesAPI

Las respuestas del SAT ahora distinguen un RFC sin información de una falla técnica del portal

Disponible desde el 2 de julio de 2026.Las consultas de firmas y sellos del SAT (public_sat_signatures) ahora distinguen dos resultados que antes se reportaban igual, mediante un campo adicional validationResult.reason dentro de item_value.data.{rfc}:

RFC no encontrado (validationResult.reason: "rfc_not_found"): el SAT respondió correctamente pero no tiene información para ese RFC. Acción: verifica que el RFC sea correcto.
Falla técnica (validationResult.reason: "scraper_error", o status: "exception"): un problema al consultar el portal del SAT (respuesta inesperada, bloqueo o cambio en la página). Acción: reintenta más tarde.

Cada caso trae además un validationMessage específico, en lugar del genérico "No successful response has been returned, please check RFC." anterior.

Cambio retrocompatible: el campo status conserva sus valores de siempre (success, fail, exception) y validationResult.reason es información nueva y opcional. Si hoy ramificas solo por status, no necesitas hacer nada. Si quieres mostrar el mensaje preciso de “verifica el RFC” vs “reintenta más tarde”, usa validationResult.reason.

Consulta el detalle en errores en consultas públicas → SAT.

VerificacionesAplicativo web

Trébol emite una síntesis con alertas sobre qué revisar para completar el dictamen

Disponible desde el 24 de junio de 2026.Qué es. Trébol ya no solo extrae información. Ahora emite una síntesis de dictamen. Esta señala qué revisar antes de dar por completo el dictamen, según las reglas de negocio de tu cuenta.Alertas. Cada hallazgo trae una severidad:

🚨 Críticos. Bloquean el dictamen y requieren revisión antes de continuar.
⚠️ Revisar. No bloquean por sí solas, pero conviene validarlas.
ℹ️ Informativo. No bloquean; los avisos son solo de contexto.

Ejemplo. Síntesis de dictamen para ACME S.A. de C.V.

🚨 Constancia de situación fiscal vencida. Tiene más de 60 días de antigüedad.
⚠️ RFC de socio faltante. Un socio no tiene RFC en el expediente.
ℹ️ INE inválida. La identificación del representante no pasó la validación.

Contacta a help@gotrebol.com para configurar tus propias reglas.

Dónde ves la síntesis de dictamen. El mismo análisis aparece en tres lugares.

Aplicativo web
Correo al finalizar
Correo de exportación

Al abrir la verificación ves la síntesis en el reporte, dentro del análisis de dictamen legal. Ahí revisas cada alerta con su severidad.

Por ahora solo en aplicativo web y correo. La síntesis y las alertas aún no se exponen vía API ni webhook.

VerificacionesAPIAplicativo web

Descarga la evidencia de auditoría de las consultas a fuentes gubernamentales

Disponible desde el 23 de junio de 2026. Aplica solo a verificaciones de México.Cada verificación de México ahora genera un reporte PDF estandarizado con la evidencia de las consultas que Trébol hace a fuentes públicas (SAT, validación QR de la constancia de situación fiscal, CURP/RENAPO, INE y SIGER): qué dependencia se consultó, sobre quién, en qué fecha y con qué resultado. El reporte se regenera automáticamente cada vez que la verificación finaliza.

Reporte de consultas a fuentes gubernamentales generado por Trébol

Por API
Por aplicativo web

Disponible en el campo lookups_report del endpoint obtener una verificación por su ID. El campo está presente solo cuando el reporte existe: en verificaciones antiguas, sin consultas externas o aún en generación, lookups_report puede venir ausente o null — chequéalo antes de leer url.La url del PDF dentro de lookups_report es firmada y de corta duración: no la caches; vuelve a consultar la verificación si necesitas un enlace fresco.

¿Necesitas la evidencia en formato procesable? La sección external-lookups la entrega como JSON. Consulta el detalle —campos, evidencia por fuente y ejemplos— en Consultas públicas externas.

VerificacionesAplicativo web

Aprueba o rechaza un prospecto y deja la verificación en solo lectura

Disponible desde el 27 de mayo de 2026.Ahora puedes asignar una etiqueta de decisión a una verificación desde el aplicativo web para cerrar el ciclo del prospecto. La etiqueta marca la verificación como aprobada o rechazada, con un comentario opcional que justifica la decisión. La decisión se toma sobre el expediente y la información que Trébol ya capturó y reconcilió.Al asignar una etiqueta de decisión, la verificación queda en solo lectura: no se pueden agregar ni reemplazar documentos, ni modificar campos. Esto protege la información sobre la cual se tomó la decisión.

Permiso requerido. Solo los usuarios con el permiso Aprobar etiquetas (decisión y bloqueo) pueden asignar este tipo de etiquetas. Los demás usuarios pueden ver la decisión pero no cambiarla.

Activación. Esta funcionalidad es opcional por cuenta. Si la quieres usar, contacta a Trébol para activarla.

Cuando asignas o remueves una etiqueta de decisión, Trébol dispara los webhooks verification.v2.label_added y verification.v2.label_removed para que tu sistema reaccione en tiempo real.

Asignación de etiqueta de decisión a una verificación

API

Integra Trébol más rápido desde Claude Code, Cursor, Codex y otros editores con IA

Disponible desde el 15 de mayo de 2026.Publicamos un skill oficial de Trébol que tu editor con IA (Claude Code, Cursor, Codex, GitHub Copilot, Windsurf, Gemini, Cline y más) carga bajo demanda. Le da a tu asistente conocimiento embebido de nuestra API: autenticación, endpoints, items, account-flows, webhooks y errores comunes. El objetivo es acelerar la integración de los clientes que se conectan vía API: menos vueltas al navegador, código listo para pegar.Instalación en una sola línea:

npx skills add gotrebol/skills

skills.sh detecta qué editor con IA usas y configura el skill en la ruta correcta. Después puedes preguntarle a tu asistente cosas como “¿cómo creo una verificación KYB para una empresa mexicana?”. La respuesta llega con endpoints y payloads específicos de Trébol.

Privacidad. El skill no envía datos a Trébol. Es contenido estático que vive localmente y tu asistente consulta bajo demanda. Lo único que sale de tu máquina son las llamadas que tú decidas hacer a api.gotrebol.com con tu propia API key.

Para la guía completa de instalación, prerequisitos, actualización y solución de problemas, consulta Integrar Trébol desde tu editor con IA.

Widget

Campos condicionales basados en respuestas previas

Disponible desde el 21 de abril de 2026. No requiere actualización en tu integración.Ahora puedes configurar campos condicionales en los formularios del widget: según la respuesta de una pregunta, el formulario muestra u oculta otras preguntas. Esto te permite construir formularios dinámicos sin ramificar el esquema.

Usa los atributos depends_on y depends_on_value en el esquema del formulario para definir las condiciones. Consulta la documentación completa en Items del flujo — campos condicionales.

VerificacionesAPIWidget

Identifica cada verificación con un nombre que tú eliges

Disponible desde el 16 de abril de 2026.Ahora puedes asignarle un nombre personalizado a cada verificación para encontrarla fácilmente en tu listado. Esto es útil cuando el nombre legal en los documentos difiere de cómo conoces a la empresa internamente.Puedes configurar el nombre personalizado desde tres puntos:

Por API
Widget (link de onboarding)
Aplicativo web (carga de documentos)

Usa el campo friendly_name en el body del request. Consulta la referencia API.

Nombre personalizado en el aplicativo web

Widget

Navega formularios largos por secciones desde el menú lateral

Disponible desde el 16 de abril de 2026. No requiere actualización en tu integración.Los formularios largos del widget ahora se organizan en secciones con un menú lateral de navegación. Antes el widget mostraba todos los campos en una sola página. Esto facilita completar formularios extensos de forma más ordenada.

Para configurar las secciones de tu formulario, consulta la documentación de Items del flujo — forms y el endpoint de esquemas de formularios.