---
title: "Generar PDF del DTE"
description: "Aprende a generar la representación visual en PDF de tus documentos tributarios"
type: "academy"
category: "lesson"
tags: []
authors: [Anonymous]
date: "2026-08-27"
last_update: "2026-08-21"
time_minutes: 3
draft: false
unlisted: false
url: "https://www.stage.apigateway.cl/academy/integracion-para-la-emision-de-dte/emision-de-documentos/generar-pdf"
---

# Generar PDF del DTE (Opcional)

Aunque el XML es el documento con validez legal, el PDF es fundamental para la experiencia del receptor. Es lo que el cliente ve, imprime y archiva. API Gateway ofrece múltiples opciones de personalización para que el PDF refleje tu imagen corporativa y cumpla con los requisitos legales.

---

## Endpoint del Servicio

### URL

```http
[POST] https://legacy.apigateway.cl/api/v1/libredte/dte/documentos/pdf
```

### Características

- El XML debe enviarse codificado en Base64
- Acepta XMLs individuales o múltiples
- Respuesta en formato PDF binario
- Sin parámetros en la URL

---

## Estructura Básica del Request

### Request Mínimo

```json
{
    "formato": "general",
    "xml": "PD94bWwgdmVyc2lvbj0iMS4w..."
}
```

### Request con Opciones

```json
{
    "formato": "general",
    "cedible": true,
    "copias_tributarias": 1,
    "copias_cedibles": 1,
    "webVerificacion": false,
    "xml": "PD94bWwgdmVyc2lvbj0iMS4w..."
}
```

---

## Formatos Disponibles

### Tipos de Formato

| Formato | Descripción | Ideal para | Características |
|---------|-------------|------------|-----------------|
| `estandar` | Formato LibreDTE | Uso general | Diseño limpio y funcional |
| `general` | Formato Empresarial | Empresas | Más opciones de personalización |
| `servicios_basicos` | Servicios básicos | Servicios | Incluye gráficos de consumo |

---

## Opciones de Configuración

### Parámetros Principales

| Parámetro | Tipo | Default | Descripción |
|-----------|------|---------|-------------|
| `formato` | string | `estandar` | Tipo de formato a usar |
| `cedible` | boolean | `false` | Incluir copia cedible |
| `copias_tributarias` | integer | `1` | Número de copias tributarias |
| `copias_cedibles` | integer | `0` | Número de copias cedibles |
| `webVerificacion` | boolean | `true` | Incluir URL de verificación |
| `compress` | boolean | `false` | Para múltiples DTEs en ZIP |

---

## Personalización Avanzada

### Estructura del Objeto `extra`

```json
{
    "extra": {
        "emisor": {
            "razonsocial": true,
            "giro": true,
            "direccion": true,
            "telefono": false,
            "web": false,
            "email": false
        },
        "detalle": {
            "posicion": 0,
            "fuente": 9,
            "ancho": {
                "CdgItem": 30,
                "QtyItem": 15,
                "PrcItem": 22,
                "DescuentoMonto": 22,
                "RecargoMonto": 22,
                "MontoItem": 22
            }
        }
    }
}
```

### Opciones del Emisor

| Campo | Tipo | Descripción |
|-------|------|-------------|
| `razonsocial` | boolean | Mostrar razón social |
| `giro` | boolean | Mostrar giro comercial |
| `direccion` | boolean | Mostrar dirección |
| `telefono` | boolean | Incluir teléfono |
| `web` | boolean | Incluir sitio web |
| `email` | boolean | Incluir email |

---

## Imágenes y Logos

### Configuración de Imágenes

```json
{
    "extra": {
        "img": {
            "logo": "base64_del_logo",
            "cotizacion": "base64_imagen_cotizacion",
            "historial": "base64_grafico_historial",
            "pie": "base64_imagen_pie"
        }
    }
}
```
---

## Códigos de Barra

### Opciones Disponibles

```json
{
    "extra": {
        "codigo_barras": {
            "cotizacion": true,
            "dte": true,
            "incluirrut": false
        }
    }
}
```

| Opción | Descripción | Contenido |
|--------|-------------|-----------|
| `cotizacion` | Código para cotización | Número de cotización |
| `dte` | Código del documento | TED (Timbre Electrónico) |
| `incluirrut` | RUT en código | Agrega RUT receptor |

---

## Personalización de Colores

### Configuración

```json
{
    "extra": {
        "color": {
            "razonsocial": [14, 66, 170]
        }
    }
}
```

### Formato RGB

- Valores: Array de 3 números [R, G, B]
- Rango: 0-255 para cada componente
- Ejemplo: [14, 66, 170] = Azul corporativo

---

## Gráficos de Historial

### Para Servicios Básicos

```json
{
    "extra": {
        "historial": {
            "titulo": "Consumo de Agua Potable",
            "datos": {
                "Febrero": 12,
                "Marzo": 11,
                "Abril": 12,
                "Mayo": 10.5,
                "Junio": 4,
                "Julio": 5
            }
        }
    }
}
```

### Características del Gráfico

- Tipo: Barras verticales
- Máximo: 12 meses
- Unidades: Numéricas
- Colores: Automáticos

---

## Papel Continuo

### Configuración

Para puntos de venta con impresoras térmicas:

```json
{
    "formato": "estandar",
    "papelContinuo": 80
}
```

### Anchos Disponibles

| Ancho | Uso Típico | Impresora |
|-------|------------|-----------|
| `57` | Tickets pequeños | Móviles |
| `75` | Estándar | POS común |
| `80` | Más común | Mayoría POS |
| `110` | Documentos amplios | Especiales |

---

## Múltiples DTEs

### Generar ZIP con Varios PDFs

```json
{
    "compress": true,
    "xml": "XML_con_multiples_DTEs_base64"
}
```

### Consideraciones

- Retorna archivo ZIP
- Un PDF por cada DTE
- Nombres: `tipo_folio.pdf`


---
Last updated on 21/08/2026