Chile
En Chile, Floogos se conecta al SII (Servicio de Impuestos Internos) a través de OpenFactura, la plataforma de Haulmer. En lugar de armar el XML y hablar directo con el SII, el motor delega ese trabajo en OpenFactura: arma el documento con los datos del receptor y el detalle de ítems, se lo envía a OpenFactura por su API REST, y esta se encarga de timbrarlo y enviarlo al SII.
Modelo de integración
Sección titulada «Modelo de integración»- Vía plataforma, sin XML propio: Floogos no genera ni firma el XML tributario; OpenFactura hace ese trabajo y se encarga de la comunicación con el SII.
- Autenticación por API key: cada credencial
openfacturaguarda la API key (headerapikey) y el entorno (productiono sandbox de pruebas). - Documento único (DTE): todos los comprobantes electrónicos chilenos son Documentos Tributarios Electrónicos (DTE), diferenciados por su
dte_type_id. - IVA 19%: el Impuesto al Valor Agregado se calcula al 19% sobre los ítems afectos; los documentos exentos (tipo 34 o 41) se marcan aparte.
Tipos de DTE soportados
Sección titulada «Tipos de DTE soportados»| Código | Documento |
|---|---|
| 33 | Factura Electrónica |
| 34 | Factura No Afecta o Exenta |
| 39 | Boleta Electrónica |
| 41 | Boleta No Afecta o Exenta |
| 52 | Guía de Despacho Electrónica |
| 56 | Nota de Débito Electrónica |
| 61 | Nota de Crédito Electrónica |
Cuándo queda válido un documento
Sección titulada «Cuándo queda válido un documento»Un DTE no queda válido por el solo hecho de enviarlo a OpenFactura: el documento pasa por el proceso de timbraje y envío al SII, que le asigna un trackId de seguimiento. Recién cuando el estado consultado indica que el SII lo aceptó, el DTE tiene validez tributaria. Si el envío falla o el SII lo rechaza, hay que corregir los datos y volver a emitir.
Nodos disponibles
Sección titulada «Nodos disponibles»| Nodo | Descripción |
|---|---|
| OpenFacturaDTE | Emite el DTE (factura, boleta, nota de crédito/débito o guía de despacho) vía OpenFactura |
| OpenFacturaConsulta | Consulta el estado de un DTE por su ID de OpenFactura o por el trackId del SII |
| OpenFacturaPDF | Descarga el PDF o el XML de un DTE ya emitido |
Flujo típico
Sección titulada «Flujo típico»- OpenFacturaDTE — emite el documento con los datos del receptor y el detalle de ítems; devuelve el
dte_idy, cuando corresponde, eltrack_iddel SII. - OpenFacturaConsulta — se consulta el estado del DTE (por
dte_idotrack_id) hasta confirmar que el SII lo aceptó. - OpenFacturaPDF — una vez aceptado, se descarga el PDF o el XML para entregárselo al cliente o archivarlo.
- La credencial de tipo
openfacturaguarda la API key y el entorno (producción o sandbox); no requiere certificado digital propio, ya que la firma la gestiona OpenFactura. - Los tres nodos comparten la misma credencial
openfactura, así que basta con configurarla una vez por cliente.