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
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
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:
- No crees otra clave de idempotencia ni otra vista previa para el mismo documento. Eso sí podría emitir un segundo documento.
- 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.
- Si sigue desconocido, entrega el
operacionIda soporte.
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ó
rechazadoo falló con uno de los errores de abajo. - Misma clave con otro
previewRef: respondeidempotency_conflict. Cada documento lleva su propia clave.
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. 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, y el catálogo completo, en la referencia de errores.