Referencia de la API

API de Cifra

API REST sobre HTTPS con respuestas JSON. Un solo esquema de autenticación, un solo formato de error y un contrato OpenAPI 3.0 importable en cualquier gateway. Todos los ejemplos de esta página son ejecutables tal cual.

URL basehttps://micifra.cl/api/v1

Autenticaciónx-api-key

Formatoapplication/json

ContratoOpenAPI 3.0

Autenticación

Toda petición autenticada envía tu clave en la cabecera x-api-key. Consigues la tuya —gratis— creando una cuenta en tu panel. La clave cifra_demo funciona para probar, con vista previa acotada en los datasets de pago.

No la expongas en el navegador. La API key identifica y factura tu consumo: úsala solo desde tu backend o desde un gateway. Nunca la incrustes en una app web o móvil.

Cabecera

x-api-key: cifra_live_a1b2c3d4e5f6...

Planes y límites

Cada dataset declara un plan mínimo. Si tu plan no alcanza, recibes 403 plan_insuficiente. Los límites de tasa se aplican por API key y dependen de qué estás llamando, no solo de tu plan.

Datasets de Cifra

Los servimos desde nuestra propia base y caché, así que el límite es amplio y escala con el plan.

Plan	Límite	Acceso
`free`	60 req/min	Indicadores, tributario y DTE. Vista previa en riesgo.
`pro`	600 req/min	Todo lo anterior + riesgo (Boletín Concursal, Diario Oficial).
`business`	6.000 req/min	Todo, incluida inteligencia comercial (licitaciones).

Operaciones contra el SII

Aquí el cuello de botella es el propio SII, no nosotros: el límite existe para no gatillar bloqueos del organismo y aplica igual en todos los planes.

Categoría	Por segundo	Por minuto	Por hora
Emisión de DTE facturas, boletas, notas	4	50	sin tope
Consultas al SII RCV, boletas de honorarios, folios	2	8	150

Un escalón sobre el estándar del mercado. La referencia habitual en Chile es 3/seg y 40/min para emisión, y 1/seg, 5/min y 100/hora para consultas al SII. Cifra entrega más margen en cada ventana, sin costo adicional.

Las respuestas 429 incluyen Retry-After, X-RateLimit-Limit y X-RateLimit-Remaining, y el mensaje indica qué ventana se agotó. Reintenta con backoff exponencial. Puedes consultar tus límites vigentes en cualquier momento con GET /api/v1/cuenta.

Ambientes (certificación y producción)

La facturación electrónica exige que el SII certifique a cada emisor antes de permitirle emitir documentos con validez tributaria. Cifra acompaña las dos etapas con la misma API: solo cambia el ambiente configurado en tu cuenta.

Ambiente	Servidor SII	Para qué sirve
`certificacion`	Maullín	Set de pruebas obligatorio del SII. Los documentos no tienen validez tributaria. Es donde se valida tu implementación antes de operar.
`produccion`	Palena	Emisión real. Requiere haber aprobado la certificación, tener certificado digital vigente y folios (CAF) autorizados.

Estado actual: la emisión corre en modo demo/certificación — genera, calcula y timbra el documento, sin firmarlo ni enviarlo al SII. La activación de producción se habilita por cuenta una vez cargados tu certificado y tus folios.

Formato de respuesta

Todos los datasets responden con el mismo envoltorio, de modo que puedes escribir un cliente genérico. El campo estado_datos te dice siempre el origen real del dato —nunca presentamos una muestra como si fuera oficial.

estado_datos	Significado
`live`	Consultado en tiempo real a la fuente oficial.
`cached`	Dato oficial real, ingerido por un job programado (incluye fecha de ingesta).
`sample`	Muestra representativa: la ingesta aún no corre o la fuente no respondió.

Errores

Los errores usan códigos HTTP estándar y un cuerpo JSON uniforme con error (código estable, seguro para programar contra él) y message (texto legible, puede cambiar).

HTTP	error	Qué hacer
400	`validacion`	Revisa los campos: el detalle viene en `detalles`.
401	`unauthorized`	Falta o es inválida la cabecera `x-api-key`.
403	`plan_insuficiente`	Sube de plan; el requerido viene en `plan_requerido`.
404	`not_found`	Dataset inexistente; la lista válida viene en la respuesta.
429	`rate_limit`	Espera lo que indique `Retry-After` y reintenta.
502	`upstream_error`	La fuente oficial no respondió. Reintenta con backoff.

Ejemplo de error

{
  "error": "plan_insuficiente",
  "message": "El dataset 'boletin-concursal' requiere el plan 'pro'. Tu plan actual es 'free'.",
  "plan_requerido": "pro"
}

Credenciales del SII

Los servicios de boletas de honorarios y del Registro de Compras y Ventas requieren que Cifra se autentique ante el SII en representación del titular, porque el SII no publica una API para esa información. Esto es lo que hacemos con esa credencial, y nos obliga contractualmente.

Garantía	Cómo se cumple
Cifrado en reposo	AES-256-GCM. Se descifra solo durante la consulta que tú solicitas.
Nunca se expone	No aparece en respuestas, logs, auditoría ni mensajes de error. `GET` devuelve solo metadatos.
Solo tus datos	La credencial identifica al contribuyente ante el SII; este solo entrega lo suyo.
Opcional y revocable	Sin ella el resto del servicio funciona igual. `DELETE` la elimina de forma definitiva.
Sin cesión	No se comparte con ningún tercero ni encargado.

Depende del portal del SII. Estas consultas no usan una API oficial: replican lo que hace el sitio del SII. Si el SII cambia su estructura, la consulta puede fallar temporalmente. Trátalo como una fuente que puede intermitir y maneja el 502. Las cuotas son más estrictas (2/seg, 8/min, 150/hora) justamente para no gatillar bloqueos del organismo.

Ver también la Política de Privacidad (sección 3) y los Términos de Servicio (sección 4).

Introducción

GET/api/v1

Catálogo de datasets

Lista todos los datasets disponibles con su plan mínimo y su fuente oficial. Es público: no requiere API key. Úsalo para descubrir la API de forma programática.

Petición

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

Respuesta 200 OK

application/json

{
  "producto": "Cifra API",
  "version": "1.0",
  "datasets": [
    {
      "slug": "indicadores",
      "nombre": "Indicadores económicos",
      "capa": "indicadores",
      "plan_minimo": "free"
    },
    {
      "slug": "boletin-concursal",
      "nombre": "Boletín Concursal",
      "capa": "riesgo",
      "plan_minimo": "pro"
    }
  ]
}

GET/api/v1/cuentaplan free

Estado de tu suscripción

Devuelve el plan asociado a tu API key, los límites vigentes en cada categoría y si tienes certificado digital cargado. Útil para que tu propio sistema verifique su cuota antes de un proceso masivo.

Petición

curl 'https://micifra.cl/api/v1/cuenta' \
  -H 'x-api-key: TU_API_KEY'

Respuesta 200 OK

application/json

{
  "producto": "Cifra API",
  "estado": "activa",
  "plan": "pro",
  "key_prefix": "cifra_live_a1b2c3d4",
  "limites": {
    "datos": {
      "por_minuto": 600
    },
    "dte": {
      "por_segundo": 4,
      "por_minuto": 50
    },
    "sii": {
      "por_segundo": 2,
      "por_minuto": 8,
      "por_hora": 150
    }
  },
  "certificado": {
    "cargado": true,
    "titular_rut": "76000000-0"
  },
  "consultado": "2026-07-26T14:03:11.204Z"
}

Indicadores y tasas

GET/api/v1/indicadoresplan free

Indicadores económicos

UF, UTM, dólar, euro, IPC e IVP del día. Valores oficiales, actualizados diariamente. El caso de uso típico es convertir montos en UF a pesos dentro de tu sistema contable o de facturación.

Fuente oficial: Banco Central de Chile / mindicador.cl

Petición

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

Respuesta 200 OK

application/json

{
  "producto": "Cifra API",
  "dataset": "indicadores",
  "nombre": "Indicadores económicos",
  "capa": "indicadores",
  "fuente": "Banco Central de Chile",
  "estado_datos": "live",
  "actualizado": "2026-07-26T14:03:11.204Z",
  "count": 4,
  "data": [
    {
      "codigo": "uf",
      "nombre": "Unidad de Fomento (UF)",
      "unidad": "Pesos",
      "valor": 39512.44,
      "fecha": "2026-07-26"
    },
    {
      "codigo": "dolar",
      "nombre": "Dólar observado",
      "unidad": "Pesos",
      "valor": 941.3,
      "fecha": "2026-07-26"
    },
    {
      "codigo": "utm",
      "nombre": "Unidad Tributaria Mensual",
      "unidad": "Pesos",
      "valor": 68923,
      "fecha": "2026-07-01"
    },
    {
      "codigo": "ipc",
      "nombre": "Índice de Precios al Consumidor",
      "unidad": "Porcentaje",
      "valor": 0.4,
      "fecha": "2026-06-01"
    }
  ]
}

GET/api/v1/tasa-maxima-convencionalplan free

Tasa Máxima Convencional (TMC)

Tasa máxima legal que puede cobrarse en una operación de crédito, publicada por la CMF. Imprescindible para validar que tus productos de crédito no superen el límite legal.

Fuente oficial: Comisión para el Mercado Financiero (CMF)

Petición

