Boleta electrónica

Boleta electrónica en Chile: emite desde el panel o desde tu sistema

Folyo emite boletas afectas (39) y exentas (41), las firma y las envía al SII por el canal dedicado de boletas. Operas desde el panel web o integras la emisión por API, con la misma cuenta y los mismos folios.

Crear cuenta gratisVer la guía de la API

Actualizado el

Qué es la boleta electrónica y quién debe emitirla

La boleta electrónica es el documento tributario electrónico (DTE) que respalda una venta a consumidor final en Chile. Reemplazó a la boleta de papel: se genera, se firma con un certificado digital y se envía al SII en formato digital. Desde 2021 es obligatoria para los contribuyentes afectos a IVA, así que un almacén, una peluquería, una tienda online o un consultorio emiten boletas electrónicas igual que una gran cadena.

Existen dos tipos. La boleta electrónica afecta, código 39, respalda ventas con IVA: el precio que ve el cliente ya incluye el impuesto y el documento desglosa el monto neto y el IVA. La boleta no afecta o exenta, código 41, se usa para ventas y servicios exentos de IVA. A diferencia de la factura, la boleta no exige el RUT del comprador y no genera crédito fiscal para quien la recibe.

Para emitirlas necesitas un software de mercado autorizado o el sistema gratuito del SII. Folyo es software de mercado: emite boletas 39 y 41 con firma propia en el servidor, las envía al SII y te deja elegir cómo trabajar. Si vendes en un local, usas el panel y entregas el ticket. Si tienes un ecommerce o un sistema propio, llamas a la API y la boleta sale desde tu flujo sin pasar por una pantalla.

Cómo emitir boletas electrónicas con Folyo

Desde el registro hasta la primera boleta hay cinco pasos. Los tres primeros se hacen una sola vez por empresa; el onboarding guiado del panel te lleva por ellos.

  1. 01

    Carga tu certificado digital

    Sube el certificado electrónico de la empresa o del representante en formato .pfx o .p12 con su clave. Con él se firma cada boleta y se guarda cifrado. Sirven los certificados de E-CertChile, Acepta, DigiSign y los demás emisores autorizados por el SII.

  2. 02

    Revisa la modalidad de boletas en el SII

    El SII solo entrega folios de boleta a empresas que emiten con software de mercado. Si tu empresa está inscrita en el sistema gratuito de boletas del SII, cambia la modalidad en el sitio del SII antes de pedir folios. Si ya emitías boletas con otro software, este paso ya está hecho.

  3. 03

    Obtén folios CAF para los tipos 39 y 41

    Solicita los folios al SII desde la sección Folios del panel o por API con POST /v1/dte/folios/solicitar. Si prefieres, descarga el archivo CAF en el sitio del SII y cárgalo. Los folios del ambiente de certificación y los de producción son independientes.

  4. 04

    Emite desde el panel o por API

    En el panel, entra a Emitir, elige boleta y completa las líneas con el precio final al público. Por API, envía POST /v1/dte/emitir con tipo_dte 39 o 41. La API responde 202 con un job_id; la boleta se firma y se envía al SII en segundo plano y el resultado llega por webhook o consultando GET /v1/dte/emision/:jobId.

  5. 05

    Entrega el documento y revisa el envío

    Descarga el PDF en formato carta o como ticket térmico de 80 o 58 mm. Consulta el estado del envío ante el SII con GET /v1/boleta/estado/:trackId usando el track_id que devolvió la emisión, y envía el Reporte de Consumo de Folios (RCOF) del día con POST /v1/dte/rcof.

Boleta electrónica para cada tipo de negocio

La misma emisión sirve para un local con impresora térmica, una tienda online o un grupo con varias razones sociales. Cambia el canal, no el documento.

Comercio con punto de venta

Emite desde el panel y descarga el ticket para impresora de bobina de 80 o 58 mm. En boletas el timbre impreso es opcional desde 2026; por defecto el ticket lo incluye y puedes omitirlo. El menú de descarga del panel ofrece PDF carta, ticket de 80 mm y ticket de 58 mm.

Ecommerce y ventas online

Integra la emisión en el checkout con la API o con el SDK oficial en TypeScript o Python. Usa el receptor anónimo 66666666-6 cuando el comprador no entrega su RUT, recibe el resultado por webhook y descarga el PDF para adjuntarlo al correo de confirmación.

Servicios con boleta exenta

Para ventas y servicios exentos de IVA emite la boleta 41 con el mismo request, cambiando el tipo. Si el cobro es por el arriendo de un inmueble amoblado, la boleta 39 admite la rebaja a la base imponible del artículo 17, con el IVA calculado sobre el bruto afecto menos la rebaja.

Grupos con varias razones sociales

Administra varias empresas bajo una sola cuenta, cada una con su certificado, sus folios y su configuración. Las cuotas de DTE y boletas del plan se comparten entre todas las empresas: no pagas una suscripción por cada RUT que emite.

