Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.siplex.cl/llms.txt

Use this file to discover all available pages before exploring further.

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.
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",
    "numeroResolucion": 80,
    "fechaResolucion": "2024-01-15"
  }'
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_..."
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}'

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
  }'

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"]}'
La factura queda enviada al SII. Puedes consultar el estado con GET /dte/{dteId}/status.

Siguiente paso

Autenticación

Generar y gestionar API keys

Webhooks

Notificaciones en tiempo real