Saltar al contenido principal

Crear una Nueva Moneda

Aprende a agregar monedas al sistema para facturación y gestión multi-moneda.

🎯 Acceder al Formulario​

Desde el módulo de monedas​

  1. Ve a Config del Sistema en el menú lateral
  2. Selecciona Monedas
  3. Haz clic en el botón + Nueva Moneda (esquina superior derecha)
  4. Se abre el modal de creación
Permisos

Solo usuarios con rol de administrador pueden crear y gestionar monedas.

📝 Formulario de Creación​

El modal muestra:

Crear Moneda

Vista del formulario​

El formulario es compacto con todos los campos en una sola vista.

📋 Campos del Formulario​

Código (Obligatorio)​

Campo: Código
Tipo: Texto corto (3 caracteres)
Placeholder: e.g. USD
Formato: Mayúsculas, 3 letras

Descripción: Código ISO 4217 estándar de la moneda.

Ejemplos válidos:

USD - Dólar Estadounidense
EUR - Euro
GBP - Libra Esterlina
JPY - Yen Japonés
CAD - Dólar Canadiense
MXN - Peso Mexicano
BRL - Real Brasileño

Validaciones:

  • Debe ser exactamente 3 caracteres
  • Solo letras (A-Z)
  • Mayúsculas
  • Único (no duplicado)

Ayuda contextual:

Códigos ISO 4217
  • Link a lista de códigos estándar
  • Referencia para códigos correctos
Código Único

El código no se puede cambiar después de crear la moneda. Verifica que sea correcto.

Nombre (Obligatorio)​

Campo: Nombre
Tipo: Texto libre
Placeholder: Nombre de la moneda
Máximo: 100 caracteres

Descripción: Nombre completo y descriptivo de la moneda.

Ejemplos:

Dólar Estadounidense
Euro
Peso Dominicano
Libra Esterlina
Yen Japonés
Colombian peso

Buenas prácticas:

  • ✅ Usa el nombre oficial completo
  • ✅ Primera letra en mayúscula
  • ✅ Evita abreviaturas
  • ✅ Usa el nombre en español (o idioma de tu firma)

Ejemplos correctos vs incorrectos:

✅ Dólar Estadounidense
❌ Dollar
❌ dolares
❌ USD

✅ Peso Dominicano
❌ pesos
❌ RD$

Símbolo (Obligatorio)​

Campo: Símbolo
Tipo: Texto corto
Placeholder: Símbolo
Máximo: 5 caracteres

Descripción: Símbolo monetario usado en la visualización de montos.

Símbolos comunes:

$ - Dólar (USD, CAD, MXN, etc.)
€ - Euro
£ - Libra Esterlina
¥ - Yen/Yuan
RD$ - Peso Dominicano
C$ - Peso Colombiano (o COP$)
R$ - Real Brasileño

Uso del símbolo:

  • Mostrado antes o después de cantidades
  • Aparece en facturas y reportes
  • Visible en registros de tiempo

Ejemplos en uso:

$1,500.00 (USD)
€850.00 (EUR)
RD$50,000.00 (DOP)
¥100,000 (JPY)
Símbolos Únicos

Si múltiples monedas usan el mismo símbolo ($), considera usar prefijos distintivos: US$, RD$, C$

Decimales (Obligatorio)​

Campo: Decimales
Tipo: Número entero
Valor por defecto: 2
Rango: 0-4

Descripción: Número de lugares decimales para mostrar y calcular.

Valores comunes:

DecimalesUsoEjemplos
0Monedas sin centavos¥100, ₩5000
2Mayoría de monedas$100.50, €85.75
3Monedas de bajo valorAlgunas criptomonedas
4Alta precisiónTrading, forex

Ejemplos por moneda:

USD: 2 decimales → $1,500.00
EUR: 2 decimales → €850.50
JPY: 0 decimales → ¥10000
COP: 3 decimales → $1,234.567
BTC: 8 decimales → ₿0.00123456

Impacto:

  • Afecta cálculos de facturación
  • Determina precisión en reportes
  • Influye en redondeo de conversiones
Estándar

La mayoría de monedas usan 2 decimales. Solo cambia si la moneda lo requiere.

Tasa de Cambio (Obligatorio)​

Campo: Tasa de Cambio
Tipo: Número decimal
Valor por defecto: 1
Formato: Número positivo con decimales

Descripción: Valor de conversión de esta moneda respecto a la moneda base.

Cómo calcular:

Tasa = Cuántas unidades de moneda base equivalen a 1 unidad de esta moneda

Ejemplo con DOP como base:

Si 1 USD = 57.50 DOP
Entonces: Tasa de USD = 57.50

