Saltar al contenido principal

Integraciones

Configuración de integraciones con servicios externos: ChileCompra, Maimag, BigQuery y Fintoc.

Descripción​

Centro de configuración de todas las integraciones externas del sistema, permitiendo conectar con servicios de facturación electrónica, mercado público, analytics y banca automática.

Proveedores de Facturación Electrónica (IntegrationsComponent)​

La pantalla de Integraciones permite elegir el facturador (proveedor de facturación electrónica) de la empresa y configurar sus credenciales. Los proveedores soportados son:

SII vía Maimag​

Integración con el SII a través de Maimag mediante credenciales:

  • RUT SII (de solo lectura, toma el RUT de la empresa)
  • Clave SII (contraseña)
  • Botón de prueba que valida las credenciales y guarda el token de integración.

Bsale​

  • Token Bsale (obligatorio) — API token de Bsale.

RelBase​

  • Authorization Token (obligatorio) — Clave API de usuario RelBase.
  • Company Token (obligatorio) — Token de empresa RelBase.
  • Categoría por defecto (opcional) — ID numérico de categoría.
  • Bodega por defecto (opcional) — ID numérico de bodega.
  • Tipo de traslado — selector con 9 opciones (1: Operación constituye venta, 2: Ventas por efectuar, 3: Consignaciones, 4: Entrega gratuita, 5: Traslados internos, 6: Otros traslados no venta, 7: Guía de devolución, 8: Traslado para exportación (no venta), 9: Venta para exportación).
  • Botones para probar bodegas y categorías contra la API.

Haulmer (OpenFactura)​

  • Token Haulmer (obligatorio) — API key.
  • Actividad Económica (acteco) (obligatorio) — código numérico.
  • Código Sucursal SII (obligatorio).
  • Ambiente — selector dev / prod.
  • Botón de prueba que autocompleta el código de sucursal y la actividad económica desde la respuesta de la API.

A continuación se describen, a nivel conceptual, las integraciones del ecosistema completo de Marko (ChileCompra, Maimag, BigQuery, Fintoc), que se conectan en distintos puntos del sistema.

Integraciones Disponibles​

1. ChileCompra (Mercado Público)​

Propósito: Sincronización con portal de compras públicas de Chile

Configuración requerida:

  • Usuario ChileCompra
  • Contraseña / API Key
  • Ambiente (Producción / Testing)
  • RUT de la empresa

Funcionalidades:

  • Sincronización de licitaciones activas
  • Descarga de OC adjudicadas
  • Envío de ofertas
  • Consulta de estados

Módulos que usan:

Estado de conexión:

  • ✅ Conectado y sincronizando
  • ⚠️ Conectado con advertencias
  • ❌ Error de conexión
  • ⏸️ Pausado

2. Maimag (Facturación Electrónica SII)​

Propósito: Generación y envío de DTEs al Servicio de Impuestos Internos

Configuración requerida:

  • API Key de Maimag
  • Ambiente (Certificación / Producción)
  • RUT empresa
  • Actividad económica
  • Resolución de folios SII

Tipos de DTE soportados:

  • Factura Electrónica (33)
  • Guía de Despacho Electrónica (52)
  • Nota de Crédito Electrónica (61)
  • Nota de Débito Electrónica (56)

Funcionalidades:

  • Generación de DTEs
  • Timbraje electrónico
  • Envío al SII
  • Descarga de PDF y XML
  • Validación de folios

Módulos que usan:

Monitoreo:

  • Folios disponibles
  • DTEs enviados hoy/mes
  • Tasa de aceptación SII
  • Errores recientes

3. BigQuery (Google Cloud)​

Propósito: Data warehouse para analytics y catálogos de productos del mercado público

Configuración requerida:

  • Proyecto de Google Cloud
  • Dataset ID
  • Credenciales de servicio (JSON key)
  • Tablas configuradas

Datasets utilizados:

  • chile_compra_historico: Licitaciones históricas
  • productos_mercado_publico: Catálogo de productos
  • analytics_ventas: Métricas y reportes

Funcionalidades:

  • Consultas a catálogos
  • Análisis de mercado
  • Actualización de productos
  • Reportes avanzados

Módulos que usan:

Performance:

  • Queries ejecutadas (hoy/mes)
  • Tiempo promedio de respuesta
  • Costo estimado
  • Última sincronización

4. Fintoc (Banca Automática)​

Propósito: Vinculación automática de cuentas bancarias para conciliación

Configuración requerida:

  • API Key Fintoc
  • Secret Key
  • Ambiente (Sandbox / Production)

Bancos soportados (Chile):

  • Banco de Chile
  • Banco Estado
  • Santander
  • BCI
  • Scotiabank
  • Itaú
  • BICE
  • Otros

Funcionalidades:

  • Vinculación segura de cuentas (OAuth)
  • Sincronización diaria de movimientos
  • Obtención de saldos
  • Categorización automática
  • Conciliación con facturas

Configuración de cuentas:

  • Agregar cuenta bancaria
  • Autorizar acceso (redirect a banco)
  • Configurar frecuencia de sincronización
  • Mapeo de cuentas contables

Módulos que usan:

Seguridad:

  • Conexión encriptada
  • Tokens de acceso temporal
  • No se almacenan credenciales bancarias
  • Revocación de acceso en cualquier momento

Monitoreo:

  • Última sincronización
  • Movimientos descargados
  • Errores de conexión
  • Cuentas vinculadas activas

Panel de Integraciones​

Vista General​

Dashboard que muestra:

  • Estado de cada integración
  • Última sincronización
  • Errores recientes
  • Uso y límites (si aplica)

Acciones Disponibles​

  • Configurar: Establecer credenciales y parámetros
  • Probar conexión: Validar configuración
  • Sincronizar ahora: Forzar sincronización manual
  • Ver logs: Historial de operaciones
  • Pausar/Reactivar: Control de integración
  • Eliminar configuración: Desconectar servicio

Testing de Integraciones​

Ambientes​

Cada integración soporta:

  • Sandbox/Testing: Para pruebas sin afectar producción
  • Producción: Operación real

Recomendación: Probar en sandbox antes de pasar a producción

Validaciones​

  • Credenciales correctas
  • Permisos adecuados
  • Conectividad de red
  • Formatos de datos
  • Límites de uso

Troubleshooting​

Problemas Comunes​

ChileCompra:

  • Credenciales inválidas → Renovar en portal ChileCompra
  • Licitaciones no se sincronizan → Verificar permisos API

Maimag:

  • DTE rechazado → Validar datos empresa en SII
  • Sin folios → Solicitar nueva resolución SII

BigQuery:

  • Query lenta → Optimizar consulta o aumentar límites
  • Credenciales expiradas → Renovar service account key

Fintoc:

  • Banco no conecta → Re-autorizar acceso
  • Movimientos desactualizados → Forzar sincronización

Logs y Auditoría​

Cada integración registra:

  • Timestamp de operación
  • Tipo de acción (read, write, sync)
  • Usuario que ejecutó
  • Resultado (éxito/error)
  • Mensaje de error (si aplica)

Seguridad​

  • Credenciales encriptadas en base de datos
  • API Keys nunca visibles en frontend
  • Conexiones HTTPS/TLS
  • Tokens con expiración
  • Revocación inmediata posible

Mejores Prácticas​

  1. Probar en sandbox primero
  2. Monitorear logs regularmente
  3. Renovar credenciales periódicamente
  4. Documentar configuraciones específicas
  5. Notificar cambios al equipo
  6. Mantener backups de configuración

Enlaces Relacionados​

⬅️ Volver a Configuración | 🏠 Índice Principal