curl 'https://micifra.cl/api/v1/tasa-maxima-convencional' \
  -H 'x-api-key: TU_API_KEY'

Respuesta 200 OK

application/json

{
  "producto": "Cifra API",
  "dataset": "tasa-maxima-convencional",
  "nombre": "Tasa Máxima Convencional",
  "capa": "indicadores",
  "fuente": "CMF",
  "estado_datos": "live",
  "actualizado": "2026-07-26T14:03:11.204Z",
  "count": 2,
  "data": [
    {
      "tramo": "No reajustable menor a 50 UF",
      "plazo": "≥ 90 días",
      "tasa_maxima": 44.28,
      "vigencia": "2026-07"
    },
    {
      "tramo": "No reajustable 50 a 200 UF",
      "plazo": "≥ 90 días",
      "tasa_maxima": 27.12,
      "vigencia": "2026-07"
    }
  ]
}

Cumplimiento tributario

GET/api/v1/validar-rutplan free

Validar RUT

Valida el dígito verificador de un RUT chileno (módulo 11) y lo devuelve normalizado en varios formatos. Úsalo en el onboarding de clientes o proveedores antes de guardar el dato.

Fuente oficial: Algoritmo módulo 11 (Registro Civil)

Parámetros

Parámetro	Tipo	Req.	Descripción
`rut`	string	sí	RUT a validar. Acepta con o sin puntos y guion. Ej: `76252128-8`

Petición

curl 'https://micifra.cl/api/v1/validar-rut?rut=76252128-8' \
  -H 'x-api-key: TU_API_KEY'

Respuesta 200 OK

application/json

{
  "producto": "Cifra API",
  "dataset": "validar-rut",
  "nombre": "Validar RUT",
  "capa": "tributario",
  "fuente": "Módulo 11",
  "estado_datos": "live",
  "actualizado": "2026-07-26T14:03:11.204Z",
  "count": 1,
  "data": [
    {
      "entrada": "76252128-8",
      "valido": true,
      "rut": "76252128-8",
      "cuerpo": "76252128",
      "dv": "8",
      "formateado": "76.252.128-8",
      "tipo": "empresa"
    }
  ]
}

GET/api/v1/sii-actividadesplan free

Actividades económicas del SII

Catálogo completo de códigos de actividad económica (acteco) del SII, con su afectación a IVA. Necesario para emitir DTE y para clasificar clientes o proveedores.

Fuente oficial: Servicio de Impuestos Internos (SII)

Parámetros

Parámetro	Tipo	Req.	Descripción
`q`	string	no	Búsqueda por texto en el nombre de la actividad. Ej: `informática`
`afecta_iva`	boolean	no	Filtra por afectación a IVA (true / false). Ej: `true`

Petición

curl 'https://micifra.cl/api/v1/sii-actividades?q=informatica' \
  -H 'x-api-key: TU_API_KEY'

Respuesta 200 OK

application/json

{
  "producto": "Cifra API",
  "dataset": "sii-actividades",
  "nombre": "Actividades económicas SII",
  "capa": "tributario",
  "fuente": "SII",
  "estado_datos": "cached",
  "actualizado": "2026-07-26T14:03:11.204Z",
  "count": 2,
  "data": [
    {
      "codigo": "620200",
      "nombre": "Actividades de consultoría de informática y gestión de instalaciones informáticas",
      "afecta_iva": true,
      "categoria": "Primera"
    },
    {
      "codigo": "620900",
      "nombre": "Otras actividades de tecnología de la información y de servicios informáticos",
      "afecta_iva": true,
      "categoria": "Primera"
    }
  ]
}

GET/api/v1/feriadosplan free

Feriados legales

Feriados chilenos de un año, con su tipo (civil o religioso) y si son irrenunciables. Se usa para calcular plazos hábiles, fechas de vencimiento y SLA.

Fuente oficial: Ministerio del Interior

Parámetros

Parámetro	Tipo	Req.	Descripción
`anio`	number	no	Año a consultar. Por defecto el año en curso. Ej: `2026`

Petición

curl 'https://micifra.cl/api/v1/feriados?anio=2026' \
  -H 'x-api-key: TU_API_KEY'

Respuesta 200 OK

application/json

{
  "producto": "Cifra API",
  "dataset": "feriados",
  "nombre": "Feriados legales",
  "capa": "tributario",
  "fuente": "Ministerio del Interior",
  "estado_datos": "cached",
  "actualizado": "2026-07-26T14:03:11.204Z",
  "count": 2,
  "data": [
    {
      "fecha": "2026-09-18",
      "nombre": "Independencia Nacional",
      "tipo": "Civil",
      "irrenunciable": true
    },
    {
      "fecha": "2026-09-19",
      "nombre": "Día de las Glorias del Ejército",
      "tipo": "Civil",
      "irrenunciable": true
    }
  ]
}

GET/api/v1/comunasplan free

Regiones y comunas

Las 346 comunas de Chile normalizadas, con su región y código oficial. Sirve para poblar selectores y para normalizar direcciones antes de emitir un DTE.

Fuente oficial: SUBDERE

Parámetros

Parámetro	Tipo	Req.	Descripción
`region`	string	no	Filtra por nombre o número de región. Ej: `Metropolitana`
`q`	string	no	Búsqueda por nombre de comuna. Ej: `providencia`

Petición

curl 'https://micifra.cl/api/v1/comunas?q=providencia' \
  -H 'x-api-key: TU_API_KEY'

Respuesta 200 OK

application/json

{
  "producto": "Cifra API",
  "dataset": "comunas",
  "nombre": "Regiones y comunas",
  "capa": "tributario",
  "fuente": "SUBDERE",
  "estado_datos": "cached",
  "actualizado": "2026-07-26T14:03:11.204Z",
  "count": 1,
  "data": [
    {
      "codigo": "13123",
      "comuna": "Providencia",
      "region": "Metropolitana de Santiago",
      "region_numero": 13,
      "provincia": "Santiago"
    }
  ]
}

GET/api/situacion-tributariaplan free

¿Este RUT puede emitir facturas?

El chequeo que se hace antes de dar de alta a un proveedor o de aceptar su primera factura: si el RUT existe, tiene inicio de actividades, está autorizado a timbrar documentos y con qué giros opera. Devuelve además un veredicto —'puede_emitir_dte'— que el SII no entrega como tal y que Cifra deduce de los campos oficiales: es la única pregunta que de verdad se hace quien consulta. Un proveedor sin inicio de actividades que te emite facturas es la señal clásica de factura falsa, y el crédito fiscal lo pierde quien la recibió. NO requiere la credencial del SII del cliente: el SII publica esta consulta sin autenticación. Para personas naturales el SII enmascara el nombre, y la respuesta lo informa como 'es_persona_natural' sin exponer datos personales.

Fuente oficial: SII — Consulta de situación tributaria de terceros

Parámetros

Parámetro	Tipo	Req.	Descripción
`rut`	string	sí	RUT con dígito verificador. Acepta varios separados por coma (máx. 25); el lote requiere un plan de pago. Ej: `76543210-9`

Petición

curl 'https://micifra.cl/api/situacion-tributaria?rut=76543210-9' \
  -H 'x-api-key: TU_API_KEY'

Respuesta 200 OK

application/json

{
  "producto": "Cifra API",
  "fuente": "SII — Consulta de situación tributaria de terceros",
  "estado_datos": "live",
  "rut": "61608204-3",
  "registrado": true,
  "razon_social": "SERVICIO DE SALUD OCCIDENTE HOSPITAL SAN JUAN DE DIOS",
  "es_persona_natural": false,
  "inicio_actividades": true,
  "fecha_inicio_actividades": "01-01-1993",
  "primera_categoria": true,
  "autorizado_a_timbrar": true,
  "timbraje_electronico": false,
  "giros": [
    {
      "codigo": "869091",
      "descripcion": "OTROS SERVICIOS DE ATENCION DE LA SALUD HUMANA",
      "categoria_tributaria": "1",
      "fecha_inicio": "01-01-1993",
      "afecto_iva": false
    }
  ],
  "observaciones": [],
  "puede_emitir_dte": true,
  "motivo": "Con inicio de actividades y autorizado a timbrar documentos tributarios.",
  "aviso": "El veredicto 'puede_emitir_dte' lo deduce Cifra de los campos oficiales; el SII no lo entrega como tal.",
  "consultado": "2026-08-05T02:10:44.000Z"
}

Riesgo y verificación

GET/api/v1/boletin-concursalplan pro

Boletín Concursal (quiebras y liquidaciones)

Publicaciones oficiales de procedimientos concursales: liquidaciones, reorganizaciones y renegociaciones. El caso de uso central es verificar a una empresa antes de otorgarle crédito o cerrar un contrato.

Fuente oficial: Superintendencia de Insolvencia y Reemprendimiento

Parámetros

Parámetro	Tipo	Req.	Descripción
`q`	string	no	Búsqueda por razón social o RUT del deudor. Ej: `constructora`
`tipo`	string	no	Tipo de procedimiento (liquidacion, reorganizacion, renegociacion). Ej: `liquidacion`
`desde`	date	no	Fecha inicial de publicación (AAAA-MM-DD). Ej: `2026-01-01`
`hasta`	date	no	Fecha final de publicación (AAAA-MM-DD). Ej: `2026-07-26`
`limit`	number	no	Máximo de filas a devolver. Por defecto 50. Ej: `50`
`offset`	number	no	Desplazamiento para paginar. Por defecto 0. Ej: `0`