Si 1 EUR = 63.00 DOP
Entonces: Tasa de EUR = 63.00

Si 1 DOP = 1 DOP
Entonces: Tasa de DOP = 1.00

Para monedas de menor valor:

Si 1 COP = 0.016 DOP
Entonces: Tasa de COP = 0.016

Si 1000 COP = 16 DOP
Entonces: Tasa de COP = 0.016

Validaciones:

  • Debe ser mayor que 0
  • Permite decimales
  • Se puede actualizar después
Fuente de Tasas

Usa tasas oficiales del Banco Central o fuentes confiables como XE.com, OANDA, o Google Finance.

Moneda Base (Opcional)​

Campo: Checkbox Moneda Base
Estado por defecto: Desmarcado (OFF)

Descripción: Marca esta moneda como la moneda base del sistema.

¿Qué es la moneda base?

  • Moneda de referencia para todas las conversiones
  • Generalmente la moneda local de tu firma
  • Solo puede haber UNA moneda base
  • Su tasa de cambio es siempre 1.00

Cuándo marcar:

✅ Si es la moneda principal de tu firma
✅ Si es tu moneda local (DOP en República Dominicana)
✅ Si es la primera moneda que creas

Ejemplo:

Configurando moneda DOP:
☑ Moneda Base (marcado)
Tasa de Cambio: 1 (automático)

Configurando moneda USD:
☐ Moneda Base (desmarcado)
Tasa de Cambio: 57.50
Solo Una Base

Si marcas una nueva moneda como base, la anterior dejará de serlo. Esto afecta todas las conversiones existentes.

Activa (Obligatorio)​

Campo: Toggle Activa
Estado por defecto: Activado (ON - dorado)

Descripción: Determina si la moneda está disponible para usar.

Estados:

✅ Activa (ON):

  • Aparece en selectores de moneda
  • Se puede usar en nuevos registros
  • Disponible para facturación
  • Visible en formularios

❌ Inactiva (OFF):

  • No aparece en selectores
  • No se puede usar en nuevos registros
  • Registros existentes mantienen la moneda
  • Útil para monedas obsoletas o temporales

Cuándo desactivar:

❌ Moneda que ya no se usa
❌ Moneda temporal de un cliente específico
❌ Moneda en proceso de eliminación

Cuándo activar:

✅ Monedas nuevas que se usarán
✅ Monedas comunes (USD, EUR, etc.)
✅ Monedas de clientes actuales
Valor por Defecto

Las nuevas monedas vienen activadas por defecto. Raramente necesitas desactivarlas al crear.

Notas (Opcional)​

Campo: Notas
Tipo: Área de texto
Placeholder: Notas
Máximo: 500 caracteres

Descripción: Información adicional sobre la moneda o su uso.

Qué documentar:

  • Razón de agregar esta moneda
  • Clientes específicos que la usan
  • Fuente de la tasa de cambio
  • Frecuencia de actualización
  • Consideraciones especiales

Ejemplos de notas:

Moneda agregada para cliente XYZ Corp.
Actualizar tasa semanalmente según Banco Central.
USD - Usado para mayoría de clientes internacionales.
Tasa actualizada diariamente.
Fuente: Banco Central RD
EUR - Para clientes europeos.
Incluye margen de 2% sobre tasa oficial.

💾 Guardar la Moneda​

Botones de acción​

Al final del modal:

  • Cancelar - Cierra el modal sin guardar
  • Guardar - Crea la nueva moneda

Validaciones finales​

Antes de guardar, el sistema verifica:

Campos obligatorios:

  • ✓ Código (3 caracteres)
  • ✓ Nombre completo
  • ✓ Símbolo
  • ✓ Decimales (numérico)
  • ✓ Tasa de cambio (mayor que 0)

Validaciones especiales:

  • ✓ Código único (no duplicado)
  • ✓ Si marca "Moneda Base", solo puede haber una
  • ✓ Formato correcto en todos los campos

Hacer clic en "Guardar"​

  1. Revisa que todos los datos sean correctos
  2. Haz clic en Guardar
  3. El sistema procesa la información
  4. La moneda se crea
  5. El modal se cierra
  6. La nueva moneda aparece en la lista
Revisión Final

Antes de guardar, verifica:

  • Código ISO correcto (permanente)
  • Tasa de cambio actualizada
  • Símbolo apropiado

🎉 ¿Qué Pasa Después?​

Moneda creada exitosamente​

Cuando se crea la moneda:

1. Disponibilidad inmediata:

  • ✅ Aparece en la lista de monedas
  • ✅ Disponible en selectores (si está activa)
  • ✅ Lista para usar en registros de tiempo
  • ✅ Lista para facturación

