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
extra
Estructura del Objeto {
"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