Petición

curl 'https://micifra.cl/api/v1/boletin-concursal?q=constructora&limit=5' \
  -H 'x-api-key: TU_API_KEY'

Respuesta 200 OK

application/json

{
  "producto": "Cifra API",
  "dataset": "boletin-concursal",
  "nombre": "Boletín Concursal",
  "capa": "riesgo",
  "fuente": "Superintendencia de Insolvencia y Reemprendimiento",
  "estado_datos": "cached",
  "actualizado": "2026-07-26T14:03:11.204Z",
  "count": 1,
  "meta": {
    "total": 19149,
    "limit": 5,
    "offset": 0
  },
  "data": [
    {
      "rut": "76123456-7",
      "nombre": "Constructora Ejemplo SpA",
      "tipo_procedimiento": "Liquidación Voluntaria",
      "tribunal": "2º Juzgado Civil de Santiago",
      "rol": "C-1234-2026",
      "fecha_publicacion": "2026-05-14"
    }
  ]
}

GET/api/v1/diario-oficialplan pro

Diario Oficial (sociedades)

Constituciones, modificaciones y disoluciones de sociedades publicadas en el Diario Oficial. Útil para due diligence y para detectar cambios societarios en tu cartera.

Fuente oficial: Diario Oficial de la República de Chile

Parámetros

Parámetro	Tipo	Req.	Descripción
`q`	string	no	Búsqueda por razón social. Ej: `inversiones`
`tipo`	string	no	Tipo de publicación (constitucion, modificacion, disolucion). Ej: `constitucion`

Petición

curl 'https://micifra.cl/api/v1/diario-oficial?q=inversiones' \
  -H 'x-api-key: TU_API_KEY'

Respuesta 200 OK

application/json

{
  "producto": "Cifra API",
  "dataset": "diario-oficial",
  "nombre": "Diario Oficial",
  "capa": "riesgo",
  "fuente": "Diario Oficial",
  "estado_datos": "cached",
  "actualizado": "2026-07-26T14:03:11.204Z",
  "count": 1,
  "data": [
    {
      "fecha": "2026-07-20",
      "tipo": "Constitución",
      "razon_social": "Inversiones Ejemplo SpA",
      "rut": "77987654-3",
      "extracto": "Constitución de sociedad por acciones..."
    }
  ]
}

Inteligencia comercial

GET/api/v1/licitacionesplan business

Licitaciones públicas (ChileCompra)

Licitaciones del Mercado Público, filtrables por rubro y fecha. Pensado para equipos comerciales que venden al Estado y quieren detectar oportunidades automáticamente.

Fuente oficial: ChileCompra / Mercado Público

Parámetros

Parámetro	Tipo	Req.	Descripción
`codigo`	string	no	Código exacto de la licitación. Ej: `1234-56-LE26`
`fecha`	date	no	Fecha de publicación (AAAA-MM-DD). Ej: `2026-07-25`
`q`	string	no	Búsqueda por texto en el nombre. Ej: `software`

Petición

curl 'https://micifra.cl/api/v1/licitaciones?q=software' \
  -H 'x-api-key: TU_API_KEY'

Respuesta 200 OK

application/json

{
  "producto": "Cifra API",
  "dataset": "licitaciones",
  "nombre": "Licitaciones ChileCompra",
  "capa": "inteligencia",
  "fuente": "ChileCompra",
  "estado_datos": "live",
  "actualizado": "2026-07-26T14:03:11.204Z",
  "count": 1,
  "data": [
    {
      "codigo": "1234-56-LE26",
      "nombre": "Servicio de desarrollo de software",
      "estado": "Publicada",
      "organismo": "Ministerio de Salud",
      "fecha_cierre": "2026-08-15",
      "monto_estimado": 45000000
    }
  ]
}

GET/api/licitaciones/radarplan free

Radar de licitaciones cruzado con tus ventas

Las licitaciones públicas abiertas ahora mismo, con una diferencia: cada una viene marcada según si la publica un organismo al que YA le facturas. El cruce se hace por el RUT de la unidad compradora contra tus documentos de venta del SII, y trae cuánto le has vendido y cuándo fue la última vez. El portal de ChileCompra muestra las mismas ~4.400 licitaciones a todo el mundo porque no sabe quién eres; tu ERP sabe a quién le facturas pero no ve las licitaciones. Funciona sin credencial del SII, entregando el radar sin cruce. Nota: el organismo comprador solo viene en el detalle de cada licitación, una llamada por código, así que primero se filtra por texto y luego se enriquecen las que cierran antes.

Fuente oficial: ChileCompra (Mercado Público) + SII (Registro de Compras y Ventas)

Parámetros

Parámetro	Tipo	Req.	Descripción
`q`	string	no	Texto a buscar en el nombre. Todas las palabras deben aparecer. Ej: `alimentos`
`dias`	number	no	Solo las que cierran dentro de N días. Ej: `5`
`clientes`	boolean	no	'1' para devolver únicamente organismos que ya son tus clientes.
`meses`	number	no	Meses de ventas a revisar para el cruce (1–12, por defecto 6). El plan gratuito usa 1.

Petición

curl 'https://micifra.cl/api/licitaciones/radar?q=alimentos&dias=5' \
  -H 'x-api-key: TU_API_KEY'

Respuesta 200 OK

application/json

{
  "producto": "Cifra API",
  "fuente": "ChileCompra — Mercado Público, cruzado con tu Registro de Compras y Ventas del SII",
  "estado_datos": "live",
  "periodo_cruce": "últimos 6 meses",
  "termino": "alimentos",
  "universo": 4357,
  "coincidencias": 15,
  "analizadas": 6,
  "clientes_conocidos": 42,
  "oportunidades": [
    {
      "codigo": "1233600-43-LE26",
      "nombre": "CONV. SUM. CATERING COFFEE BREAK Y ALIMENTOS",
      "estado": "Publicada",
      "organismo": "CORP MUNICIPAL DE RENCA",
      "rut_comprador": "70.931.100-K",
      "region": "Región Metropolitana de Santiago",
      "comuna": "Renca",
      "monto_estimado": null,
      "moneda": "CLP",
      "fecha_cierre": "2026-08-04T15:00:00",
      "dias_para_cierre": 1,
      "items": [
        {
          "categoria": "Servicios de distribución de alimentos",
          "producto": "Servicio de catering",
          "cantidad": 1,
          "unidad": "Unidad"
        }
      ],
      "url": "https://www.mercadopublico.cl/Procurement/Modules/RFB/DetailsAcquisition.aspx?idlicitacion=1233600-43-LE26",
      "relacion": "cliente",
      "historial": {
        "documentos": 2,
        "monto": 6600000,
        "ultima_venta": "2026-07-03"
      }
    },
    {
      "codigo": "3000-27-LE26",
      "nombre": "300 Cajas de Alimentos SOCIAL",
      "estado": "Publicada",
      "organismo": "I MUNICIPALIDAD DE MONTEPATRIA",
      "rut_comprador": "69.040.800-7",
      "region": "Región de Coquimbo",
      "monto_estimado": 8500000,
      "moneda": "CLP",
      "dias_para_cierre": 1,
      "relacion": "nuevo"
    }
  ],
  "aviso": "Las licitaciones vienen de Mercado Público en tiempo real. La clasificación como cliente se basa en tus documentos de venta del SII. No verifica que puedas ofertar ni que cumplas las bases.",
  "consultado": "2026-08-03T14:20:11.004Z"
}

GET/api/radar/busquedasplan pro

Búsquedas guardadas del radar

Lo que quieres que vigilemos. Cada mañana revisamos las licitaciones abiertas contra tus búsquedas guardadas y generamos alertas. Un radar que hay que ir a mirar sirve poco: las licitaciones cierran en uno o dos días. POST guarda una búsqueda (nombre, término, plazo de cierre, solo clientes, aviso por correo), DELETE ?id=N la borra y PATCH ?id=N&activa=0 la pausa sin perder el historial de lo ya mostrado. Máximo 10 por cuenta.

Fuente oficial: Cifra

Parámetros

Parámetro	Tipo	Req.	Descripción
`nombre`	string	sí	Cómo identificas esta búsqueda. Ej: `Alimentos en la Araucanía`
`termino`	string	no	Palabras que deben aparecer todas en el nombre de la licitación.
`dias_maximos`	number	no	Avisar solo de las que cierran dentro de N días.
`solo_clientes`	boolean	no	Avisar únicamente de organismos a los que ya le facturas.
`notificar_email`	boolean	no	Resumen diario por correo además del panel. Por defecto true.

Petición

curl 'https://micifra.cl/api/radar/busquedas' \
  -H 'x-api-key: TU_API_KEY'

Respuesta 200 OK

application/json

{
  "producto": "Cifra API",
  "maximo": 10,
  "busquedas": [
    {
      "id": 3,
      "nombre": "Alimentos en la Araucanía",
      "termino": "alimentos",
      "dias_maximos": 7,
      "solo_clientes": false,
      "notificar_email": true,
      "activa": true,
      "creada": "2026-08-01",
      "ultima_revision": "2026-08-03T12:00:11Z",
      "sin_leer": 4
    }
  ]
}

GET/api/radar/alertasplan pro

Bandeja de alertas del radar

