Monedas y Centavos
En arcadi cuando nos referimos a cualquier monto de cualquier moneda usamos como referencia su valor en centavos, para facilitar la utilización de las monedas se establece un endpoint que contiene datos de configuración comprendidos por la gema de ruby money-rails.
Estos valores contienen información de decimales, nombres, y otros. La parte importante son el tamaño de los decimales ya que eso también explica los centavos de cada moneda.
Ejemplo de moneda COP (Pesos colombianos), los centavos de COP van desde 0 a 100, por lo tanto 100 centavos equivale a 1 COP y 10 centavos equivale a 0.10 COP. Los valores de Arcadi no necesariamente son comparables con los valores reales es por ello que es importante revisar la información utilizando la información de esta sección. Como nota final la probabilidad de que estos valores cambien en el futuro es muy baja por lo que puede ser almacenados y utilizados sin necesidad de hacer solicitud de información constante.
Listado de monedas
Endpoint
GET /api/v3/currencies HTTP/1.1
Authorization: Bearer token
Ejemplo de respuesta
Respuesta 200
[
{
"name": "Chilean Peso",
"iso_code": "CLP",
"subunit_to_unit": 1
},
{
"name": "Venezuelan Bolívar Soberano",
"iso_code": "VES",
"subunit_to_unit": 100
},
{
"name": "Colombian Peso",
"iso_code": "COP",
"subunit_to_unit": 100
},
{
"name": "United States Dollar",
"iso_code": "USD",
"subunit_to_unit": 100
}
]
| Parametro | Detalles |
|---|---|
| name | Nombre de la moneda, puede estar en español o inglés |
| iso_code | Código de la moneda |
| subunit_to_unit | Cuantos centavos equivale una unidad de la moneda |
Si se requiere más información solicitarlo al correo de soporte
Como usar centavos
El uso de centavos es bastante simple, en general para cualquier operación matemática lo mejor es usar los centavos como un número INTEGER, y al momento de mostrarlo se divide los centavos entre el parámetro "subunit_to_uni" y con eso se obtiene el valor como FLOAT. El motivo de porque es mejor hacer matemática con números INTEGER es porque FLOAT tiene cierto nivel de imprecisión, con un INTEGER siempre nos aseguraremos que los cálculos sean precisos.