Skip to main content
POST
Crear sesión de Tupana Connect
Es el primer paso de Tupana Connect: tu backend crea la sesión con su API key y le pasa al frontend solo el client_token. Tu API key nunca va al navegador y la clave del SII de tu usuario nunca pasa por tu código.

Abrir el widget

Con el token abres https://developers.tupana.ai/connect?token=… en un iframe o en una ventana. El token dura 30 minutos y sirve una sola vez: créalo justo cuando tu usuario hace clic en “Conectar empresa”.

Confirmar la conexión

El widget te avisa por postMessage con event: "success" cuando el usuario termina, pero eso solo sirve para cerrar tu modal. La conexión es real cuando tu backend recibe el webhook connection.active; si la clave estaba mala, llega connection.requires_action. Después la ves en Listar conexiones con su company_id.

Authorizations

Authorization
string
header
required

API Key para autenticación. Debe proporcionarse en el header Authorization con el formato: 'Api-Key YOUR-API-KEY' (incluye el prefijo 'Api-Key ' seguido de tu API key)

Body

application/json
capabilities
enum<string>[]

Qué podrá hacer la conexión: invoicing emite documentos, sii_data lee el registro de compras y ventas, banking lee cuentas y movimientos. Puedes pedir varias.

Available options:
invoicing,
sii_data,
banking
tax_id
string

RUT de la empresa a conectar. Si lo mandas, el widget no lo vuelve a pedir.

Example:

"78.152.641-K"

app_name
string

Nombre de tu app, se muestra dentro del widget.

Maximum string length: 120
Example:

"Mi ERP"

external_customer_id
string

Tu identificador del cliente. Vuelve en los webhooks de la conexión.

Maximum string length: 120
Example:

"cust_8841"

return_url
string<uri>

Si abres el widget en una ventana en vez de un iframe, adónde vuelve al terminar.

Example:

"https://mi-erp.cl/integraciones/tupana"

environment
enum<string>

Por defecto sigue al ambiente de tu API key. Una key de sandbox solo puede abrir sesiones sandbox.

Available options:
sandbox,
production

Response

Sesión creada

connect_session_id
string

Id de la sesión, con prefijo cses_.

Example:

"cses_4829301923847120394"

client_token
string

Token para abrir el widget: https://developers.tupana.ai/connect?token=…. Se muestra una sola vez.

Example:

"cst_9f2b7c1e4d8a..."

expires_at
string<date-time>
Example:

"2026-10-29T19:45:00+00:00"