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
| Documento | Qué incluye |
|---|---|
| Factura electrónica afecta 33 y exenta 34 | Del 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ón | Anula una factura 33 o 34 emitida con el Facturador Gratuito, o una boleta 39 o 41 emitida por Emisso |
| Factura de compra 46 | Compra 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 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, 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
fechaPublicaciondice de cuándo es la nómina. - Revisa
estadoantes de usar los datos:rut_inexistentees una respuesta del SII, mientras queno_verificablesignifica 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):
| 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 | Los 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 |
f29 | Las 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ónde | Qué trae |
|---|---|
conexiones.estado.consultar | verificados: un verificadoAl por mes, con motivo cuando es null. |
sii.documentos.consultar | verificadoAl 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
verificadoAlposterior 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: nullsignifica 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.motivodice por qué;tiempo_agotadoysistema_no_disponiblese resuelven solos en las próximas sincronizaciones.verificadoAlno retrocede. Una sincronización que queda a medias lo deja ennullhasta 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:
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:
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 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 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ó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 | Solo 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_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 y MCP.
sii.contribuyente.buscar: razón social, giros y domicilio de cualquier RUT.sii.receptor.opciones: giros y direcciones, con sucursales, que el Facturador Gratuito muestra para un receptor.- Errores: cómo manejar el catálogo completo.