13-currencies

Currencies (Valute e Tassi di Cambio)

A cosa serve questa sezione

La sezione Currencies gestisce le valute utilizzate nel sistema per i prezzi di acquisto dei componenti. Poiché i fornitori possono fatturare in valute diverse (USD, GBP, CHF…), il sistema converte automaticamente tutti i prezzi in EUR per uniformare le analisi dei costi.

La sezione si divide in due parti:

1. Currencies — Anagrafica Valute

Definisce le valute supportate: codice ISO (es. USD), simbolo (es. $), nome per esteso.

2. FX Rates (Tassi di Cambio ECB)

Contiene i tassi di cambio giornalieri pubblicati dalla Banca Centrale Europea (ECB). Ogni record rappresenta il tasso di cambio tra EUR e un’altra valuta in una data specifica.

I tassi vengono usati per:

• Convertire purchase_price e shipment_price in EUR negli Item Purchasings
• Calcolare il costo di rollup complessivo in EUR

---

Chi deve modificarlo

Ruolo	Azione consentita
DB Settings	Creazione valute, inserimento/aggiornamento tassi di cambio
Acquisti	Aggiornamento dei tassi quando cambiano i prezzi fornitore

---

Chi deve leggerlo

Ruolo	Motivo
Acquisti	Per verificare la conversione dei prezzi fornitore
Progettazione - Accountant	Per analisi di costo in EUR
Product Manager / CEO	Per budget e analisi di profittabilità

---

Come popolarlo — Esempi

Esempio 1: Aggiungere la valuta USD

1. Vai su Management → Currencies → Aggiungi Valuta
2. Compila:
   • Codice: USD
   • Simbolo: $
   • Nome: Dollaro Statunitense
   • Attiva: ✓
3. Salva

Esempio 2: Set di valute consigliato

Codice	Simbolo	Nome
EUR	€	Euro
USD	$	Dollaro Statunitense
GBP	£	Sterlina Britannica
CHF	Fr	Franco Svizzero
JPY	¥	Yen Giapponese
CNY	¥	Yuan Cinese

Esempio 3: Inserire un tasso di cambio manuale

1. Vai su Management → FX Rates → Aggiungi FX Rate
2. Compila:
   • Data: 2026-03-19
   • Valuta base: EUR
   • Valuta quotata: USD
   • Tasso: 1.085 (1 EUR = 1.085 USD)
3. Salva

Esempio 4: Fonte ufficiale per i tassi ECB

I tassi ufficiali sono pubblicati quotidianamente su: https://www.ecb.europa.eu/stats/eurofxref/eurofxref-daily.xml

In futuro, il sistema potrà essere configurato per recuperarli automaticamente tramite il servizio ecb_rates.py già presente nel codice.

---

Note importanti

• La valuta di riferimento del sistema è EUR — tutti i costi vengono normalizzati in euro
• Se non esistono tassi aggiornati per una valuta, la conversione potrebbe essere imprecisa o fallire
• Inserire almeno il tasso per USD se si acquistano componenti da fornitori americani o asiatici (molti listini internazionali sono in USD)
• I tassi ECB sono riferiti alla data di quotazione: per analisi storiche accurate, mantieni lo storico dei tassi giornalieri