Preguntas frecuentes de integradores
Enrolamiento es la plataforma y API REST de Elasbit SpA con la que los proveedores de software de facturación certifican ante el SII a las empresas que enrolan y operan sus folios.
Respuestas cortas a lo que más preguntan quienes integran la API.
¿Quién contrata Enrolamiento: el proveedor de software o la empresa?
El proveedor de software. Los clientes de Enrolamiento son proveedores de software de facturación electrónica, no las empresas emisoras: cada proveedor enrola a sus empresas con el RUT, el certificado digital y los tipos de documento, y sigue su avance por API o desde el portal.
¿Cuánto demora la certificación de una empresa ante el SII?
Los plazos los define el SII. Una de las etapas, las muestras impresas, la revisa una persona del SII, y la resolución exenta llega cuando el SII la emite. Consultar el avance más seguido no lo acelera: lo explica la guía del ciclo de vida.
¿Qué necesita la plataforma para certificar una empresa?
El RUT de la empresa, su certificado digital y los tipos de documento que va a emitir. Para iniciar la certificación hace falta además al menos un producto y un servicio de la empresa, porque la simulación usa los reales.
¿Se pueden certificar boletas electrónicas 39 y 41?
Sí, en una certificación propia, aparte de las facturas. La boleta afecta (39) y la exenta (41) van cada una en su certificación: pedirlas juntas responde SET_AMBAS_BOLETAS_JUNTAS. El camino es más corto, sin simulación, intercambio ni muestras impresas.
¿Qué es un CAF?
Es el Código de Autorización de Folios: el archivo XML con el que el SII autoriza a una empresa a usar un rango de folios de un tipo de documento. Con la API de folios y CAF los pides, los vuelves a bajar, los listas y anulas los que no vas a usar.
¿Cómo recupero un CAF cuyo XML perdí?
Con caf_v1_reobtener, que vuelve a bajar un CAF ya timbrado sin pedir folios nuevos: sin folioInicial, el más reciente; con folioInicial, el que empieza en ese folio. Cómo reobtener un CAF.
¿Qué hago si el SII responde «No ha sido posible completar su solicitud»?
La API ya leyó la página por ti y responde un código. «Inténtelo más tarde» llega como SII_ERROR_CXN, reintentable, pero al descargar, revisa antes con caf_v1_reobtener sin folioInicial si el CAF quedó timbrado. Si el usuario o la empresa no están autorizados, llega CERT_SIN_PERMISO o SEC_EMP_NOT_AUTHORIZED, que no se arreglan reintentando. El catálogo completo, en Errores y reintentos.
¿Cómo sé si conviene reintentar un error de la API?
Por los headers: cada error con código trae X-Codigo-Error y X-Reintentable, y Retry-After cuando conviene reintentar. En una operación que no es idempotente, como caf_v1_descargar, revisa antes de repetir. La regla completa, en Errores y reintentos.
¿Qué ambientes tiene la API?
Los dos del SII: certificación, que el SII también llama homologación (ambiente=0), y producción (ambiente=1). Pásalo siempre explícito: si lo omites, la operación corre en producción. El detalle, en Ambientes.
¿Puedo probar la integración sin tocar el SII?
Sí, con un RUT de prueba de tu perfil de cliente: con él la API responde sin consultar al SII, así que ejercitas el contrato sin postular ni timbrar nada. El RUT de prueba no simula los errores del SII: esos solo se ven contra el SII, en certificación y con una empresa real.
¿Qué pasa con el certificado digital de cada empresa?
Se usa únicamente ante el SII, en nombre de la empresa a la que pertenece. Su contraseña se guarda cifrada; el certificado se abre cuando un trabajo de la certificación lo necesita y se libera cuando ese trabajo termina. Cuando la certificación se cierra con la autorización del SII, la plataforma sobrescribe el certificado y su contraseña. Más en Seguridad.