# Resultados y errores

> Qué significa cada resultado de una emisión o anulación ante el SII, cómo reintentar sin duplicar documentos y qué hacer con los errores más comunes.



## Los tres resultados [#los-tres-resultados]

`sii.dte.emitir` y `sii.anulacion.emitir` devuelven un `resultado` con uno de tres estados. Los de la
anulación van en femenino porque hablan de la nota. Las boletas tienen sus propios resultados y errores,
en [Boletas 39 y 41](/docs/emitir/boletas#resultados).

| Emisión                 | Anulación               | Qué significa                                                                                                                   | Qué hacer                                                                                                                                                           |
| ----------------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `emitido`               | `emitida`               | El SII confirmó el envío: el resultado trae `folio`, `fechaEmision`, `confirmadoEn` y `xmlFirmado`, el documento con su timbre. | Guarda `folio`, `operacionId` y el XML. Si no lo guardaste, [`sii.dte_xml.consultar`](/docs/emitir/facturas#3-pide-el-xml-después) lo entrega con el `operacionId`. |
| `rechazado`             | `rechazada`             | El documento no se emitió, de forma concluyente. `puedeReintentar` es `false`.                                                  | Corrige la causa y prepara una vista previa nueva. En una anulación, el documento anulado sigue vigente.                                                            |
| `resultado_desconocido` | `resultado_desconocido` | Connect todavía no puede afirmar si el SII emitió o no.                                                                         | No reenvíes ni prepares otro documento. Consulta la misma operación, como se explica abajo.                                                                         |

`emitido` significa que Connect observó en el SII un desenlace concluyente del envío. No certifica la
aceptación tributaria posterior ni la aceptación del receptor.

## Resultado desconocido [#resultado-desconocido]

Ocurre cuando el documento ya pudo salir hacia el SII, pero su respuesta no alcanza para afirmar el
desenlace; por ejemplo, si la conexión se corta a mitad del envío. Connect conserva la operación y
actualiza su estado automáticamente cuando puede confirmar el resultado.

Mientras tanto:

1. **No crees otra clave de idempotencia ni otra vista previa** para el mismo documento. Eso sí podría
   emitir un segundo documento.
2. **Repite la misma llamada de emisión con la misma clave.** No reenvía nada: devuelve el estado guardado
   de la operación mientras la reconciliación automática intenta cerrarlo. Funciona aunque la vista previa
   ya haya vencido.
3. Si sigue desconocido, entrega el `operacionId` a soporte.

En una factura (`sii.dte.emitir`), la operación termina como `rechazado` cuando Connect confirma que
el documento no se emitió. El `codigo` indica el motivo del cierre:

| `codigo`                  | Motivo del cierre                                        | Cuándo se cierra                                                          |
| ------------------------- | -------------------------------------------------------- | ------------------------------------------------------------------------- |
| `sii_emission_not_sent`   | El intento se cortó antes de enviar el documento al SII. | En la primera reconciliación, a menos de un minuto.                       |
| `sii_emission_not_in_rcv` | Connect confirmó que el documento no quedó emitido.      | Cuando la conexión sincroniza el RCV de ese mes, dentro de unas 34 horas. |

El cierre por `sii_emission_not_in_rcv` requiere que la conexión sincronice el Registro de Compras y
Ventas del mes de emisión. Si no lo sincroniza y la emisión no puede confirmarse, la operación sigue
como `resultado_desconocido` y requiere soporte.

## Reintentar sin duplicar [#reintentar-sin-duplicar]

* **Misma clave de idempotencia:** repetir la emisión devuelve el resultado guardado. Es la forma correcta
  de recuperarte de un corte de red, un timeout o un `connection_busy`.
* **Clave nueva, mismo `previewRef`:** tampoco emite un segundo documento. Cada vista previa se emite una
  sola vez, así que la llamada falla.
* **Clave nueva y vista previa nueva:** es otro documento. Úsala solo cuando el intento anterior terminó
  `rechazado` o falló con uno de los errores de abajo.
* **Misma clave con otro `previewRef`:** responde `idempotency_conflict`. Cada documento lleva su propia
  clave.

## Errores frecuentes [#errores-frecuentes]

Estos errores no son un resultado desconocido de emisión. Pueden surgir al validar la petición,
completar el receptor o preparar el documento. Sigue la acción indicada para cada caso.

| Código                                           | Cuándo                                                                                                                                                         | Qué hacer                                                                                                                                                                                                                                                             |
| ------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `validation_error` o `sii_dte_validation_failed` | El candidato no cumple el contrato, faltan datos para completar el receptor o sus totales no pueden prepararse.                                                | Revisa `details` cuando exista y la explicación de `message` y `suggested_fix`. Conserva los datos reales; si están fuera de la capacidad de Connect, usa otra vía de emisión. Consulta [errores por campo](/docs/emitir/validacion#errores-por-campo-en-rest-y-mcp). |
| `scope_not_granted`                              | La clave de API no tiene el permiso `sii:write`.                                                                                                               | Crea una clave con ese permiso: las claves no se editan.                                                                                                                                                                                                              |
| `sii_facturador_not_enabled`                     | La emisión no está activa en la conexión, o Emisso la cortó.                                                                                                   | Actívala en **Ajustes › Emisión en el SII** de la conexión y revisa [qué necesitas](/docs/emitir#qué-necesitas). Si todo está en orden, escribe al equipo de Emisso.                                                                                                  |
| `sii_facturador_not_enrolled`                    | La empresa no aparece en el Facturador Gratuito con la clave de la conexión.                                                                                   | Completa la inscripción en sii.cl, o conecta con una persona que represente a la empresa ahí.                                                                                                                                                                         |
| `sii_dte_type_not_authorized`                    | El SII no le permite a la persona de la conexión emitir ese tipo de documento en esa empresa. Pasa, por ejemplo, con quien sólo puede emitir facturas exentas. | Emite un tipo de `tiposDte.autorizados` en `conexiones.estado.consultar`. Si la empresa le da la autorización en sii.cl, vuelve a comprobarlo en **Ajustes** de la conexión.                                                                                          |
| `sii_emitter_profile_required`                   | La conexión no tiene elegidas la actividad económica y la dirección del emisor.                                                                                | Se eligen al terminar de conectar. Si la conexión quedó sin ellas, pulsa **Activar emisión** en **Ajustes › Emisión en el SII** de la conexión: el panel te pide elegirlas.                                                                                           |
| `sii_signing_material_required`                  | Falta la clave del certificado en la conexión, o la empresa no tiene certificado centralizado en el SII.                                                       | Entrega la clave en **Ajustes** de la conexión, o centraliza el certificado en sii.cl.                                                                                                                                                                                |
| `sii_preview_token_expired`                      | Pasaron más de 15 minutos desde la vista previa.                                                                                                               | Previsualiza de nuevo.                                                                                                                                                                                                                                                |
| `sii_preview_token_invalid`                      | La vista previa ya se emitió, es de otra conexión o la emite otro actor.                                                                                       | Previsualiza de nuevo con la misma clave de API con la que vas a emitir.                                                                                                                                                                                              |
| `sii_preview_changed`                            | Al emitir, el SII armó algo distinto de lo que previsualizaste.                                                                                                | Revisa una vista previa nueva antes de emitir.                                                                                                                                                                                                                        |
| `connection_busy`                                | Hay otra operación en curso en la misma conexión.                                                                                                              | Espera unos segundos y reintenta con la misma clave de idempotencia.                                                                                                                                                                                                  |
| `idempotency_in_progress`                        | Otro intento con esa misma clave sigue corriendo.                                                                                                              | Espera y repite con la misma clave.                                                                                                                                                                                                                                   |
| `sii_facturador_contract_changed`                | El formulario del SII cambió y ya no coincide con lo que Connect reconoce.                                                                                     | No reintentes. Escríbenos con el `request_id`.                                                                                                                                                                                                                        |

Los errores propios de la anulación están en [Anular o corregir un documento](/docs/emitir/anular-o-corregir#errores-frecuentes-de-la-anulación),
y el catálogo completo, en la [referencia de errores](/docs/referencia/errores#facturador-gratuito-sii).
