Formatos de PDF

Todo DTE emitido con Folyo se puede descargar como PDF. Existen dos representaciones impresas:

El formato carta es el de siempre: usa la plantilla activa de tu empresa y es el que se entrega por defecto. Si tu integración ya descarga PDFs, no tienes que cambiar nada.

En boletas el ticket sale en bobina de 80 o 58 mm y el timbre impreso se puede omitir. En facturas y notas la normativa vigente del SII es más estricta: solo bobina de 80 mm y el timbre siempre va impreso.

Cómo pedir cada formato

Ambas representaciones salen del mismo endpoint, GET /v1/dte/pdf/:tipo/:folio. El formato se elige por query params:

Sin parámetros obtienes la carta, con el comportamiento de siempre:

# Formato carta (default)
curl "https://api.folyo.cl/v1/dte/pdf/39/12345" \
  -H "X-API-Key: $API_KEY" \
  -o boleta_12345.pdf

# Formato ticket para bobina de 80 mm
curl "https://api.folyo.cl/v1/dte/pdf/39/12345?formato=ticket&ancho=80" \
  -H "X-API-Key: $API_KEY" \
  -o boleta_12345_ticket.pdf

La respuesta es el binario del documento con Content-Type: application/pdf, en ambos formatos. El archivo se descarga con el sufijo de la variante en el nombre (por ejemplo DTE_Boleta_Electronica_F123-ticket80.pdf, o -ticket58-sin-timbre), así que la carta y los tickets de un mismo documento no se pisan al guardarlos.

Errores

Qué contiene el ticket

El ticket cumple los requisitos del SII para la representación impresa de la boleta electrónica: identificación del emisor, nombre del documento con su folio, fecha de emisión y, en la boleta afecta (39), el desglose de monto neto e IVA. El timbre electrónico se imprime con sus dos leyendas, salvo que lo omitas con timbre=0. El alto del papel se ajusta al contenido: el PDF sale en una sola página continua, como el corte de una impresora térmica. El detalle de líneas y los datos del receptor aparecen cuando el documento los trae.

En facturas y notas el ticket suma lo que la normativa vigente del SII exige para esos documentos: los datos completos del receptor, las referencias a otros documentos cuando el DTE las trae y el timbre siempre impreso. En las facturas a crédito incluye además la sección de acuse de recibo y la mención CEDIBLE; en las ventas al contado se omite.

Cuándo usar cada formato

• Venta presencial con impresora térmica: ticket. La normativa vigente del SII exige entregar la boleta impresa en las ventas presenciales, y el mismo formato sirve para facturas y notas emitidas en el punto de venta.
• Envío por correo o respaldo: carta, disponible para todos los tipos de DTE.

En la plataforma web no necesitas armar la URL: el menú de descarga de las boletas ofrece las tres variantes (PDF carta, ticket de 80 mm y ticket de 58 mm) y el de las facturas y notas ofrece dos (PDF carta y ticket de 80 mm).

Regenerar una variante

POST /v1/dte/pdf/:tipo/:folio/regenerate acepta los mismos parámetros (formato, ancho, timbre) para volver a generar una variante puntual de un documento ya emitido, sobrescribiendo la copia guardada.

Regenerar una variante solo invalida esa. Si un cambio afecta a todas (por ejemplo, contratar marca blanca) usa formato=todas: regenera de una vez la carta y las variantes ticket que el documento ya tenía guardadas, sin generar las que nunca se pidieron. Es todo o nada: si alguna falla no se sobrescribe ninguna, y 503 indica que conviene reintentar. formato=todas solo existe al regenerar y no admite ancho ni timbre. La respuesta lista las variantes regeneradas:

{
  "ok": true,
  "data": {
    "regenerated": true,
    "formato": "todas",
    "tipo_dte": 39,
    "folio": 12345,
    "variantes": [
      { "formato": "carta", "size_bytes": 48213 },
      { "formato": "ticket", "ancho": 80, "timbre": true, "size_bytes": 30103 }
    ]
  }
}