rckrdmrd/erp-core
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
0086695b4c
erp-core/docs/00-vision-general/INTEGRACIONES-EXTERNAS.md
rckrdmrd 0086695b4c
Some checks failed
ERP Core CI / Backend Lint (push) Has been cancelled
Details
ERP Core CI / Backend Unit Tests (push) Has been cancelled
Details
ERP Core CI / Backend Integration Tests (push) Has been cancelled
Details
ERP Core CI / Frontend Lint (push) Has been cancelled
Details
ERP Core CI / Frontend Unit Tests (push) Has been cancelled
Details
ERP Core CI / Frontend E2E Tests (push) Has been cancelled
Details
ERP Core CI / Database DDL Validation (push) Has been cancelled
Details
ERP Core CI / Backend Build (push) Has been cancelled
Details
ERP Core CI / Frontend Build (push) Has been cancelled
Details
ERP Core CI / CI Success (push) Has been cancelled
Details
Performance Tests / Lighthouse CI (push) Has been cancelled
Details
Performance Tests / Bundle Size Analysis (push) Has been cancelled
Details
Performance Tests / k6 Load Tests (push) Has been cancelled
Details
Performance Tests / Performance Summary (push) Has been cancelled
Details
[SIMCO-V38] feat: Actualizar a SIMCO v3.8.0 + cambios backend 
- HERENCIA-SIMCO.md actualizado con directivas v3.7 y v3.8
- Actualizaciones en modulos CRM y OpenAPI

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-10 08:53:05 -06:00

449 lines
10 KiB
Markdown
Raw Blame History

