Introducción a Integraciones

Sistema de Integraciones de Prisma

Prisma proporciona un sistema completo de integraciones que permite el intercambio bidireccional de información entre Prisma y otros sistemas empresariales.

Tipos de Integraciones

El sistema de integraciones de Prisma se divide en dos categorías principales:

📥 Integraciones de Entrada (Input)

Permiten enviar información hacia Prisma desde sistemas externos.

Casos de uso:

Carga de catálogo de productos
Actualización de precios
Sincronización de inventario
Gestión de tiendas y competidores
Configuración de promociones
Importación de clientes

Métodos disponibles:

API REST: Para actualizaciones en tiempo real
Archivos SFTP: Para carga masiva de datos

Ver documentación de Input →

📤 Integraciones de Salida (Output)

Permiten extraer información desde Prisma hacia sistemas externos.

Casos de uso:

Exportación de ventas
Reportes de stock
Datos de auditorías
Información de precios aplicados
Métricas de competencia
Análisis de promociones

Métodos disponibles:

API REST: Consultas en tiempo real
Webhooks: Notificaciones de eventos
Archivos SFTP: Exportaciones programadas

Ver documentación de Output → (próximamente)

Arquitectura de Integraciones

┌─────────────────────────────────────────────────────────────┐
│                    SISTEMAS EXTERNOS                        │
│  (ERP, POS, WMS, CRM, E-commerce, BI Tools)                │
└──────────────┬────────────────────────┬─────────────────────┘
               │                        │
        ┌──────▼──────┐          ┌──────▼──────┐
        │   INPUT     │          │   OUTPUT    │
        │ (Entrada)   │          │  (Salida)   │
        └──────┬──────┘          └──────▲──────┘
               │                        │
        ┌──────▼────────────────────────┴──────┐
        │           PRISMA CORE                 │
        │  • Catálogo    • Precios              │
        │  • Inventario  • Promociones          │
        │  • Ventas      • Competencia          │
        └───────────────────────────────────────┘

Métodos de Integración

API REST

Características:

✅ Comunicación sincrónica (request/response inmediato)
✅ Autenticación mediante OAuth2 (JWT tokens)
✅ Formato JSON para intercambio de datos
✅ Ideal para tiempo real y volúmenes pequeños a medianos
✅ HTTPS para comunicación segura

Cuándo usar:

Necesitas respuestas inmediatas
Trabajas con registros individuales o lotes pequeños
Integración desde aplicaciones web o móviles
Validación en tiempo real

Ejemplo de flujo:

Cliente → [POST /api/products] → Prisma
Cliente ← [200 OK + datos] ← Prisma

Archivos Planos (SFTP)

Características:

✅ Comunicación asíncrona (procesamiento diferido)
✅ Autenticación mediante credenciales SFTP
✅ Formato CSV/TXT (con compresión gzip)
✅ Ideal para carga masiva y procesos programados
✅ SFTP para transferencia segura

Cuándo usar:

Carga de miles o millones de registros
Procesos batch nocturnos o programados
Exportaciones completas de sistemas legacy
Sincronizaciones periódicas

Ejemplo de flujo:

Cliente → [Sube archivo via SFTP] → Servidor SFTP
Prisma → [Pull periódico] → Lee y procesa archivo
Cliente ← [Resultado en archivo de log] ← Servidor SFTP

Comparativa de Métodos

Aspecto	API REST	Archivos SFTP
Comunicación	Sincrónica	Asíncrona
Formato	JSON	CSV/TXT
Volumen ideal	Pequeño/Mediano	Grande/Masivo
Tiempo de respuesta	Inmediato (segundos)	Diferido (minutos/horas)
Autenticación	OAuth2 (JWT)	Credenciales SFTP
Complejidad técnica	Media	Baja
Uso de red	Por request	Por archivo
Validación	Inmediata	Post-procesamiento
Reintentos	Manual/automático	Reintentar subida

Seguridad

Todas las integraciones de Prisma implementan medidas de seguridad robustas:

API REST

🔒 HTTPS obligatorio (TLS 1.2+)
🔑 Autenticación OAuth2 con tokens JWT
⏱️ Tokens con expiración (1 hora por defecto)
🛡️ Rate limiting para prevenir abuso
📝 Auditoría completa de todas las operaciones

SFTP