Lo que apareció mientras no estabas. Tres clases: 'nueva' (una licitación que calza y que nunca te habíamos mostrado), 'cierra_pronto' (algo que ya viste cierra en 48 horas) y 'cambio_estado' (salió del listado de abiertas: se adjudicó, quedó desierta o se revocó). El orden NO es cronológico: primero lo no leído, dentro de eso lo de organismos que ya son clientes, y dentro de eso lo que cierra antes — el orden en que conviene atenderlas. PATCH con { ids: [...] } o { todas: true } las marca como leídas.

Fuente oficial: ChileCompra + tu Registro de Compras y Ventas del SII

Parámetros

Parámetro	Tipo	Req.	Descripción
`sin_leer`	boolean	no	'1' para devolver solo las no leídas.
`limite`	number	no	Máximo de alertas a devolver (1–200, por defecto 50).

Petición

curl 'https://micifra.cl/api/radar/alertas?sin_leer=1&limite=50' \
  -H 'x-api-key: TU_API_KEY'

Respuesta 200 OK

application/json

{
  "producto": "Cifra API",
  "sin_leer": 4,
  "alertas": [
    {
      "id": 128,
      "busqueda_id": 3,
      "busqueda_nombre": "Alimentos en la Araucanía",
      "clase": "nueva",
      "codigo": "1233600-43-LE26",
      "nombre": "CONV. SUM. CATERING COFFEE BREAK Y ALIMENTOS",
      "organismo": "CORP MUNICIPAL DE RENCA",
      "rut_comprador": "70.931.100-K",
      "region": "Región Metropolitana de Santiago",
      "monto_estimado": null,
      "dias_para_cierre": 1,
      "es_cliente": true,
      "detalle": "Organismo al que ya le facturas. Llegas con historial, no de cero.",
      "leida": false,
      "creada": "2026-08-03T12:00:08Z"
    }
  ],
  "consultado": "2026-08-03T14:20:11.004Z"
}

GET/api/licitaciones/informeplan pro

Informe consolidado de compras públicas

Cuánto se está licitando, quién compra, en qué territorio y con qué urgencia. Es la vista de gestión y auditoría frente a la operativa del radar. IMPORTANTE sobre el monto: buena parte de los organismos NO publica el monto estimado, así que el total viene siempre acompañado de `cobertura_monto` — cuántas licitaciones lo respaldan. El total es un piso, no el tamaño del mercado. Los filtros de región, organismo y monto se aplican sobre el detalle ya traído, porque Mercado Público acepta el parámetro `region` y lo ignora. Con formato=csv devuelve el archivo con los MISMOS filtros de la consulta.

Fuente oficial: ChileCompra — Mercado Público

Parámetros

Parámetro	Tipo	Req.	Descripción
`q`	string	no	Texto en el nombre de la licitación. Ej: `alimentos`
`dias`	number	no	Solo las que cierran dentro de N días.
`region`	string	no	Filtra por región del organismo comprador (coincidencia parcial).
`organismo`	string	no	Filtra por nombre del organismo (coincidencia parcial).
`monto_min`	number	no	Monto estimado mínimo en pesos.
`con_monto`	boolean	no	'1' para excluir las que no publican monto.
`muestra`	number	no	Cuántas enriquecer con su detalle (10–120, por defecto 60).
`formato`	string	no	'csv' para descargar. Separador ';' y BOM UTF-8, para Excel en español.

Petición

curl 'https://micifra.cl/api/licitaciones/informe?q=alimentos&region=araucania&dias=15' \
  -H 'x-api-key: TU_API_KEY'

Respuesta 200 OK

application/json

{
  "producto": "Cifra API",
  "fuente": "ChileCompra — Mercado Público",
  "estado_datos": "live",
  "filtro": {
    "termino": "alimentos",
    "dias": 15,
    "region": "araucania",
    "organismo": null,
    "monto_min": null,
    "con_monto": false
  },
  "universo": 76,
  "enriquecidas": 60,
  "analizadas": 9,
  "cobertura_monto": {
    "con_monto_publicado": 6,
    "sin_monto_publicado": 3,
    "porcentaje": 66.7
  },
  "monto_total_publicado": 421500000,
  "urgencia": {
    "cierra_hoy": 1,
    "en_2_dias": 3,
    "en_7_dias": 4,
    "mas_de_7": 1
  },
  "opciones": {
    "regiones": [
      "Región de la Araucanía",
      "Región Metropolitana de Santiago"
    ],
    "organismos": [
      "I MUNICIPALIDAD DE PITRUFQUEN"
    ]
  },
  "por_organismo": [
    {
      "organismo": "SERVICIO DE SALUD ARAUCANIA SUR",
      "rut": "61.602.230-K",
      "region": "Región de la Araucanía",
      "licitaciones": 3,
      "monto": 218000000,
      "con_monto": 2
    }
  ],
  "por_region": [
    {
      "region": "Región de la Araucanía",
      "licitaciones": 9,
      "monto": 421500000,
      "con_monto": 6
    }
  ],
  "aviso": "Se enriquecieron 60 licitaciones de las 76 que coinciden con el texto y de esas quedaron 9 tras aplicar los filtros. 3 no publican monto estimado, así que el total es un piso.",
  "consultado": "2026-08-03T14:20:11.004Z"
}

Facturación electrónica (DTE)

POST/api/dte/emitirplan free

Emitir documento tributario electrónico

Genera, calcula totales y timbra un DTE (factura 33, factura exenta 34, boleta 39, nota de débito 56 o nota de crédito 61). Devuelve el XML del documento y el timbre PDF417 en PNG (base64). Con certificado y folios CAF cargados, el documento queda listo para firmar y enviar al SII.

Parámetros

Parámetro	Tipo	Req.	Descripción
`tipo`	number	sí	Tipo de DTE: 33 factura, 34 factura exenta, 39 boleta, 56 nota de débito, 61 nota de crédito. Ej: `33`
`folio`	number	no	Folio del documento. Si se omite, se asigna uno de prueba. Ej: `1024`
`emisor`	object	sí	Datos del emisor: rut, razonSocial, giro, acteco, direccion, comuna.
`receptor`	object	no	Datos del receptor: rut, razonSocial. Opcional en boletas (39).
`items`	array	sí	Líneas del documento: nombre, cantidad, precioUnitario.
`referencia`	object	no	Requerido en notas (56 y 61): tipoDocRef, folioRef, fechaRef, codigo, razon.

Petición

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

Respuesta 200 OK

application/json

{
  "estado": "demo",
  "nota": "Modo demo: documento generado y timbrado, sin firma ni envío al SII.",
  "tipoDte": 33,
  "folio": 1024,
  "fecha": "2026-07-26",
  "totales": {
    "neto": 100000,
    "iva": 19000,
    "exento": 0,
    "total": 119000
  },
  "timbre": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUg...",
  "xml": "<?xml version=\"1.0\"?><DTE version=\"1.0\">...</DTE>"
}

POST/api/dte/pdfplan free

Representación impresa (PDF)

Devuelve el PDF del documento listo para imprimir o enviar por correo. Un solo endpoint cubre los tres formatos y la variante cedible: hoja carta para oficina, y rollo térmico de 80 mm o 58 mm para punto de venta. Con cedible: true agrega la leyenda CEDIBLE y el recuadro de acuse de recibo de la Ley 19.983, necesario para ceder la factura a un factoring.

Parámetros

Parámetro	Tipo	Req.	Descripción
`formato`	string	no	carta (por defecto), 80mm o 58mm. Ej: `carta`
`cedible`	boolean	no	Agrega leyenda CEDIBLE y acuse de recibo. Por defecto false. Ej: `true`
`salida`	string	no	pdf devuelve el binario (por defecto); base64 lo devuelve dentro del JSON. Ej: `base64`
`resolucion`	object	no	Resolución del SII que autoriza al emisor: { numero, anio }.
`tipo · emisor · receptor · items`	—	sí	Mismos campos que /api/dte/emitir.

Petición

curl -X POST 'https://micifra.cl/api/dte/pdf' \
  -H 'x-api-key: TU_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "tipo": 33,
  "formato": "carta",
  "cedible": true,
  "emisor": {
    "rut": "76000000-0",
    "razonSocial": "Mi Empresa SpA",
    "giro": "Servicios de consultoría",
    "acteco": "620200",
    "direccion": "Av. Providencia 1234",
    "comuna": "Providencia"
  },
  "receptor": {
    "rut": "77000000-1",
    "razonSocial": "Cliente Ltda"
  },
  "items": [
    {
      "nombre": "Asesoría profesional",
      "cantidad": 1,
      "precioUnitario": 850000
    }
  ]
}'

Respuesta 200 OK

application/json

{
  "// salida: pdf": "devuelve el binario con Content-Type: application/pdf",
  "// salida: base64": "devuelve este JSON",
  "estado": "ok",
  "tipoDte": 33,
  "folio": 1024,
  "formato": "carta",
  "cedible": true,
  "nombre": "dte-33-1024.pdf",
  "mime": "application/pdf",
  "bytes": 10716,
  "pdf_base64": "JVBERi0xLjMKJf////8KOCAwIG9iago8PAovVHlwZSA..."
}

Folios (CAF)

GET/api/dte/foliosplan free

Consultar folios disponibles

