Skip to main content
Si eres un SaaS, un ERP o un estudio contable, no integras una empresa: integras cientos. En Tupana eso es una sola integración. La API key es por usuario y opera sobre todas las empresas conectadas a ese usuario; cada empresa se conecta una vez (una conexión o credencial por empresa, por eso se le dice multicredencial) y desde ahí la eliges por su RUT en cada documento.

​
Cómo se arma

1

Cada cliente conecta su empresa con Tupana Link

Tu backend abre una sesión (POST /v2/connect-sessions/) y tu frontend muestra el widget. Tu cliente entrega su clave adentro del widget: tú nunca la ves. Manda tu propio id de cliente en external_customer_id para cruzarlo después.
El detalle del widget y sus eventos está en Tupana Link.
2

Guardas la conexión cuando queda activa

El webhook connection.active trae connection_id (cred_…), company_id (ment_…) y tu external_customer_id. Guarda los tres. El evento success del widget solo sirve para cerrar el modal; la fuente de verdad es el webhook.
3

Emites eligiendo la empresa por RUT

En cada documento, document_issuer.rut dice a nombre de qué empresa se emite. Si facturas para varias empresas a la vez, arma un lote por empresa emisora: así cada lote tiene un resultado y un reintento independiente.
4

Un webhook por empresa

Los webhooks se crean por master_entity_id. Crea uno por cada empresa al recibir connection.active, apuntando a la misma URL de tu backend; el payload trae el emisor para que sepas de quién es cada evento. Ver Recibir avisos de estado.

​
Mantener las conexiones sanas

  • GET /v2/connections/ lista todas las empresas conectadas, con su giro, dirección, ambiente (sandbox o production) y status.
  • Cuando una clave deja de funcionar, la conexión pasa a requires_action y llega el webhook connection.requires_action. No hay nada que reintentar desde tu lado: pide a tu cliente que reconecte con Tupana Link.
  • Para dar de baja una empresa, usa Desactivar una conexión.

​
Permisos

  • La key ve las empresas a las que tiene acceso su usuario. Si tu equipo tiene varias personas, crea las keys con un usuario de integración y no con una cuenta personal.
  • Emitir requiere que el usuario tenga permiso de emisión en esa empresa; sin él, el acceso es de solo lectura.
  • Las keys de sandbox nunca operan sobre datos reales. Prueba el alta de clientes completa en sandbox antes de abrir producción.

​
Precios para integradores

Facturación por API cuesta 0,5 UF al mes por empresa que enroles, sin precio mínimo. Ver Precios.

​
Relacionado