Emitir en el SII
Emite facturas 33 y 34, anula facturas con nota de crédito y emite guías 52 y notas 56/61 ante el SII por API, MCP o SDK, con el Facturador Gratuito. Beta con activación por organización.
Connect emite documentos tributarios electrónicos ante el SII a nombre de la empresa de una conexión, usando el Facturador Gratuito del propio SII. Tu software o tu agente prepara el documento, recibe la vista previa que calcula el SII y lo emite: la respuesta trae el folio. Funciona por REST, MCP y SDK, y está en beta con activación por organización.
No hay ambiente de prueba
El Facturador Gratuito no tiene ambiente de certificación: todo documento que emites es real, consume folio y le llega al SII y al receptor. Revisa la vista previa antes de emitir. Una factura 33 emitida por error se deshace anulándola con una nota de crédito.
Qué puedes emitir
| Documento | Qué admite | Guía |
|---|---|---|
| Factura electrónica afecta 33 | Del giro y a crédito, de una a diez líneas y hasta tres referencias (orden de compra, HES, guía de despacho, contrato) | Facturas 33 y 34 |
| Factura electrónica exenta 34 | La misma forma que la 33, sin IVA | Facturas 33 y 34 |
| Nota de crédito 61 de anulación | Anula una factura 33 emitida con el Facturador Gratuito. El SII arma la nota completa a partir de la factura | Anular una factura |
| Guía de despacho 52 | Que constituye venta, con una línea | Guía 52 y notas de corrección |
| Nota de débito 56 y nota de crédito 61 | Corrigen montos de una factura exenta 34, con una línea | Guía 52 y notas de corrección |
Quedan fuera de la beta la factura de compra 46, los descuentos, los impuestos adicionales, las notas que corrigen texto y la anulación de una factura 34. Las boletas 39 y 41 tienen su propia beta de e-Boleta, con activación independiente.
Qué necesitas
- La beta activada para tu organización. Pídesela al equipo de Emisso.
- 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.
- Una conexión SII de representante. En Conexiones, al conectar la empresa elige Entro como representante: 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.
- La emisión marcada en esa conexión. En el mismo paso, marca Emitir documentos en el SII e ingresa la clave del certificado digital. 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, la conexión se crea igual para leer y la clave se entrega después en Ajustes de la conexión. 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.
- 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:
- Previsualizar con
sii.dte.previsualizar(osii.anulacion.previsualizarpara 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 unpreviewRefque vence en 15 minutos. No firma ni emite nada. - Emitir con
sii.dte.emitir(osii.anulacion.emitir), elpreviewRefy 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_busyy 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.