Cómo emitir una factura

Esta guía muestra cómo emitir una Factura Electrónica (tipo 33) y recibir el resultado vía webhook.

Prerequisitos

  • Cuenta Folyo con una empresa configurada
  • Certificado digital subido
  • Folios tipo 33 disponibles (CAF cargado)
  • API Key creada

1. Emitir el DTE

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

{
  "tipo_dte": 33,
  "receptor": {
    "rut": "76543210-K",
    "razon_social": "Cliente SpA",
    "giro": "Comercio al por menor",
    "direccion": "Calle Los Leones 456",
    "comuna": "Las Condes",
    "ciudad": "Santiago"
  },
  "detalle": [
    {
      "nombre": "Servicio de consultoría",
      "cantidad": 10,
      "precio": 50000,
      "monto": 500000
    }
  ]
}

Cada línea de detalle requiere nombre, precio (valor neto unitario) y monto (total neto de la línea, normalmente cantidad × precio). El IVA se calcula a nivel de documento; no lo incluyas en monto para una factura afecta.

Respuesta inmediata:

json
{
  "ok": true,
  "data": {
    "job_id": "a1b2c3d4-...",
    "folio": 1001,
    "tipo_dte": 33,
    "estado": "pending"
  }
}

2. Recibir el resultado vía webhook

Configura un webhook en el dashboard apuntando a tu endpoint. Cuando el DTE se procesa, recibes:

json
{
  "evento": "dte.emitido",
  "data": {
    "job_id": "a1b2c3d4-...",
    "tipo_dte": 33,
    "folio": 1001,
    "track_id": "123456789",
    "monto_total": 595000,
    "fecha_emision": "2026-05-08"
  }
}

Verifica la firma del webhook con el header X-Folyo-Signature: sha256=<hmac>.

3. Descargar el PDF

http
GET https://api.folyo.cl/v1/dte/pdf/33/1001
X-API-Key: tu_api_key
X-Empresa-Id: tu_empresa_id

Retorna el PDF del DTE para enviar al receptor.

Campos opcionales

Campo Descripción
descuentos_globales Arreglo de descuentos o recargos globales al documento (tipo_movimiento D/R, tipo_valor %/$, valor)
referencia Arreglo de documentos referenciados (ej: orden de compra, contrato, HES)
observacion Glosa libre visible en el DTE
forma_pago Forma de pago (1 contado, 2 crédito, 3 sin costo)
receptor.email_intercambio Casilla de intercambio B2B del receptor: se le envía el sobre EnvioDTE por correo tras emitir