> ## Documentation Index
> Fetch the complete documentation index at: https://gotrebol.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Exportar datos de verificación a documento personalizado

> Exporta los datos de una verificación a un documento personalizado (PDF o Word) reemplazando los IDs con la información extraída.

El endpoint recibe un documento que contiene IDs (marcadores de posición) que se encuentran documentados en la [sección de plantillas](/docs/plantillas/intro).
Estos IDs serán reemplazados automáticamente con la información extraída de cada item de la verificación.

**Funcionalidad:**
- Genera un diccionario de variables únicas a partir de la información extraída
- Reemplaza los IDs en el documento con la información correspondiente
- Retorna el documento procesado con los datos actualizados

**Tipos de documentos soportados:** PDF, Word (.docx)




## OpenAPI

````yaml /api-reference/openapi.yaml get /v2/verifications/{verification-id}/export/{doc-template-id}
openapi: 3.0.0
info:
  title: Coleccion de API KYB MX
  description: >
    La Colección de API KYB MX proporciona puntos finales para crear y gestionar
    verificaciones de empresas en México. La verificación de empresas implica
    validar la información proporcionada por un cliente comercial, incluyendo
    documentos y fuentes de datos, para asegurar su legitimidad y precisión.


    Cada verificación de empresa puede incluir múltiples ítems, como Actas
    Constitutivas, Constancias de Situación Fiscal, Identificaciones Personales
    y Comprobantes de Domicilio. Trebol maneja automáticamente la clasificación
    de documentos, lo que te permite enviar todos los documentos requeridos como
    URLs descargables (por ejemplo, URLs prefirmadas de AWS o GCP).


    **Autenticación**: 

    La API utiliza una clave API para la autenticación, pasada en el encabezado
    `x-api-key`. Para obtener una clave API, por favor
    [contáctanos](mailto:sales@gotrebol.com).
  version: 1.0.0
servers:
  - url: https://api.gotrebol.com
  - url: http://{{trebol_api_base_url}}
security: []
tags:
  - name: Creacion de Verificacion
    description: Endpoints para crear nuevas verificaciones.
  - name: Leer información de la empresa
    description: >-
      Endpoints v2 para obtener información detallada de empresas y
      verificaciones.
  - name: Leer por Etiqueta
    description: >-
      Endpoints para obtener información detallada sobre empresas mediante
      etiquetas.
  - name: Leer por ID de Verificacion
    description: >-
      Endpoints para obtener información detallada sobre verificaciones mediante
      ID.
  - name: Gestión de IPs Permitidas
    description: >-
      Endpoints para gestionar la lista de IPs permitidas (whitelist) para la
      cuenta del cliente.
  - name: Gestión de API Keys
    description: Endpoints para crear, listar y eliminar API keys de la cuenta del usuario.
  - name: Gestion de item Ids
    description: Endpoints para gestionar items de verificaciones.
  - name: Invalidar un documento
    description: Endpoints para invalidar documentos de verificaciones.
  - name: Labels de Verificacion
    description: Endpoints para gestionar labels de verificaciones.
  - name: Actualizar personas clave de una verificacion
    description: Endpoints para actualizar personas clave de verificaciones.
  - name: Agregar items a una verificacion
    description: Endpoints para agregar items a verificaciones existentes.
  - name: Estado de validacion de documentos
    description: Endpoints para obtener el estado de validación de documentos.
  - name: Gestión de Flujos de Cuenta
    description: Endpoints para gestionar flujos de cuenta.
  - name: Gestión de Webhooks
    description: Endpoints para crear, listar, actualizar y eliminar webhooks de la cuenta.
  - name: Gestión de Política de Retención
    description: Endpoints para gestionar la política de retención de datos de la cuenta.
  - name: Exportación de Verificaciones
    description: >-
      Endpoints para exportar datos de verificaciones a documentos
      personalizados.
  - name: Leer información de la empresa v1
    description: >-
      Endpoints v1 (legacy) para obtener información detallada de empresas y
      verificaciones. Te recomendamos migrar a los endpoints v2.
  - name: Tipos de Ítem Personalizados
    description: >-
      Endpoints para crear y gestionar tipos de ítem personalizados con procesos
      configurables de clasificación, validación y extracción.
