API de facturación electrónica SII para tu software

Tupana Developers es la infraestructura para que tu SaaS, ERP o marketplace emita documentos tributarios electrónicos (DTE) al SII de Chile, lea los registros del SII y conecte bancos. Tus clientes conectan su empresa una vez y tú emites por todas ellas desde tu producto.

Centro de ayuda

Videos paso a paso para cada integración y la documentación completa en docs.tupana.ai.

Tupana Connect · Conecta la empresa de tu cliente: Integra Tupana Connect para que tus clientes conecten su empresa con el SII y sus bancos.
Tupana API · Consultas de documentos: Consulta las facturas emitidas y recibidas de una empresa en el SII desde tu código.
Tupana API · Información bancaria: Obtén las cuentas y los movimientos bancarios de una empresa con la API.
Tupana API · Recaudación: Cobra a los clientes de tus usuarios con un link de pago que emite el documento al pagar.
Tupana MCP · Usa Tupana desde Claude: Conecta Tupana a Claude y trabaja la facturación desde una conversación.

SDKs oficiales

Tupana publica SDKs oficiales de código abierto (MIT) para Node.js y Python, con reintentos, Idempotency-Key automático, errores tipados y verificación de webhooks. Con la key de sandbox puedes emitir facturas de prueba: nada llega al SII.

Node.js / TypeScript

npm install tupana

import Tupana from "tupana";

const tupana = new Tupana({ apiKey: process.env.TUPANA_API_KEY }); // key de sandbox
const batch = await tupana.documents.createBatch({ documents: [{
  dte_type: { code: "33" },
  document_issuer: { rut: "76543210-3" },
  document_receiver: { rut: "77777777-7" },
  details: [{ item_name: "Asesoría contable", quantity: 1, unit_price: 150000 }],
}] }, { useDefaults: true });
const result = await tupana.documents.waitForBatch(batch.batch_id);

npm · GitHub

Python

pip install tupana

from tupana import Tupana

tupana = Tupana()  # lee TUPANA_API_KEY (tu key de sandbox)
batch = tupana.documents.create_batch([{
    "dte_type": {"code": "33"},
    "document_issuer": {"rut": "76543210-3"},
    "document_receiver": {"rut": "77777777-7"},
    "details": [{"item_name": "Asesoría contable", "quantity": 1, "unit_price": 150000}],
}], use_defaults=True)
result = tupana.documents.wait_for_batch(batch["batch_id"])

PyPI · GitHub

Ejemplos completos (emisión masiva, webhooks, agente con confirmación humana) en https://github.com/tupana-ai/tupana-examples.

API REST v2

Emisión en lote: POST https://api.tupana.ai/v2/documents/batch/ recibe hasta 500 documentos por llamada: factura (33), factura exenta (34), boleta (39/41), nota de débito (56), nota de crédito (61), guía de despacho (52) y exportación (110, 111, 112).
Asíncrona: responde 202 Accepted de inmediato y el SII procesa en segundo plano. El estado de cada documento llega por webhook (avisos de estado) o lo consultas en GET /v2/documents/{document_id}/states/.
Autenticación: header Authorization: Api-Key TU_API_KEY. La key vive en tu backend, nunca en el navegador.
Además: documentos programados, cesiones de facturas, folios y CAF, libros de compras y ventas del SII, búsqueda de empresas por RUT y conexiones por cliente.

Referencia completa en docs.tupana.ai y especificación OpenAPI v2 (JSON).

Facturador de mercado o facturador gratuito del SII

Cada empresa que conectas elige cómo emitir: con el facturador gratuito del SII, usando sus claves, o con el facturador de mercado de Tupana, que no tiene los topes del gratuito (3 referencias y 10 líneas por documento, alrededor de $100 millones por factura y de 600 a 700 facturas al mes). Tu integración es la misma y el precio también.

Servidor MCP

