Facturador Gratuito SII en beta

La beta opera por conexión SII. No activa otras empresas ni cambia los módulos de lectura. Un owner o administrador configura el perfil emisor, acepta los contratos exactos y habilita la conexión. Cada emisión requiere además revisar y confirmar su preparación completa.

Documentos incluidos

Todas las variantes de esta beta admiten una sola línea de detalle por documento.

• Factura electrónica afecta 33: 33:del_giro:del_giro:credito.
• Factura electrónica exenta 34: 34:del_giro:del_giro:credito.
• Guía de despacho 52 que constituye venta: 52:constituye_venta.
• Nota de débito 56 que corrige montos de una factura exenta 34: 56:corregir_montos:34_exenta.
• Nota de crédito 61 que corrige montos de una factura exenta 34: 61:corregir_montos:34_exenta.

La forma exacta del portal se confirma al preparar. Que un documento aparezca en esta lista no prueba que una conexión particular sea compatible.

Antes de habilitarla

La organización debe estar incluida en el flag facturador-beta por su organization_id, y las puertas operativas globales y de la organización deben estar habilitadas por operación. La persona activa después el opt-in de emisión de cada conexión; ese acto no modifica las puertas operativas. La conexión debe estar activa, usar una credencial vigente de representante, tener el perfil emisor guardado y contar con autorización para preparar DTE y vistas previas. Para emitir, el certificado centralizado debe estar verificado y corresponder al producto e-cert FES02 cubierto por esta versión. Esa compatibilidad es acotada: el primer DTE real de esta beta aún no ha sido observado de punta a punta.

El runbook versionado de habilitación y revocación separa las tareas del operador de este flujo humano.

Si la empresa no aparece en el selector del Facturador Gratuito, primero completa su inscripción en sii.cl con el certificado digital del representante legal. Connect no selecciona ni activa empresas durante el alta.

Flujo de una operación

1. Tu integración llama sii.dte.previsualizar con el connectionId, el tipo, la variante exacta y los datos.
2. Connect persiste una preparación privada con vencimiento. Un owner o administrador la abre y revisa emisor, receptor, detalles, referencias y totales completos.
3. La persona confirma esa revisión e ingresa la clave del certificado en el formulario privado. La clave solo cruza esa Server Action; no forma parte de la API, el SDK, MCP, logs ni analítica.
4. La integración llama sii.dte.emitir con el previewRef confirmado y una clave de idempotencia estable.
5. Conserva operacionId. Un resultado emitido significa que Connect observó un desenlace concluyente de emisión en el SII; no certifica aceptación tributaria posterior ni aceptación del receptor.

La confirmación humana no emite por sí misma. Si la preparación vence o cambia, crea una vista previa nueva y vuelve a revisarla. Una preparación confirmada se consume una sola vez.

Resultado desconocido y replay

resultado_desconocido significa que Connect no puede afirmar si el SII emitió. No crees otra clave de idempotencia y no vuelvas a enviar el documento. Repite la consulta de la misma solicitud con la misma clave: el replay devuelve el estado persistido de esa operación mientras la reconciliación automática intenta cerrar el resultado. Si continúa desconocido, entrega operacionId a soporte.

rechazado es concluyente y puedeReintentar es false. Corrige la causa y prepara una operación nueva solo cuando corresponda. sii_signing_material_required y sii_signing_material_invalid cierran antes de la barrera de emisión: corrige el material de firma antes de continuar. sii_preparation_confirmation_required responde HTTP 428: un owner o administrador debe confirmar la preparación y la integración continúa con el mismo connectionId, previewRef e Idempotency-Key. La clave privada del certificado solo se ingresa en Connect; no pertenece a REST, MCP ni SDK. Consulta la referencia de errores.

Estos errores previos a la barrera no son un resultado_desconocido. Este último es un resultado durable de una operación que ya cruzó la barrera y conserva su identificador para reconciliación.

Revocar acceso

Desactiva el opt-in desde los ajustes de la conexión. La revocación impide operaciones nuevas; no borra la auditoría ni cambia el resultado de una operación ya concluida. Operación también puede retirar la habilitación de emisión de la organización como medida de cierre general, conservando su permiso de previsualización.

Esta beta no compromete disponibilidad del portal SII ni un SLA de emisión. Revisa el resultado canónico de cada operación antes de continuar un flujo contable.