Emitir en el SII

Connect emite documentos tributarios electrónicos ante el SII a nombre de la empresa de una conexión, usando los sistemas gratuitos del propio SII: el Facturador Gratuito para facturas, guías y notas, y E-Boleta para boletas. Tu software o tu agente prepara el documento, recibe la vista previa y lo emite: la respuesta trae el folio. Funciona por REST, MCP y SDK, y está en beta con activación por organización.

Qué puedes emitir

Quedan fuera de la beta la factura de compra 46, los descuentos, los impuestos adicionales, las notas que corrigen texto, la anulación de una factura 34 y la anulación de boletas.

Qué necesitas

Esta sección y la siguiente describen el Facturador Gratuito. Las boletas usan E-Boleta, que emite con la clave tributaria de la conexión y exige su propio permiso, sii:boletas:write: sus requisitos están en Boletas 39 y 41.

1. La beta activada para tu organización. Pídesela al equipo de Emisso.

2. La empresa inscrita en el Facturador Gratuito del SII, con su certificado digital centralizado en sii.cl. El SII firma con ese certificado: Connect no lo sube ni lo reemplaza. Si la empresa no aparece en el selector del Facturador Gratuito, primero completa su inscripción en sii.cl. Si factura con otro sistema, Connect no puede emitir ni anular por ella.

3. Una conexión SII de representante. En Conexiones, al conectar la empresa elige Con clave de persona: el RUT y la clave tributaria de una persona que la representa, más el RUT de la empresa. Una conexión creada con la clave de la empresa sirve para leer, pero no para emitir, y no se convierte: hay que crear otra.

4. La emisión marcada en esa conexión. En el mismo paso, marca Emitir en el SII a nombre de la empresa e ingresa la clave del certificado digital, que es obligatoria para emitir: firma las facturas y las notas de crédito. Quien entrega las credenciales y marca la casilla autoriza la emisión de esa conexión, sea en el panel o por un enlace de conexión. Si la clave del certificado no está a mano, desmarca la emisión y la conexión se crea solo para leer. Si la empresa tiene más de una actividad económica o dirección, elige cuáles usar al terminar de conectar; con una sola, Connect la toma sin preguntar. Al cerrar, el alta dice por separado cómo quedaron las facturas y las boletas. La guía Activar la emisión en el SII muestra estos dos pasos con una demo animada.

   Si la conexión ya existe y se creó solo para leer, no hace falta crearla de nuevo: en su pestaña Ajustes, el panel Emisión en el SII la activa con la misma autorización, y la conexión conserva su ID. Pide la clave del certificado si todavía no está guardada y, si corresponde, la actividad económica y la dirección. La guía Activar la emisión en una conexión que ya tienes lo muestra con una demo animada.

5. Una clave de API con el permiso sii:write, o un agente conectado por MCP con ese permiso. Las claves no se editan: si la tuya no lo tiene, crea otra en API keys.

La clave del certificado queda cifrada en la credencial de la conexión y se resuelve en el servidor. Nunca forma parte de tus llamadas, de los resultados ni de los logs, y no se pide documento por documento.

Cómo funciona

Toda emisión son dos llamadas contra la misma conexión:

1. Previsualizar con sii.dte.previsualizar (o sii.anulacion.previsualizar para anular). Connect entra al Facturador Gratuito con la credencial de la conexión, llena el formulario y devuelve lo que calculó el SII: tipo, fecha, receptor y totales, más un previewRef que vence en 15 minutos. No firma ni emite nada.
2. Emitir con sii.dte.emitir (o sii.anulacion.emitir), el previewRef y una clave de idempotencia que generas tú. Connect vuelve a preparar el documento en el portal, comprueba que lo que se va a firmar coincide con lo que previsualizaste (receptor, líneas, referencias y totales) y recién entonces lo firma y lo envía al SII. Si algo no coincide, se detiene antes de firmar.

Nadie confirma documento por documento: la autorización se dio al marcar la emisión en la conexión. El resultado llega normalmente en la misma llamada, con el folio asignado por el SII. Qué hacer con cada desenlace está en Resultados y errores.

Tres reglas evitan casi todos los problemas:

• Una clave de idempotencia por documento. Genera una UUID v4, guárdala junto al documento antes de llamar y reutilízala solo para reintentar esa misma emisión. Una clave nueva significa «otro documento».
• El mismo actor en las dos llamadas. Previsualiza y emite con la misma clave de API (o la misma persona). Una vista previa creada con una clave no se emite con otra.
• Un documento a la vez por conexión. Las llamadas de una misma conexión se atienden en serie; si mandas varias en paralelo, las que esperan reciben connection_busy y se reintentan con su misma clave de idempotencia.

Dónde ver lo emitido

En Conexiones, abre la conexión y entra a Datos → Emisión: los documentos emitidos desde esa conexión y sus anulaciones, con receptor, neto, IVA y total. Cada llamada queda además en la bitácora de la organización.

Revocar acceso

Para dejar de emitir desde una empresa, elimina su conexión. Eso impide operaciones nuevas; no borra la auditoría ni cambia el resultado de una operación ya concluida. Emisso también puede retirar la habilitación de emisión de toda la organización como medida de cierre general.

Esta beta no compromete disponibilidad del portal del SII ni un SLA de emisión. Revisa el resultado de cada operación antes de continuar un flujo contable.