2. Dónde aparece:

  • 📝 Formulario de registro de tiempo
  • 💰 Formulario de facturación
  • 👥 Configuración de clientes
  • 📊 Reportes financieros

3. Acciones disponibles:

  • ✏️ Editar tasa de cambio
  • 📈 Ver historial de tasas
  • ⚙️ Modificar configuración
  • ❌ Desactivar (si ya no se usa)

💡 Mejores Prácticas​

Al crear monedas​

Usa códigos estándar:

  • ✅ Consulta la lista ISO 4217
  • ✅ Usa códigos reconocidos internacionalmente
  • ✅ Evita códigos inventados

Establece tasas correctas:

  • ✅ Usa fuentes oficiales confiables
  • ✅ Verifica la tasa antes de guardar
  • ✅ Documenta la fuente en las notas

Activa solo lo necesario:

  • ✅ Solo monedas que usarás activamente
  • ✅ Evita crear monedas "por si acaso"
  • ✅ Mantén la lista manejable

Documenta bien:

  • ✅ Usa el campo de notas
  • ✅ Indica para qué clientes es
  • ✅ Especifica frecuencia de actualización

Configuración inicial​

Primera moneda (Moneda Base):

Código: DOP
Nombre: Peso Dominicano
Símbolo: RD$
Decimales: 2
Tasa: 1.00
☑ Moneda Base
✓ Activa

Segunda moneda (USD):

Código: USD
Nombre: Dólar Estadounidense
Símbolo: $
Decimales: 2
Tasa: 57.50 (según tasa actual)
☐ Moneda Base
✓ Activa

Tercera moneda (EUR):

Código: EUR
Nombre: Euro
Símbolo: €
Decimales: 2
Tasa: 63.00 (según tasa actual)
☐ Moneda Base
✓ Activa

📊 Ejemplos Completos​

Ejemplo 1: Dólar Estadounidense​

Código: USD
Nombre: Dólar Estadounidense
Símbolo: $
Decimales: 2
Tasa de Cambio: 57.50
☐ Moneda Base
✓ Activa
Notas: Moneda principal para clientes internacionales.
       Actualizar tasa semanalmente.

Ejemplo 2: Euro​

Código: EUR
Nombre: Euro
Símbolo: €
Decimales: 2
Tasa de Cambio: 63.00
☐ Moneda Base
✓ Activa
Notas: Para clientes de Unión Europea.
       Tasa basada en Banco Central.

Ejemplo 3: Peso Colombiano​

Código: COP
Nombre: Colombian peso
Símbolo: $
Decimales: 3
Tasa de Cambio: 0.016
☐ Moneda Base
✓ Activa
Notas: Cliente específico en Colombia.
       Tasa de cambio baja debido al valor.

⚠️ Errores Comunes​

Error 1: Código duplicado​

❌ Error: El código USD ya existe

Solución:

  • Verifica si la moneda ya está creada
  • Usa un código diferente si es una variación

Error 2: Tasa de cambio cero​

❌ Error: La tasa de cambio debe ser mayor que 0

Solución:

  • Ingresa una tasa válida (mayor que 0)
  • Para moneda base, usa 1.00

Error 3: Código inválido​

❌ Error: El código debe tener exactamente 3 letras

Solución:

  • Usa exactamente 3 caracteres
  • Solo letras (A-Z)
  • Mayúsculas

❓ Preguntas Frecuentes​

¿Puedo cambiar el código después de crear?​

No. El código es permanente. Si necesitas cambiarlo, debes crear una nueva moneda.

¿Qué pasa si marco una nueva moneda como base?​

La moneda base anterior dejará de serlo. Esto afecta todas las conversiones existentes y futuras.

¿Puedo tener múltiples monedas con el mismo símbolo?​

Sí, técnicamente puedes. Pero es confuso. Mejor usa símbolos distintivos (US$, RD$, C$).

¿Debo crear todas las monedas del mundo?​

No. Solo crea las monedas que realmente usarás con tus clientes.

¿Cuántos decimales debo usar?​

2 decimales es el estándar para la mayoría. Solo cambia si la moneda lo requiere (JPY usa 0, algunas usan 3-4).

¿Qué tasa de cambio uso?​

La tasa oficial del Banco Central o una fuente confiable como XE.com al momento de crear.

¿Puedo editar la moneda después?​

Sí, puedes editar casi todos los campos excepto el código. Especialmente puedes actualizar la tasa de cambio.

¿Qué pasa si desactivo una moneda?​

No estará disponible para nuevos registros, pero los registros existentes la mantendrán.

🎯 Siguiente Paso​

¿Necesitas Ayuda?

Si tienes dudas sobre qué tasa usar o cómo configurar una moneda, contacta a tu administrador o consulta la sección de ayuda.