Lista los rangos de folios (CAF) cargados, con cuántos quedan disponibles, cuántos se han usado y cuál es el siguiente. Consúltalo antes de un proceso de facturación masiva para no quedarte sin folios a mitad de camino.

Parámetros

Parámetro	Tipo	Req.	Descripción
`tipo`	number	no	Filtra por tipo de DTE (33, 39, …). Ej: `33`

Petición

curl 'https://micifra.cl/api/dte/folios?tipo=33' \
  -H 'x-api-key: TU_API_KEY'

Respuesta 200 OK

application/json

{
  "producto": "Cifra API",
  "total_disponibles": 7,
  "rangos": [
    {
      "id": 1,
      "tipo_dte": 33,
      "rut_emisor": "76000000-0",
      "desde": 500,
      "hasta": 509,
      "siguiente": 503,
      "disponibles": 7,
      "usados": 3,
      "agotado": false,
      "anulado": false,
      "fecha_autorizacion": "2026-07-01",
      "creado": "2026-07-26T14:03:11.204Z"
    }
  ],
  "consultado": "2026-07-26T14:05:00.000Z"
}

POST/api/dte/foliosplan free

Cargar un CAF del SII

Registra un archivo CAF (Código de Autorización de Folios) tal como lo entrega el SII. Desde ese momento, las emisiones que no indiquen folio toman automáticamente el siguiente disponible. El CAF contiene la llave privada con la que se firma el timbre, por lo que se guarda cifrado con AES-256-GCM.

Parámetros

Parámetro	Tipo	Req.	Descripción
`caf`	string	sí	Contenido XML del archivo CAF entregado por el SII.

Petición

curl -X POST 'https://micifra.cl/api/dte/folios' \
  -H 'x-api-key: TU_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "caf": "<AUTORIZACION><CAF version=\"1.0\"><DA><RE>76000000-0</RE><TD>33</TD><RNG><D>500</D><H>509</H></RNG><FA>2026-07-01</FA>...</DA>...</CAF><RSASK>...</RSASK></AUTORIZACION>"
}'

Respuesta 200 OK

application/json

{
  "estado": "cargado",
  "id": 1,
  "tipo_dte": 33,
  "rut_emisor": "76000000-0",
  "desde": 500,
  "hasta": 509,
  "cantidad": 10,
  "fecha_autorizacion": "2026-07-01"
}

Boletas de honorarios (BHE)

POST/api/sii/credencialesplan free

Conectar tu cuenta del SII

Guarda el RUT y la Clave Tributaria con los que Cifra consultará tu información ante el SII. La clave se cifra con AES-256-GCM antes de almacenarse y solo se descifra durante la consulta que tú pides: nunca se muestra, nunca se registra y nunca se cede a terceros. Es opcional y puedes eliminarla en cualquier momento con DELETE al mismo endpoint. GET devuelve el estado sin exponer la clave.

Parámetros

Parámetro	Tipo	Req.	Descripción
`rut`	string	sí	RUT del contribuyente. Se valida el dígito verificador. Ej: `12345678-9`
`clave`	string	sí	Clave Tributaria del SII.

Petición

curl -X POST 'https://micifra.cl/api/sii/credenciales' \
  -H 'x-api-key: TU_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "rut": "12345678-9",
  "clave": "«tu clave del SII»"
}'

Respuesta 200 OK

application/json

{
  "estado": "guardada",
  "rut": "12345678-9"
}

GET/api/bheplan free

Consultar boletas de honorarios

Devuelve tus boletas de honorarios electrónicas, emitidas o recibidas, con los totales del período ya calculados (bruto, retención y líquido). Requiere haber conectado tu cuenta del SII. Solo entrega documentos del propio contribuyente autenticado. El informe anual no lista boletas una a una: devuelve el resumen por mes en 'resumen_mensual'.

Fuente oficial: Servicio de Impuestos Internos (SII)

Parámetros

Parámetro	Tipo	Req.	Descripción
`direccion`	string	no	recibidas (por defecto) o emitidas. Ej: `recibidas`
`periodicidad`	string	no	mensual (por defecto), anual o diario. Ej: `mensual`
`anio`	number	no	Año a consultar. Por defecto, el año en curso. Ej: `2026`
`mes`	number	no	Mes 1-12. Requerido en mensual y diario. Ej: `7`
`dia`	number	no	Día 1-31. Solo para periodicidad diaria. Ej: `15`

Petición

curl 'https://micifra.cl/api/bhe?direccion=recibidas&periodicidad=mensual&anio=2026&mes=7' \
  -H 'x-api-key: TU_API_KEY'

Respuesta 200 OK

application/json

{
  "producto": "Cifra API",
  "fuente": "Servicio de Impuestos Internos (SII)",
  "estado_datos": "live",
  "direccion": "recibidas",
  "periodicidad": "mensual",
  "periodo": {
    "anio": 2026,
    "mes": 7
  },
  "contribuyente": {
    "nombre": "JUAN PÉREZ SOTO",
    "rut": "12345678-9",
    "total_boletas": 1
  },
  "count": 1,
  "totales": {
    "boletas_vigentes": 1,
    "boletas_anuladas": 0,
    "honorarios_brutos": 35000,
    "retencion": 0,
    "liquido": 35000
  },
  "boletas": [
    {
      "folio": 514,
      "fecha_emision": "07/07/2026",
      "rut_contraparte": "16012074-6",
      "nombre_contraparte": "EMPRESA EJEMPLO SPA",
      "monto_bruto": 35000,
      "retencion": 0,
      "monto_liquido": 35000,
      "anulada": false,
      "fecha_anulacion": null,
      "codigo_barras": "1601207400514F555950",
      "codigo_comuna": "8201",
      "sociedad_profesional": false
    }
  ],
  "consultado": "2026-07-26T14:03:11.204Z"
}

GET/api/bhe/pdfplan free

PDF oficial de una boleta

Devuelve el documento tal como lo emite el SII, listo para archivar o enviar. La boleta se identifica por su código de barras (no por folio), que viene en el campo codigo_barras de cada fila de /api/bhe.

Parámetros

Parámetro	Tipo	Req.	Descripción
`codigo`	string	sí	Código de barras de la boleta. Ej: `1601207400514F555950`
`direccion`	string	no	recibidas (por defecto) o emitidas. Ej: `recibidas`

Petición

curl 'https://micifra.cl/api/bhe/pdf?codigo=1601207400514F555950' \
  -H 'x-api-key: TU_API_KEY'

Respuesta 200 OK

application/json

{
  "// binario": "Devuelve application/pdf directamente, no JSON.",
  "Content-Type": "application/pdf",
  "Content-Disposition": "inline; filename=\"boleta-1601207400514F555950.pdf\""
}

GET/api/bhe/exportplan free

Exportar boletas a Excel

Descarga las boletas del período como planilla CSV con BOM UTF-8 y separador punto y coma: se abre directo en Excel con configuración chilena, sin importar ni corregir tildes. En periodicidad anual exporta el resumen por mes en vez del detalle.

Parámetros

Parámetro	Tipo	Req.	Descripción
`direccion`	string	no	recibidas (por defecto) o emitidas.
`periodicidad`	string	no	mensual (por defecto) o anual.
`anio`	number	no	Año a exportar. Ej: `2026`
`mes`	number	no	Mes 1-12, en periodicidad mensual. Ej: `7`

Petición

curl 'https://micifra.cl/api/bhe/export?direccion=recibidas&periodicidad=mensual&anio=2026&mes=7' \
  -H 'x-api-key: TU_API_KEY'

Respuesta 200 OK

application/json

{
  "// binario": "Devuelve text/csv como descarga, no JSON.",
  "Content-Type": "text/csv; charset=utf-8",
  "Content-Disposition": "attachment; filename=\"boletas-recibidas-2026-07.csv\"",
  "// columnas": "Folio; Fecha; RUT contraparte; Nombre contraparte; Bruto; Retención; Líquido; Estado; Código de barras; Comuna"
}

Compras y Ventas (RCV)

GET/api/rcvplan free

Registro de Compras y Ventas

Tu RCV del SII: totales por tipo de documento y, si lo pides, el detalle uno a uno con folio, RUT de la contraparte, fecha y montos. Es la fuente cruda sobre la que se calculan el Control de IVA y la conciliación. Las notas de crédito restan en los totales aunque el SII las informe con signo positivo.

Fuente oficial: SII — Registro de Compras y Ventas

Parámetros

Parámetro	Tipo	Req.	Descripción
`periodo`	string	no	AAAA-MM. Por defecto, el mes en curso. Ej: `2026-07`
`operacion`	string	no	'compra' (por defecto) o 'venta'.
`estado`	string	no	REGISTRO (por defecto) alimenta el F29 · PENDIENTE son documentos a la espera de acuse de recibo, cuyo IVA todavía NO es crédito · NO_INCLUIR y RECLAMADO quedan excluidos.
`detalle`	boolean	no	'1' para incluir los documentos uno a uno.
`tipo`	number	no	Código de documento del SII (33 factura, 61 nota de crédito…). Trae el detalle de UN solo tipo: es una llamada al portal en vez de una por cada tipo del período. Sin este parámetro se recorren todos. Ej: `33`

Petición

curl 'https://micifra.cl/api/rcv?periodo=2026-07&operacion=compra&detalle=1' \
  -H 'x-api-key: TU_API_KEY'

Respuesta 200 OK

application/json

