# 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 [#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](/docs/emitir/boletas).

Empieza con la guía [Emitir en el SII](/docs/emitir): requisitos, activación y el flujo de cada documento,
con ejemplos por REST y MCP. Las tools son
[`sii.dte.previsualizar`](/docs/referencia/sii/dte-previsualizar) y
[`sii.dte.emitir`](/docs/referencia/sii/dte-emitir) para emitir, y
[`sii.anulacion.previsualizar`](/docs/referencia/sii/anulacion-previsualizar) y
[`sii.anulacion.emitir`](/docs/referencia/sii/anulacion-emitir) para anular.

## Buscar un contribuyente por RUT [#buscar-un-contribuyente-por-rut]

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

```json
{
  "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.

<Callout type="warn" title="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`](/docs/referencia/sii/dte-emitir), que no
  completa el receptor solo: elige un giro de la lista y envía el receptor entero.
</Callout>

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

## Los alcances [#los-alcances]

¿Vas a conectar desde el panel? La guía [Conectar el SII](/docs/como-conectar/sii) recorre el alta con
una demo animada, y [Activar la emisión en el SII](/docs/como-conectar/emision-sii) la versión que factura.

Para leer datos, la persona entrega su clave tributaria mediante el
[enlace de conexión](/docs/empezar/conectar) 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`](/docs/referencia/sii/rcv-consultar) (documentos) y [`sii.rcv_totales.consultar`](/docs/referencia/sii/rcv_totales-consultar) (totales del mes) |
| `boletas`            | El resumen diario de boletas electrónicas de venta (tipos 39 y 41).                                                                                                                                                                                                  | [`sii.boletas.consultar`](/docs/referencia/sii/boletas-consultar)                                                                                                    |
| `guias`              | Guías de despacho electrónicas emitidas (DTE 52).                                                                                                                                                                                                                    | [`sii.guias.consultar`](/docs/referencia/sii/guias-consultar)                                                                                                        |
| `boletas_honorarios` | Boletas de honorarios emitidas y recibidas, con su retención.                                                                                                                                                                                                        | [`sii.boletas_honorarios.consultar`](/docs/referencia/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`](/docs/referencia/sii/documentos-consultar) y [`sii.documentos.detallar`](/docs/referencia/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`](/docs/referencia/sii/f29-consultar)                                                                                                            |

<Callout type="warn" title="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.
</Callout>

<Callout type="warn" title="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).
</Callout>

<Callout type="info" title="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`.
</Callout>

## Qué XML puede recuperar Emisso [#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](https://www.sii.cl/normativa_legislacion/resoluciones/2023/reso61.pdf)
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 [#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`](/docs/referencia/conexiones/estado-consultar) | `verificados`: un `verificadoAl` por mes, con `motivo` cuando es `null`. |
| [`sii.documentos.consultar`](/docs/referencia/sii/documentos-consultar)       | `verificadoAl` del `periodo` que consultas.                              |

```json
{ "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 [#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`](/docs/referencia/sii/rcv-consultar): los documentos, uno por fila.
2. [`sii.rcv_totales.consultar`](/docs/referencia/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.

<Callout type="warn" title="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.
</Callout>

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

<Callout type="warn" title="Las boletas están en dos fuentes: usa una">
  El alcance `boletas` ([`sii.boletas.consultar`](/docs/referencia/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`.
</Callout>

## Cómo sincronizar el SII [#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.

```bash
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`):

```json
{
  "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](/docs/conceptos/sincronizar-consultar#cómo-sabes-que-terminó)
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](/docs/operar/webhooks), también puedes recibir avisos de finalización.

## Errores que vas a ver, y qué hacer [#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](https://connect.emisso.ai/connections) o quítalo del input.                                            |

## Próximos pasos [#próximos-pasos]

* [`sii.rcv.consultar`](/docs/referencia/sii/rcv-consultar): la referencia completa del RCV, con ejemplo pareado.
* [Conecta tu primera empresa](/docs/empezar/conectar): el enlace hosted paso a paso.
* [Emitir en el SII](/docs/emitir): facturas, anulaciones, guías y notas, con ejemplos por REST y MCP.
* [`sii.contribuyente.buscar`](/docs/referencia/sii/contribuyente-buscar): razón social, giros y domicilio de cualquier RUT.
* [`sii.receptor.opciones`](/docs/referencia/sii/receptor-opciones): giros y direcciones, con sucursales, que el Facturador Gratuito muestra para un receptor.
* [Errores](/docs/operar/errores): cómo manejar el catálogo completo.


---

Esta página es parte de la documentación de Emisso. El índice completo, con cada página y su descripción, está en https://connect.emisso.ai/llms.txt. Esta misma página en HTML: https://connect.emisso.ai/docs/sistemas/sii.
