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 Link, 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.
Las boletas de honorarios emitidas y recibidas, y las de prestación de servicios de terceros.
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 y boletas de honorarios emitidas y recibidas, con la clave del SII de la empresa.
Hasta 100 documentos o 1.000 boletas al mes por empresa: 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 Link 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í: 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.