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. Las boletas tienen sus propios resultados y errores,
en Boletas 39 y 41.
| 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 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
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:
- 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.
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
- 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 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. |
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. 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, y el catálogo completo, en la referencia de errores.
Descargar el PDF de una factura, guía o nota
Descarga el PDF oficial de una factura 33 o 34, guía de despacho 52 o nota 56 o 61 emitida con el Facturador Gratuito del SII, por REST o MCP.
Conexiones
El vínculo con un sistema para un contribuyente o titular concreto: la unidad con la que Connect autoriza, sincroniza y factura.