- Frontend React (SKEEN Brand) con Vite, TypeScript, Tailwind - Frontend Homenest (versión alternativa) - Módulos Odoo 17 custom (citas, pacientes, monedero, pagos, ventas, inventario, whatsapp) - WACRM fork (Next.js 16 + Supabase) - Hermes + Bridge + Skills (Qwen3.6 via Nan Builders) - Scripts de migración y operación - Documentación extensiva en docs/
80 lines
2.3 KiB
Markdown
80 lines
2.3 KiB
Markdown
---
|
|
name: skeen-pagos
|
|
description: >
|
|
Gestion de pagos para SKEEN Derma Experts.
|
|
Genera links de pago (Stripe/MercadoPago), consulta estados,
|
|
y gestiona facturacion. Usar cuando el usuario quiera pagar,
|
|
consultar saldo, o ver sus pagos pendientes.
|
|
version: 1.0.0
|
|
metadata:
|
|
hermes:
|
|
requires:
|
|
bins: [python]
|
|
env: [STRIPE_SECRET_KEY, MP_ACCESS_TOKEN]
|
|
envVars:
|
|
- name: STRIPE_SECRET_KEY
|
|
required: true
|
|
- name: MP_ACCESS_TOKEN
|
|
required: true
|
|
- name: ODOO_URL
|
|
required: true
|
|
platforms: [whatsapp, webchat, cli]
|
|
activation: keyword
|
|
keywords: ["pagar", "saldo", "deuda", "factura", "pago", "stripe", "mercadopago"]
|
|
---
|
|
|
|
# SKEEN — Gestion de Pagos
|
|
|
|
## Instrucciones de Uso
|
|
|
|
### PASO 1: Identificar intencion de pago
|
|
|
|
- "Quiero pagar" → Generar link de pago
|
|
- "Cuanto debo?" / "Saldo pendiente" → Consultar deuda
|
|
- "Ya pague" → Verificar pago
|
|
- "Necesito factura" → Generar factura (CFDI)
|
|
|
|
### PASO 2: Consultar servicios pendientes
|
|
|
|
Usa `odoo_api_call` para consultar modelo account.move:
|
|
Dominio: [['partner_id.phone', '=', PACIENTE_PHONE], ['state', '=', 'posted'], ['payment_state', '!=', 'paid']]
|
|
Campos: ['name', 'amount_residual', 'invoice_date_due']
|
|
|
|
### PASO 3: Generar link de pago
|
|
|
|
Para pagos en Mexico (MXN) — usa MercadoPago:
|
|
Crear preference con items del servicio
|
|
notification_url: https://skeen.mx/webhooks/mercadopago
|
|
back_urls: { success: 'https://app.skeen.mx/pagos/exitoso' }
|
|
|
|
Para pagos internacionales — usa Stripe Checkout:
|
|
Crear session con line_items
|
|
mode: 'payment'
|
|
success_url: 'https://app.skeen.mx/pagos/exitoso'
|
|
metadata: { patient_phone: PACIENTE_PHONE }
|
|
|
|
### PASO 4: Enviar link de pago
|
|
|
|
Usa `wacrm_send` para enviar mensaje con resumen y link.
|
|
|
|
Incluir:
|
|
- Listado de servicios con precios
|
|
- Total a pagar
|
|
- Link de pago
|
|
- Metodos aceptados (tarjeta, OXXO, SPEI)
|
|
- Puntos de monedero que acumulara
|
|
|
|
### PASO 5: Confirmacion de pago
|
|
|
|
Cuando el webhook confirme el pago:
|
|
1. Registra pago en Odoo via `odoo_api_call`
|
|
2. Calcula puntos de monedero (10% del monto)
|
|
3. Envia confirmacion + puntos acumulados
|
|
|
|
## Reglas
|
|
|
|
- Siempre confirmar el monto antes de generar el link
|
|
- Para pagos >$5,000 MXN, ofrecer opcion de meses sin intereses
|
|
- Verificar que el telefono coincida con el paciente
|
|
- Guardar referencia de pago en memoria
|