Activar la emisión con un enlace desde tu sistema

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.

Antes de empezar

• 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).
• 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

1. Crea el enlace desde tu sistema

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

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:

{
  "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.

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

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.

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

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 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

• Emitir facturas y boletas con la conexión.
• El enlace de conexión para integradores: todos los campos, la página incrustada y los errores.
• Activar la emisión desde el panel, si la clave del certificado la tienes tú.