Primeros pasos

De cero a tu primera llamada

Cinco minutos, sin instalar nada. Si tu lenguaje puede hacer una petición HTTPS, ya puedes usar Cifra.

1 · Consigue tu API key

Crea una cuenta en mimicifra.cl/login. Al registrarte se genera automáticamente tu clave del plan Free (60 solicitudes/minuto, sin tarjeta). La ves y copias en tu panel.

¿Solo quieres mirar? Usa la clave cifra_demo sin registrarte. Devuelve los datos gratuitos completos y una vista previa de 5 filas en los datasets de pago.

2 · Guarda la clave como variable de entorno

Nunca la escribas en el código ni la subas al repositorio: identifica y factura tu consumo.

Terminal

# Linux / macOS
export CIFRA_API_KEY="cifra_live_..."

# Windows (PowerShell)
$env:CIFRA_API_KEY = "cifra_live_..."

# .env de tu proyecto
CIFRA_API_KEY=cifra_live_...

3 · Haz tu primera llamada

Pedimos los indicadores del día —el dataset gratuito— y leemos el valor de la UF.

curl 'https://mimicifra.cl/api/v1/indicadores' \
  -H 'x-api-key: TU_API_KEY'

Lo que recibes

application/json

{
  "producto": "Cifra API",
  "dataset": "indicadores",
  "fuente": "Banco Central de Chile",
  "estado_datos": "live",
  "count": 4,
  "data": [
    {
      "codigo": "uf",
      "nombre": "Unidad de Fomento (UF)",
      "valor": 39512.44,
      "fecha": "2026-07-26"
    }
  ]
}

4 · Casos de uso frecuentes

Verificar una empresa antes de darle crédito

cURL

curl 'https://mimicifra.cl/api/v1/boletin-concursal?q=76123456-7' \
  -H "x-api-key: $CIFRA_API_KEY"

# Si "count" es 0, la empresa no tiene procedimientos concursales publicados.

Validar el RUT en el onboarding

cURL

curl 'https://mimicifra.cl/api/v1/validar-rut?rut=76252128-8' \
  -H "x-api-key: $CIFRA_API_KEY"

# data[0].valido → true | false

Emitir una factura electrónica

cURL

curl -X POST 'https://mimicifra.cl/api/dte/emitir' \
  -H "x-api-key: $CIFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "tipo": 33,
    "emisor": {
      "rut": "76000000-0", "razonSocial": "Mi Empresa SpA",
      "giro": "Servicios", "acteco": "620200",
      "direccion": "Av. Providencia 1234", "comuna": "Providencia"
    },
    "receptor": { "rut": "77000000-1", "razonSocial": "Cliente Ltda" },
    "items": [{ "nombre": "Asesoría", "cantidad": 1, "precioUnitario": 100000 }]
  }'

5 · Buenas prácticas

Llama siempre desde tu backend, nunca desde el navegador o una app móvil.
Cachea los datasets cached al menos una hora: cambian a diario, no por segundo.
Reintenta con backoff exponencial ante 429 y 502.
Programa contra el campo error, no contra el texto de message.
Registra el estado_datos si necesitas trazabilidad ante auditoría.
Usa una API key distinta por ambiente (desarrollo / producción).

¿Y si no tengo desarrolladores?

No necesitas programar para usar Cifra. Desde tu panel puedes buscar empresas, consultar indicadores y emitir un DTE desde un formulario. También puedes conectarlo a Excel o Power BI con Power Query.

¿Recién partiendo con la facturación electrónica? La guía Cómo empezar a facturar explica los trámites del SII —certificado, set de pruebas, folios— sin tecnicismos, y qué exigirle a la agencia que contrates.

Power Query (Excel / Power BI)

let
    Origen = Json.Document(
        Web.Contents(
            "https://mimicifra.cl/api/v1/indicadores",
            [Headers = [#"x-api-key" = "TU_API_KEY"]]
        )
    ),
    Datos = Table.FromRecords(Origen[data])
in
    Datos

Siguiente: referencia completa de la API →