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 y MCP, en toda organización: basta una conexión que emita.

Qué puedes emitir

Todavía no se admiten 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 que no emitió Connect.

Antes de integrar facturas, guías o notas de corrección, revisa Campos, validación y límites: distingue los requisitos de Connect del formato DTE y explica cómo leer los errores de cada campo por REST y MCP.

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. Espacio en tu plan. Una conexión con emisión usa US$25 al mes de tu plan, en vez de los US$10 de una de solo lectura.

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.

   Al activar la emisión, Connect comprueba qué documentos le permite emitir el SII a esa persona en esa empresa: hay personas que, por ejemplo, sólo pueden emitir facturas exentas. El resultado sale en tiposDte de conexiones.estado.consultar y en el panel Emisión en el SII. Pedir un tipo que el SII le rechazó responde sii_dte_type_not_authorized. Si la empresa le da otra autorización en sii.cl, vuelve a comprobarlo desde ese panel.

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 devuelve tipo, fecha, receptor y totales del documento, más un previewRef que vence en 15 minutos. Revisa esos datos antes de emitir. Esta llamada no firma ni emite el documento.
2. Emitir con sii.dte.emitir (o sii.anulacion.emitir), el previewRef y una clave de idempotencia que generas tú. Connect firma y envía el documento al SII solo si coincide con la vista previa: receptor, líneas, referencias y totales. Si algo cambia, se detiene antes de firmar; debes preparar una vista previa nueva y revisarla.

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, abre la conexión, entra a Ajustes y pulsa Dejar de emitir (lo puede hacer el dueño o un administrador de la organización). Eso impide operaciones nuevas; la conexión conserva su connectionId y lo ya sincronizado, y vuelve a cobrarse como una conexión de lectura. Mientras esté apagada tampoco puedes anular documentos ni descargar el PDF de los ya emitidos. Puedes reactivarla cuando quieras con Activar emisión. 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.

Connect 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.