# Facturador Gratuito SII en beta

> Emite facturas 33/34, guías 52 y notas 56/61 con el Facturador Gratuito SII en beta. Activación por empresa, preparación, confirmación humana y emisión desde API, MCP o SDK.



**La emisión por Facturador Gratuito SII está disponible en beta en Emisso Connect.** Puedes integrar
la preparación y la emisión de facturas, guías y notas desde tu software o agente mediante API, MCP o
SDK. El flujo incluye una revisión y confirmación humana en Connect antes de solicitar el envío real
al SII.

La beta se activa por empresa con el equipo de Emisso. Un propietario o administrador configura el
perfil emisor, acepta las variantes incluidas y habilita su conexión SII. Los módulos de lectura
conservan su configuración independiente.

## Cómo empezar [#cómo-empezar]

1. Solicita al equipo de Emisso la activación de la beta para tu organización.
2. En [Conexiones](https://connect.emisso.ai/connections), abre la conexión SII y busca **Facturador
   Gratuito SII**. Pulsa **Cargar desde el SII**, elige actividad económica y dirección y guarda el
   perfil emisor.
3. Autoriza la preparación de DTE y las vistas previas. Comprueba que el certificado de firma esté
   verificado y pulsa **Activar opt-in de emisión**. Si la firma está pendiente, contacta al equipo
   para revisar la compatibilidad de tu certificado.
4. Prepara el primer documento desde tu integración y sigue el flujo de revisión y emisión de abajo.

La beta habilitada permite usar este flujo; cada empresa necesita completar su configuración. La
confirmación de una preparación todavía no emite: el envío lo solicita después la integración.

## Documentos incluidos [#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 [#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. La compatibilidad se verifica para cada conexión;
otros certificados o variantes requieren una revisión del equipo antes de habilitarlos.

El [runbook versionado de habilitación y revocación](https://github.com/emisso-ai/connect/blob/main/docs/runbooks/sii-facturador-beta.md)
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 [#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-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](/docs/referencia/errores#facturador-gratuito-sii).

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