SII
Consulta datos tributarios, emite facturas, guías y notas, y anula facturas y boletas mediante el Facturador Gratuito SII.
Connect permite leer datos tributarios y emitir y anular DTE mediante el Facturador Gratuito del SII. La emisión está disponible por API, MCP y SDK en toda organización y se configura en la misma conexión SII, que con emisión usa US$25 al mes del plan, en vez de US$10. Nadie confirma documento por documento: la autorización se da al marcar la emisión en la conexión.
Emisión de facturas, guías y notas
| Documento | Qué incluye |
|---|---|
| Factura electrónica afecta 33 y exenta 34 | Del giro y a crédito, de una a diez líneas y hasta tres referencias (orden de compra, HES, guía de despacho) |
| Nota de crédito 61 de anulación | Anula una factura 33 emitida con el Facturador Gratuito, o una boleta 39 o 41 emitida por Connect |
| Guía de despacho 52 | Cualquiera de los nueve motivos de traslado, de una a diez líneas, con referencias y transporte |
| Nota de débito 56 y nota de crédito 61 | Corrigen montos de una factura exenta 34, con una línea |
Requiere una conexión de representante, la empresa inscrita en el Facturador Gratuito y su certificado digital centralizado en el SII, con la clave del certificado entregada al conectar. El DTE 46 no está incluido. Las boletas 39/41 se emiten en E-Boleta, con requisitos propios: ver Boletas 39 y 41.
Empieza con la guía Emitir en el SII: requisitos, activación y el flujo de cada documento,
con ejemplos por REST, MCP y SDK. Las tools son
sii.dte.previsualizar y
sii.dte.emitir para emitir, y
sii.anulacion.previsualizar y
sii.anulacion.emitir para anular.
Los cinco alcances
¿Vas a conectar desde el panel? La guía Conectar el SII recorre el alta con una demo animada, y Activar la emisión en el SII la versión que factura.
Para leer datos, la persona entrega su clave tributaria mediante el
enlace de conexión y elige qué módulos habilitar. sincronizar trae los
alcances compatibles con esa credencial en una misma sesión, por período mensual (AAAA-MM):
| Alcance | Qué trae | Se lee con |
|---|---|---|
rcv | El Registro de Compra-Venta: cada DTE recibido y emitido con montos, estados y eventos del receptor, y los totales del mes que el SII informa sin detalle (boletas, pagos con tarjeta). La base del IVA mensual. | sii.rcv.consultar (documentos) y sii.rcv_totales.consultar (totales del mes) |
boletas | El resumen diario de boletas electrónicas de venta (tipos 39 y 41). | sii.boletas.consultar |
guias | Guías de despacho electrónicas emitidas (DTE 52). | sii.guias.consultar |
boletas_honorarios | Boletas de honorarios emitidas y recibidas, con su retención. | sii.boletas_honorarios.consultar |
documentos | El XML firmado de cada DTE, con sus ítems, giros, direcciones y forma de pago. El RCV dice qué documentos existen; este respaldo trae el documento. | sii.documentos.consultar y sii.documentos.detallar |
Los dos alcances con restricción de credencial
La mayoría de los alcances los sirve cualquiera de las dos claves, pero dos no, y en sentidos
opuestos: boletas_honorarios solo lo sirve la clave de la empresa, y documentos solo la de
una persona que la representa. Si el alcance que necesitas es uno de esos dos, la clave que pidas en
el enlace decide si la conexión va a servir.
Las guías de despacho tienen ventana de 6 meses, en el SII
El detalle de guías emitidas solo existe en el SII para los últimos 6 meses, en ventana rodante. Por eso su historia no se puede reconstruir con un backfill: se construye sincronizando de forma continua (la cadencia programada ya lo hace). Conecta la empresa antes de necesitar el histórico, porque lo que la ventana ya botó no se puede recuperar.
En la prueba se cargan los 3 meses más recientes; con un plan activo, los anteriores (guías: solo los últimos 6 meses).
Meses con más de unos 1.000 documentos del mismo tipo
Sobre ese volumen, el SII no entrega el Registro de Compra-Venta en línea: lo entrega como archivo.
Connect lo pide y lo baja solo, en el mismo sync, y en el resultado del alcance rcv te dice cuántos
grupos llegaron así (diferidos). Ese archivo no trae el código del evento del receptor: si el
documento tiene fecha de acuse o de reclamo, Connect lo completa; si no tiene ninguna, el código queda
vacío. Para saber si hubo acuse o reclamo, guíate por fechaAcuse y fechaReclamo.
Cómo sumar las ventas del mes
El SII no entrega todo el Registro de Compra-Venta documento por documento. Las facturas y las notas de crédito y débito llegan una por una, pero las boletas electrónicas (39) y los comprobantes de pago con tarjeta (48) llegan como un total por mes. Por eso el RCV se lee con dos herramientas:
sii.rcv.consultar: los documentos, uno por fila.sii.rcv_totales.consultar: un total por mes y tipo, con la cantidad de documentos y sus montos.
Las ventas del mes salen de los documentos de la primera (las notas de crédito restan) más los totales de
la segunda que vienen con sumable: true, que hoy son las boletas. El total del mes en curso crece en cada
sincronización, y el de un mes cerrado todavía puede cambiar si el SII lo corrige.
Los pagos con tarjeta pueden repetir ventas
El comprobante de pago con tarjeta (48) no lo emite la empresa: lo informa al SII quien procesa el pago
(Transbank, Mercado Pago, Getnet, …) y vale como boleta. Si la empresa además emitió su boleta o su factura
por esa misma venta, la venta aparece dos veces en el registro. Por eso el 48 viene con sumable: false:
Connect no puede saber cuál es tu caso, y la respuesta depende de cómo emite y corrige la empresa.
| Situación de la empresa | ¿Se suma el 48? |
|---|---|
| No emite boleta ni factura por esas ventas: el comprobante es su único documento | Sí |
| Emite boleta o factura, y corrigió la duplicidad con una nota de crédito | Sí: la nota ya resta lo repetido |
| Emite boleta o factura, y dejó el comprobante en $0 en el registro | Da igual: suma $0 |
| Emite boleta o factura, y no corrigió nada | No: contaría la venta dos veces |
El SII evita la duplicidad con el «modelo de emisión de boletas», que solo pueden declarar quienes emiten boletas. Una empresa que solo factura la corrige en el registro del mes o con una nota de crédito. Si corriges un mes cerrado, vuelve a sincronizar ese período para que Connect lea el registro corregido.
Las boletas están en dos fuentes: usa una
El alcance boletas (sii.boletas.consultar) trae las mismas
boletas 39, día por día. Si sumas el total del RCV y el resumen diario, las cuentas dos veces. Elige una de
las dos fuentes. Las boletas exentas (41) sólo vienen en boletas.
Cómo sincronizar el SII
La cadencia 4h mantiene el mes corriente al día. El cierre de un mes suele pedirse a demanda:
curl -X POST https://connect.emisso.ai/api/v1/tools/sii.conexion.sincronizar/execute \
-H "Authorization: Bearer connect_sk_…" \
-H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \
-H "Content-Type: application/json" \
-d '{"input": {"periodo": "2026-07"}}'Salida esperada (200, campo data, recortada):
{
"periodo": "2026-07",
"results": [
{ "alcance": "rcv", "status": "ok", "recordsSynced": 214, "completo": true },
{ "alcance": "boletas", "status": "ok", "recordsSynced": 31 }
]
}La respuesta trae un resultado por alcance (ok, partial o failed, con recordsSynced y
completo). Un alcance puede fallar sin tumbar a los demás: revisa results[] antes de dar el
período por cerrado. Si rcv sale partial, incompletosPorMotivo dice por qué faltó cada parte;
con presupuesto o tope basta volver a sincronizar ese período más tarde.
Errores que vas a ver, y qué hacer
| Código | Cuándo | Qué hacer |
|---|---|---|
connection_credential_required | La empresa cambió su clave tributaria, o el SII la bloqueó. | Crea un enlace con modo: "reconectar" y pide a tu cliente que entregue la clave nueva. No reintentes con la anterior: el SII bloquea por intentos. |
connection_sync_in_progress | Ya corre un sync de ese período, quizá el programado. | Espera y reintenta (es reintentable), o consulta directamente: puede que ya haya datos. |
alcance_not_enabled | Pediste un alcance que la conexión no habilitó. | Habilítalo en connect.emisso.ai/connections o quítalo del input. |
Próximos pasos
sii.rcv.consultar: la referencia completa del RCV, con ejemplo pareado.- Conecta tu primera empresa: el enlace hosted paso a paso.
- Emitir en el SII: facturas, anulaciones, guías y notas, con ejemplos por REST, MCP y SDK.
- Errores: cómo manejar el catálogo completo.