erp-core/docs/05-user-stories/mgn-003/US-MGN-003-003-002-tasas-de-cambio.md

1.4 KiB

US-MGN-003-003-002: Gestión de Tasas de Cambio

RF Asociado: RF-MGN-003-003 Módulo: MGN-003 - Catálogos Maestros Epic: Multi-Moneda Prioridad: P0 (MVP) Story Points: 2 Sprint: Sprint 4 Fecha: 2025-11-24


User Story

Como administrador, Quiero registrar tasas de cambio diarias (USD/MXN, etc.), Para convertir transacciones a moneda base automáticamente.


Criterios de Aceptación

Escenario 1: Registrar tasa manual

Cuando registro USD/MXN = 17.50 para hoy, Entonces transacciones en USD se convierten a MXN automáticamente.

Escenario 2: Integración con API externa (futuro)

Cuando activo integración con Open Exchange Rates, Entonces tasas se actualizan automáticamente diario.


Reglas de Negocio

  • RN-1: Tasa de cambio por fecha y par de monedas
  • RN-2: Si no hay tasa para fecha, usar última disponible
  • RN-3: Conversión: amount * exchange_rate

Tareas Técnicas

  • POST /api/v1/exchange-rates - Crear tasa
  • GET /api/v1/exchange-rates - Listar tasas
  • Función: convertCurrency(amount, from, to, date)
  • Tests

Estimación: 2 SP


Referencias