SuperFaktúra
SuperFaktúra es un sistema eslovaco de facturación y contabilidad online. Esta integración permite importar sus clientes desde SuperFaktúra directamente a Deratix.
Configuración
La conexión debe estar configurada antes de la primera importación. Si la tarjeta SuperFaktúra muestra Requiere configuración o la importación no está disponible, pida al administrador o al soporte de Deratix que configure la conexión.
Datos Necesarios
Para configurar la conexión se necesitan tres datos de la cuenta SuperFaktúra:
| Dato | Dónde encontrarlo |
|---|---|
| Email usado para iniciar sesión en SuperFaktúra | |
| Clave API | SuperFaktúra → Herramientas → Acceso API |
| Company ID | SuperFaktúra → Herramientas → Acceso API (número de empresa) |
Obtener la Clave API
- Inicie sesión en SuperFaktúra.
- Abra Herramientas en el menú principal.
- Seleccione Acceso API.
- Copie:
- API Token (cadena de texto larga)
- Company ID (número)
Nota: Comparta los datos de acceso solo con la persona que administra su instalación de Deratix. No los guarde en notas de protocolos ni en documentos públicos.
Prueba de Conexión
Después de la configuración, recomendamos probar la conexión:
- Abra Integraciones en la aplicación.
- En la tarjeta SuperFaktúra, haga clic en Test.
- Espere el resultado:
- ✅ La conexión funciona - la configuración es correcta
- ❌ Error - revise los datos introducidos
Errores Frecuentes
| Error | Solución |
|---|---|
| Credenciales no válidas | Revise el email y la clave API |
| Company ID no válido | Verifique el número de empresa en SuperFaktúra |
| Fallo de conexión | Revise la conexión a internet |
Importar Clientes
Iniciar la Importación
- Abra Integraciones.
- En la tarjeta SuperFaktúra, haga clic en Importar.
- Espere a que se carguen y analicen los clientes.
Preparación de la Importación
El sistema automáticamente:
- Descarga todos los clientes desde SuperFaktúra.
- Consolida clientes por Company ID (clientes con el mismo Company ID se convierten en un cliente con varias direcciones).
- Compara con la base de clientes existente.
- Muestra un resumen para aprobación.
Estados de Clientes
Tras el análisis, los clientes se dividen en tres categorías. El resumen aparece en el panel de estadísticas:
| Estado | Color | Significado | Acción predeterminada |
|---|---|---|---|
| Nuevo | Verde | Todavía no existe un cliente con este Company ID | Importar |
| Existe | Azul | Ya existe un cliente con el mismo Company ID | Actualizar |
| Duplicado | Rojo | Se han encontrado varias coincidencias posibles | Omitir |
Tabla de Importación
La tabla muestra todos los clientes de SuperFaktúra:
| Columna | Descripción |
|---|---|
| Nombre | Nombre de persona o empresa |
| Company ID | Número de identificación de la organización |
| Email de contacto | |
| Direcciones | Número de direcciones (facturación + entrega) |
| Estado | Nuevo / Existe / Duplicado |
| Acción | Importar / Actualizar / Omitir |
Elegir la Acción
Puede elegir una acción para cada cliente:
- Importar - crea un nuevo cliente en Deratix
- Actualizar - actualiza los datos de un cliente existente
- Omitir - el cliente no se importa
Comparar Datos
En clientes con estado Existe o Duplicado, puede comparar los datos:
- Haga clic en el icono 👁 en la fila del cliente.
- Se abre un diálogo de comparación:
- Izquierda: datos de SuperFaktúra
- Derecha: datos actuales en Deratix
- Las diferencias se resaltan
- Decida qué acción usar.
Selección Masiva
Para acelerar el trabajo, puede usar acciones masivas:
- Seleccionar todo - selecciona todos los clientes de la página
- Borrar selección - desmarca los clientes seleccionados
Ejecución
- Revise los clientes seleccionados y sus acciones.
- Haga clic en Importar (cantidad).
- Espere a que finalice.
Durante la importación se muestra:
- Porcentaje completado
- Número de clientes importados
- Número de clientes actualizados
- Número de clientes omitidos
Resultado de la Importación
Al finalizar se muestra un resumen:
| Categoría | Icono | Descripción |
|---|---|---|
| Importados | ✅ | Clientes creados |
| Actualizados | 🔄 | Clientes con datos actualizados |
| Omitidos | ⏭️ | Clientes sin cambios |
| Errores | ❌ | Operaciones fallidas, si las hubo |
Haga clic en Ver clientes para abrir la base de clientes.
Qué se Importa
Desde SuperFaktúra se importan estos datos:
Datos Básicos del Cliente
- Nombre de empresa / persona
- Company ID, ID fiscal, ID de IVA
- Email de contacto
- Número de teléfono
- Persona de contacto
Direcciones
- Dirección de facturación - calle, ciudad, código postal
- Direcciones de entrega - se importan como sedes del cliente
Consolidación por Company ID
SuperFaktúra puede contener varios registros con el mismo Company ID, por ejemplo diferentes sedes. Deratix los consolida automáticamente:
- Clientes con el mismo Company ID se fusionan en un cliente.
- Diferentes direcciones se importan como sedes.
- Se conservan todos los datos de contacto disponibles.
Paginación y Ordenación
Ordenación
Ordene la tabla haciendo clic en los encabezados de columna:
- Nombre (A-Z, Z-A)
- Company ID
- Número de direcciones
- Estado
Paginación
Con muchos clientes aparece paginación. Navegue con « y ».
Repetir la Importación
Puede repetir la importación en cualquier momento:
- Los clientes nuevos de SuperFaktúra se añaden.
- Los clientes existentes pueden actualizarse.
- Los clientes ya importados se omiten si no cambia la acción.
Consejo: Las importaciones regulares mantienen la base de clientes alineada con SuperFaktúra.
Solución de Problemas
La Importación es Lenta
- En la primera importación se descargan todos los clientes.
- La espera depende del número de clientes en SuperFaktúra.
- Tenga paciencia con cuentas que contienen miles de clientes.
Falta un Cliente
- Compruebe que el cliente tenga datos básicos en SuperFaktúra.
- Los clientes sin nombre no se pueden importar.
Registros Duplicados
- Los clientes se emparejan por Company ID.
- Los clientes sin Company ID siempre se crean como nuevos.
- Después de importar, revise duplicados en la base de clientes.
Error de Conexión Durante la Importación
- La importación se detiene automáticamente.
- Revise la conexión a internet.
- Ejecute la importación de nuevo - los clientes ya importados se omiten.
Consejos para una Importación Eficiente
Consejo: Antes de la primera importación, limpie clientes duplicados en SuperFaktúra.
Consejo: En la primera importación, empiece con una muestra más pequeña y revise el resultado.
Consejo: Los clientes se emparejan por Company ID. Asegúrese de que los Company ID estén rellenados correctamente.
Consejo: Después de importar, revise direcciones y contactos en el detalle del cliente.
Consejo: Use la acción Actualizar para sincronizar cambios desde SuperFaktúra.