Documentación API webFactura

Referencia técnica de la API REST de webFactura para emisión de documentos tributarios electrónicos (DTE) en Chile. Autenticación OAuth 2.0, formato JSON.

Ver en Swagger → Colección Postman →

Información general

Base URL	https://api.webfactura.cl
Formato	REST · JSON
Autenticación	OAuth 2.0 (Bearer Token)
Versión	v1
Documentación interactiva	Swagger UI disponible en /swagger
Colección	Postman Collection disponible bajo solicitud

Autenticación

La API usa OAuth 2.0. Obtén tu access_token con tus credenciales de cliente y úsalo en el header de cada request.

POST https://api.webfactura.cl/oauth/token
Content-Type: application/json

{
  "client_id": "tu_client_id",
  "client_secret": "tu_client_secret",
  "grant_type": "client_credentials"
}

# Respuesta
{
  "access_token": "eyJ...",
  "token_type": "Bearer",
  "expires_in": 3600
}

# Uso en requests
Authorization: Bearer eyJ...

Endpoints

POST /dte/emitir

Emitir DTE unitario

Emite un documento tributario electrónico de forma individual. Retorna el folio asignado, el PDF y el XML del documento una vez procesado por el SII.

POST /dte/emitir
Authorization: Bearer {token}
Content-Type: application/json

{
  "tipoDte": 39,
  "receptor": {
    "rut": "12345678-9",
    "razonSocial": "Empresa Ejemplo SpA",
    "giro": "Comercio al por menor",
    "direccion": "Av. Ejemplo 123, Santiago"
  },
  "detalle": [
    {
      "nombre": "Producto o servicio",
      "cantidad": 1,
      "precio": 10000
    }
  ]
}

POST /dte/sobre

Emisión masiva en sobre

Agrupa múltiples DTE en un solo request (sobre o batch). Recomendado para sistemas con alto volumen como TUVES (40.000 boletas/mes). El API procesa el sobre de forma asíncrona y notifica el resultado.

POST /dte/sobre
Authorization: Bearer {token}
Content-Type: application/json

{
  "documentos": [
    { "tipoDte": 39, "receptor": {...}, "detalle": [...] },
    { "tipoDte": 39, "receptor": {...}, "detalle": [...] }
    // hasta N documentos por sobre
  ]
}

GET /dte/{folio}/estado

Consultar estado ante el SII

Devuelve el estado actual del documento ante el SII: ACEPTADO, RECHAZADO o PENDIENTE.

Tipos de DTE soportados

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

Documentación interactiva

La documentación completa con todos los parámetros, ejemplos de respuesta y pruebas en vivo está disponible en Swagger UI y en la colección Postman.

Abrir Swagger UI Solicitar colección Postman