{
  "producto": "Cifra API",
  "fuente": "Servicio de Impuestos Internos (SII) — Registro de Compras y Ventas",
  "estado_datos": "live",
  "contribuyente": {
    "rut": "76543210-9"
  },
  "periodo": "2026-07",
  "operacion": "compra",
  "estado": "REGISTRO",
  "factor_proporcionalidad": 1,
  "totales": {
    "documentos": 57,
    "neto": 18095858,
    "exento": 0,
    "iva": 3438218,
    "otros_impuestos": 169439,
    "total": 21702283
  },
  "count": 2,
  "resumen": [
    {
      "tipo_dte": 33,
      "nombre": "Factura Electrónica",
      "documentos": 55,
      "monto_exento": 0,
      "monto_neto": 18396306,
      "monto_iva": 3495303,
      "iva_no_recuperable": 0,
      "iva_uso_comun": 0,
      "monto_total": 22061048,
      "otros_impuestos": 169439
    },
    {
      "tipo_dte": 61,
      "nombre": "Nota de Crédito Electrónica",
      "documentos": 2,
      "monto_exento": 0,
      "monto_neto": 300448,
      "monto_iva": 57085,
      "iva_no_recuperable": 0,
      "iva_uso_comun": 0,
      "monto_total": 358765,
      "otros_impuestos": 1232
    }
  ],
  "documentos": [
    {
      "tipo_dte": 33,
      "folio": 179681756,
      "rut_contraparte": "96989120",
      "razon_social": "COMERCIAL CCU S.A.",
      "fecha_emision": "22/07/2026",
      "monto_neto": 316615,
      "monto_iva": 60157,
      "monto_total": 382788
    }
  ],
  "count_documentos": 57,
  "sin_datos": false,
  "consultado": "2026-07-30T18:12:04.117Z"
}

Control de IVA

GET/api/ivaplan free

Proyección del IVA del período

Calcula la línea de IVA del F29 —débito menos crédito menos remanente— con lo que el SII tiene registrado en el Registro de Compras y Ventas. Si el período sigue abierto, proyecta el cierre extrapolando por días transcurridos e informa el nivel de confianza. El remanente del período anterior se reconstruye automáticamente contra el SII: se camina hacia atrás hasta el último mes que terminó pagando, porque ese corta la cadena. Para probar la forma de la respuesta sin credenciales ni cuenta del SII, existe GET /api/demo/iva: devuelve exactamente esta estructura, calculada con el mismo motor, sobre una empresa de ejemplo.

Fuente oficial: SII — Registro de Compras y Ventas

Parámetros

Parámetro	Tipo	Req.	Descripción
`periodo`	string	no	AAAA-MM. Por defecto, el mes en curso. Ej: `2026-07`
`remanente`	number	no	Remanente de crédito fiscal del período anterior. Si se omite, se calcula automáticamente.
`simular`	number	no	Monto neto de una compra hipotética: devuelve cuánto bajaría el pago.
`detalle`	boolean	no	'1' para incluir los documentos uno a uno. Consume más consultas al SII.
`proveedores`	boolean	no	'1' para agrupar las compras por proveedor, con su participación en el gasto.
`diario`	boolean	no	'1' para incluir el desglose diario de boletas electrónicas.

Petición

curl 'https://micifra.cl/api/iva?periodo=2026-07' \
  -H 'x-api-key: TU_API_KEY'

Respuesta 200 OK

application/json

{
  "producto": "Cifra API",
  "fuente": "Servicio de Impuestos Internos (SII) — Registro de Compras y Ventas",
  "estado_datos": "live",
  "contribuyente": {
    "rut": "76543210-9"
  },
  "periodo": "2026-07",
  "factor_proporcionalidad": 1,
  "resumen": {
    "ventas": [
      {
        "tipo_dte": 39,
        "nombre": "Total Oper. del mes Boleta Electr.",
        "documentos": 324,
        "monto_neto": 4460924,
        "monto_iva": 847579,
        "iva_no_recuperable": 0,
        "iva_uso_comun": 0,
        "monto_total": 5308503
      }
    ],
    "compras": [
      {
        "tipo_dte": 33,
        "nombre": "Factura Electrónica",
        "documentos": 55,
        "monto_neto": 17424894,
        "monto_iva": 3367820,
        "iva_no_recuperable": 0,
        "iva_uso_comun": 0,
        "monto_total": 20792714
      },
      {
        "tipo_dte": 61,
        "nombre": "Nota de Crédito Electrónica",
        "documentos": 2,
        "monto_neto": 300448,
        "monto_iva": 57085,
        "iva_no_recuperable": 0,
        "iva_uso_comun": 0,
        "monto_total": 358765
      }
    ]
  },
  "proyeccion": {
    "periodo": "2026-07",
    "dias_con_datos": 29,
    "dias_del_periodo": 31,
    "parcial": true,
    "ventas": {
      "documentos": 2595,
      "neto": 38224037,
      "iva": 7262572,
      "total": 45486609
    },
    "compras": {
      "documentos": 57,
      "neto": 17424894,
      "iva": 3310735,
      "total": 20433949
    },
    "posicion_actual": 3951837,
    "remanente_anterior": 0,
    "a_pagar_hoy": 3951837,
    "remanente_hoy": 0,
    "proyectado": {
      "debito": 7763232,
      "credito": 3539720,
      "a_pagar": 4223512,
      "remanente": 0
    },
    "confianza": "alta",
    "vence": "2026-08-20",
    "dias_para_vencer": 22
  },
  "remanente": {
    "aplicado": 0,
    "origen": "calculado",
    "periodos_revisados": 1,
    "truncada": false
  },
  "ppm": {
    "periodo": "2026-07",
    "base_imponible": 38224063,
    "tasa": 0.1,
    "monto": 38224,
    "categoria_tributaria": 1,
    "es_propyme": true,
    "en_plazo": true
  },
  "retenciones": {
    "periodo": "2026-07",
    "boletas": 1,
    "honorarios_brutos": 149123,
    "retencion": 21623,
    "liquido": 127500,
    "tasa_implicita": 14.5,
    "anuladas": 0
  },
  "total_f29": {
    "iva": 3951837,
    "ppm": 38224,
    "retenciones": 21623,
    "total": 4011684,
    "proyectado": 4283359,
    "incompleto": true,
    "falta": "No incluye impuestos adicionales declarables ni créditos especiales (capacitación SENCE y similares), que dependen de información que el SII no expone."
  },
  "otros_impuestos": {
    "compras": 169439,
    "ventas": 0,
    "nota": "Impuestos adicionales incluidos en tus documentos: ILA de bebidas alcohólicas y analcohólicas, tabacos o combustibles. NO se sumaron al crédito fiscal: según tu giro pueden ser recuperables o formar parte del costo."
  },
  "pendientes_de_acuse": {
    "documentos": 8,
    "neto": 4188055,
    "iva": 795730,
    "a_pagar_si_se_registran": 3156107
  },
  "aviso": "Esta cifra es la LÍNEA DE IVA del F29 (débito menos crédito). El total que efectivamente pagas puede diferir: el F29 incluye además PPM, retenciones de honorarios e impuestos adicionales, que no se obtienen del RCV.",
  "consultado": "2026-07-30T18:12:04.117Z"
}

GET/api/iva/historicoplan free

Evolución del IVA

Serie de los últimos períodos con débito, crédito, lo pagado y la carga efectiva sobre las ventas netas. Los remanentes se encadenan entre períodos, así que la serie es coherente y no una suma de meses sueltos. El promedio excluye el período en curso, que está incompleto y lo distorsionaría.

Fuente oficial: SII — Registro de Compras y Ventas

Parámetros

Parámetro	Tipo	Req.	Descripción
`meses`	number	no	Cuántos períodos hacia atrás, entre 1 y 12. Por defecto 6.

Petición

curl 'https://micifra.cl/api/iva/historico?meses=6' \
  -H 'x-api-key: TU_API_KEY'

Respuesta 200 OK

application/json

{
  "producto": "Cifra API",
  "estado_datos": "live",
  "contribuyente": {
    "rut": "76543210-9"
  },
  "meses": 6,
  "serie": [
    {
      "periodo": "2026-05",
      "debito": 8103455,
      "credito": 3495845,
      "remanente_inicial": 0,
      "a_pagar": 4607610,
      "remanente": 0,
      "ventas_neto": 41200000,
      "compras_neto": 18399184,
      "carga_efectiva": 11.18
    },
    {
      "periodo": "2026-06",
      "debito": 8047823,
      "credito": 4389903,
      "remanente_inicial": 0,
      "a_pagar": 3657920,
      "remanente": 0,
      "ventas_neto": 42340000,
      "compras_neto": 23104752,
      "carga_efectiva": 8.64
    }
  ],
  "promedio_a_pagar": 3470714,
  "consultado": "2026-07-30T18:12:04.117Z"
}

GET/api/f29plan free

PPM y declaración del F29

Lo que el Registro de Compras y Ventas NO tiene: el Pago Provisional Mensual, con la base imponible y la tasa que el propio SII asigna al contribuyente, y la declaración del período si ya fue presentada. Sin el PPM, la cifra de IVA subestima el desembolso real del mes.

Fuente oficial: SII — Propuesta del Formulario 29

Parámetros

Parámetro	Tipo	Req.	Descripción
`periodo`	string	no	AAAA-MM. Por defecto, el mes en curso. Ej: `2026-07`