🔒 Protocolo SFTP (SSH File Transfer Protocol)
🔑 Autenticación por usuario/contraseña o certificados
📁 Carpetas aisladas por cliente
📝 Logging de todas las transferencias
🔐 Compresión y cifrado de datos sensibles

Flujo Típico de Integración

1. Configuración Inicial

Solicitar credenciales a tu account manager de Prisma:
- Para API REST: client_id y client_secret
- Para SFTP: usuario, contraseña, host, carpeta
Revisar documentación específica de la integración
Configurar entorno de pruebas (sandbox)

2. Desarrollo

Implementar autenticación (API REST) o conexión (SFTP)
Desarrollar lógica de integración:
- Mapeo de datos
- Transformaciones necesarias
- Manejo de errores
Probar en sandbox con datos de prueba

3. Despliegue

Validar con datos reales en ambiente controlado
Implementar monitoreo y logging
Activar en producción
Monitorear primeras ejecuciones

Casos de Uso Comunes

E-commerce → Prisma (Input)

Escenario: Sincronizar catálogo de productos desde tienda online

Método recomendado: API REST (actualizaciones frecuentes)

Flujo:

Evento en e-commerce (nuevo producto, cambio de precio)
Webhook llama a tu middleware
Middleware transforma datos y llama API de Prisma
Prisma confirma la actualización

ERP → Prisma (Input)

Escenario: Carga nocturna de inventario desde ERP corporativo

Método recomendado: Archivos SFTP (carga masiva)

Flujo:

Job nocturno en ERP exporta inventario a CSV
CSV se comprime (gzip) y se sube a SFTP
Prisma procesa el archivo automáticamente
Logs de procesamiento disponibles en SFTP

Prisma → BI Tool (Output)

Escenario: Exportar ventas diarias para análisis

Método recomendado: Archivos SFTP (exportación programada)

Flujo:

Prisma genera archivo de ventas diariamente
Archivo se deposita en carpeta SFTP
BI Tool descarga archivo
Dashboards se actualizan automáticamente

Mejores Prácticas

General

✅ Implementar reintentos con exponential backoff
✅ Validar datos antes de enviar
✅ Loggear todas las operaciones para auditoría
✅ Monitorear tasas de error y latencias
✅ Usar ambientes de prueba antes de producción
✅ Documentar integraciones custom

API REST

✅ Renovar tokens antes de expiración
✅ Cachear respuestas cuando sea apropiado
✅ Paginar resultados grandes
✅ Comprimir payloads (gzip) si son grandes
✅ Implementar circuit breakers para fallos

SFTP

✅ Usar compresión gzip para archivos grandes
✅ Enviar solo deltas (cambios) cuando sea posible
✅ Incluir timestamp en nombres de archivo
✅ Archivar archivos procesados (no eliminar)
✅ Monitorear espacio en disco

Próximos Pasos

Explora la documentación específica según tu necesidad:

📥 Integraciones de Entrada

Introducción a Input - Conceptos y métodos
Autenticación API REST - Cómo obtener tokens
Formatos de Archivos - Especificaciones CSV/TXT
Etiquetas (Tags) - Metadatos personalizados
Códigos de Producto - EAN, Serie, IMEI
Competidores - Asignar competencia a tiendas

📤 Integraciones de Salida

Introducción a Output - (Próximamente)

Soporte y Recursos

Documentación Técnica

📚 API REST: Swagger/OpenAPI disponible en tu instancia
📚 Schemas de archivos: Consultar con tu account manager
📚 Postman Collection: Solicitar al equipo técnico

Canales de Soporte

📧 Email: soporte@prismaretail.ai
💬 Chat: Disponible en el portal de cliente
📞 Teléfono: Horario de atención 9-18h

Recursos Adicionales

🎓 Training: Sesiones de capacitación disponibles
🔧 Consultoría técnica: Para integraciones complejas
📊 Ejemplos de código: Repositorio de GitHub (privado)

Roadmap de Integraciones

Disponible Ahora ✅

API REST para Input/Output
SFTP para carga masiva
Webhooks básicos

Próximamente 🚀

GraphQL API
Webhooks avanzados con retry
Conectores pre-built (SAP, Salesforce, etc.)
SDK oficial en Python/JavaScript
Streaming de eventos (Kafka)

¿Listo para comenzar? Dirígete a la documentación de Input u Output según tu necesidad.