Sistemas

SII

Consulta datos tributarios, emite facturas, guías y notas, y anula facturas y boletas mediante el Facturador Gratuito SII.

Emisso permite leer datos tributarios y emitir y anular DTE mediante el Facturador Gratuito del SII. La emisión está disponible por API y MCP 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 Starter, 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

DocumentoQué incluye
Factura electrónica afecta 33 y exenta 34Del giro y a crédito, de una a diez líneas con descripción opcional y hasta diez referencias (orden de compra, HES, guía de despacho)
Nota de crédito 61 de anulaciónAnula una factura 33 o 34 emitida con el Facturador Gratuito, o una boleta 39 o 41 emitida por Emisso
Factura de compra 46Compra con retención total del IVA, una línea, con el vendedor completo (admite 55555555-5 para un extranjero sin RUT)
Guía de despacho 52Cualquiera 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 61Corrigen montos de una factura exenta 34, de una a diez líneas

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. 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 y MCP. Las tools son sii.dte.previsualizar y sii.dte.emitir para emitir, y sii.anulacion.previsualizar y sii.anulacion.emitir para anular.

Buscar un contribuyente por RUT

Para facturar no hace falta buscar al receptor: sii.dte.previsualizar lo completa desde el SII con solo su RUT, y sii.receptor.opciones muestra sus giros y direcciones cuando hay más de una (Facturas). Para conocer a un contribuyente sin usar la clave de la conexión, sii.contribuyente.buscar devuelve la razón social, los giros y el domicilio de cualquier RUT, no solo el de la empresa conectada:

{
  "rut": "76123456-0",
  "estado": "puede_emitir",
  "nombre": "COMERCIAL EJEMPLO SPA",
  "fechaInicioActividades": "2019-03-14",
  "giros": [
    { "codigo": "469000", "descripcion": "VENTA AL POR MAYOR NO ESPECIALIZADA", "categoriaTributaria": "1", "afectoIva": true, "fechaInicio": "2019-03-14" }
  ],
  "domicilio": { "direccion": "AV EJEMPLO 1234 DEPTO 501", "comuna": "PROVIDENCIA", "fechaPublicacion": "2026-08-05T15:36:37.000Z" }
}
  • Razón social y giros se consultan en vivo en la consulta pública de situación tributaria del SII. No usa la clave de la conexión ni guarda lo que consulta, pero requiere una conexión SII y el permiso sii:read.
  • El domicilio sale de la nómina de domicilios de personas jurídicas que publica el SII, que Emisso revisa cada semana. No cubre personas naturales, y fechaPublicacion dice de cuándo es la nómina.
  • Revisa estado antes de usar los datos: rut_inexistente es una respuesta del SII, mientras que no_verificable significa que el SII no respondió y no dice nada del RUT. Reintenta más tarde.

Los datos del SII pueden no caber en el receptor

El SII publica giros, direcciones y comunas más largos de lo que admite el receptor de un DTE (40, 70 y 20 caracteres). Abrévialos antes de llamar a sii.dte.emitir, que no completa el receptor solo: elige un giro de la lista y envía el receptor entero.

Admite 10 búsquedas por minuto por organización; sobre eso responde 429 rate_limited con la espera.

Los 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):

AlcanceQué traeSe lee con
rcvEl 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)
boletasEl resumen diario de boletas electrónicas de venta (tipos 39 y 41).sii.boletas.consultar
guiasGuías de despacho electrónicas emitidas (DTE 52).sii.guias.consultar
boletas_honorariosBoletas de honorarios emitidas y recibidas, con su retención.sii.boletas_honorarios.consultar
documentosLos XML firmados disponibles en el respaldo del SII, con sus ítems, giros, direcciones y forma de pago. Que un DTE aparezca en el RCV no garantiza que su XML esté disponible aquí.sii.documentos.consultar y sii.documentos.detallar
f29Las declaraciones mensuales (Formulario 29) presentadas, con sus códigos. No va por período: cada revisión lee la grilla del año en curso y los seis anteriores, y se repite sola después de cada vencimiento. Es opcional: no viene marcado de entrada al conectar.sii.f29.consultar

Los alcances con restricción de credencial

La mayoría de los alcances los sirve cualquiera de las dos claves, pero tres no, y en sentidos opuestos: boletas_honorarios y f29 solo los sirve la clave de la empresa, y documentos solo la de una persona que la representa. Elige la clave compatible con el alcance que necesitas. Para documentos, esa credencial es un requisito de acceso; no garantiza que el respaldo contenga todos los XML que buscas.

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. Emisso 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, Emisso 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.

Qué XML puede recuperar Emisso

El alcance documentos consulta Respaldo de Información XML (DTE e IECV) del SII. Esa herramienta ofrece la información registrada en el sistema de Facturación SII para empresas autorizadas, incluidas las que antes lo usaron y luego cambiaron a una solución de mercado.

Emisso descarga los XML emitidos y recibidos que esa fuente ofrece para la empresa. No filtra por el software de emisión del proveedor, pero tampoco garantiza recuperar todos los DTE del RCV. El RCV y el respaldo son fuentes distintas: Emisso no reconstruye un XML firmado a partir del RCV. Usar la clave de una persona autorizada permite intentar la consulta; no amplía la información disponible en el respaldo.

