Contrato primero
La API está descrita en OpenAPI 3.1. La documentación, los SDK y los ejemplos se generan del mismo contrato, así que nunca se contradicen.
API de facturación electrónica para el SII, diseñada para integrarse una vez
Emite, recibe y cede documentos tributarios con una API REST descrita en OpenAPI. Tu sistema no espera al SII y nunca emite dos veces la misma venta.
Actualizado el
# Respuesta 201, sin esperar al SII
{
"folio": 18452,
"tipo_dte": 39,
"timbre": "PDF417…",
"estado": { "sii": "pendiente_envio" }
}
# Después, por webhook firmado (HMAC-SHA256)
documento.aceptado folio 18452Cómo viaja un documento por la API
Tu sistema hace una sola llamada. Lo que depende del SII ocurre después, en Ivexa.
- Tu sistema llama a la API Envía la venta con una clave de idempotencia.
- Ivexa valida y firma Asigna el folio, firma y genera el timbre.
- Respuesta inmediata Recibes el documento firmado y tu sistema sigue.
- Envío al SII Ivexa envía, consulta el estado y reintenta.
- Webhook firmado El resultado del SII llega a tu sistema.
Lo que esperas de una buena API, aplicado a la facturación
Asíncrona por diseño
Respuesta inmediata con el documento firmado. El envío al SII, las consultas de estado y los reintentos ocurren después, en Ivexa.
Idempotencia obligatoria
Cada escritura lleva su clave. Reintentar es seguro: misma clave, misma respuesta, durante 90 días.
Errores accionables
Formato RFC 9457 con un código estable, el campo exacto y un mensaje en español. Los rechazos del SII se traducen y conservan su texto original.
Webhooks firmados y feed de eventos
Firmados con HMAC-SHA256, con reintentos durante 72 horas. El feed de eventos permite retomar desde el último evento procesado.
Montos exactos
Pesos en enteros y decimales como texto. Nunca hay números de coma flotante en los montos de un documento tributario.
Todo el ciclo del documento, por API
La API vive en api.ivexa.cl/v1. Las pruebas usan un sandbox separado, con un SII simulado disponible a toda hora.
Empresas y certificados
Alta, verificación automática ante el SII y rotación de certificados.
Folios
Carga de CAF, cobertura en días y solicitud automática.
Documentos
Emitir, simular sin consumir folio, consultar, descargar PDF y XML.
Recepción
Listar, aceptar o reclamar documentos de proveedores. Más sobre recepción.
Cesión
Ceder facturas y seguir su estado.
Sandbox
Aceptados, reparos, rechazos y caídas del SII, simulados cuando quieras.
El sello Ivexa
Tu sistema y el SII, en sincronía. Cuatro compromisos con los que diseñamos cada documento.
- Respuesta sin esperar al SII El documento firmado, con folio y timbre, en la misma llamada.
- Ningún folio perdido ni duplicado La base de datos lo impide aunque falle un servidor.
- Reintentos seguros Misma clave de idempotencia, mismo documento, durante 90 días.
- Webhooks firmados El resultado del SII llega firmado con HMAC-SHA256.
Preguntas frecuentes
¿La API espera la respuesta del SII?
No por defecto. Responde con el documento firmado, su folio y su timbre, y el resultado del SII llega por webhook. Si lo necesitas, puedes pedir que espere hasta un límite de tiempo.
¿Qué pasa si mi sistema repite una llamada?
Toda escritura lleva una clave de idempotencia. Con la misma clave y el mismo contenido recibes la misma respuesta durante 90 días, sin emitir un documento nuevo.
¿Cómo sé si un webhook es auténtico?
Cada webhook va firmado con HMAC-SHA256 e incluye una marca de tiempo. Además, el feed de eventos te permite conciliar sin depender de los webhooks.
¿Habrá SDK?
Están planificados. El primero será para TypeScript, generado del mismo contrato OpenAPI que la API; después vendrán PHP, Python, Java y .NET.
Súmate a la lista de espera
Ivexa está en construcción. Las primeras empresas de la lista tendrán acceso al sandbox y acompañamiento para certificarse ante el SII.
- Acceso primero al sandbox
- Acompañamiento para certificarte ante el SII
- Solo te escribimos para avisarte del acceso