webFactura
← Volver al blog
Integraciones

¿Cómo emitir DTE por API en Chile? Guía práctica para desarrolladores

Aprende cómo emitir facturas, boletas y guías de despacho electrónicas por API REST en Chile. Autenticación OAuth 2.0, emisión por documento y por sobre, ejemplos de código y tipos de DTE soportados.

Equipo webFactura · 14 de marzo de 2026

Si tu empresa tiene un sistema propio — ERP, e-commerce, plataforma SaaS o cualquier software a medida — integrar la emisión de documentos tributarios electrónicos (DTE) por API es la forma más eficiente de automatizar la facturación sin depender de interfaces manuales.

Esta guía explica cómo funciona la API REST de webFactura: autenticación, tipos de DTE disponibles, emisión por documento y por sobre, y consulta de estado ante el SII. La referencia técnica completa está en la documentación de la API.

¿Qué DTE se pueden emitir por API?

La API de webFactura permite emitir los siguientes documentos tributarios electrónicos:

Código SIITipo de documento
33Factura electrónica
34Factura no afecta o exenta electrónica
39Boleta electrónica
41Boleta no afecta o exenta electrónica
52Guía de despacho electrónica
56Nota de débito electrónica
61Nota de crédito electrónica
110Factura de exportación electrónica
111Nota de débito de exportación electrónica
112Nota de crédito de exportación electrónica

Autenticación: OAuth 2.0

La API usa OAuth 2.0 con Client Credentials. Primero obtienes un access_token con tus credenciales y lo usas en cada request posterior.

POST https://api.webfactura.cl/oauth/v2/token
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials&client_id=tu_client_id&client_secret=tu_client_secret

Respuesta:

{
  "access_token": "xxxxxxxxxxxxxxxx",
  "expires_in": 86400,
  "token_type": "bearer",
  "scope": "user"
}

El token dura 24 horas. Todos los endpoints requieren el header:

Authorization: Bearer {access_token}

Las credenciales identifican a tu empresa: no necesitas enviar ningún identificador de empresa en las llamadas.

Emisión por documento: un DTE por request

El endpoint para emitir un documento individual es POST /api/v3/pos/dte/sendDTEJson.json. El cuerpo sigue la estructura del DTE definida por el SII: encabezado (identificación, emisor, receptor y totales), detalle de ítems y, opcionalmente, referencias.

Ejemplo: emitir una factura electrónica (tipo 33)

POST /api/v3/pos/dte/sendDTEJson.json
Authorization: Bearer {access_token}
Content-Type: application/json

{
  "DteSend": {
    "Dte": [
      {
        "Encabezado": {
          "IdDoc": { "TipoDTE": "33", "Folio": "0", "FchEmis": "2026-03-15", "FmaPago": "2", "FchVenc": "2026-04-14" },
          "Emisor": { "RUTEmisor": "76000000-1", "RznSoc": "Mi Empresa SpA", "GiroEmis": "Desarrollo de software", "Acteco": "620200", "DirOrigen": "Av. Siempre Viva 123", "CmnaOrigen": "Providencia" },
          "Receptor": { "RUTRecep": "76123456-7", "RznSocRecep": "Empresa Ejemplo SpA", "GiroRecep": "Comercio al por mayor", "DirRecep": "Av. Providencia 1234", "CmnaRecep": "Providencia" },
          "Totales": { "MntNeto": "740000", "MntExe": "0", "TasaIVA": "19", "IVA": "140600", "MntTotal": "880600" }
        },
        "Detalles": [
          { "NroLinDet": "1", "NmbItem": "Licencia software anual", "QtyItem": "1", "PrcItem": "500000", "MontoItem": "500000" },
          { "NroLinDet": "2", "NmbItem": "Soporte técnico mensual", "QtyItem": "3", "PrcItem": "80000", "MontoItem": "240000" }
        ]
      }
    ]
  }
}

Con "Folio": "0" webFactura asigna automáticamente el siguiente folio disponible. Si tu sistema lleva su propia numeración, puedes enviar el número de folio que corresponda.

Respuesta:

{
  "code": "200",
  "message": "OK",
  "DocumentoDTE": {
    "TipoDTE": "33",
    "Folio": 2048,
    "EstadoDTE": "0",
    "GlosaEstadoDTE": "DTE RECIBIDO OK",
    "PDFUrl": "https://{host_pdf}/pdf/{token}",
    "PDFUrlTimbre": "https://{host_pdf}/pdf/{token}/2"
  }
}

En la misma respuesta recibes el folio asignado y el enlace al PDF para enviar al cliente. webFactura se encarga del timbre, la firma y el envío al SII de forma automática.

Emisión masiva: sobre de DTE

Para sistemas con alto volumen — e-commerce con muchas ventas simultáneas, facturación recurrente o cierres de período — existe el endpoint POST /api/v3/pos/dte/sendSobreDTEJson, que recibe hasta 2000 documentos en un solo request, con la misma estructura de la emisión por documento.

POST /api/v3/pos/dte/sendSobreDTEJson
Authorization: Bearer {access_token}
Content-Type: application/json

