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

# Preview de documento programado

> Genera un preview en PDF del próximo documento que se emitirá para un documento programado ya guardado.

## Qué hace

* Genera un preview en PDF del próximo documento que se emitirá
* Muestra cómo se verá el documento en su próxima emisión automática
* Proporciona el PDF en formato base64 para facilitar su visualización
* No emite realmente el documento, solo genera una vista previa
* Útil para verificar la configuración antes de la ejecución automática

## Ejemplos de uso

* Visualizar cómo se verá un documento antes de su próxima emisión
* Verificar que la configuración del documento programado es correcta
* Revisar montos, productos y detalles antes de la ejecución automática
* Compartir un preview con el cliente antes de activar la programación
* Validar que todos los datos están correctos antes de la emisión

### Notas

* El PDF generado es un borrador que muestra cómo se verá el documento en su próxima emisión
* El documento no se emite realmente, solo se genera una vista previa
* El PDF está codificado en base64 para facilitar su uso en aplicaciones web

## Endpoints relacionados

* [Obtener Documento Programado](/api-reference/scheduled-documents/get) - Ver detalles del documento programado
* [Actualizar Documento Programado](/api-reference/scheduled-documents/update) - Modificar el documento antes de la emisión
* [Listar Documentos Programados](/api-reference/scheduled-documents/list) - Ver todos los documentos programados
* [Crear Documento Programado](/api-reference/scheduled-documents/create) - Crear un nuevo documento programado
* [Listar Documentos](/api-reference/documents/list) - Consultar documentos ya emitidos


## OpenAPI

````yaml GET /scheduled-documents/{id}/preview
openapi: 3.0.0
info:
  title: Tupana API
  description: API para integración con el sistema Tupana - Facturación Electrónica
  version: 1.0.0
servers:
  - url: https://api.tupana.ai/v1
    description: Servidor de producción
security:
  - apiKeyAuth: []
paths:
  /scheduled-documents/{id}/preview:
    get:
      tags:
        - Documentos Programados
      summary: Preview de documento programado guardado
      description: >-
        Genera un preview en PDF del próximo documento que se emitirá para un
        documento programado ya guardado.
      parameters:
        - name: id
          in: path
          description: ID del documento programado
          required: true
          schema:
            type: integer
            example: 789
        - name: master_entity_id
          in: query
          description: ID de la entidad maestra
          required: true
          schema:
            type: integer
            example: 123
      responses:
        '200':
          description: Preview generado exitosamente
          content:
            application/json:
              schema:
                type: object
                properties:
                  pdf_base64:
                    type: string
                    description: PDF del documento en formato base64
                    example: JVBERi0xLjQKMSAwIG9iago8PC9UeXBlIC9DYXRhbG9n...
        '401':
          description: No autorizado - API Key inválida
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Prohibido - Sin acceso a la entidad
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Documento programado no encontrado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Error generando el preview
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - apiKeyAuth: []
components:
  schemas:
    Error:
      required:
        - error
        - message
      type: object
      properties:
        error:
          type: string
          description: Código de error
          example: VALIDATION_ERROR
          enum:
            - VALIDATION_ERROR
            - AUTHENTICATION_ERROR
            - AUTHORIZATION_ERROR
            - NOT_FOUND
            - SII_ERROR
            - INTERNAL_ERROR
        message:
          type: string
          description: Mensaje de error
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        API Key para autenticación. Debe proporcionarse en el header
        Authorization con el formato: 'Api-Key YOUR-API-KEY' (incluye el prefijo
        'Api-Key ' seguido de tu API key)

````