Primeros pasos

Esta guía te lleva desde el registro hasta emitir tu primer DTE en menos de 15 minutos.

Si programas en TypeScript o Python, hay SDK oficial para ambos: integras en una tarde sin escribir HTTP a mano.

bash
pnpm add @folyo/sdk
# Python: pip install folyo

Revisa la página de SDKs para el quickstart completo. El resto de esta guía usa la API por HTTP directo, que aplica a cualquier lenguaje.

1. Crear una cuenta

Regístrate en folyo.cl. Todas las cuentas nuevas inician en el plan Free, con 25 DTE al mes que puedes emitir en el ambiente de certificación del SII o en producción.

2. Crear una empresa

Desde el dashboard, ve a Configuración → Empresa y agrega tu empresa. Necesitas:

  • RUT de la empresa
  • Razón social
  • Giro comercial
  • Dirección

Puedes autocompletar los datos desde el SII ingresando el RUT.

3. Subir el certificado digital

Sube el certificado .pfx de la empresa en Configuración → Certificado. Este certificado firma todos los DTE que emitas.

4. Cargar folios (CAF)

Solicita folios al SII desde Folios en el dashboard, o carga un archivo CAF manualmente. Sin folios no puedes emitir documentos.

5. Obtener una API Key

Ve a API Keys y crea una nueva clave. Úsala en el header X-API-Key para autenticarte.

6. Emitir tu primer DTE

http
POST https://api.folyo.cl/v1/dte/emitir
X-API-Key: tu_api_key
X-Empresa-Id: empresa_id
Content-Type: application/json

{
  "tipo_dte": 33,
  "receptor": {
    "rut": "12345678-9",
    "razon_social": "Empresa Receptora SpA",
    "giro": "Servicios de Tecnología",
    "direccion": "Av. Providencia 123",
    "comuna": "Providencia",
    "ciudad": "Santiago"
  },
  "detalle": [
    {
      "nombre": "Servicio de desarrollo",
      "cantidad": 1,
      "precio": 100000,
      "monto": 100000
    }
  ]
}

La API responde 202 Accepted con un job_id. El DTE se firma y envía al SII en segundo plano. El resultado llega por webhook o puedes consultar el estado con GET /v1/dte/emision/:jobId.