{
  "DteSend": {
    "Dte": [
      { "Encabezado": { "IdDoc": { "TipoDTE": "39", "Folio": "0", "FchEmis": "2026-03-15" }, ... }, "Detalles": [ ... ] },
      { "Encabezado": { "IdDoc": { "TipoDTE": "39", "Folio": "0", "FchEmis": "2026-03-15" }, ... }, "Detalles": [ ... ] }
    ]
  }
}

El sobre se procesa de forma asíncrona. La API responde de inmediato con un sobreId, y con él consultas el resultado en GET /api/v3/pos/dte/sobre/{sobreId}/response: el estado del sobre y, por cada documento, su folio y PDF o el motivo del error.

Consultar documentos y su estado ante el SII

Para consultar los documentos emitidos (o recibidos) y su estado ante el SII se usa GET /api/v3/pos/getDocumentsFiltered/data, con filtros por tipo de documento, fecha o RUT, y paginación:

GET /api/v3/pos/getDocumentsFiltered/data?operation=VENTA&page=1&limit=50&searchCriteria[filter][0][field]=FchEmis&searchCriteria[filter][0][value]=2026-03-01&searchCriteria[filter][0][conditionType]=mayorIgual
Authorization: Bearer {access_token}

Cada documento de la respuesta incluye su folio, receptor, totales, detalle, el campo EstadoSII y el enlace al PDF. Con el parámetro resource también puedes obtener el XML del documento, con o sin firma. Ver la guía de consulta.

¿Para quién está pensada la API?

La API de webFactura está orientada a empresas y equipos técnicos que necesitan control total sobre la emisión de DTE sin depender de una interfaz manual. Es especialmente útil cuando:

  • Tienes un sistema propio (ERP, CRM, plataforma interna) que debe emitir documentos automáticamente
  • Tu operación genera alto volumen de documentos y el proceso manual no escala
  • Necesitas que la facturación esté integrada en tu flujo de negocio: una venta aprobada, un despacho completado o un cobro procesado genera el DTE de forma inmediata
  • Tienes un equipo de desarrollo que puede consumir una API REST estándar

No se requiere experiencia previa en facturación electrónica chilena — la API abstrae toda la complejidad del SII: folios, timbre electrónico, firma digital y envío al Servicio de Impuestos Internos quedan a cargo de webFactura.

Beneficios de integrar por API

Automatización sin intervención manual Cada evento en tu sistema — una venta, una orden aprobada, un despacho — genera automáticamente el DTE correspondiente. Se eliminan los errores de digitación y los documentos que quedan sin emitir.

Velocidad de respuesta La emisión por documento es sincrónica: envías el request y en la misma respuesta recibes el folio y el enlace al PDF. No hay pasos intermedios ni esperas.

Escalabilidad Con el endpoint de sobre (batch), puedes emitir hasta 2000 documentos en un solo request. Ideal para empresas con picos de volumen o procesos de facturación recurrente.

Trazabilidad completa Cada DTE emitido queda registrado con su estado ante el SII. Puedes consultar en cualquier momento si un documento fue aceptado, rechazado o está pendiente, e integrarlo en tus propios reportes.

Compatibilidad universal La API es REST con formato JSON y autenticación OAuth 2.0 — los estándares más usados en la industria. Es compatible con cualquier lenguaje: Python, PHP, Node.js, Java, .NET, Ruby y más.

Casos de uso frecuentes

ERP conectado a facturación Empresas con SAP Business One, Microsoft Dynamics, Softland u otros sistemas de gestión que necesitan emitir facturas y guías de despacho directamente desde su ERP, sin doble digitación.

E-commerce con facturación automática Tiendas en Shopify, WooCommerce o Jumpseller que generan automáticamente la boleta o factura de cada venta online, en el momento del pago, y la envían por email al cliente.

Plataformas SaaS que facturan a sus clientes Empresas de software que emiten facturas recurrentes a sus suscriptores de forma automática cada mes, sin intervención del equipo de administración.

Sistemas de punto de venta (POS) Locales con alto flujo de ventas que necesitan emitir boletas electrónicas en tiempo real desde su sistema de caja, con impresión directa o envío por email.

Operaciones logísticas con guías de despacho Empresas de distribución que generan guías de despacho automáticamente al momento de preparar un pedido en bodega, antes de que el vehículo salga.

¿Por dónde empezar?

  1. Solicita tus credenciales — contacta al equipo de webFactura para obtener tu client_id y client_secret.
  2. Prueba en sandbox — antes de producción, valida tu integración en el ambiente de pruebas de webFactura (https://api-qa.webfactura.cl).
  3. Solicita la colección Postman — incluye la obtención del token y ejemplos listos para ejecutar de cada tipo de documento.
  4. Revisa la documentación técnica — en webfactura.cl/api/docs encontrarás la referencia completa: emisión de documentos y consulta de documentos.

¿Tienes dudas técnicas o quieres coordinar una integración a medida? Contáctanos y nuestro equipo te acompaña en el proceso.

¿Quieres simplificar tu facturación?

Agenda una demo y te mostramos webFactura en 30 minutos.

Soporte Agendar demo Hablar con Ventas