paths:
  /v2/verifications/{verification-id}/export/{doc-template-id}:
    get:
      tags:
        - Exportación de Verificaciones
      summary: Exportar datos de verificación a documento personalizado
      description: >
        Exporta los datos de una verificación a un documento personalizado (PDF
        o Word) reemplazando los IDs con la información extraída.


        El endpoint recibe un documento que contiene IDs (marcadores de
        posición) que se encuentran documentados en la [sección de
        plantillas](/docs/plantillas/intro).

        Estos IDs serán reemplazados automáticamente con la información extraída
        de cada item de la verificación.


        **Funcionalidad:**

        - Genera un diccionario de variables únicas a partir de la información
        extraída

        - Reemplaza los IDs en el documento con la información correspondiente

        - Retorna el documento procesado con los datos actualizados


        **Tipos de documentos soportados:** PDF, Word (.docx)
      parameters:
        - $ref: '#/components/parameters/verificationIdParam'
        - in: path
          name: doc-template-id
          required: true
          description: >-
            El ID de la plantilla de documento. Ver [plantillas de
            documentos](/plantillas/gestion).
          schema:
            type: string
      responses:
        '200':
          description: JSON con la url de descarga del archivo y otros datos adicionales.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Booleano que indica si la exportación fue exitosa.
                    example: true
                  message:
                    type: string
                    description: Mensaje de éxito.
                    example: File generated successfully. Download URL provided.
                  download_url:
                    type: string
                    description: >-
                      URL de descarga del archivo. Al acceder a ella se
                      descargará el archivo automáticamente.
                    example: https://www.gotrebol.com/download/file.pdf
                  expires_in:
                    type: number
                    description: Tiempo de expiración del enlace en milisegundos(1 hora).
                    example: 3600000
                  size:
                    type: number
                    description: Tamaño del archivo en bytes.
                    example: 1000000
              examples:
                success:
                  summary: Exportación exitosa
                  value:
                    success: true
                    message: File generated successfully. Download URL provided.
                    download_rl: https://www.gotrebol.com/download/file.pdf
                    expiresIn: 3600000
                    size: 1000000
        '400':
          $ref: '#/components/responses/BadRequestError'
        '404':
          $ref: '#/components/responses/NotFoundError'
        '422':
          description: Verificación sin items o datos insuficientes.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: verification with no items
        '500':
          $ref: '#/components/responses/InternalServerError'
      security:
        - ApiKeyAuth: []
components:
  parameters:
    verificationIdParam:
      name: verification-id
      in: path
      required: true
      description: El ID único de la verificación
      schema:
        type: string
  responses:
    BadRequestError:
      description: Datos de entrada inválidos
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            ValidationError:
              summary: Error de validación
              value:
                success: false
                message: 'Validation failed: ''items'' is required'
                code: VALIDATION_ERROR
                timestamp: '2025-01-01T12:34:56.000Z'
            ItemsNotProvided:
              summary: items_not_provided
              value:
                success: false
                message: >-
                  Please provide a valid items array or a flow id in your
                  request
                code: items_not_provided
                timestamp: '2025-01-01T12:34:56.000Z'
            InvalidItemType:
              summary: invalid_item_type
              value:
                success: false
                message: The generic item type is not supported
                code: invalid_item_type
                timestamp: '2025-01-01T12:34:56.000Z'
            InvalidItemOptionsFileUrl:
              summary: invalid_item_options_file_url
              value:
                success: false
                message: >-
                  The specified file_url is invalid. Ensure it is public and
                  downloadable.
                code: invalid_item_options_file_url
                timestamp: '2025-01-01T12:34:56.000Z'
    NotFoundError:
      description: Recurso no encontrado
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            NotFound:
              summary: Recurso inexistente
              value:
                success: false
                message: Entity not found
                code: NOT_FOUND
                timestamp: '2025-01-01T12:34:56.000Z'
    InternalServerError:
      description: Error interno del servidor
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            ServerError:
              summary: Error inesperado
              value:
                success: false
                message: Internal server error
                code: INTERNAL_SERVER_ERROR
                timestamp: '2025-01-01T12:34:56.000Z'
  schemas:
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
          example: false
        message:
          type: string
          example: Descripción breve y accionable del error
        code:
          oneOf:
            - type: string
              enum:
                - VALIDATION_ERROR
                - BAD_REQUEST
                - UNAUTHORIZED
                - FORBIDDEN
                - NOT_FOUND
                - CONFLICT
                - DUPLICATE_RESOURCE
                - INTERNAL_SERVER_ERROR
            - type: string
              description: Código de dominio específico (p.ej., items_not_provided)
          example: VALIDATION_ERROR
        timestamp:
          type: string
          format: date-time
          example: '2025-01-01T12:34:56.000Z'
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````