---
id: INTEGRACIONES-EXTERNAS-ERP-CORE
title: Integraciones Externas - ERP Core
type: Technical
status: Published
version: 1.0.0
created_date: 2026-01-10
updated_date: 2026-01-10
---
# Integraciones Externas - ERP Core
> Catalogo completo de integraciones con servicios externos
## Resumen
ERP Core integra multiples servicios externos para proveer funcionalidades de billing, comunicaciones, almacenamiento e inteligencia artificial.
---
## 1. Catalogo de Integraciones
| ID | Servicio | Proveedor | Modulo | Estado |
|----|----------|-----------|--------|--------|
| INT-001 | Billing | Stripe | MGN-016 | Planificado |
| INT-002 | Email | SendGrid/SES | MGN-008 | Planificado |
| INT-003 | Push | Web Push API | MGN-008 | Planificado |
| INT-004 | WhatsApp | Meta Cloud API | MGN-021 | Planificado |
| INT-005 | Storage | S3/R2/MinIO | N/A | Planificado |
| INT-006 | Cache/Queue | Redis/BullMQ | N/A | Planificado |
| INT-007 | LLM Gateway | OpenRouter | MGN-020 | Planificado |
| INT-008 | Transcripcion | OpenAI Whisper | MGN-021 | Planificado |
| INT-009 | Vision/OCR | Google Vision | MGN-021 | Planificado |
---
## 2. INT-001: Stripe (Billing)
### 2.1 Descripcion
Stripe provee la infraestructura de pagos para suscripciones, facturacion y gestion de metodos de pago.
### 2.2 Caracteristicas
- Suscripciones recurrentes (mensual/anual)
- Trial periods configurables
- Upgrade/downgrade con prorateo
- Webhooks para sincronizacion
- Portal de cliente integrado
- Multiples monedas (USD, MXN)
### 2.3 Configuracion
```env
# Variables de entorno requeridas
STRIPE_SECRET_KEY=sk_live_...
STRIPE_PUBLISHABLE_KEY=pk_live_...
STRIPE_WEBHOOK_SECRET=whsec_...
```
### 2.4 Webhooks Requeridos
| Evento | Accion |
|--------|--------|
| customer.subscription.created | Activar suscripcion |
| customer.subscription.updated | Actualizar plan |
| customer.subscription.deleted | Cancelar suscripcion |
| invoice.paid | Registrar pago |
| invoice.payment_failed | Notificar fallo |
### 2.5 Documentacion
- [Stripe Docs](https://stripe.com/docs)
- [Stripe API Reference](https://stripe.com/docs/api)
---
## 3. INT-002: SendGrid/SES (Email)
### 3.1 Descripcion
Servicios de email transaccional para notificaciones, verificaciones y comunicaciones con usuarios.
### 3.2 Proveedores Soportados
| Proveedor | Caso de uso |
|-----------|-------------|
| SendGrid | Principal - alto volumen |
| AWS SES | Alternativo - bajo costo |
| SMTP generico | Desarrollo/self-hosted |
### 3.3 Configuracion SendGrid
```env
SENDGRID_API_KEY=SG...
SENDGRID_FROM_EMAIL=noreply@example.com
SENDGRID_FROM_NAME=ERP Core
```
### 3.4 Configuracion AWS SES
```env
AWS_SES_ACCESS_KEY_ID=AKIA...
AWS_SES_SECRET_ACCESS_KEY=...
AWS_SES_REGION=us-east-1
AWS_SES_FROM_EMAIL=noreply@example.com
```
### 3.5 Templates de Email
| Template | Uso |
|----------|-----|
| welcome | Bienvenida a nuevo usuario |
| verify_email | Verificacion de email |
| password_reset | Reset de password |
| invoice_paid | Factura pagada |
| trial_ending | Trial por terminar |
### 3.6 Documentacion
- [SendGrid Docs](https://docs.sendgrid.com/)
- [AWS SES Docs](https://docs.aws.amazon.com/ses/)
---
## 4. INT-003: Web Push API (Notificaciones Push)
### 4.1 Descripcion
Notificaciones push para navegadores web usando el estandar Web Push con VAPID.
### 4.2 Configuracion
```env
VAPID_PUBLIC_KEY=BJ...
VAPID_PRIVATE_KEY=...
VAPID_SUBJECT=mailto:admin@example.com
```
### 4.3 Generacion de Claves VAPID
```bash
npx web-push generate-vapid-keys
```
### 4.4 Documentacion
- [Web Push Protocol](https://web.dev/push-notifications/)
- [web-push npm](https://www.npmjs.com/package/web-push)
---
## 5. INT-004: Meta WhatsApp Business (Mensajeria)
### 5.1 Descripcion
WhatsApp Business Cloud API para comunicacion con clientes via WhatsApp, integrado con IA conversacional.
### 5.2 Configuracion
```env
WHATSAPP_ACCESS_TOKEN=EAA...
WHATSAPP_PHONE_NUMBER_ID=123456789
WHATSAPP_WABA_ID=987654321
WHATSAPP_WEBHOOK_VERIFY_TOKEN=my-verify-token
```
### 5.3 Webhooks
| Evento | Accion |
|--------|--------|
| messages | Procesar mensaje entrante |
| message_status | Actualizar estado (sent/delivered/read) |
### 5.4 Templates Pre-aprobados
Los templates de WhatsApp deben ser aprobados por Meta antes de usarse:
| Template | Uso |
|----------|-----|
| order_confirmation | Confirmacion de pedido |
| payment_reminder | Recordatorio de pago |
| shipping_update | Actualizacion de envio |
### 5.5 Documentacion
- [WhatsApp Business API](https://developers.facebook.com/docs/whatsapp/cloud-api)
---
## 6. INT-005: S3/R2/MinIO (Storage)
### 6.1 Descripcion
Almacenamiento de archivos compatible con S3 API para documentos, imagenes y assets.
### 6.2 Proveedores Soportados
| Proveedor | Caso de uso |
|-----------|-------------|
| AWS S3 | Produccion - alta disponibilidad |
| Cloudflare R2 | Alternativo - sin egress fees |
| MinIO | Self-hosted / desarrollo |
### 6.3 Configuracion AWS S3
```env
AWS_ACCESS_KEY_ID=AKIA...
AWS_SECRET_ACCESS_KEY=...
AWS_REGION=us-east-1
AWS_S3_BUCKET=erp-core-files
```
### 6.4 Configuracion Cloudflare R2
```env
R2_ACCESS_KEY_ID=...
R2_SECRET_ACCESS_KEY=...
R2_ENDPOINT=https://xxx.r2.cloudflarestorage.com
R2_BUCKET=erp-core-files
```
### 6.5 Configuracion MinIO
```env
MINIO_ENDPOINT=http://localhost:9000
MINIO_ACCESS_KEY=minioadmin
MINIO_SECRET_KEY=minioadmin
MINIO_BUCKET=erp-core-files
```
### 6.6 Documentacion
- [AWS S3 Docs](https://docs.aws.amazon.com/s3/)
- [Cloudflare R2 Docs](https://developers.cloudflare.com/r2/)
- [MinIO Docs](https://min.io/docs/minio/linux/index.html)
---
## 7. INT-006: Redis/BullMQ (Cache y Colas)
### 7.1 Descripcion
Redis para cache de datos y BullMQ para colas de trabajos asincronos.
### 7.2 Casos de Uso
| Uso | Proposito |
|-----|-----------|
| Session store | Almacenar sesiones de usuario |
| Cache | Cache de queries frecuentes |
| Rate limiting | Control de limite de requests |
| Job queue | Colas para webhooks, emails, etc. |
### 7.3 Configuracion
```env
REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_PASSWORD=
REDIS_TLS=false
```
### 7.4 Colas Definidas
| Cola | Procesador | Uso |
|------|------------|-----|
| email | EmailProcessor | Envio de emails |
| webhook | WebhookProcessor | Envio de webhooks |
| notification | NotificationProcessor | Notificaciones push |
| llm | LLMProcessor | Requests a LLM |
### 7.5 Documentacion
- [Redis Docs](https://redis.io/docs/)
- [BullMQ Docs](https://docs.bullmq.io/)
---
## 8. INT-007: OpenRouter (LLM Gateway)
### 8.1 Descripcion
Gateway unificado para acceder a multiples modelos de lenguaje (LLM) con una sola API key.
### 8.2 Modelos Disponibles
| Modelo | ID | Costo/1M tokens | Uso |
|--------|----|-----------------:|-----|
| Claude 3 Haiku | anthropic/claude-3-haiku | $0.25 | Default |
| Claude 3 Sonnet | anthropic/claude-3-sonnet | $3.00 | Premium |
| GPT-4o-mini | openai/gpt-4o-mini | $0.15 | Fallback |
| GPT-3.5 Turbo | openai/gpt-3.5-turbo | $0.50 | Fallback |
| Mistral 7B | mistralai/mistral-7b | $0.06 | Economico |
| Llama 3 | meta-llama/llama-3-8b | $0.20 | Open source |
### 8.3 Configuracion
```env
OPENROUTER_API_KEY=sk-or-v1-...
LLM_MODEL_DEFAULT=anthropic/claude-3-haiku
LLM_MODEL_FALLBACK=openai/gpt-3.5-turbo
LLM_MAX_TOKENS=1000
LLM_TEMPERATURE=0.7
LLM_BASE_URL=https://openrouter.ai/api/v1
```
### 8.4 Rate Limits
Los rate limits dependen del modelo y plan de OpenRouter.
### 8.5 Documentacion
- [OpenRouter Docs](https://openrouter.ai/docs)
---
## 9. INT-008: OpenAI Whisper (Transcripcion)
### 9.1 Descripcion
Transcripcion de audio a texto para procesamiento de notas de voz en WhatsApp.
### 9.2 Configuracion
```env
OPENAI_API_KEY=sk-...
WHISPER_MODEL=whisper-1
```
### 9.3 Formatos Soportados
- MP3, MP4, MPEG, MPGA, M4A, WAV, WEBM
- Maximo 25 MB por archivo
### 9.4 Documentacion
- [Whisper API](https://platform.openai.com/docs/guides/speech-to-text)
---
## 10. INT-009: Google Vision (OCR)
### 10.1 Descripcion
Vision por computadora para reconocimiento de texto en imagenes (OCR) y deteccion de productos.
### 10.2 Casos de Uso
| Caso | Descripcion |
|------|-------------|
| OCR de productos | Extraer nombre/precio de fotos |
| Codigo de barras | Detectar y decodificar barcodes |
| Etiquetas | Extraer texto de etiquetas |
### 10.3 Configuracion
```env
GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json
GOOGLE_VISION_PROJECT_ID=my-project
```
### 10.4 Documentacion
- [Cloud Vision API](https://cloud.google.com/vision/docs)
---
## 11. Variables de Entorno Consolidadas
```env
# ==========================================
# STRIPE (Billing)
# ==========================================
STRIPE_SECRET_KEY=sk_live_...
STRIPE_PUBLISHABLE_KEY=pk_live_...
STRIPE_WEBHOOK_SECRET=whsec_...
# ==========================================
# EMAIL (SendGrid)
# ==========================================
SENDGRID_API_KEY=SG...
SENDGRID_FROM_EMAIL=noreply@example.com
SENDGRID_FROM_NAME=ERP Core
# ==========================================
# PUSH NOTIFICATIONS (VAPID)
# ==========================================
VAPID_PUBLIC_KEY=BJ...
VAPID_PRIVATE_KEY=...
VAPID_SUBJECT=mailto:admin@example.com
# ==========================================
# WHATSAPP
# ==========================================
WHATSAPP_ACCESS_TOKEN=EAA...
WHATSAPP_PHONE_NUMBER_ID=123456789
WHATSAPP_WABA_ID=987654321
WHATSAPP_WEBHOOK_VERIFY_TOKEN=my-verify-token
# ==========================================
# STORAGE (S3)
# ==========================================
AWS_ACCESS_KEY_ID=AKIA...
AWS_SECRET_ACCESS_KEY=...
AWS_REGION=us-east-1
AWS_S3_BUCKET=erp-core-files
# ==========================================
# REDIS
# ==========================================
REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_PASSWORD=
# ==========================================
# LLM (OpenRouter)
# ==========================================
OPENROUTER_API_KEY=sk-or-v1-...
LLM_MODEL_DEFAULT=anthropic/claude-3-haiku
LLM_MODEL_FALLBACK=openai/gpt-3.5-turbo
LLM_MAX_TOKENS=1000
LLM_TEMPERATURE=0.7
# ==========================================
# WHISPER (Transcripcion)
# ==========================================
OPENAI_API_KEY=sk-...
# ==========================================
# GOOGLE VISION (OCR)
# ==========================================
GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json
GOOGLE_VISION_PROJECT_ID=my-project
```
---
## Referencias
- [VISION-ERP-CORE.md](VISION-ERP-CORE.md) - Vision general
- [STACK-TECNOLOGICO.md](STACK-TECNOLOGICO.md) - Stack completo
- [ARQUITECTURA-SAAS.md](ARQUITECTURA-SAAS.md) - Arquitectura SaaS
- [ARQUITECTURA-IA.md](ARQUITECTURA-IA.md) - Arquitectura IA
---
*Actualizado: 2026-01-10*
Reference in New Issue View Git Blame Copy Permalink