Construye facturación electrónica chilena con IA

Claude escribe el código y Tupana lo conecta. Con las especificaciones que mantiene Tupana (documentación, OpenAPI y servidor MCP), tu asistente de IA no genera solo el request: arma el flujo completo de tu producto, con formularios, validaciones, estados de carga, errores, pantallas de éxito y el manejo de webhooks. Funciona para emitir DTE al SII, leer el registro de compras y ventas, buscar empresas por RUT, cobrar con link de pago y leer bancos.

Dos formas de conectar tu IA

Conectar el servidor MCP

Claude Code

En la terminal, dentro de tu proyecto, agrega el servidor y autentícate con /mcp:

claude mcp add --transport http tupana https://mcp.tupana.ai/mcp

Codex

Agrega el servidor en ~/.codex/config.toml, reinicia Codex y aprueba el acceso en el navegador:

[mcp_servers.tupana]
url = "https://mcp.tupana.ai/mcp"

Claude Desktop y claude.ai

En Ajustes, Conectores, elige Añadir conector personalizado, pega la URL y aprueba el acceso con tu cuenta Tupana.

https://mcp.tupana.ai/mcp

ChatGPT

En Configuración, Conectores, elige Crear conector personalizado (requiere un plan con conectores) y pega la URL.

https://mcp.tupana.ai/mcp

Cursor

Agrega el servidor en .cursor/mcp.json de tu proyecto:

{ "mcpServers": { "tupana": { "url": "https://mcp.tupana.ai/mcp" } } }

Guía completa en docs.tupana.ai/user-guide/mcp. En sandbox los documentos no llegan al SII; emitir o cobrar en producción siempre pasa por tu cuenta Tupana.

Qué puede construir tu IA con Tupana

Facturación

Emite facturas, boletas, notas de crédito y boletas de honorarios al SII, con XML, PDF y estados. API: POST /v2/documents/batch/ y GET /v2/documents/{document_id}/states/. Webhooks: document.issued, document.rejected, document.issue_failed.

Lectura del SII

Lee el registro de compras y ventas y las boletas de honorarios emitidas y recibidas de cada empresa conectada. API: GET /v2/documents/?document_type=received. Webhooks: document.updated, credential.validated, credential.invalid.

Empresas

Busca cualquier empresa de Chile por RUT y precarga razón social, actividades y direcciones. Gratis y sin credenciales. API: GET /v2/master-entities/?rut=.

Recaudación

Cobra con un link de pago integrado a Transbank y recibe un webhook cuando llega el dinero. API: POST /v2/payment-requests/. Webhooks: payment_request.paid, payment_request.document_issued, payment_request.expired.

Lectura bancaria

Cada cliente conecta su banco en Tupana Link y lees sus abonos y cargos, sincronizados cada hora. API: GET /v2/documents/?dte_type__code__in=100,101. Webhooks: connection.active, connection.requires_action, document.paid.

Bancos y SII en la misma integración: API bancaria, API del SII y la comparación con otras opciones de Chile.

Prompts listos por producto

Cada producto tiene un prompt para Claude o Codex que apunta a las fuentes oficiales (llms-full.txt y OpenAPI v2) en vez de inventar campos. El de facturación, por ejemplo, pide implementar el enrolamiento de la empresa, el formulario de factura con validación, la emisión unitaria y en lote, el estado por webhook, la descarga del PDF y el XML, y las notas de crédito que referencian el documento original, todo partiendo en sandbox.

Tool calling: ejemplo de herramientas

Si tu agente corre dentro de tu SaaS, estas son tres herramientas típicas. La API key vive en tu backend como variable de entorno (TUPANA_API_KEY), nunca en el modelo ni en el navegador.

[
  {
    "name": "buscar_empresa_por_rut",
    "description": "Datos de una empresa chilena desde su RUT (GET /v2/master-entities/?rut=).",
    "input_schema": { "type": "object", "properties": { "rut": { "type": "string" } }, "required": ["rut"] }
  },
  {
    "name": "emitir_documentos",
    "description": "Emite DTE al SII en lote (POST /v2/documents/batch/). Solo después de que la persona confirme la vista previa.",
    "input_schema": { "type": "object", "properties": { "documents": { "type": "array" } }, "required": ["documents"] }
  },
  {
    "name": "estado_documento",
    "description": "Estado de un documento en el SII (GET /v2/documents/{document_id}/states/).",
    "input_schema": { "type": "object", "properties": { "document_id": { "type": "string" } }, "required": ["document_id"] }
  }
]

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.

Agentes seguros: la persona confirma

La regla es la misma con MCP o con tool calling: 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.

Más patrones en Agentes de IA que facturan, cobran y concilian.

Cuánto cuesta

En producción, Facturación cuesta 0,5 UF al mes por empresa enrolada, sin mínimo; el sandbox es gratis. Tabla completa en precios de la API.

Empieza en el sandbox gratis, prueba el flujo de conexión en Tupana Link o busca empresas en la nómina gratuita.

Preguntas frecuentes

¿Qué necesito para construir facturación chilena con IA?

Un asistente que hable MCP (Claude Code, Codex, Cursor, ChatGPT o Claude) conectado a https://mcp.tupana.ai/mcp, y una API key de sandbox de www.tupana.ai (consola de developers). El asistente lee el contrato de facturación (pasos, reglas del SII, estados y manejo asíncrono) y escribe el código contra tu base.

¿Uso el MCP o tool calling sobre la API?

El MCP sirve para que tu asistente de código construya la integración y para operar tu cuenta con OAuth. Tool calling sirve cuando el agente vive dentro de tu producto: declaras los endpoints de la API REST v2 como herramientas y llamas con tu API key desde tu backend.

¿Un agente puede emitir facturas solo?

Puede preparar y validar el documento, pero una persona confirma antes de emitir al SII. Un DTE emitido no se borra: solo se anula con una nota de crédito. Por eso toda escritura del MCP pide confirmación y queda auditada.

¿Cuánto cuesta?

Construir es gratis: el sandbox no tiene costo ni plazo. En producción, Facturación cuesta 0,5 UF al mes por empresa enrolada, lectura del SII 0,2 UF por empresa, bancos 0,35 UF por banco y recaudación 2% + IVA.