Aller au contenu

Devises et montants

Une devise est un document. Facet crée le registre lors de l’initialisation, et vous le gérez dans l’espace Configurer comme n’importe quelle autre liste. Un champ monétaire porte toujours une valeur et un ticker ensemble. Le backend stocke les deux et vérifie le ticker à chaque écriture.

Travaillez sur les devises quandà :

  • vous ajoutez ou retirez une devise du sélecteur,
  • vous définissez un champ monétaire sur un doctype,
  • vous filtrez des documents par montants.
  • Le domaine core est masqué dans la barre latérale de l’espace de travail. L’espace Configurer est le chemin d’accès.
  • facet seed:core initialise les lignes de devises. La commande est idempotenteà : la relancer ne change rien.

Ouvrez Configurer → Devise. La liste est un tableau standard avec les routes habituelles de création et d’édition, /core/Currency/new et /core/Currency/{id}/edit. L’aperçu et la page détail passent par les modèles de vue pré-créés.

L’initialisation livre les devises ISO-4217 en circulation. Six lignes démarrent actives — CHF, CNY, EUR, GBP, JPY et USD — et toutes les autres lignes arrivent inactives. Une ligne porte ces champsà :

Champ Signification Exemple
ticker La clé du registre. Tout en majuscules, commence par une lettre, 3 à 10 caractères. Unique. EUR
symbol Le glyphe affiché. Facultatif — un symbole vide affiche le ticker seul. €
name Le nom anglais de la devise. Euro
digits Décimales de la sous-unité, de 0 à 4. Défaut 2. 2
active Met le ticker dans les flux de création quand true. true
favorite Épingle la ligne en haut du sélecteur de devises. false
grouping Groupement d’affichageà : standard (milliers) ou lakhs (12,34,567). standard

Passez active à false pour retirer une devise sans la supprimer. Un ticker inactif reste connuà : les documents qui le portent continuent de fonctionner.

Chaque enregistrement d’une devise est diffusé à tous les processus en cours, qui marquent leur registre en mémoire comme périmé. La prochaine écriture sur chaque processus reconstruit le registre à partir des documents. Après un redémarrage, le registre démarre périmé et s’hydrate à

la première écriture. Si une diffusion se perd, une limite de péremption — cache.staleness_ttl_s, 300 secondes par défaut — force une reconstruction à la prochaine lecture.

Un contrôle vérifie les valeurs monétaires sur chaque chemin d’écritureà :

Chemin Règle
Création Chaque chemin monétaire doit nommer une devise enregistrée et active. Les chemins imbriqués comptent aussi.
Mise à jour Seuls les tickers changés sont vérifiés. Réenregistrer un chemin avec son ticker existant passe même si la ligne est passée inactive. Un passage à un autre ticker exige une ligne active.
Import en masse Le contrôle est sauté. Un ticker enregistré mais inactif s’importe. Un ticker supprimé échoue avec UnknownCurrencyError.

Une violation répond 422 avec le code inactive_currency sur le champ <path>.currency. Un ticker inconnu continue d’échouer comme erreur de schéma.

Une valeur monétaire est un objet JSONà:

{ "value": "123.42", "currency": "USD" }

value est une chaîne. Le backend l’interprète comme un décimal exact, jamais comme un flottant, et la précision survit.

Un filtre monétaire accepte deux formesà : USD 1000 compare cette seule devise, et un 1000 nu compare toutes les devises.

Créez une devise avec l’API, puis déclarez un champ monétaire qui l’utiliseà :

Fenêtre de terminal
curl -k -X POST -H "Authorization: Bearer $FACET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"ticker":"CRD","symbol":"Cr","name":"House credit","digits":2,"active":true,"favorite":false,"grouping":"standard"}' \
"https://facet.localhost:3443/Api/core/Currency"

Le champ ticker est unique sur tout le doctypeà : un ticker déjà porté par une ligne existante répond 422 avec une erreur de validation unique.

La déclaration du champ dans le doctypeà :

{
"salary": { "type": "money", "currency": "USD" }
}

Le currency du champ est un indice d’affichage et une valeur par défautà : une écriture qui omet le membre de devise est complétée avec lui. La valeur stockée porte toujours son propre ticker. Filtrez le doctype par montantà :

Fenêtre de terminal
curl -s -H "Authorization: Bearer $FACET_API_KEY" \
"https://facet.localhost:3443/Api/hr/Employee?filters[salary__gte]=USD%201000"

Un enregistrement répond 422 avec inactive_currency.

Le ticker est connu mais inactif. Activez la ligne de devise, ou gardez le document sur son ticker existant — un réenregistrement avec le même ticker passe.

Le sélecteur n’affiche pas une devise.

La ligne est inactive, ou le registre ne s’est pas encore reconstruit. Activez la ligne et enregistrez un documentà ; la prochaine écriture reconstruit le registre.

Un import échoue sur une devise.

Le ticker a été supprimé, pas seulement désactivé. Recréez la ligne de devise avec le même ticker, puis relancez l’import.

Le fichier de configuration ne contient aucune liste de devises.

Les devises ne viennent pas de la configuration. Ce sont des documents core.Currency, et le registre les lit dans la base de données.