Petición

curl 'https://micifra.cl/api/f29?periodo=2026-07' \
  -H 'x-api-key: TU_API_KEY'

Respuesta 200 OK

application/json

{
  "producto": "Cifra API",
  "fuente": "Servicio de Impuestos Internos (SII) — Propuesta del Formulario 29",
  "estado_datos": "live",
  "periodo": "2026-07",
  "contribuyente": {
    "rut": "76543210-9",
    "nombre": "COMERCIAL EJEMPLO SPA",
    "direccion": "AV. PRINCIPAL Nº:514, ANGOL",
    "comuna": "ANGOL",
    "categoria_tributaria": 1
  },
  "ppm": {
    "periodo": "2026-07",
    "base_imponible": 38224063,
    "tasa": 0.1,
    "monto": 38224,
    "categoria_tributaria": 1,
    "es_propyme": true,
    "en_plazo": true
  },
  "declaracion": {
    "periodo": "2026-07",
    "declarado": false,
    "detalle": []
  },
  "aviso": "El PPM se calcula sobre los ingresos brutos que el SII tiene cargados, que a mitad de período están incompletos. No incluye retenciones de honorarios, impuestos adicionales ni créditos especiales.",
  "consultado": "2026-07-30T18:12:04.117Z"
}

GET/api/boletas-diariasplan free

Boletas electrónicas día por día

Desglose diario de tus boletas: documentos, neto, IVA y total por jornada, más el mejor día del período y el promedio sobre los días con venta. El SII no entrega la boleta individual —no identifica al receptor— así que esta es la granularidad máxima disponible. Suele estar más actualizado que el resumen mensual del RCV.

Fuente oficial: SII — Registro de Compras y Ventas (boletas diarias)

Parámetros

Parámetro	Tipo	Req.	Descripción
`periodo`	string	no	AAAA-MM. Por defecto, el mes en curso. Ej: `2026-07`
`tipo`	number	no	39 boleta electrónica (por defecto) o 41 boleta exenta.

Petición

curl 'https://micifra.cl/api/boletas-diarias?periodo=2026-07' \
  -H 'x-api-key: TU_API_KEY'

Respuesta 200 OK

application/json

{
  "producto": "Cifra API",
  "estado_datos": "live",
  "contribuyente": {
    "rut": "76543210-9"
  },
  "periodo": "2026-07",
  "tipo_dte": 39,
  "documentos": 335,
  "monto_neto": 4563882,
  "monto_exento": 0,
  "monto_iva": 867141,
  "monto_total": 5431023,
  "promedio_diario": 217241,
  "mejor_dia": {
    "dia": 25,
    "documentos": 19,
    "monto_neto": 315380,
    "monto_exento": 0,
    "monto_iva": 59922,
    "monto_total": 375302,
    "modificado": false
  },
  "dias": [
    {
      "dia": 1,
      "documentos": 13,
      "monto_neto": 159949,
      "monto_exento": 0,
      "monto_iva": 30391,
      "monto_total": 190340,
      "modificado": false
    },
    {
      "dia": 2,
      "documentos": 12,
      "monto_neto": 154714,
      "monto_exento": 0,
      "monto_iva": 29396,
      "monto_total": 184110,
      "modificado": false
    }
  ],
  "count": 25,
  "consultado": "2026-07-30T18:12:04.117Z"
}

GET/api/iva/exportplan free

Exportar el período a Excel

Devuelve el período completo en CSV: la determinación de la línea de IVA, el crédito pendiente de acuse, los resúmenes por tipo de documento y el detalle documento a documento. Separador ';', coma decimal y BOM UTF-8, que es lo que Excel en español necesita para abrirlo sin romper acentos ni juntar todo en una celda.

Fuente oficial: SII — Registro de Compras y Ventas

Parámetros

Parámetro	Tipo	Req.	Descripción
`periodo`	string	no	AAAA-MM. Por defecto, el mes en curso. Ej: `2026-07`
`detalle`	boolean	no	'0' para omitir el detalle documento a documento y generar más rápido.

Petición

curl 'https://micifra.cl/api/iva/export?periodo=2026-07' \
  -H 'x-api-key: TU_API_KEY'

Respuesta 200 OK

application/json

{
  "// tipo": "text/csv; charset=utf-8",
  "Content-Disposition": "attachment; filename=\"iva-76543210-9-2026-07.csv\"",
  "// contenido": "Bloques: determinación del IVA · crédito pendiente · resumen de ventas · resumen de compras · detalle"
}

GET/api/f29/propuestaplan free

Propuesta del F29, código por código

El formulario armado: cada recuadro del F29 con su código, su valor y de dónde salió. Reúne en una sola llamada lo que hoy exige entrar a cuatro pantallas distintas del SII —registro de compras, registro de ventas, propuesta de PPM y boletas de honorarios recibidas— y ya aplica el remanente encadenado del período anterior. NO presenta la declaración: eso tiene peso legal y lo hace el contribuyente. Si el período ya fue declarado, devuelve además la comparación entre lo declarado y lo que el SII tiene registrado, que es como se revisa un período hacia atrás. Cada línea trae 'unidad' porque el formulario mezcla pesos, cantidades de documentos y porcentajes: formatear la tasa de PPM como moneda la muestra como $0.

Fuente oficial: SII — Registro de Compras y Ventas, propuesta de PPM y boletas de honorarios

Parámetros

Parámetro	Tipo	Req.	Descripción
`periodo`	string	no	AAAA-MM. Por defecto, el mes en curso. Los períodos cerrados requieren un plan de pago. Ej: `2026-07`

Petición

curl 'https://micifra.cl/api/f29/propuesta?periodo=2026-07' \
  -H 'x-api-key: TU_API_KEY'

Respuesta 200 OK

application/json

{
  "producto": "Cifra API",
  "fuente": "SII — Registro de Compras y Ventas y propuesta del F29",
  "estado_datos": "live",
  "contribuyente": {
    "rut": "76543210-9"
  },
  "declarado": false,
  "propuesta": {
    "periodo": "2026-07",
    "debitos": [
      {
        "codigo": 503,
        "concepto": "Cantidad de facturas emitidas",
        "valor": 41,
        "unidad": "cantidad",
        "origen": "RCV ventas, documentos afectos distintos de boleta"
      },
      {
        "codigo": 502,
        "concepto": "Débito fiscal de facturas emitidas",
        "valor": 7404258,
        "origen": "RCV ventas, IVA de facturas"
      },
      {
        "codigo": 110,
        "concepto": "Cantidad de boletas y comprobantes",
        "valor": 2502,
        "unidad": "cantidad",
        "origen": "RCV ventas, boletas electrónicas y comprobantes de pago"
      },
      {
        "codigo": 111,
        "concepto": "Débito fiscal de boletas",
        "valor": 847579,
        "origen": "RCV ventas, IVA de boletas y comprobantes"
      },
      {
        "codigo": 538,
        "concepto": "TOTAL DÉBITOS",
        "valor": 8251837,
        "origen": "Suma de los débitos, con las notas de crédito restadas"
      }
    ],
    "creditos": [
      {
        "codigo": 519,
        "concepto": "Cantidad de facturas recibidas con derecho a crédito",
        "valor": 55,
        "unidad": "cantidad",
        "origen": "RCV compras, estado REGISTRO"
      },
      {
        "codigo": 520,
        "concepto": "Crédito fiscal de facturas recibidas",
        "valor": 4909009,
        "origen": "RCV compras, IVA recuperable"
      },
      {
        "codigo": 527,
        "concepto": "Notas de crédito recibidas (rebajan el crédito)",
        "valor": 57085,
        "origen": "RCV compras, DTE 61"
      },
      {
        "codigo": 537,
        "concepto": "TOTAL CRÉDITOS",
        "valor": 4851924,
        "origen": "Suma de los créditos, con notas de crédito restadas y remanente incluido"
      }
    ],
    "impuesto": [
      {
        "codigo": 89,
        "concepto": "IVA determinado a pagar",
        "valor": 3399913,
        "origen": "Débitos menos créditos"
      }
    ],
    "otros": [
      {
        "codigo": 563,
        "concepto": "Base imponible del PPM",
        "valor": 42852000,
        "origen": "Informada por el SII en la propuesta del F29"
      },
      {
        "codigo": 115,
        "concepto": "Tasa de PPM (0.1%)",
        "valor": 0.1,
        "unidad": "porcentaje",
        "origen": "Asignada por el SII al contribuyente"
      },
      {
        "codigo": 62,
        "concepto": "PPM neto determinado",
        "valor": 42852,
        "origen": "Base por tasa, según el SII"
      }
    ],
    "total_a_pagar": 3442765,
    "incompleta": true,
    "no_incluye": [
      "Exportaciones y ventas exentas que no estén en el RCV",
      "Cambio de sujeto y retenciones de IVA",
      "Créditos especiales: capacitación (SENCE), activo fijo",
      "Impuestos adicionales declarables (ILA, tabacos, combustibles)",
      "Postergación del pago de IVA, si estás acogido"
    ],
    "advertencia": "Propuesta calculada con lo que el SII tiene registrado. NO es una declaración: contrástala con la propuesta del propio SII antes de presentar el F29, y revisa con tu contador las situaciones que no aparecen arriba."
  },
  "// comparacion": "Presente solo si el período ya fue declarado.",
  "comparacion": {
    "diferencias": [
      {
        "codigo": 520,
        "concepto": "Crédito fiscal de facturas recibidas",
        "calculado": 4909009,
        "declarado": 4880110,
        "diferencia": -28899
      }
    ],
    "sin_diferencias": false,
    "nota": "Hay diferencias entre lo declarado y el registro. No implican error —puede haber ajustes legítimos que el RCV no refleja— pero conviene poder explicarlas."
  },
  "consultado": "2026-07-30T18:12:04.117Z"
}