Emitir una boleta electrónica por API

Un request basta. Los precios van con IVA incluido y el receptor anónimo reemplaza el RUT del comprador. Este ejemplo es el de la guía de emisión de boletas, adaptado a curl.

bash
curl -X POST https://api.folyo.cl/v1/dte/emitir \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tipo_dte": 39,
    "receptor": {
      "rut": "66666666-6",
      "razon_social": "Sin nombre"
    },
    "detalle": [
      {
        "nombre": "Café americano",
        "cantidad": 2,
        "precio": 2500,
        "monto": 5000
      }
    ]
  }'

# Responde 202 Accepted con un job_id. El resultado llega por webhook
# o consultando GET /v1/dte/emision/:jobId

Errores frecuentes al emitir boletas electrónicas

Casi todos los problemas aparecen antes de la primera boleta, al pedir folios. Cada error de la API trae un código estable que indica qué hacer.

El SII no entrega folios de boleta

La solicitud responde 409 con el código FOLIOS_BOLETA_SISTEMA_SII. Significa que la empresa está inscrita en el sistema gratuito de boletas del SII, que no entrega CAF a software de mercado. Cambia la modalidad en el sitio del SII y vuelve a solicitar, o descarga el CAF manualmente y cárgalo.

El plan no incluye boletas

Los planes gratuitos responden 403 con el código PLAN_LIMIT al solicitar o cargar folios de boleta, antes de contactar al SII, para no consumir cupo de timbraje en documentos que el plan no puede emitir. Se resuelve subiendo a un plan con boletas.

Folios en el ambiente equivocado

Los folios de certificación no sirven en producción ni al revés. Si la emisión falla por falta de folios, revisa qué ambiente tiene activo la empresa y que el CAF cargado corresponda a ese ambiente y al tipo de boleta que emites.

Envío con reparos o rechazado

Consulta el track_id en GET /v1/boleta/estado. Un reparo leve no invalida la boleta: queda aceptada y el detalle sirve para corregir la causa en las siguientes. Si el SII rechaza el envío, la respuesta trae el detalle por folio con el error reportado.

Preguntas frecuentes sobre boleta electrónica

¿Puedo emitir boletas con el plan gratis?
No. Los planes Free y API Free incluyen 25 DTE al mes para facturas, notas y guías, pero no incluyen boletas. Las boletas parten en Starter (500 al mes) y API Start (1.000 al mes); Pyme, Business, API Pro y API Scale las incluyen sin tope, sujetas a un uso razonable del servicio. Puedes partir gratis, integrar y subir de plan cuando vayas a emitir boletas.
¿Necesito certificado digital para emitir boletas electrónicas?
Sí. Cada boleta se firma con el certificado digital de la empresa o de su representante, emitido por una entidad autorizada por el SII. Lo cargas una vez en formato .pfx o .p12 y Folyo lo guarda cifrado; desde ahí firma todas tus boletas sin que vuelvas a intervenir.
¿Cuál es la diferencia entre boleta afecta y boleta exenta?
La boleta afecta (tipo 39) respalda ventas con IVA y el precio incluye el impuesto; el documento muestra el neto y el IVA por separado. La boleta exenta (tipo 41) respalda ventas y servicios sin IVA. En Folyo se emiten con el mismo request cambiando el tipo, y cada una usa sus propios folios CAF.
¿Qué pasa si el SII rechaza una boleta?
Consultas el estado del envío con el track_id que devolvió la emisión. La respuesta incluye la estadística del envío y, si hay reparos o rechazos, el detalle por folio con el error que reporta el SII. Un reparo leve no invalida la boleta; un rechazo te dice qué corregir antes de emitir de nuevo.
¿Puedo imprimir la boleta en formato ticket?
Sí. Toda boleta se puede descargar como ticket para impresora térmica de 80 o 58 mm, además del PDF carta. En el panel, el menú de descarga ofrece las tres variantes; por API se pide con los parámetros formato, ancho y timbre del endpoint de PDF. El ticket incluye lo que exige el SII para la representación impresa de la boleta.
¿Tengo que enviar el Reporte de Consumo de Folios?
Sí, el RCOF es obligatorio para las empresas que emiten boletas. Folyo genera el resumen del día a partir de las boletas emitidas y lo envía al SII cuando lo pides con POST /v1/dte/rcof. Con GET /v1/dte/rcof puedes previsualizarlo y saber si una fecha ya fue reportada.
¿Puedo probar la emisión antes de pasar a producción?
Sí. Toda empresa parte en el ambiente de certificación del SII, donde los documentos no tienen valor tributario y puedes validar la integración con folios de prueba. Probar ahí no certifica a tu empresa ante el SII; ese trámite se explica en la guía de certificación.

Enlaces relacionados

Tu primer documento está a una decisión de distancia.

Parte gratis, valida tu operación y escala cuando el volumen lo pida.

Crear cuenta gratisVer la guía de la API