El servidor MCP de Tupana (https://mcp.tupana.ai/mcp) se conecta a Claude, Cursor, ChatGPT o cualquier cliente MCP. Expone herramientas para emitir y consultar documentos, buscar clientes por RUT, leer libros del SII, ver cobranza y conciliar movimientos bancarios, y también el contrato de facturación chilena para que un asistente escriba tu integración. Guía en tupana.ai/mcp.

SDK y ejemplos

Node.js / TypeScript: npm install tupana (paquete tupana en npm), repositorio https://github.com/tupana-ai/tupana-node.
Python: pip install tupana (PyPI), repositorio https://github.com/tupana-ai/tupana-python.
Ejemplos: emisión masiva, webhooks e integraciones en https://github.com/tupana-ai/tupana-examples.
La referencia trae ejemplos en curl, JavaScript y Python para cada endpoint.

Agentes de IA que facturan y cobran

Puedes construir agentes que emiten facturas, mandan cobranzas o concilian pagos con Tupana, ya sea conectando el servidor MCP o declarando los endpoints de la API como herramientas (tool calling) en tu modelo. La regla es la misma en los dos casos: el agente prepara el documento y una persona lo confirma antes de emitirlo al SII. Un DTE emitido no se borra (solo se anula con una nota de crédito), así que toda acción de escritura pide confirmación humana y queda auditada.

Validar el borrador antes de emitir (RUT, montos, referencias, límites del facturador).
Mostrar la vista previa y pedir confirmación explícita.
Emitir en lote y esperar el resultado por webhook, sin bloquear al usuario.

Precios en UF

Producto	Precio (neto, más IVA)	Incluye
Facturación	0,5 UF al mes por empresa que enroles	Hasta 100 documentos o 1.000 boletas de venta al mes por empresa. Facturas, boletas, notas de crédito y boletas de honorarios, con XML, PDF y estados del SII. Integrada al facturador gratuito del SII con las claves de la empresa (y si quieres, también puedes migrar al facturador de mercado de Tupana), al mismo precio. Solo por API: no incluye la plataforma web de Tupana. Sin precio mínimo.
Lectura bancaria	0,35 UF al mes por banco que enroles	Cuentas, saldos y movimientos sincronizados sin límite.
Lectura del SII	0,2 UF al mes por empresa	Registro de compras y ventas, y boletas de honorarios emitidas y recibidas.
Recaudación	2% de lo recaudado	Link de pago integrado a Transbank, con aviso por webhook cuando llega el dinero. Opcional, sin costo fijo.
Sandbox	Gratis	Ilimitado y sin plazo: empresas, facturas y webhooks de prueba.
Nómina de empresas del SII	Gratis	Busca cualquier empresa de Chile por nombre o RUT, sin credenciales del SII.

No hay costo fijo mensual ni cobro por documento: pagas solo por las empresas que enrolaste ese mes. Ejemplo: 10 empresas facturando = 5 UF al mes. Tabla completa, ejemplos y preguntas en precios de la API.

Los planes Independent (0,3 UF), Starter (1,0 UF), Pro (2,2 UF) y Enterprise (desde 4,5 UF) son de la plataforma web de Tupana, para empresas que facturan desde www.tupana.ai. Son otro producto y no son el precio de la API. Desde Starter, esos planes incluyen acceso a la API para las empresas de tu propia cuenta. Si construyes software que factura por tus clientes, el precio es el de esta página: 0,5 UF al mes por empresa enrolada. Ver los planes de la plataforma web.

Precios: integraciones para personas naturales (IVA incluido)

Producto	Precio (IVA incluido)	Incluye
Boletas de honorarios	$9.990 al mes por persona, IVA incluido	Hasta 100 boletas de honorarios al mes, emitidas en el SII con la clave de la persona. Retención calculada (receptor o emisor), PDF y estado de cada boleta.
Banca persona natural	$14.990 al mes por persona, IVA incluido	Cuentas personales con solo el RUT y la clave del banco: cuentas, saldos y movimientos sincronizados sin límite. Banco de Chile, Santander, BancoEstado, BCI, Itaú, Scotiabank y BICE.

Preguntas frecuentes

¿Cuánto cuesta la API de facturación electrónica de Tupana?

Facturación 0,5 UF al mes por empresa que enroles, lectura bancaria 0,35 UF por banco, lectura del SII 0,2 UF por empresa y recaudación 2% de lo recaudado. Todos netos, más IVA. No hay costo fijo mensual, no hay plan mínimo y no se cobra por documento emitido. Para personas naturales: boletas de honorarios $9.990 al mes (hasta 100 boletas) y banca persona natural $14.990 al mes, ambos con IVA incluido.

¿La API está incluida en los planes web?

Son productos distintos. Los planes web (Independent 0,3 UF, Starter 1,0 UF, Pro 2,2 UF y Enterprise desde 4,5 UF) son para facturar desde la plataforma www.tupana.ai, y desde Starter incluyen acceso a la API para las empresas de tu propia cuenta. Para integrar a tus clientes en tu software, la API de developers cuesta 0,5 UF al mes por empresa enrolada y no incluye la plataforma web.

¿Emite con el facturador gratuito del SII o con uno de mercado?

Con los dos. Cada empresa que conectas puede emitir con el facturador gratuito del SII (con sus claves) o con el facturador de mercado de Tupana, que no tiene los topes del gratuito (3 referencias, 10 líneas por documento, unos $100 millones por factura y 600 a 700 facturas al mes). El precio es el mismo.

¿Dónde queda la clave del SII de mi cliente?

En Tupana, cifrada. Tu usuario la escribe en el widget de conexión y tú te quedas solo con un connection_id. Nunca pasa por tu código.

¿Qué pasa si el SII se cae?

La emisión es asíncrona: Tupana reintenta y te avisa por webhook cuando el documento queda aceptado o rechazado. El folio no se pierde.

¿Sirve para construir con IA?

Sí. Conectas el servidor MCP (https://mcp.tupana.ai/mcp) a Claude, Cursor o ChatGPT y pides la funcionalidad en español. El asistente lee el contrato de facturación chilena (pasos, reglas del SII, estados y manejo asíncrono) y escribe el código contra tu propia base.