GET/api/riesgo-clientesplan free

Cartera de clientes: concentración y conducta

El espejo del riesgo de proveedores, sobre el lado venta del registro. Responde dos preguntas que un comité de crédito hace siempre y que hoy se contestan de memoria: de quién dependen tus ventas, y cómo se portan tus clientes con tus facturas. IMPORTANTE: el acuse de recibo NO es el pago. Es el acto por el que el receptor reconoce el documento en su registro de compras; alguien puede acusar el día uno y pagar a noventa. Se informa como conducta de acuse, nunca como morosidad. Pasados 8 días corridos el SII acepta el documento por silencio, así que un promedio sobre ese umbral significa que el cliente deja vencer el plazo en vez de revisarlo. Las boletas (39, 41) y los comprobantes (48) no identifican al comprador: el SII los entrega agregados y no forman cartera. La respuesta lo dice en vez de mostrar cero.

Fuente oficial: SII — Registro de Compras y Ventas (lado venta)

Parámetros

Parámetro	Tipo	Req.	Descripción
`periodo`	string	no	AAAA-MM. Por defecto, el mes en curso. Ej: `2026-07`

Petición

curl 'https://micifra.cl/api/riesgo-clientes?periodo=2026-07' \
  -H 'x-api-key: TU_API_KEY'

Respuesta 200 OK

application/json

{
  "producto": "Cifra API",
  "fuente": "SII — Registro de Compras y Ventas (lado venta)",
  "estado_datos": "live",
  "periodo": "2026-07",
  "total_neto": 22150000,
  "documentos_identificados": 9,
  "documentos_sin_receptor": 2,
  "concentracion_top1": 56.3,
  "concentracion_top3": 96.7,
  "conducta": {
    "con_acuse": 7,
    "sin_acuse": 1,
    "reclamados": 1,
    "dias_acuse_promedio": 4.1,
    "sin_informacion": false
  },
  "clientes": [
    {
      "rut": "76.330.114-2",
      "razon_social": "SUPERMERCADOS DEL VALLE SPA",
      "documentos": 3,
      "neto": 12460000,
      "participacion": 56.3,
      "ultima_venta": "2026-07-29",
      "dias_acuse_promedio": 1,
      "sin_acusar": 0,
      "reclamados": 0
    }
  ],
  "alertas": [
    {
      "clase": "reclamos",
      "severidad": "alta",
      "titulo": "HOTELERA COSTANERA S.A. reclamó 1 documento(s)",
      "detalle": "Un reclamo deja el documento fuera del crédito fiscal del cliente y suele anteceder a una disputa comercial.",
      "rut": "79.512.660-1"
    }
  ],
  "aviso": "El acuse de recibo NO es el pago: es el acto por el que tu cliente reconoce la factura en su registro de compras.",
  "consultado": "2026-08-05T02:40:00.000Z"
}

GET/api/riesgo-proveedoresplan free

Salud de tu cartera de proveedores

Cruza a quién le compras (tu Registro de Compras del SII) con quién está en procedimiento concursal (Boletín Concursal), y revisa la concentración del gasto. Es un cruce que ninguna de las dos fuentes puede hacer por separado: un ERP sabe a quién le compras pero no tiene los datos de riesgo, y un buró de riesgo tiene los datos pero no sabe a quién le compras. Detecta además documentos del mismo proveedor por el mismo monto, que pueden ser una compra recurrente legítima o una factura duplicada. Las alertas son señales para revisar, nunca conclusiones: un falso positivo aquí daña una relación comercial.

Fuente oficial: SII (Registro de Compras y Ventas) + Boletín Concursal

Parámetros

Parámetro	Tipo	Req.	Descripción
`periodo`	string	no	AAAA-MM. Por defecto, el mes en curso. Ej: `2026-07`

Petición

curl 'https://micifra.cl/api/riesgo-proveedores?periodo=2026-07' \
  -H 'x-api-key: TU_API_KEY'

Respuesta 200 OK

application/json

{
  "producto": "Cifra API",
  "fuente": "SII (Registro de Compras y Ventas) + Boletín Concursal",
  "estado_datos": "live",
  "contribuyente": {
    "rut": "76543210-9"
  },
  "periodo": "2026-07",
  "proveedores": [
    {
      "rut": "96812340-1",
      "razon_social": "MAYORISTA CENTRAL LTDA.",
      "documentos": 14,
      "neto": 6120400,
      "iva": 1162876,
      "participacion": 36.7,
      "ultima_factura": "28/07/2026"
    },
    {
      "rut": "91041000-8",
      "razon_social": "ALIMENTOS DEL SUR S.A.",
      "documentos": 9,
      "neto": 2480150,
      "iva": 471229,
      "participacion": 14.9,
      "ultima_factura": "26/07/2026"
    }
  ],
  "total_proveedores": 23,
  "total_neto": 16656220,
  "concentracion_top3": 61.3,
  "boletin_disponible": true,
  "alertas": [
    {
      "clase": "concursal",
      "severidad": "alta",
      "titulo": "BEBIDAS Y LICORES DEL VALLE LTDA. tiene un procedimiento concursal publicado",
      "detalle": "Reorganización de la Empresa Deudora · 1º Juzgado Civil de Rancagua · publicado el 2026-07-09. Le compraste $1.488.300 en el período.",
      "rut": "78455120-4",
      "monto": 1488300
    },
    {
      "clase": "posible_duplicado",
      "severidad": "media",
      "titulo": "2 documentos de MAYORISTA CENTRAL LTDA. por el mismo monto",
      "detalle": "Folios 884213, 884655, ambos por $412.900. Puede ser una compra recurrente legítima o una factura duplicada.",
      "rut": "96812340-1",
      "monto": 825800
    }
  ],
  "aviso": "Las alertas son señales para revisar, no conclusiones. Un procedimiento concursal publicado no impide operar con el proveedor; conviene evaluarlo caso a caso.",
  "consultado": "2026-07-30T18:12:04.117Z"
}

Conciliación

POST/api/conciliacionplan free

Conciliar SII contra tu ERP

Compara el registro del SII con el de tu sistema contable y devuelve las diferencias clasificadas en tres tipos: documentos que el SII registra y tu ERP no (faltantes), documentos que tu ERP tiene y el SII no (sobrantes), y documentos presentes en ambos con montos distintos. El emparejamiento usa la llave natural del documento tributario: tipo + folio + RUT de la contraparte. Reconoce las columnas por su nombre, sin importar el orden ni el separador del archivo. Las planillas se procesan en memoria y no se almacenan.

Parámetros

Parámetro	Tipo	Req.	Descripción
`erp`	string	sí	Contenido CSV del export de tu sistema contable. Máximo 6 MB.
`periodo`	string	no	AAAA-MM. Trae el registro del SII automáticamente; no hace falta enviar 'sii'. Ej: `2026-07`
`operacion`	string	no	'compra' (por defecto) o 'venta'. Solo aplica en modo automático.
`sii`	string	no	Alternativa a 'periodo': el CSV del RCV exportado a mano. Máximo 6 MB.

Petición

curl -X POST 'https://micifra.cl/api/conciliacion' \
  -H 'x-api-key: TU_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "erp": "TipoDocumento,NumeroDocumento,RutProveedor,FechaEmision,MontoTotal\\n33,1001,76123456-7,2026-06-05,1190000",
  "periodo": "2026-06",
  "operacion": "compra"
}'

Respuesta 200 OK

application/json

{
  "producto": "Cifra API",
  "generado": "2026-07-26T14:03:11.204Z",
  "resumen": {
    "documentos_sii": 5,
    "documentos_erp": 4,
    "coincidentes": 2,
    "faltantes_en_erp": 2,
    "sobrantes_en_erp": 1,
    "diferencias_monto": 1,
    "tasa_calce": 40,
    "monto_faltante": 2680000,
    "monto_sobrante": 952000,
    "monto_diferencias": 59500,
    "exposicion_iva": 589399
  },
  "discrepancias": [
    {
      "clase": "faltante_en_erp",
      "tipo": 33,
      "folio": 3300,
      "rut": "76555111-K",
      "razon_social": "Servicios Andes SA",
      "fecha": "2026-06-18",
      "monto_sii": 2380000,
      "monto_erp": null,
      "diferencia": null,
      "motivo": "El SII registra este documento, pero no está en tu ERP. Revisa si falta contabilizarlo."
    }
  ],
  "mapeo": {
    "sii": {
      "tipo": "Tipo Doc",
      "folio": "Folio",
      "rut": "RUT Proveedor",
      "total": "Monto Total"
    },
    "erp": {
      "tipo": "TipoDocumento",
      "folio": "NumeroDocumento",
      "rut": "RutProveedor",
      "total": "MontoTotal"
    }
  },
  "avisos": []
}

¿Vas a integrarlo en un gateway corporativo? Mira la guía de integración por nube o el stack técnico.