> ## 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.

# Eliminar documento programado

> Elimina un documento programado existente.

## Qué hace

* Elimina un documento programado existente de forma permanente
* Remueve el documento programado del sistema
* No afecta los documentos ya emitidos que fueron generados por este documento programado
* Esta acción no se puede deshacer
* Requiere que el documento programado pertenezca a tu entidad

## Ejemplos de uso

* Eliminar un documento programado que ya no se necesita
* Remover documentos programados obsoletos o con errores de configuración
* Limpiar documentos programados que han completado todas sus ejecuciones
* Eliminar documentos programados de prueba o desarrollo
* Remover documentos programados que se crearon por error

### Notas importantes

* ⚠️ **Esta acción es permanente**: Una vez eliminado, el documento programado no podrá ser recuperado
* Solo puedes eliminar documentos programados que pertenezcan a tu entidad
* La eliminación no afecta los documentos ya emitidos que fueron generados por este documento programado

## Endpoints relacionados

* [Listar Documentos Programados](/api-reference/scheduled-documents/list) - Ver todos los documentos programados
* [Obtener Documento Programado](/api-reference/scheduled-documents/get) - Ver detalles antes de eliminar
* [Crear Documento Programado](/api-reference/scheduled-documents/create) - Crear un nuevo documento programado
* [Listar Documentos](/api-reference/documents/list) - Consultar documentos ya emitidos por este documento programado


## OpenAPI

````yaml DELETE /scheduled-documents/{id}
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}:
    delete:
      tags:
        - Documentos Programados
      summary: Eliminar documento programado
      description: Elimina un documento programado existente.
      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:
        '204':
          description: Documento programado eliminado exitosamente
        '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'
      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)

````