Quickstart

Prerequisitos

Una cuenta creada en el dashboard

Una API key generada en Settings → API Keys

Un tenant con credenciales configuradas (certificado .pfx + API key de Simple API)

1. Crear un tenant

Cada empresa que factura es un tenant. Créalo con los datos tributarios del RUT. Los campos de resolución del SII son opcionales: si la empresa todavía no está certificada, se omiten y se completan después.

curl -X POST https://api.example.com/api/v1/tenants \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "rutEmpresa": "76.123.456-7",
    "razonSocial": "Mi Empresa SpA",
    "giro": "Tecnología",
    "direccion": "Av. Principal 123",
    "comuna": "Santiago",
    "ciudad": "Santiago"
  }'

const res = await fetch('https://api.example.com/api/v1/tenants', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer sk_live_...',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    rutEmpresa: '76.123.456-7',
    razonSocial: 'Mi Empresa SpA',
    giro: 'Tecnología',
    direccion: 'Av. Principal 123',
    comuna: 'Santiago',
    ciudad: 'Santiago',
  }),
})
const tenant = await res.json()
// tenant.id → usar en los siguientes pasos
// tenant.estadoCertificacion → 'borrador'

Si la empresa ya está certificada, agregá numeroResolucionCert y fechaResolucionCert (el par del ambiente de certificación). Cada par va completo o vacío, y las fechas en YYYY-MM-DD. Ver Tenants para las dos resoluciones y el paso a producción.

2. Enviar link de activación

Genera un link para que tu cliente suba su certificado digital y API key de Simple API. El link expira en 7 días.

curl -X POST https://api.example.com/api/v1/tenants/{tenantId}/activation-link \
  -H "Authorization: Bearer sk_live_..."

const res = await fetch(
  `https://api.example.com/api/v1/tenants/${tenant.id}/activation-link`,
  {
    method: 'POST',
    headers: { 'Authorization': 'Bearer sk_live_...' },
  }
)
const { url, expiresAt } = await res.json()
// Envía `url` a tu cliente por email o in-app

Tu cliente abre el link, sube su .pfx y API key de Simple API en una página hosted por nosotros. No necesitas construir UI para esto.

3. Solicitar folios

Una vez que tu cliente configuró credenciales (recibirás un webhook tenant.credentials.updated), solicita folios al SII.

curl -X POST https://api.example.com/api/v1/tenants/{tenantId}/folios/request \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"tipoDte": 33, "cantidad": 50}'

await fetch(
  `https://api.example.com/api/v1/tenants/${tenant.id}/folios/request`,
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer sk_live_...',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ tipoDte: 33, cantidad: 50 }),
  }
)

4. Emitir una factura

curl -X POST https://api.example.com/api/v1/tenants/{tenantId}/dte \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "tipoDte": 33,
    "receptor": {
      "rut": "77.777.777-7",
      "razonSocial": "Cliente SpA",
      "giro": "Comercio",
      "direccion": "Calle 1",
      "comuna": "Santiago",
      "ciudad": "Santiago"
    },
    "detalle": [
      {
        "nombre": "Servicio de desarrollo web",
        "cantidad": 1,
        "precioUnitario": 100000,
        "montoItem": 100000
      }
    ],
    "montoTotal": 119000
  }'

const res = await fetch(
  `https://api.example.com/api/v1/tenants/${tenant.id}/dte`,
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer sk_live_...',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      tipoDte: 33,
      receptor: {
        rut: '77.777.777-7',
        razonSocial: 'Cliente SpA',
        giro: 'Comercio',
        direccion: 'Calle 1',
        comuna: 'Santiago',
        ciudad: 'Santiago',
      },
      detalle: [
        {
          nombre: 'Servicio de desarrollo web',
          cantidad: 1,
          precioUnitario: 100000,
          montoItem: 100000,
        },
      ],
      montoTotal: 119000,
    }),
  }
)
const dte = await res.json()

5. Enviar al SII

curl -X POST https://api.example.com/api/v1/tenants/{tenantId}/dte/send \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"dteIds": ["uuid-del-dte"]}'

await fetch(
  `https://api.example.com/api/v1/tenants/${tenant.id}/dte/send`,
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer sk_live_...',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ dteIds: [dte.id] }),
  }
)

La factura queda enviada al SII. Puedes consultar el estado con GET /dte/{dteId}/status.

Empezar

Flujos principales

Referencia

Prerequisitos

1. Crear un tenant

2. Enviar link de activación

3. Solicitar folios

4. Emitir una factura

5. Enviar al SII

Siguiente paso

Autenticación

Webhooks

​Prerequisitos

​1. Crear un tenant

​2. Enviar link de activación

​3. Solicitar folios

​4. Emitir una factura

​5. Enviar al SII

​Siguiente paso

Autenticación

Webhooks

Prerequisitos

1. Crear un tenant

2. Enviar link de activación

3. Solicitar folios

4. Emitir una factura

5. Enviar al SII

Siguiente paso