Si falta un XML, revisa primero que se haya sincronizado el alcance documentos para su período y el resultado de esa carga. Una sincronización completa acredita lo obtenido del índice del respaldo, no la cobertura de todos los documentos del RCV. documento: null significa que Emisso no tiene ese XML guardado; repetir la sincronización no garantiza recuperarlo si la fuente no lo ofrece.

Para un documento recibido que no esté disponible, puedes pedir al proveedor que reenvíe el XML original. Además, el punto 4 de la Resolución Ex. SII N.º 61 de 2023 contempla recuperar XML correctamente recibidos por el SII: mediante consulta web para usuarios del Facturador Gratuito y mediante petición administrativa para usuarios de soluciones de mercado. Emisso no tramita esa petición administrativa.

Hasta cuándo está verificado un mes de documentos

Un mes completo no es un mes cerrado para siempre. Algunos proveedores emiten con fecha del mes y el SII muestra el documento días después. En octubre de 2026, el 1 % de los documentos recibidos apareció en noviembre, unos 4 días después de su fecha de emisión. Los documentos emitidos por la propia empresa no mostraron ese atraso.

Por eso cada mes de documentos trae verificadoAl: el instante desde el que lo guardado coincide con todo lo que el SII mostraba para ese mes, revisado entero y sin partes rechazadas.

DóndeQué trae
conexiones.estado.consultarverificados: un verificadoAl por mes, con motivo cuando es null.
sii.documentos.consultarverificadoAl del periodo que consultas.
{ "alcance": "documentos", "periodo": "2026-10", "verificadoAl": "2026-11-03T11:58:00.000Z", "motivo": null }

Esto dice: lo que guardamos de octubre coincide con lo que el SII mostraba el 3 de noviembre a las 11:58 UTC. Un documento con fecha de octubre que el SII publique después aparece en una sincronización posterior y mueve verificadoAl hacia adelante.

  • Para cerrar un mes, usa un verificadoAl posterior al plazo que tu proceso da a los documentos atrasados. Si lees uno anterior, vuelve a consultar más adelante: Emisso sigue revisando los meses recientes por su cuenta.
  • verificadoAl: null significa que la última sincronización del mes no alcanzó a revisarlo entero, o que el mes todavía no termina su primera revisión. Lo guardado sigue disponible, pero no lo trates como cerrado. motivo dice por qué; tiempo_agotado y sistema_no_disponible se resuelven solos en las próximas sincronizaciones.
  • verificadoAl no retrocede. Una sincronización que queda a medias lo deja en null hasta la siguiente revisión completa, pero no borra lo que ya guardamos.

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:

  1. sii.rcv.consultar: los documentos, uno por fila.
  2. 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: Emisso 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 documentoSí
Emite boleta o factura, y corrigió la duplicidad con una nota de créditoSí: la nota ya resta lo repetido
Emite boleta o factura, y dejó el comprobante en $0 en el registroDa igual: suma $0
Emite boleta o factura, y no corrigió nadaNo: 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 Emisso 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. Para actualizar otro período, indica también los alcances: en esta tool son obligatorios y deben estar habilitados en la conexión. Aquí pedimos rcv. Reemplaza el mes del ejemplo por el que necesitas; durante la prueba puedes cargar el mes actual y los dos anteriores.

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", "alcances": ["rcv"]}}'

Salida esperada (200, campo data):

{
  "periodo": "2026-07",
  "estado": "encolado",
  "jobId": "sjb_9f2kc0q8w1m4x7t3p6b5d",
  "yaEnCurso": false
}

El 200 confirma que el trabajo está encolado, no que el período esté completo. Sigue data.jobId con GET /api/v1/syncs/{jobId} usando la misma API key. La guía de seguimiento explica cuándo esperar, cuándo detenerse y qué hacer si yaEnCurso es true y jobId viene null.

Al terminar, data.outcomes trae un resultado por alcance (ok, partial o failed, con recordsSynced y los campos propios de cada alcance). Un alcance puede fallar sin tumbar a los demás: Para cerrar el RCV exige status: "ok", completo: true, reconMismatches: 0 y filasDescartadas: 0, aunque el trabajo esté succeeded. Un contador distinto de cero o ausente impide acreditar el período completo; completo por sí solo no detecta esas pérdidas. Si rcv sale partial, incompletosPorMotivo dice por qué faltó cada parte; con presupuesto o tope puedes volver a sincronizar ese período después de que termine el trabajo. Si tu plan incluye webhooks, también puedes recibir avisos de finalización.

Errores que vas a ver, y qué hacer

CódigoCuándoQué hacer
connection_credential_requiredLa 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_progressSolo por POST /v1/connections/{conn}/syncs: ese período ya tiene una sincronización en cola o corriendo, quizá la programada. La tool sii.conexion.sincronizar no lo devuelve: responde yaEnCurso: true.Sigue ese trabajo, o consulta directamente: puede que ya haya datos.
alcance_not_enabledPediste un alcance que la conexión no habilitó.Habilítalo en connect.emisso.ai/connections o quítalo del input.

Próximos pasos

En esta página