# Activar la emisión con un enlace desde tu sistema

> Si integras Emisso en tu producto y tu cliente conectó el SII solo para leer, crea por API un enlace para que escriba la clave del certificado y su conexión pase a emitir. Con demo animada de la llamada y de la pantalla que ve tu cliente.



<CompartirGuia />

Si integras Emisso en tu producto y tu cliente conectó el SII **con la clave de una persona que representa a
la empresa** solo para leer, puedes pasarlo a emitir sin que entre al panel de Emisso. Tu sistema crea un
enlace con una llamada a la API, se lo mandas, y tu cliente escribe la clave del certificado digital en una
página de Emisso. La conexión conserva su ID, sus datos y su sincronización: tu integración sigue igual y,
desde ese momento, también puede emitir facturas, notas de crédito y boletas.

La demo recorre la llamada que crea el enlace y la **pantalla real** que ve tu cliente al abrirlo. Puedes
pausarla, verla otra vez o tomar el control con «Probarlo yo». La llamada de la demo no sale de tu navegador,
el enlace no abre nada y la clave que escribas no se guarda.

<RecorridoDemo guion="activar-emision-enlace" />

## Antes de empezar [#antes-de-empezar]

<Callout type="warn" title="La emisión es real desde el primer documento">
  El SII no tiene ambiente de prueba para el Facturador Gratuito: todo lo que Emisso emita consume folio y le
  llega al SII y al receptor.
</Callout>

* **Una conexión del SII creada con clave de persona.** En `GET /v1/connections` se ve como
  `credential_scheme: "portal_credentials_representante"`. Una conexión con la clave de la empresa no emite
  y su acceso no cambia: para esa empresa crea una conexión nueva con clave de persona y `emitir: true`
  (ver [crear la sesión](/docs/plataformas/enlace-hosted#1-crear-la-sesión)).
* **Una API key con permiso sobre las conexiones** de tu organización.
* **La emisión habilitada para tu organización** y espacio en tu plan: una conexión que emite usa más de tu
  plan que una que solo lee.
* **Que tu cliente tenga la empresa inscrita en el Facturador Gratuito del SII**, con su certificado digital
  centralizado en sii.cl, y la clave de ese certificado a mano.

## Los pasos [#los-pasos]

### 1. Crea el enlace desde tu sistema [#1-crea-el-enlace-desde-tu-sistema]

Llama a `POST /v1/connect_sessions` con `mode: "activar_emision"` y el ID de la conexión:

```bash
curl -X POST https://connect.emisso.ai/api/v1/connect_sessions \
  -H "Authorization: Bearer connect_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "activar_emision",
    "connection_id": "conn_4ly7hnmw2tigryuxfjkr4"
  }'
```

La respuesta (`201`) trae la `url` del enlace:

```json
{
  "data": {
    "id": "cs_7f3ab9c1d2e4f5061728",
    "mode": "activar_emision",
    "connector_code": "sii",
    "connection_id": "conn_4ly7hnmw2tigryuxfjkr4",
    "status": "pending",
    "max_attempts": 5,
    "expires_at": "2026-11-09T12:00:00.000Z",
    "url": "https://connect.emisso.ai/c/connect_cs_..."
  }
}
```

Si la conexión no puede activarse, la llamada lo dice y no crea nada: `409 requiere_clave_de_persona` si
entra con la clave de la empresa, `409 emision_ya_activa` si ya emite y `428 connection_credential_required`
si su clave dejó de servir (renuévala antes con `mode: "reauth"`). La lista completa está en
[activar la emisión en una conexión existente](/docs/plataformas/enlace-hosted#activar-la-emisión-en-una-conexión-existente).

Desde un agente, es la herramienta `conexiones.enlace.crear` con `modo: "activar_emision"` y `conexionId`.
Sin código, es el botón **Pedir la clave a la empresa** en la pestaña Ajustes de la conexión, en el panel.

### 2. Mándale el enlace a la empresa [#2-mándale-el-enlace-a-la-empresa]

Muéstralo en tu producto o mándalo por correo o WhatsApp a la persona que tiene la clave del certificado.
La `url` llega **solo en esa respuesta**: guárdala o crea otra. El enlace vence en **24 horas**, sirve una
sola vez y crear otro para la misma conexión anula el anterior.

**Envía el enlace solo a quien tiene la clave del certificado.** El enlace funciona como una autorización:
quien lo completa activa la emisión de la empresa. Trátalo como una credencial y compártelo por un canal
privado. Si la clave no es la correcta, lo sabrás al emitir el primer documento: ese documento no sale y pides
la clave nueva con `mode: "cambiar_clave_certificado"`.

Para mostrarlo dentro de tu producto, agrega `allowed_origins` y `redirect_uri` a la llamada, igual que en
un [enlace de conexión](/docs/plataformas/enlace-hosted#3-incrustarlo-en-tu-producto).

### 3. La empresa escribe la clave del certificado [#3-la-empresa-escribe-la-clave-del-certificado]

Tu cliente abre una página de `connect.emisso.ai` con el nombre de tu organización y el RUT de la empresa.
Ve que la lectura de datos sigue igual y que se suma emitir a nombre de la empresa. No crea una cuenta, no
entra al panel y no ve precios. Escribe solo la **clave del certificado digital**: el RUT y la clave del SII
ya los tiene la conexión.

### 4. Activa la emisión [#4-activa-la-emisión]

Al pulsar **Activar emisión**, Emisso comprueba en el SII que la empresa esté inscrita en el Facturador
Gratuito y que haya un certificado para firmar. Si la empresa tiene más de una actividad económica o
dirección, tu cliente elige cuál usar en las facturas. Al terminar ve **Emisión activa**.

Tu sistema recibe el webhook [`connect_session.consumed`](/docs/operar/webhooks) con el mismo
`connection_id`: para un enlace de activar emisión, llega solo cuando la conexión ya emite. Si el SII dice que
la empresa no está inscrita o no tiene certificado, tu cliente ve qué hacer en sii.cl y el enlace sigue
sirviendo mientras no venza.

## Siguientes pasos [#siguientes-pasos]

* [Emitir facturas](/docs/emitir/facturas) y [boletas](/docs/emitir/boletas) con la conexión.
* [El enlace de conexión para integradores](/docs/plataformas/enlace-hosted): todos los campos, la página
  incrustada y los errores.
* [Activar la emisión desde el panel](/docs/como-conectar/activar-emision-sii), si la clave del certificado
  la tienes tú.


---

Esta página es parte de la documentación de Emisso Connect. El índice completo, con cada página y su descripción, está en https://connect.emisso.ai/llms.txt. Esta misma página en HTML: https://connect.emisso.ai/docs/plataformas/activar-emision-enlace.
