# Trébol - [¿Qué es Trébol y para qué sirve?](https://gotrebol.com/docs/introduccion/bienvenido.md): Trébol es una herramienta para extraer información de documentos legales. - [Cómo funciona Trébol](https://gotrebol.com/docs/producto/como-funciona.md): Los tres métodos para crear verificaciones en Trébol: Aplicativo Web (no técnico), widget y API. - [Transforma PDFs en Datos Estructurados](https://gotrebol.com/docs/introduccion/pdfaexcel.md): Trébol automatiza la extracción de información desde documentos PDF legales (actas constitutivas, poderes notariales, escrituras, estados financieros) y los transforma en datos estructurados listos para Excel, JSON o tu sistema — con clasificación, reconciliación y validación de calidad. - [Extracciones personalizadas](https://gotrebol.com/docs/producto/guias/extracciones-personalizadas.md): Define instrucciones propias para extraer datos de tipos de documento en tu cuenta, activa una versión y consume los resultados por API o en plantillas. - [Tipos de ítem personalizados](https://gotrebol.com/docs/producto/guias/tipos-de-item-personalizados.md): Crea y gestiona tus propios tipos de documento con clasificación, validación y extracción configurables vía la API v2. - [Divisor de documentos (doc_splitter)](https://gotrebol.com/docs/producto/guias/doc-splitter.md): Analiza un PDF con varios documentos, obtén los cortes con sus rangos de páginas y clasificación, y crea ítems de verificación a partir de cada corte. - [Introducción](https://gotrebol.com/docs/guia-devs/intro.md): Esta página te ayudará a comenzar con nuestra API. - [Integrar Trébol desde tu editor con IA](https://gotrebol.com/docs/guia-devs/skill.md): Instala el skill oficial de Trébol en Claude Code, Cursor, Codex y otros editores con IA para integrar más rápido. - [Cómo conectarse a la API](https://gotrebol.com/docs/guia-devs/conectarse.md): URL base, autenticación y formato de request/response del API de Trébol. - [API Keys](https://gotrebol.com/docs/guia-devs/gestion-api-keys.md): Crea, lista y elimina API keys para integrarte con Trébol. Desde el Aplicativo Web o vía API. - [Cómo funciona Vía API](https://gotrebol.com/docs/guia-devs/crear-verificaciones/via-api/overview.md): Las 3 formas de procesar documentos cuando creas verificaciones vía API directa en Trébol. - [Crear una verificación](https://gotrebol.com/docs/guia-devs/crear-verificaciones/via-api/crear-verificacion.md): Endpoint POST /verifications: variantes, atributos principales y cómo elegir tu forma de procesamiento. - [Subir documentos con carga directa](https://gotrebol.com/docs/guia-devs/crear-verificaciones/via-api/carga-directa.md): Cómo subir documentos directamente a Trébol cuando no tienes una URL de descarga accesible. - [Forma 1: Clasificación automática](https://gotrebol.com/docs/guia-devs/crear-verificaciones/via-api/forma-clasificacion.md): Deja que Trébol clasifique automáticamente el tipo de documento usando el item generic. - [Forma 2: Validación](https://gotrebol.com/docs/guia-devs/crear-verificaciones/via-api/forma-validacion.md): Valida que un documento sea del tipo esperado y cumpla reglas específicas usando el item doc_validation. - [Forma 3: Extracción](https://gotrebol.com/docs/guia-devs/crear-verificaciones/via-api/forma-extraccion.md): Extrae directamente la información del documento usando el tipo de item correspondiente al caso de uso, sin validar. - [Cómo funciona Vía Widget](https://gotrebol.com/docs/guia-devs/crear-verificaciones/via-widget/overview.md): El widget de onboarding de Trébol permite que tus usuarios finales carguen documentos directamente desde tu aplicación. - [Crear el flujo](https://gotrebol.com/docs/guia-devs/crear-verificaciones/via-widget/crear-flujo.md): Diseña y gestiona flujos de onboarding reutilizables para el widget. - [Items del flujo](https://gotrebol.com/docs/guia-devs/crear-verificaciones/via-widget/items.md): Tipos de items que puedes agregar al flujo: ubos, forms (UI del prospecto) y consultas a fuentes externas (auto-ejecutadas). - [Instalar el widget](https://gotrebol.com/docs/guia-devs/crear-verificaciones/via-widget/instalar.md): Cómo embeber el widget de onboarding de Trébol en tu sitio o aplicación con unas pocas líneas de código. - [Personalizar el widget](https://gotrebol.com/docs/guia-devs/crear-verificaciones/via-widget/personalizar.md): Ajusta logo, colores, políticas, consentimiento y el dominio de las ligas de onboarding desde el aplicativo web de Trébol. - [Estados del expediente](https://gotrebol.com/docs/guia-devs/crear-verificaciones/via-widget/estados-expediente.md): Estado general del expediente y estado por requerimiento en una verificación creada vía widget. - [Estados de Verificaciones y Documentos](https://gotrebol.com/docs/guia-devs/monitorear/estados-verificacion.md): Documentación técnica sobre los estados en el sistema de Trébol para la validación de documentos (KYB). - [Notificaciones de Trébol](https://gotrebol.com/docs/guia-devs/monitorear/alertas.md): Trébol notifica el resultado de las verificaciones por email, Slack, Google Workspace, Microsoft Teams o webhook. - [Leer una verificación](https://gotrebol.com/docs/guia-devs/monitorear/leer.md): Cómo consultar la información extraída de una verificación finalizada: listar verificaciones, leer por ID, consultar por sección y revisar el estado de documentos. - [Consultas públicas externas](https://gotrebol.com/docs/guia-devs/monitorear/consultas-publicas-externas.md): Lee la evidencia de las consultas a fuentes gubernamentales (SAT, RENAPO, INE, SIGER) y descarga el reporte PDF de auditoría. - [Webhooks](https://gotrebol.com/docs/guia-devs/webhooks.md) - [Tipos de Documentos y Consultas](https://gotrebol.com/docs/guia-devs/referencia/tipos-item.md): Lista de tipos de documentos y consultas soportados por Trébol - [Respuestas por tipo de ítem](https://gotrebol.com/docs/guia-devs/referencia/respuestas-por-tipo-de-item.md): Catálogo de la estructura de las respuestas por tipo de ítem. - [Coordenadas de citas (Citations Artifact)](https://gotrebol.com/docs/guia-devs/referencia/coordenadas-citas.md): Cómo activar el artifact de coordenadas, qué estructura tiene y cómo integrarlo para mostrar de dónde se extrajo cada dato. - [Países y nacionalidades](https://gotrebol.com/docs/guia-devs/referencia/paises-nacionalidades.md): Lista de 249 países y territorios con código ISO 3166-1 alpha-2 y gentilicios usados en los formularios del widget (UBOs). - [Reglas de validación](https://gotrebol.com/docs/guia-devs/crear-verificaciones/via-api/reglas-validacion.md): Reglas predefinidas y personalizadas que puedes aplicar al validar documentos con Trébol, tanto en widget como en API. - [Manejo de errores del API](https://gotrebol.com/docs/guia-devs/errores.md): Estructura de errores, códigos y ejemplos de respuestas del API de Trébol. - [Errores en consultas públicas](https://gotrebol.com/docs/guia-devs/referencia/errores-consultas-publicas.md): Cómo detectar si una consulta pública falló según la fuente externa: RENAPO, INE, SAT, SIGER, RUES, DIAN y Cámara de Comercio. - [Log Stream](https://gotrebol.com/docs/guia-devs/log-stream.md): Configura integraciones para recibir eventos de auditoría en tiempo real en plataformas como Splunk - [Overview — KYB México](https://gotrebol.com/docs/guia-devs/uso-kyb/mexico/overview.md): Guía end-to-end para crear verificaciones KYB de empresas mexicanas: items aplicables, apoderados, variaciones de creación con ejemplos de payload. - [Items de documentos — KYB México](https://gotrebol.com/docs/guia-devs/uso-kyb/mexico/items-documentos.md): Documentos cargables en verificaciones KYB de México: descripciones, campos extraídos y estructura de respuesta. - [Items de consultas públicas — KYB México](https://gotrebol.com/docs/guia-devs/uso-kyb/mexico/items-consultas-publicas.md): Consultas públicas aplicables a verificaciones KYB de México: SIGER, SAT, CURP. - [Extraer Accionistas de Actas](https://gotrebol.com/docs/guia-devs/uso-kyb/mexico/accionistas.md): Consultar los accionistas de una empresa en el onboarding de empresas - [Extraer Apoderados de Actas y Poderes](https://gotrebol.com/docs/guia-devs/uso-kyb/mexico/firmantes.md): Guía para consultar y validar firmantes y administradores de una empresa - [Overview — KYB Colombia](https://gotrebol.com/docs/guia-devs/uso-kyb/colombia/overview.md): Guía end-to-end para crear verificaciones KYB de empresas colombianas: items aplicables, variaciones de creación con ejemplos de payload. - [Items de documentos — KYB Colombia](https://gotrebol.com/docs/guia-devs/uso-kyb/colombia/items-documentos.md): Documentos cargables en verificaciones KYB de Colombia: descripciones, campos extraídos y estructura de respuesta. - [Items de consultas públicas — KYB Colombia](https://gotrebol.com/docs/guia-devs/uso-kyb/colombia/items-consultas-publicas.md): Consultas públicas aplicables a verificaciones KYB de Colombia: RUES, NIT en la DIAN, Cámara de Comercio. - [Overview — KYB Estados Unidos](https://gotrebol.com/docs/guia-devs/uso-kyb/eeuu/overview.md): Guía end-to-end para crear verificaciones KYB de empresas en Estados Unidos: items aplicables, variaciones de creación con ejemplos de payload. - [Items de documentos — KYB Estados Unidos](https://gotrebol.com/docs/guia-devs/uso-kyb/eeuu/items-documentos.md): Documentos cargables en verificaciones KYB de Estados Unidos: certificate of incorporation, certificate of incumbency, IRS EIN assignment letter, FinCEN MSB registration. - [Items de documentos — KYB Todos los países](https://gotrebol.com/docs/guia-devs/uso-kyb/todos-paises/items-documentos.md): Documentos cargables aplicables a verificaciones KYB en cualquier país: identificación personal, comprobante de domicilio, estado de cuenta, contratos de fideicomiso, documentos de unión y estados financieros. - [Overview — Hipotecas](https://gotrebol.com/docs/guia-devs/uso-hipotecas/overview.md): Guía end-to-end para crear verificaciones de mortgage underwriting: items aplicables, variaciones de creación con ejemplos de payload. - [Items de Hipotecas](https://gotrebol.com/docs/guia-devs/uso-hipotecas/items.md): Items aplicables a verificaciones de mortgage underwriting: escrituras de propiedad, certificados de gravámenes, recibos de predial y avalúos. - [Overview — Nómina](https://gotrebol.com/docs/guia-devs/uso-nomina/overview.md): Guía end-to-end para crear verificaciones de payroll lending: items aplicables, variaciones de creación con ejemplos de payload. - [Items de Nómina](https://gotrebol.com/docs/guia-devs/uso-nomina/items.md): Items aplicables a verificaciones de payroll lending: recibos de nómina o pensión. - [Diccionario de variables de Trébol](https://gotrebol.com/docs/plantillas/intro.md): Compendio completo de todos los IDs utilizables por las empresas en sus formatos, reemplazados automáticamente por Trébol con la información proporcionada. - [Configuración de formularios de formato PDF](https://gotrebol.com/docs/plantillas/configuracion.md): Guía completa para crear formularios interactivos usando la herramienta que recomendamos, Adobe Acrobat, desde archivos PDF existentes o desde cero - [Gestion](https://gotrebol.com/docs/plantillas/gestion.md) - [Estatutos y Empresa](https://gotrebol.com/docs/plantillas/empresa.md): Información detallada sobre las variables relacionadas con los estatutos y la constitución de la empresa para la documentación en la plataforma de Trébol. - [Apoderados](https://gotrebol.com/docs/plantillas/apoderados.md): Guía detallada sobre cómo utilizar las variables de apoderados en Trébol, incluyendo la implementación de bucles, listas, y condicionales para personalizar la documentación. - [Accionistas](https://gotrebol.com/docs/plantillas/accionistas.md) - [Órgano de Administración](https://gotrebol.com/docs/plantillas/administracion.md): Variables relacionadas con el consejo de administración o administrador único de la persona moral, extraídos de las actas constitutivas y de asamblea. - [Órgano de Vigilancia](https://gotrebol.com/docs/plantillas/vigilancia.md): Variables relacionadas con los comisarios o auditores del órgano de vigilancia de la persona moral, extraídos de las actas constitutivas y de asamblea. - [Colombia](https://gotrebol.com/docs/plantillas/colombia.md) - [API Reference](https://gotrebol.com/docs/api-reference/intro.md): Documentación completa de la API de Onboarding de empresas de Trébol - [Listar verificaciones de la cuenta](https://gotrebol.com/docs/api-reference/leer-información-de-la-empresa/listar-verificaciones-de-la-cuenta.md): Retorna las verificaciones asociadas a la cuenta con paginación basada en tokens. El tamaño de página por defecto es 10 y el máximo permitido es 20. - [Obtener una verificación por su ID](https://gotrebol.com/docs/api-reference/leer-información-de-la-empresa/obtener-una-verificación-por-su-id.md): Retorna una verificación pública con sus items serializados. Consulta la guía de estructuras de `item_value` por tipo en [Respuestas por tipo de ítem](/docs/guia-devs/respuestas-por-tipo-de-item). - [Obtener historial corporativo conciliado](https://gotrebol.com/docs/api-reference/leer-información-de-la-empresa/obtener-historial-corporativo-conciliado.md): Retorna el historial de actas de una empresa, conciliado entre las tres fuentes que lo conocen, con una fila por acta y la trazabilidad de qué fuente aportó cada dato. - [Obtener sección por ID de verificación](https://gotrebol.com/docs/api-reference/leer-información-de-la-empresa/obtener-sección-por-id-de-verificación.md): Retorna datos públicos v2 de una sección específica de una verificación a partir de su id. - [Obtener sección por etiqueta de empresa](https://gotrebol.com/docs/api-reference/leer-información-de-la-empresa/obtener-sección-por-etiqueta-de-empresa.md): Retorna datos públicos v2 de una sección específica de una empresa a partir de su etiqueta. - [Crear una nueva verificación](https://gotrebol.com/docs/api-reference/creacion-de-verificacion/crear-una-nueva-verificación.md): Inicia una nueva verificación con los documentos especificados. - [Obtener todos los items de verificación](https://gotrebol.com/docs/api-reference/gestion-de-item-ids/obtener-todos-los-items-de-verificación.md): Retorna una lista de todos los items de verificación disponibles con paginación basada en tokens. La paginación funciona con un tamaño fijo de 10 items por página. - [Obtener un item de verificación por ID](https://gotrebol.com/docs/api-reference/gestion-de-item-ids/obtener-un-item-de-verificación-por-id.md): Retorna un item de verificación específico por su ID. - [Confirmar la carga de un documento](https://gotrebol.com/docs/api-reference/gestion-de-item-ids/confirmar-la-carga-de-un-documento.md): Después de subir el archivo mediante PUT a `item_options.upload_url`, confirma la carga para iniciar el procesamiento del item. Aplica a `generic`, `doc_validation`, tipos de extracción de documentos y `doc_splitter`, incluidos los tipos personalizados habilitados para la cuenta. El procesamiento es… - [Invalidar un documento de una verificacion](https://gotrebol.com/docs/api-reference/invalidar-un-documento/invalidar-un-documento-de-una-verificacion.md): Invalida el documento de la verificación especificado. - [Exportar datos de verificación a documento personalizado](https://gotrebol.com/docs/api-reference/exportación-de-verificaciones/exportar-datos-de-verificación-a-documento-personalizado.md): Exporta los datos de una verificación a un documento personalizado (PDF o Word) reemplazando los IDs con la información extraída. - [Exportar datos de verificación a documento personalizado con variables de apoderados](https://gotrebol.com/docs/api-reference/exportación-de-verificaciones/exportar-datos-de-verificación-a-documento-personalizado-con-variables-de-apoderados.md): Exporta los datos de una verificación a un documento personalizado (PDF o Word) reemplazando los IDs con la información extraída, incluyendo el mapeo de variables de apoderados. - [Ejecutar la Síntesis de Dictamen bajo demanda](https://gotrebol.com/docs/api-reference/sintesis-de-dictamen/ejecutar-sintesis-de-dictamen-bajo-demanda.md): Encola una corrida de la Síntesis de Dictamen (`findings`) para la verificación, sin esperar a que un nuevo documento la dispare automáticamente. - [Actualizar labels de una verificacion](https://gotrebol.com/docs/api-reference/labels-de-verificacion/actualizar-labels-de-una-verificacion.md): Actualiza los labels de una verificación específica. Estos labels son útiles para identificar y buscar verificaciones. - [Actualizar personas clave de una verificacion](https://gotrebol.com/docs/api-reference/actualizar-personas-clave-de-una-verificacion/actualizar-personas-clave-de-una-verificacion.md): Actualiza las personas clave de una verificación específica. - [Agregar items a una verificación existente](https://gotrebol.com/docs/api-reference/agregar-items-a-una-verificacion/agregar-items-a-una-verificación-existente.md): Agrega nuevos items/documentos a una verificación específica usando el id de la verificación. - [Obtener estado de validacion de documentos por el ID de Verificacion](https://gotrebol.com/docs/api-reference/estado-de-validacion-de-documentos/obtener-estado-de-validacion-de-documentos-por-el-id-de-verificacion.md): Obtener el estado de validacion de documentos de una verificacion usando el id de la verificación. - [Listar flujos de cuenta](https://gotrebol.com/docs/api-reference/gestión-de-flujos-de-cuenta/listar-flujos-de-cuenta.md): Obtiene una lista de todos los flujos de cuenta - [Crear nuevo flujo](https://gotrebol.com/docs/api-reference/gestión-de-flujos-de-cuenta/crear-nuevo-flujo.md): Crea un nuevo flujo de cuenta. Visita la [guía de desarrollo](/guia-devs/crear-verificaciones/via-widget/crear-flujo) para más información. - [Obtener flujo por ID](https://gotrebol.com/docs/api-reference/gestión-de-flujos-de-cuenta/obtener-flujo-por-id.md): Recupera un flujo de cuenta específico por su id_slug. - [Actualizar flujo existente](https://gotrebol.com/docs/api-reference/gestión-de-flujos-de-cuenta/actualizar-flujo-existente.md): Actualiza un flujo de cuenta existente por su id_slug. - [Eliminar flujo existente](https://gotrebol.com/docs/api-reference/gestión-de-flujos-de-cuenta/eliminar-flujo-existente.md): Elimina un flujo de cuenta existente por su id_slug - [Listar esquemas de formularios](https://gotrebol.com/docs/api-reference/gestión-de-esquemas-de-formularios/listar-esquemas-de-formularios.md): Obtiene una lista de todos los esquemas de formularios de la cuenta - [Crear nuevo esquema de formulario](https://gotrebol.com/docs/api-reference/gestión-de-esquemas-de-formularios/crear-nuevo-esquema-de-formulario.md): Crea un nuevo esquema de formulario para la cuenta. - [Obtener esquema por ID](https://gotrebol.com/docs/api-reference/gestión-de-esquemas-de-formularios/obtener-esquema-por-id.md): Recupera un esquema de formulario específico por su id_schema - [Actualizar esquema existente](https://gotrebol.com/docs/api-reference/gestión-de-esquemas-de-formularios/actualizar-esquema-existente.md): Actualiza un esquema de formulario existente por su id_schema. - [Eliminar esquema existente](https://gotrebol.com/docs/api-reference/gestión-de-esquemas-de-formularios/eliminar-esquema-existente.md): Elimina un esquema de formulario existente por su id_schema - [Obtener lista de IPs permitidas para hacer llamadas a la API](https://gotrebol.com/docs/api-reference/gestión-de-ips-permitidas/obtener-lista-de-ips-permitidas-para-hacer-llamadas-a-la-api.md): Obtiene la lista de IPs permitidas para la cuenta del cliente. Si no hay IPs configuradas, no se realiza validación de origen de las llamadas a la API. Si hay al menos una IP configurada, todas las llamadas a la API deben provenir de estas IPs. - [Agregar IPs a la lista de permitidas para hacer llamadas a la API](https://gotrebol.com/docs/api-reference/gestión-de-ips-permitidas/agregar-ips-a-la-lista-de-permitidas-para-hacer-llamadas-a-la-api.md): Agrega una o más direcciones IP a la lista de IPs permitidas. Si es la primera IP que se agrega, automáticamente se activa la validación de origen para todas las llamadas a la API. Máximo 100 IPs permitidas por cuenta. - [Eliminar todas las IPs permitidas](https://gotrebol.com/docs/api-reference/gestión-de-ips-permitidas/eliminar-todas-las-ips-permitidas.md): Elimina todas las IPs de la lista de permitidas. Después de esta operación, no se realizará validación de origen para las llamadas a la API. - [Eliminar IP específica de la lista de permitidas](https://gotrebol.com/docs/api-reference/gestión-de-ips-permitidas/eliminar-ip-específica-de-la-lista-de-permitidas.md): Elimina una dirección IP específica de la lista de IPs permitidas. Si se elimina la última IP, se desactiva la validación de origen. - [Listar API keys](https://gotrebol.com/docs/api-reference/gestión-de-api-keys/listar-api-keys.md): Obtiene la lista del id y la fecha de creación de todas las API keys asociadas a la cuenta del usuario. - [Crear nueva API key](https://gotrebol.com/docs/api-reference/gestión-de-api-keys/crear-nueva-api-key.md): Crea una nueva API key para la cuenta del usuario. La API key se genera automáticamente y se retorna una sola vez. - [Eliminar API key](https://gotrebol.com/docs/api-reference/gestión-de-api-keys/eliminar-api-key.md): Elimina una API key específica de la cuenta del usuario. La eliminación es inmediata y no se puede deshacer. Se puede autenticar con cualquier API key válida de la cuenta. - [Obtener política de retención actual](https://gotrebol.com/docs/api-reference/gestión-de-política-de-retención/obtener-política-de-retención-actual.md): Obtiene la política de retención de datos configurada para la cuenta. Si no hay política configurada, retorna la política por defecto. - [Actualizar política de retención](https://gotrebol.com/docs/api-reference/gestión-de-política-de-retención/actualizar-política-de-retención.md): Actualiza la política de retención de datos existente para la cuenta. Si no existe una política, la crea. - [Crear política de retención](https://gotrebol.com/docs/api-reference/gestión-de-política-de-retención/crear-política-de-retención.md): Crea una nueva política de retención de datos para la cuenta. Si ya existe una política, retorna un error. - [Eliminar política de retención](https://gotrebol.com/docs/api-reference/gestión-de-política-de-retención/eliminar-política-de-retención.md): Elimina la política de retención de datos de la cuenta. Después de esta operación, se aplicará la política por defecto del sistema. - [Listar webhooks](https://gotrebol.com/docs/api-reference/gestión-de-webhooks/listar-webhooks.md): Obtiene la lista de webhooks configurados para tu cuenta. Cada webhook define una URL de destino, eventos suscritos y metadatos para la firma de seguridad. - [Crear webhook](https://gotrebol.com/docs/api-reference/gestión-de-webhooks/crear-webhook.md): Crea un nuevo webhook para tu cuenta. Por seguridad, el secreto solo se muestra una vez en la creación. - [Obtener webhook](https://gotrebol.com/docs/api-reference/gestión-de-webhooks/obtener-webhook.md): Obtiene la configuración de un webhook específico. - [Actualizar webhook](https://gotrebol.com/docs/api-reference/gestión-de-webhooks/actualizar-webhook.md): Actualiza la URL, eventos, descripción o estado activo del webhook. - [Eliminar webhook](https://gotrebol.com/docs/api-reference/gestión-de-webhooks/eliminar-webhook.md): Elimina un webhook específico. - [Listar tipos de ítem personalizados](https://gotrebol.com/docs/api-reference/tipos-de-ítem-personalizados/listar-tipos-de-ítem-personalizados.md): Devuelve los tipos no eliminados de la cuenta (activos y archivados) con sus procesos. Ordenados por fecha de creación descendente. Tamaño de página fijo: 10. Las respuestas GET incluyen `user_input` y `json_schema` en cada proceso. - [Crear un tipo de ítem personalizado](https://gotrebol.com/docs/api-reference/tipos-de-ítem-personalizados/crear-un-tipo-de-ítem-personalizado.md): Crea un nuevo tipo de ítem personalizado. El `name` debe empezar con `cit_` y no puede contener espacios. - [Obtener un tipo de ítem personalizado](https://gotrebol.com/docs/api-reference/tipos-de-ítem-personalizados/obtener-un-tipo-de-ítem-personalizado.md): Devuelve un tipo con todos sus procesos. Misma estructura que un elemento individual del listado. Los tipos archivados se devuelven normalmente; solo los eliminados (DELETE) producen 404. - [Eliminar un tipo de ítem personalizado](https://gotrebol.com/docs/api-reference/tipos-de-ítem-personalizados/eliminar-un-tipo-de-ítem-personalizado.md): Elimina el tipo de forma permanente junto con todos sus procesos. Es irreversible. Para pausar un tipo sin borrarlo (y poder reactivarlo después), usa PATCH con `status: "archived"` en lugar de DELETE. - [Actualizar un tipo de ítem personalizado](https://gotrebol.com/docs/api-reference/tipos-de-ítem-personalizados/actualizar-un-tipo-de-ítem-personalizado.md): Actualiza campos del tipo. Debes enviar al menos un campo. Si todos los campos ya coinciden con los valores actuales, no se ejecuta ningún UPDATE y `updated_at` no cambia (idempotencia). - [Agregar un proceso a un tipo de ítem personalizado](https://gotrebol.com/docs/api-reference/tipos-de-ítem-personalizados/agregar-un-proceso-a-un-tipo-de-ítem-personalizado.md): Agrega un proceso de validación o extracción a un tipo existente. Hasta 5 procesos de extracción y 20 de validación por tipo. En procesos de extracción sin `json_schema`, `auto_improve` debe enviarse como `true`; enviarlo como `false` devuelve 400. Si se envía `json_schema`, `auto_improve` se establ… - [Obtener un proceso de un tipo de ítem personalizado](https://gotrebol.com/docs/api-reference/tipos-de-ítem-personalizados/obtener-un-proceso-de-un-tipo-de-ítem-personalizado.md): Devuelve un proceso con su versión activa, incluyendo `user_input` y `json_schema`. Para que el GET responda correctamente: el tipo padre debe existir (no eliminado ni archivado), el proceso debe existir (no eliminado), y la versión activa debe tener `user_input` no nulo. - [Eliminar un proceso de un tipo de ítem personalizado](https://gotrebol.com/docs/api-reference/tipos-de-ítem-personalizados/eliminar-un-proceso-de-un-tipo-de-ítem-personalizado.md): Elimina permanentemente un proceso de validación o extracción. El proceso de clasificación no se puede eliminar; intentarlo devuelve 409. Para modificar sus instrucciones, usa PATCH sobre el proceso. - [Actualizar un proceso de un tipo de ítem personalizado](https://gotrebol.com/docs/api-reference/tipos-de-ítem-personalizados/actualizar-un-proceso-de-un-tipo-de-ítem-personalizado.md): Actualiza un proceso. Debes enviar al menos un campo. `process_type` y `id` no se pueden cambiar. Cuando el PATCH modifica `user_input`, se crea una nueva versión del proceso que pasa a ser la activa. - [Obtener estatutos de las actas por la Etiqueta](https://gotrebol.com/docs/api-reference/leer-información-de-la-empresa-v1/obtener-estatutos-de-las-actas-por-la-etiqueta.md): Obtener información detallada de los estatutos e información fiscal sobre una empresa específica usando su etiqueta. - [Obtener documentos de la empresa](https://gotrebol.com/docs/api-reference/leer-información-de-la-empresa-v1/obtener-documentos-de-la-empresa.md): Obtener documentos que se han subido por el cliente o que encontrado en portales oficiales del gobierno. Se usa la etiqueta asignada para obtener la información. - [Obtener apoderados y representantes legales de la empresa de las actas por la Etiqueta](https://gotrebol.com/docs/api-reference/leer-información-de-la-empresa-v1/obtener-apoderados-y-representantes-legales-de-la-empresa-de-las-actas-por-la-etiqueta.md): Obtener la lista de apoderados y representantes legales analizados de la empresa. Se obtiene la lista de apoderados, sus roles, facultades, vigencias, limitaciones, y tipos de firma. - [Obtener accionistas de las actas de la empresa por la Etiqueta](https://gotrebol.com/docs/api-reference/leer-información-de-la-empresa-v1/obtener-accionistas-de-las-actas-de-la-empresa-por-la-etiqueta.md): Obtener la lista de accionistas asociados con una empresa específica y la documentación que se sube. - [Obtener la informacion de la prevalidacion de documentos asosciados a una empresa](https://gotrebol.com/docs/api-reference/leer-información-de-la-empresa-v1/obtener-la-informacion-de-la-prevalidacion-de-documentos-asosciados-a-una-empresa.md): Obtener la información de la preevaluación de documentos relacionados con una empresa específica. - [Obtener estatutos de las actas por el ID de Verificacion](https://gotrebol.com/docs/api-reference/leer-información-de-la-empresa-v1/obtener-estatutos-de-las-actas-por-el-id-de-verificacion.md): Obtener información detallada sobre los estatutos e información fiscal de la empresa usando el id de la verificación. - [Obtener documentos de la empresa por id de verificacion](https://gotrebol.com/docs/api-reference/leer-información-de-la-empresa-v1/obtener-documentos-de-la-empresa-por-id-de-verificacion.md): Obtener documentos relacionados con una verificación específica usando el id de la verificación. - [Obtener apoderados y representates legales de la empresa de las actas por el ID de Verificacion](https://gotrebol.com/docs/api-reference/leer-información-de-la-empresa-v1/obtener-apoderados-y-representates-legales-de-la-empresa-de-las-actas-por-el-id-de-verificacion.md): Obtener la lista de apoderados y representates legales de la empresa usando el id de la verificación. - [Obtener accionistas de la empresa de las actas por el ID de Verificacion](https://gotrebol.com/docs/api-reference/leer-información-de-la-empresa-v1/obtener-accionistas-de-la-empresa-de-las-actas-por-el-id-de-verificacion.md): Obtener la lista de accionistas asociados con una empresa usando el id de la verificación. - [Obtener datos de prevalidacion de documentos](https://gotrebol.com/docs/api-reference/leer-información-de-la-empresa-v1/obtener-datos-de-prevalidacion-de-documentos.md): Obtener fuentes para la pre-evaluación de documentos relacionados con una empresa usando el id de la verificación. - [Novedades](https://gotrebol.com/docs/actualizaciones/novedades.md): Conoce las nuevas funcionalidades y mejoras que Trébol desarrolla para ti. - [¿Qué empresas procesamos?](https://gotrebol.com/docs/faqs/empresas-procesadas.md): Te contamos sobre las empresas que Trébol puede procesar en México - [¿Cómo creo una verificación?](https://gotrebol.com/docs/faqs/crear-verificacion.md): Aprende a crear tu primera verificación para dictaminar una empresa en pocos minutos con Trébol. - [¿Qué hago luego de crear una verificación?](https://gotrebol.com/docs/faqs/luego-crear-verificacion.md): Te contamos qué pasa luego de que creas una verificación en Trébol. - [Cargar más archivos a una verificación](https://gotrebol.com/docs/faqs/subir-otros-docs.md): Aquí te explicamos qué debes hacer si quieres subir un archivo adicional a una verificación ya creada en Trébol. - [¿Cómo creo nuevos usuarios?](https://gotrebol.com/docs/faqs/crear-usuarios.md): Aprende cómo crear usuarios en Trébol de forma segura y eficiente. Sigue estos pasos para invitar a nuevos usuarios y gestionar roles adecuadamente. - [Alertas en documentos de Empresas](https://gotrebol.com/docs/faqs/alertas-en-docs.md): Descubre cómo Trébol valida actas, poderes, documentos fiscales, mercantiles, bancarios y de identidad para asegurar información precisa y actualizada en cada verificación. - [Pre-cargar una plantilla de dictamen](https://gotrebol.com/docs/faqs/subir-plantillas.md): Cómo subir plantillas a la aplicación de Trébol - [¿Puedo llenar formatos de dictamen?](https://gotrebol.com/docs/faqs/descargar-plantilla.md): Te contamos cómo puedes llenar automáticamente contratos y formatos de dictamen con la información extraída por Trébol. - [¿Cómo corrijo un dato de una verificación?](https://gotrebol.com/docs/faqs/editar-info.md): Aquí te mostramos cómo puedes editar un dato que Trébol ya extrajo de una verificación finalizada. - [Quiero descargar documentos de empresas](https://gotrebol.com/docs/faqs/descargar-docs.md): Aquí te explicamos cómo puedes descargar los documentos que subiste a la app, así como certificados y archivos obtenidos por Trébol. - [CRUSH](https://gotrebol.com/docs/CRUSH.md) - [Introducción](https://gotrebol.com/docs/introduction.md): Bienvenido a la documentación de Trébol - [Corrections](https://gotrebol.com/docs/skills/dictamen-template-pipeline/corrections.md): Correcciones conocidas al pipeline de configuración de plantillas de dictamen. Registra errores que el pipeline cometió al mapear o escribir variables de Trébol en plantillas pasadas, y los mapeos/escrituras correctos que deben usarse. Este skill tiene MÁXIMA PRIORIDAD sobre cualquier otro grounding… - [Dictionary example](https://gotrebol.com/docs/skills/dictamen-template-pipeline/grounding/dictionary-example.md) - [Example actinver mapping](https://gotrebol.com/docs/skills/dictamen-template-pipeline/grounding/example-actinver-mapping.md) - [Example template reference](https://gotrebol.com/docs/skills/dictamen-template-pipeline/grounding/example-template-reference.md) - [Sintaxis plantillas](https://gotrebol.com/docs/skills/dictamen-template-pipeline/grounding/sintaxis-plantillas.md) - [Variable catalog](https://gotrebol.com/docs/skills/dictamen-template-pipeline/grounding/variable-catalog.md) - [Helper pdf form configurator](https://gotrebol.com/docs/skills/dictamen-template-pipeline/helpers/helper-pdf-form-configurator.md): Helper del pipeline de configuración de plantillas de dictamen para configurar plantillas en PDF editable (PDF con campos de formulario / AcroForm) de clientes de Trébol. La regla central del PDF es que cada variable de Trébol se configura como el NOMBRE de un campo de formulario (ej. un campo de te… - [Persona trebol template engineer](https://gotrebol.com/docs/skills/dictamen-template-pipeline/personas/persona-trebol-template-engineer.md): Actúa como el ingeniero experto en variables de plantillas de Trébol — la persona que conoce al dedillo el diccionario de variables, la sintaxis del motor de plantillas (bucles, inversos, x_mark, fuentes), la numeración (apoderados 1-based vs accionistas/órganos 0-based), las diferencias entre Word… - [SKILL](https://gotrebol.com/docs/skills/dictamen-template-pipeline/SKILL.md): Orquesta el pipeline completo para CONFIGURAR plantillas de dictamen de clientes de Trébol — es decir, tomar la plantilla en blanco que envía un cliente (Word .docx o PDF editable) y devolverla idéntica en formato pero con las variables/IDs de Trébol (ej. {legal_businessName}, {#shareholders}...{/})… - [Stage 1 parse template](https://gotrebol.com/docs/skills/dictamen-template-pipeline/stages/stage-1-parse-template.md): Primera etapa del pipeline de configuración de plantillas de dictamen. Lee la plantilla en blanco del cliente (Word .docx o PDF editable) y, si existe, el ejemplo ya diligenciado, y los normaliza a una estructura interna uniforme de "campos del cliente" (etiqueta literal, ubicación, si es campo únic… - [Stage 2 map variables](https://gotrebol.com/docs/skills/dictamen-template-pipeline/stages/stage-2-map-variables.md): Segunda etapa del pipeline de configuración de plantillas de dictamen. Toma los campos del cliente extraídos por Stage 1 y produce un MAPEO CANDIDATO campo→variable de Trébol, fundado en el diccionario de variables (grounding), la plantilla de referencia, y el ejemplo diligenciado si existe. Cada ca… - [Stage 3 panel discussion](https://gotrebol.com/docs/skills/dictamen-template-pipeline/stages/stage-3-panel-discussion.md): Tercera etapa del pipeline de configuración de plantillas de dictamen. Convoca a los 3 actores de Trébol (CPO, ingeniero experto en variables de plantillas, y persona legal de dictámenes) para revisar el mapeo candidato de Stage 2 y discutir qué va en cada campo, resolviendo desacuerdos y produciend… - [Stage 4 user qa](https://gotrebol.com/docs/skills/dictamen-template-pipeline/stages/stage-4-user-qa.md): Cuarta etapa del pipeline de configuración de plantillas de dictamen. Produce un markdown breve y escaneable con solo los campos que el panel (Stage 3) no pudo resolver (campos sin variable clara, ambigüedades, decisiones de negocio). Es el único punto de pausa humana del pipeline — se detiene aquí… - [Stage 5 configure deliverable](https://gotrebol.com/docs/skills/dictamen-template-pipeline/stages/stage-5-configure-deliverable.md): Quinta etapa del pipeline de configuración de plantillas de dictamen. Toma el mapeo consolidado (Stage 3) más las respuestas del usuario (Stage 4) e inserta los tokens de Trébol en el archivo del cliente, preservando exactamente su formato. Según el tipo de archivo invoca al helper de Word (helper-d… - [Stage 6 rationale packaging](https://gotrebol.com/docs/skills/dictamen-template-pipeline/stages/stage-6-rationale-packaging.md): Sexta y última etapa del pipeline de configuración de plantillas de dictamen. Toma el archivo configurado por Stage 5 y lo empaqueta para entrega, adjuntando un mapa de variables auditable (campo del cliente → variable de Trébol), un racional corto (3-6 bullets) de las decisiones clave, y la lista d… - [Auth](https://gotrebol.com/docs/skills/trebol/auth.md) - [Corrections](https://gotrebol.com/docs/skills/trebol/dictamen-template-pipeline/corrections.md): Correcciones conocidas al pipeline de configuración de plantillas de dictamen. Registra errores que el pipeline cometió al mapear o escribir variables de Trébol en plantillas pasadas, y los mapeos/escrituras correctos que deben usarse. Este skill tiene MÁXIMA PRIORIDAD sobre cualquier otro grounding… - [Dictionary example](https://gotrebol.com/docs/skills/trebol/dictamen-template-pipeline/grounding/dictionary-example.md) - [Example client mapping](https://gotrebol.com/docs/skills/trebol/dictamen-template-pipeline/grounding/example-client-mapping.md) - [Example template reference](https://gotrebol.com/docs/skills/trebol/dictamen-template-pipeline/grounding/example-template-reference.md) - [Sintaxis plantillas](https://gotrebol.com/docs/skills/trebol/dictamen-template-pipeline/grounding/sintaxis-plantillas.md) - [Variable catalog](https://gotrebol.com/docs/skills/trebol/dictamen-template-pipeline/grounding/variable-catalog.md) - [Helper pdf form configurator](https://gotrebol.com/docs/skills/trebol/dictamen-template-pipeline/helpers/helper-pdf-form-configurator.md): Helper del pipeline de configuración de plantillas de dictamen para configurar plantillas en PDF editable (PDF con campos de formulario / AcroForm) de clientes de Trébol. La convención confirmada en producción (Convención A) es que el token {variable} va como VALOR del campo de formulario y el nombr… - [Persona trebol template engineer](https://gotrebol.com/docs/skills/trebol/dictamen-template-pipeline/personas/persona-trebol-template-engineer.md): Actúa como el ingeniero experto en variables de plantillas de Trébol — la persona que conoce al dedillo el diccionario de variables, la sintaxis del motor de plantillas (bucles, inversos, x_mark, fuentes), la numeración (apoderados 1-based vs accionistas/órganos 0-based), las diferencias entre Word… - [SKILL](https://gotrebol.com/docs/skills/trebol/dictamen-template-pipeline/SKILL.md): Orquesta el pipeline completo para CONFIGURAR plantillas de dictamen de clientes de Trébol — es decir, tomar la plantilla en blanco que envía un cliente (Word .docx o PDF editable) y devolverla idéntica en formato pero con las variables/IDs de Trébol (ej. {legal_businessName}, {#shareholders}...{/})… - [Stage 1 parse template](https://gotrebol.com/docs/skills/trebol/dictamen-template-pipeline/stages/stage-1-parse-template.md): Primera etapa del pipeline de configuración de plantillas de dictamen. Lee la plantilla en blanco del cliente (Word .docx o PDF editable) y, si existe, el ejemplo ya diligenciado, y los normaliza a una estructura interna uniforme de "campos del cliente" (etiqueta literal, ubicación, si es campo únic… - [Stage 2 map variables](https://gotrebol.com/docs/skills/trebol/dictamen-template-pipeline/stages/stage-2-map-variables.md): Segunda etapa del pipeline de configuración de plantillas de dictamen. Toma los campos del cliente extraídos por Stage 1 y produce un MAPEO CANDIDATO campo→variable de Trébol, fundado en el diccionario de variables (grounding), la plantilla de referencia, y el ejemplo diligenciado si existe. Cada ca… - [Stage 3 panel discussion](https://gotrebol.com/docs/skills/trebol/dictamen-template-pipeline/stages/stage-3-panel-discussion.md): Tercera etapa del pipeline de configuración de plantillas de dictamen. Convoca a los 3 actores de Trébol (CPO, ingeniero experto en variables de plantillas, y persona legal de dictámenes) para revisar el mapeo candidato de Stage 2 y discutir qué va en cada campo, resolviendo desacuerdos y produciend… - [Stage 4 user qa](https://gotrebol.com/docs/skills/trebol/dictamen-template-pipeline/stages/stage-4-user-qa.md): Cuarta etapa del pipeline de configuración de plantillas de dictamen. Produce un markdown breve y escaneable con solo los campos que el panel (Stage 3) no pudo resolver (campos sin variable clara, ambigüedades, decisiones de negocio). Es el único punto de pausa humana del pipeline — se detiene aquí… - [Stage 5 configure deliverable](https://gotrebol.com/docs/skills/trebol/dictamen-template-pipeline/stages/stage-5-configure-deliverable.md): Quinta etapa del pipeline de configuración de plantillas de dictamen. Toma el mapeo consolidado (Stage 3) más las respuestas del usuario (Stage 4) e inserta los tokens de Trébol en el archivo del cliente, preservando exactamente su formato. Según el tipo de archivo invoca al helper de Word (helper-d… - [Stage 6 rationale packaging](https://gotrebol.com/docs/skills/trebol/dictamen-template-pipeline/stages/stage-6-rationale-packaging.md): Sexta y última etapa del pipeline de configuración de plantillas de dictamen. Toma el archivo configurado por Stage 5 y lo empaqueta para entrega, adjuntando un mapa de variables auditable (campo del cliente → variable de Trébol), un racional corto (3-6 bullets) de las decisiones clave, y la lista d… - [Hipotecas](https://gotrebol.com/docs/skills/trebol/flows/hipotecas.md) - [Kyb colombia](https://gotrebol.com/docs/skills/trebol/flows/kyb-colombia.md) - [Kyb eeuu](https://gotrebol.com/docs/skills/trebol/flows/kyb-eeuu.md) - [Kyb mexico](https://gotrebol.com/docs/skills/trebol/flows/kyb-mexico.md) - [Nomina](https://gotrebol.com/docs/skills/trebol/flows/nomina.md) - [Webhooks](https://gotrebol.com/docs/skills/trebol/flows/webhooks.md) - [Widget](https://gotrebol.com/docs/skills/trebol/flows/widget.md) - [Endpoints](https://gotrebol.com/docs/skills/trebol/reference/endpoints.md) - [Errors](https://gotrebol.com/docs/skills/trebol/reference/errors.md) - [SKILL](https://gotrebol.com/docs/skills/trebol/SKILL.md): Integración con la API de Trébol para automatizar procesos de back office (KYB y más). Cubre endpoints, autenticación, items, account-flows, widget, webhooks y errores. - [STYLE GUIDE](https://gotrebol.com/docs/STYLE_GUIDE.md) ## OpenAPI Specs - [openapi](/docs/api-reference/openapi.yaml) - [MX - Alta de empresas.postman_collection](/docs/MX - Alta de empresas.postman_collection.json) - [openapi](/docs/skills/trebol/reference/openapi.yaml)