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

| Emisión                 | Anulación               | Qué significa                                                                         | Qué hacer                                                                                      |
| ----------------------- | ----------------------- | ------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| `emitido`               | `emitida`               | El SII confirmó el envío: el resultado trae `folio`, `fechaEmision` y `confirmadoEn`. | Guarda `folio` y `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, la factura 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 guarda la operación antes de
enviar y la reconcilia automáticamente contra el portal.

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.

## 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 llegan antes de que el documento salga hacia el SII, así que no son un resultado
desconocido: corrige la causa y vuelve a intentar.

| Código                                           | Cuándo                                                                                                                               | Qué hacer                                                                                               |
| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------- |
| `validation_error` o `sii_dte_validation_failed` | El candidato no cumple el contrato: un campo de más, un texto largo, un RUT inválido, un total que no cuadra. No se contactó al SII. | Corrige los campos que indica `details` y previsualiza de nuevo.                                        |
| `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 para la organización o para la conexión.                                                                   | 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_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, escribe al equipo de Emisso.         |
| `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 una factura](/docs/emitir/anular#errores-frecuentes),
y el catálogo completo, en la [referencia de errores](/docs/referencia/errores#facturador-gratuito-sii).
