APICAF
API de Autorización de Folios para documentos tributarios chilenos
Sistema integral para la emisión, anulación y reobtención de Códigos de Autorización de Folios (CAF) del Servicio de Impuestos Internos de Chile.
Estado del Servicio
En línea
Tiempo de Respuesta
< 500ms
Seguridad
Tokens activos
Planes de Uso
Plan Público
Gratis
- 10 consultas diarias
- Token:
token_publico
- Tiempo de vida: 1 minuto
- Soporte básico
Plan Premium
$1.000 CLP/año
- 50 consultas diarias
- Token personalizado
- Sin límite de tiempo
- Soporte prioritario
Documentación de la API
URL Base
https://apicaf.cl
Endpoint Principal: Autorización de Folios (CAF)
POST /api/caf
Endpoint principal para emisión, anulación y reobtención de folios CAF.
Parámetros principales:
- token (string): Token de autorización
- rut (string): RUT de la empresa
- etapa (string): Etapa del proceso
- entorno (string): "certificacion" o "produccion"
- firma_electronica (object): Datos de la firma digital
Tutorial Paso a Paso
Con firma electrónica (P12/PFX):
{
"entorno": "certificacion",
"token": "token_publico",
"firma_electronica": {
"string_firma": "MIIb...", // Archivo P12 en base64
"string_password": "clave_firma",
"subject_serial_number": "16291998-9"
},
"rut": "76883241-2",
"etapa": "conectar"
}
Con certificado ya procesado:
{
"entorno": "certificacion",
"token": "token_publico",
"firma_electronica": {
"priv_key": "-----BEGIN PRIVATE KEY-----...",
"cert": "-----BEGIN CERTIFICATE-----...",
"subject_serial_number": "16291998-9",
"init_signature": false
},
"rut": "76883241-2",
"etapa": "conectar"
}
{
"id_peticion": 1,
"token": "token_publico",
"etapa": "listar"
}
Respuesta: Lista de códigos de documento disponibles (33, 34, 39, 41, etc.)
{
"id_peticion": 1,
"token": "token_publico",
"cod_docto": 33,
"etapa": "disponibles"
}
Respuesta: Cantidad máxima de folios disponibles para el documento
{
"id_peticion": 1,
"token": "token_publico",
"cant_doctos": 1,
"etapa": "confirmar"
}
Respuesta: Confirmación de la cantidad solicitada
{
"id_peticion": 1,
"token": "token_publico",
"etapa": "obtener"
}
Respuesta: Información de los folios asignados
{
"id_peticion": 1,
"token": "token_publico",
"etapa": "archivo"
}
Respuesta: Archivo CAF en formato XML para usar en la facturación
Información Importante
- Todos los requests deben incluir un token válido
- Los RUTs deben estar en formato sin puntos y con dígito verificador
- El sistema implementa rate limiting y ban temporal por abuso
- Los archivos CAF se generan en formato XML estándar SII
- Soporte para entornos de Certificación y Producción
- Las peticiones tienen un tiempo de vida de 1 minuto
Proyecto de Donación
Este servicio se mantiene gracias a donaciones simbólicas para fomentar el uso de software libre como Odoo y Flectra.
Impulsado por GlobalResponse y OdooCoop
Soporte Técnico
¿Necesitas ayuda con la integración? Contáctanos para soporte técnico especializado.
Contactar Soporte