# Währungseinstellungen

# Währungseinstellungen

Cloud-Anbieter rechnen in der Währung des Kontos ab, deshalb kann ein Workspace Kosten in mehreren
Währungen gleichzeitig enthalten. Jeder Kostensatz behält die Währung, in der er abgerechnet wurde.
Der Workspace entscheidet nur, wie diese Kosten dargestellt werden: in ihrer eigenen Währung oder
umgerechnet in eine.

Öffne **Einstellungen**, dann **Workspaces**, und wähle den Workspace. Die Karte
**Währungseinstellungen** enthält zwei Einstellungen, und eine dritte erscheint, sobald die
Umrechnung aktiviert ist.

## Anzeigepräferenz

Die Währung, auf die Kosten zurückfallen, wenn keine Abrechnungswährung gilt: ein leerer Zeitraum,
ein neues Budget, ein Alarmschwellenwert. Sie beschriftet nie Kosten um, die in einer anderen
Währung abgerechnet wurden, denn die Abrechnungswährung ist das, was der Anbieter in Rechnung
gestellt hat.

Die Anzeigepräferenz lässt sich nur ändern, solange die Währungsumrechnung deaktiviert ist. Ist die
Umrechnung aktiv, entscheidet die Umrechnungswährung, und die Präferenz wird ausgegraut angezeigt.

## Währungsumrechnung

Setze **Währungsumrechnung** auf **Aktiviert** und wähle die Zielwährung. Jede Kostenzahl im
Workspace wird dann in diese Währung umgerechnet, und jede Zahl nennt die Ausgangswährung, den
Betrag vor der Umrechnung, den Kurs und die Methode.

Mit **Deaktiviert**:

- Ein Zeitraum, dessen Kosten alle in einer Währung anfallen, wird in dieser Währung gelesen.
- Ein Zeitraum mit mehreren Währungen zeigt eine Summe je Währung und keine Gesamtsumme, denn einen
  Dollarbetrag zu einem Eurobetrag zu addieren ergibt eine Zahl ohne Bedeutung. Kostenberichte und
  das Dashboard sagen das dort, wo sonst eine einzelne Summe stünde.
- Ein Budget zählt nur die Kosten, die bereits in seiner Währung anfallen, und listet den Rest als
  nicht gezählt auf.

## Wechselkursdaten

Sobald die Umrechnung aktiviert ist, wähle, welche veröffentlichten Kurse sie verwendet. Verwende
für die genauesten Ergebnisse die Methode, nach der dein Anbieter abrechnet.

| Option | Was sie verwendet |
|---|---|
| Monatsdurchschnitt | Den Mittelwert der Tageskurse, die im Monat der Kostenposition veröffentlicht wurden. Der laufende Monat verändert sich mit jeder Veröffentlichung leicht, bis er abgeschlossen ist. |
| Kurs am Transaktionsdatum | Den für den Tag der Kostenposition veröffentlichten Kurs. Ein Tag ohne Veröffentlichung, etwa ein Wochenende, verwendet den letzten davor veröffentlichten Kurs. |

## Woher die Kurse stammen

Costfluent rechnet mit den Euro-Referenzkursen der Europäischen Zentralbank um, die an Geschäftstagen
gegen 16:00 MEZ veröffentlicht werden. Die Kurse werden genau so gespeichert, wie die EZB sie
veröffentlicht, als Einheiten einer Währung je Euro, und jedes andere Währungspaar wird über den
Euro abgeleitet. Costfluent akzeptiert keine selbst eingegebenen Wechselkurse: eine Zahl ist nur
belastbar, wenn ihre Quelle eine ist, die du selbst prüfen kannst.

Wenn für eine Währung im betrachteten Zeitraum kein Kurs vorliegt — eine Währung, die die EZB nicht
notiert, oder ein Zeitraum, der älter ist als die geladenen Kurse — wird der Betrag als nicht
umgerechnet ausgewiesen, statt auf gut Glück in die Summe einzugehen.

## Eine umgerechnete Zahl lesen

Ein umgerechneter Bericht trägt unter seiner Summe einen Hinweis, zum Beispiel:

> 120,00 $ umgerechnet in 96,00 €. Umgerechnet in EUR zum Mittelwert der täglichen EZB-Kurse des
> Monats. 1 EUR = 1,25 USD.

Unter **Einstellungen**, dann **Wechselkurse**, steht, was für den Workspace gilt, und dort lässt
sich der Kurs zwischen zwei Währungen mit seinem Veröffentlichungsdatum ansehen.

## Wechselkursrichtlinie

Im Scale-Tarif kann für einen Workspace eine Wechselkursrichtlinie hinterlegt werden. Eine
Richtlinie nennt die Methode, die Kursquelle und den Zeitraum, für den sie gilt, und sie überschreibt
die Workspace-Einstellungen, solange sie gilt. So behält eine Zahl aus einem abgeschlossenen Monat
die Methode, die sie erzeugt hat, auch nachdem sich die Richtlinie ändert. Richtlinien werden von
Costfluent gemeinsam mit deinem Finanzteam gesetzt und sind in der Konsole schreibgeschützt.

## Public API

Die Währungseinstellungen eines Workspace und die veröffentlichten Kurse sind über die Public API
verfügbar. Siehe [Authentifizierung](/de/api/authentication) für Tokens und die
[API-Referenz](/api) für die vollständigen Schemas.

Die Währungseinstellungen eines Workspace lesen:

```bash
curl -H "Authorization: Bearer $COSTFLUENT_API_TOKEN" \
  https://api.costfluent.com/api/v1/workspaces/wsp_example
```

Zum Monatsdurchschnitt in Euro umrechnen:

```bash
curl -X PUT \
  -H "Authorization: Bearer $COSTFLUENT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"enableCurrencyConversion": true, "conversionCurrency": "EUR", "conversionMethod": "MonthlyAverage"}' \
  https://api.costfluent.com/api/v1/workspaces/wsp_example
```

Die Kurse abrufen, mit denen ein Bericht umgerechnet wurde:

```bash
curl -H "Authorization: Bearer $COSTFLUENT_API_TOKEN" \
  "https://api.costfluent.com/api/v1/exchange-rates?from=2026-09-01&to=2026-09-30&targetCurrency=USD"
```

Kostendaten und Kostenzusammenfassungen nehmen ein optionales `workspaceId` entgegen, das bestimmt,
wessen Währungseinstellungen die Zahlen darstellen. Ohne diese Angabe bleibt jede Zahl in ihrer
Abrechnungswährung:

```bash
curl -H "Authorization: Bearer $COSTFLUENT_API_TOKEN" \
  "https://api.costfluent.com/api/v1/costs?workspaceId=wsp_example&startDate=2026-09-01&endDate=2026-09-30"
```