Integra Facturación

Referencia API

Documentación completa de todos los endpoints disponibles. REST API con respuestas JSON.

Información General

Base URL

https://api.sii-api.cl/v1

Autenticación

X-API-Key header

Content-Type

application/json

Rate Limit

100 requests/minute

Endpoints

Autenticación

POST/auth/login
POST/auth/register
POST/auth/refreshAuth
GET/auth/meAuth

Empresas

GET/businessesAuth
POST/businessesAuth
GET/businesses/{id}Auth
PUT/businesses/{id}Auth
DELETE/businesses/{id}Auth
POST/businesses/{id}/certificateAuth

DTEs (Documentos Tributarios)

POST/dte/emitAuth
GET/dteAuth
GET/dte/{id}Auth
GET/dte/{id}/statusAuth
GET/dte/{id}/pdfAuth
GET/dte/{id}/xmlAuth

API Keys (Tokens)

GET/tokensAuth
POST/tokensAuth
DELETE/tokens/{id}Auth

Utilidades

GET/health
POST/rut/validateAuth

Formato de Peticiones

Ejemplo de Petición

curl -X POST https://api.sii-api.cl/v1/dte/emit \
  -H "X-API-Key: sk_live_tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "tipo": 33,
    "receptor": {
      "rut": "76543210-K",
      "razon_social": "Cliente SpA",
      "giro": "Tecnología",
      "direccion": "Av. Principal 123",
      "comuna": "Santiago"
    },
    "items": [{
      "nombre": "Servicio",
      "cantidad": 1,
      "precio": 100000
    }]
  }'

Respuesta Exitosa

{
  "success": true,
  "data": {
    "id": "dte_abc123xyz",
    "tipo": 33,
    "folio": 1234,
    "fecha_emision": "2024-01-20T10:30:00Z",
    "monto_total": 119000,
    "estado": "ENVIADO"
  }
}

Respuesta de Error

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "El campo receptor.rut es requerido",
    "details": {
      "field": "receptor.rut",
      "reason": "required"
    }
  }
}

Paginación

Los endpoints que devuelven listas soportan paginación mediante parámetros de query string.

page

Número de página (desde 1)

limit

Resultados por página (máx. 100)

GET /v1/dte?page=1&limit=20&tipo=33&desde=2024-01-01&hasta=2024-01-31

Response:
{
  "success": true,
  "data": [...],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 150,
    "total_pages": 8
  }
}

Códigos de Estado HTTP

200OKPetición exitosa
201CreatedRecurso creado exitosamente
400Bad RequestParámetros inválidos o faltantes
401UnauthorizedAPI Key inválida o no proporcionada
403ForbiddenSin permisos para este recurso
404Not FoundRecurso no encontrado
422Unprocessable EntityError de validación de datos
429Too Many RequestsRate limit excedido
500Internal Server ErrorError interno del servidor

SDKs y Librerías

Próximamente ofreceremos SDKs oficiales para facilitar la integración en tu lenguaje favorito.

JavaScript/Node.js

Próximamente

Python

Próximamente

PHP

Próximamente

¿Listo para integrar?

Crea tu cuenta gratis y comienza a usar la API inmediatamente.

Crear Cuenta GratisGuía de Inicio