La API del SII de Tupana lee los datos tributarios de las empresas que conectas: el Registro de Compras y Ventas (RCV), los documentos emitidos y recibidos con su traza y las boletas de honorarios. Con la misma integración también emites facturas, boletas y notas de crédito al SII. Tus clientes conectan su empresa en Tupana Connect, tú consultas por REST con una API key y recibes los cambios por webhook. Lectura: 0,2 UF al mes por empresa. Emisión: 0,5 UF al mes por empresa.
Todo se lee con la misma API key, el mismo company_id (ment_…) y el mismo formato de respuesta { data, meta, links }. La lectura usa la clave del SII de la propia empresa: no hace falta la del representante legal.
El detalle documento por documento del libro de compras y del libro de ventas (GET /v2/book-documents/), en el período en que el SII lo clasifica, con folio, tipo, fecha, contraparte, neto, exento, IVA, total, otros impuestos, fecha de recepción, acuse y reclamo.
Los totales del período por tipo de documento: cantidad, neto, exento, IVA y total (GET /v2/book-summaries/). Se habilita por empresa.
Las facturas, notas y guías que la empresa emitió o recibió (GET /v2/documents/ con document_type=issued o received), con su PDF y XML, sus datos del RCV y la traza del SII si los pides.
Cada evento de la traza del SII de un documento, emitido o recibido. Llega por el webhook document.trace_updated, con el rol de quien lo recibe.
Con la Lectura SII también das acuse de recibo, aceptas o reclamas las facturas que recibe la empresa. Tupana registra cada evento en el SII y lo confirma volviendo a leer la traza del documento.
Las boletas de honorarios recibidas y las de prestación de servicios de terceros emitidas por la empresa.
Las cesiones emitidas y recibidas de la empresa, para operaciones de factoring. Se habilitan por empresa.
Cada empresa conectada se sincroniza sola cada 24 horas: documentos emitidos y recibidos, libros de compras y ventas, boletas de honorarios y cesiones. Si tu producto necesita datos más frescos, hay planes de 12 y de 3 horas.
En el plan de 24 horas puedes pedir una sincronización a demanda con POST /v2/sync-requests/, por ejemplo justo después de conectar a un cliente nuevo. Es asíncrona: responde al tiro con status pending y te avisa a tu webhook_url cuando termina. GET /v2/sync-status/ te dice cuándo se actualizó cada tipo de dato, para mostrar en tu producto "actualizado hace 2 horas".
La misma API que lee también emite. POST /v2/documents/batch/ acepta hasta 500 documentos por llamada, responde de inmediato y te avisa el resultado de cada uno por webhook. Tupana es facturador de mercado: emite directo al SII con su propio facturador, o con el facturador gratuito del SII si la empresa lo prefiere, al mismo precio.
Ventas entre empresas, con referencias a orden de compra o HES.
Ventas a consumidor final, por ejemplo al confirmar el pago en tu tienda.
Corrigen o anulan un documento ya emitido, referenciándolo.
Con el tipo de traslado del SII.
La emite quien compra, con retención de IVA.
Factura, nota de débito y nota de crédito de exportación, en moneda extranjera.
Los folios (CAF) se piden solos cuando hacen falta. Detalle de la emisión en la API de factura electrónica.
El SII no tiene una API REST moderna. Integrarse directo es posible, y muchos equipos lo intentan, pero es un proyecto de meses y un costo de mantención que no termina. Esto es lo que te ahorras con una API intermedia como Tupana:
| Tema | Directo con el SII | Con la API de Tupana |
|---|---|---|
| Certificación | Postular como emisor con software propio y pasar el set de pruebas, la simulación, el intercambio y las muestras impresas. | No certificas nada: Tupana ya es facturador de mercado y las empresas emiten con él o con el facturador gratuito del SII. |
| Certificado digital | Necesitas el certificado digital de una persona autorizada por cada empresa, guardarlo y renovarlo. | Tú no guardas ni renuevas certificados: la firma la resuelve Tupana. |
| Firma XML | Armas el XML de cada DTE según el esquema del SII, lo firmas (XMLDSig), armas el sobre de envío y lo vuelves a firmar. | Mandas JSON. La API valida, timbra, firma y envía. |
| Folios (CAF) | Pides los rangos de folios al SII, los guardas y controlas que no se te acaben ni se repitan. | Se piden solos cuando hacen falta. |
| Protocolo | Servicios SOAP con autenticación por semilla y token, más el portal web para lo que no tiene servicio. | REST con JSON, una API key y webhooks firmados. |
| Lectura del RCV y la traza | Entrar al portal del SII empresa por empresa y descargar lo que necesitas, cuidando el límite de sesiones. | GET /v2/book-documents/ y GET /v2/documents/, sincronizados solos cada 24 horas o más seguido. |
| Estados | Consultar el estado de cada envío hasta que el SII responda. | Webhook document.issued, document.rejected o document.issue_failed. |
| Ambiente de pruebas | El ambiente de certificación del SII, separado y con datos de prueba propios. | Sandbox gratis con la misma API; nada llega al SII. |
Integrar directo tiene sentido si vas a ser facturador de mercado tú mismo. Si lo que necesitas es que tu producto lea y emita por tus clientes, una API te deja enfocarte en tu producto.
Los webhooks van firmados con HMAC (X-Pana-Signature), se reintentan y los SDKs oficiales traen la verificación de la firma.
| Evento | Cuándo llega |
|---|---|
| connection.active | La clave del SII de la empresa quedó validada. |
| connection.requires_action | La clave dejó de servir. Hay que volver a conectar. |
| document.issued | El SII aceptó un documento emitido. |
| document.rejected | El SII rechazó un documento. |
| document.trace_updated | Hay un acuse, reclamo o rechazo nuevo en la traza de un documento emitido o recibido. |
| sync_request.completed | Terminó una sincronización a demanda (a la webhook_url de la solicitud). |
Valores netos, más IVA, sin costo fijo ni mínimo. Ejemplo: 10 empresas facturando y leyendo el SII son 7 UF al mes. El sandbox es gratis. Tabla completa en precios de la API. Es el precio de developers; los planes de la plataforma web son otro producto.
Registro de compras y ventas, boletas de honorarios recibidas y de terceros emitidas por la empresa, y acuse de recibo o rechazo de las facturas recibidas, con la clave del SII de la empresa.
100 documentos (facturas, guías de despacho, facturas de exportación, notas de crédito y de débito, y boletas de honorarios de terceros) y 1.000 boletas de venta al mes por cada empresa (adicional: 0,004 UF por documento y 0,0004 UF por boleta de venta): facturas, boletas, notas de crédito y boletas de honorarios, con XML, PDF y estados del SII.
Para buscar cualquier empresa de Chile por RUT o por nombre no necesitas la clave de nadie. La nómina de empresas del SII y la búsqueda por RUT (razón social, actividades y direcciones) son gratis con cualquier API key. Ver API para consultar RUT de empresas.
El Registro de Compras y Ventas (detalle y resumen), los documentos emitidos y recibidos con su PDF, XML y traza, las boletas de honorarios emitidas, recibidas y de terceros, y las cesiones de facturas. Todo de las empresas que tus clientes conectan.
Sí. Con la misma integración emites facturas (33 y 34), boletas (39 y 41), notas de crédito y débito, guías de despacho, factura de compra y documentos de exportación, hasta 500 por llamada.
Para leer, la clave del SII de la empresa. Para emitir, la del representante legal con permisos. Tu cliente la escribe en Tupana Connect y tu backend nunca la ve: solo guardas el connection_id.
Cada 24 horas por defecto, con planes de 12 y de 3 horas. En el plan de 24 horas puedes pedir una sincronización a demanda con POST /v2/sync-requests/ y recibir el aviso en tu webhook_url.
Solo si vas a certificarte como facturador. Integrarse directo significa certificado digital, firma XML, manejo de folios (CAF), servicios SOAP y leer el portal empresa por empresa. Con una API mandas JSON y recibes webhooks.
Sí, con la Lectura SII. Das acuse de recibo, aceptas o reclamas (por contenido, falta total o falta parcial) las facturas recibidas: una por una por la API o varias a la vez desde el MCP. Tupana registra el evento en el SII y lo confirma volviendo a leer la traza. El SII lo permite dentro de los 8 días desde la recepción y no en documentos pagados al contado.
Sí: connection.active y connection.requires_action para la clave, document.issued y document.rejected para la emisión, document.trace_updated para acuses y reclamos, y sync_request.completed para las sincronizaciones a demanda.
Leer el SII cuesta 0,2 UF al mes por empresa y emitir, 0,5 UF al mes por empresa, más IVA y sin mínimo. El sandbox es gratis.
Sí, con la misma integración. Ver la API bancaria y bancos y SII en una sola API.