Integración para la emisión de DTE

Sigue los pasos para emitir documentos tributarios desde tu software usando API Gayeway.

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

[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

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

Request con Opciones

{
    "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

{
    "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

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

Códigos de Barra

Opciones Disponibles

{
    "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

{
    "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

{
    "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:

{
    "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

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

Consideraciones

  • Retorna archivo ZIP
  • Un PDF por cada DTE
  • Nombres: tipo_folio.pdf
On this page

Last updated on 28/08/2025 by Anonymous