Przejdź do głównej zawartości

Waluty (currencies)

Lista kodów walut ISO 4217 akceptowanych w danej instalacji. Odpowiednik modułu languages.

API publiczne​

Metoda i ścieżkaUprawnieniePrzeznaczenie
GET /api/v1/admin/currenciescurrencies:readPełna lista
PUT /api/v1/admin/currencies/:codecurrencies:writeUtworzenie lub aktualizacja
POST /api/v1/admin/currencies/:code/defaultcurrencies:writeUstawienie jako domyślnej (w tej samej operacji zdejmuje to oznaczenie z poprzedniej)
DELETE /api/v1/admin/currencies/:codecurrencies:writeUsunięcie (odrzucane dla waluty domyślnej)

GET /api/v1/i18n/config zwraca też aktywne waluty i walutę domyślną, ale jest trasą modułu languages, a nie tego modułu: łączy oba katalogi w jedną publiczną odpowiedź, a część dotyczącą walut odczytuje przez currencyReadPort. Zobacz languages.

Uprawnienia​

currencies:read i currencies:write, należące do tego modułu od 2026-08-29.

Do tego czasu cztery powyższe trasy znajdowały się w languages i wymagały catalog:write — wszystkie cztery, łącznie z odczytem listy — więc operator, który mógł edytować opis produktu, mógł też dodać walutę, dezaktywować ją, usunąć i ustawić jako domyślną walutę sklepu. Nic w tym repozytorium nie wywołuje tych tras: ekran walut w panelu administracyjnym należy do dictionaries (/api/v1/admin/dictionary/currencies/*, chroniony przez dictionary.write), co stanowi drugą drogę do tej tabeli i jest osobną kwestią.

test/contract/currencies/permission-authority.test.ts sprawdza oba kierunki — rola z kodami katalogu jest odrzucana, rola z tą parą uprawnień jest obsługiwana — oraz to, że działający w procesie currencyReadPort, przez który każdy inny moduł odczytuje walutę, nie został zmieniony przy przeniesieniu.

Wartości domyślne​

Ten sam wzorzec częściowego indeksu unikalnego co w languages. Migracja inicjalizująca tworzy PLN (domyślną) i EUR; symbole są zapisane jako literały Unicode Postgresa, więc kod migracji pozostaje w ASCII.

Ustawienie nieaktywnej waluty jako domyślnej jest odrzucane odpowiedzią 409 DICTIONARY_DEFAULT_ENTRY_INACTIVE, a utworzenie waluty o istniejącym kodzie — odpowiedzią 409 DICTIONARY_ENTRY_CODE_TAKEN; obie niosą details.code: "currency" i kod waluty w details.entryCode i są kodami modułu dictionaries. Do zgłoszenia #643 obie były odpowiedzią 409 VALIDATION_FAILED.

Encje​

Currency — naturalny klucz główny w postaci kodu ISO 4217; label, symbol, isDefault, isActive, sortOrder.

Punkty rozszerzenia​

  • Waluta domyślna dla kanału sprzedaży — gdy kanał sprzedaży ma własną walutę, uzależnij priceFor(cart) w module orders od waluty skonfigurowanej dla kanału, a nie od globalnej waluty domyślnej.
  • Dostawca kursów walut — poza zakresem tego modułu; gdy potrzebny jest prawdziwy adapter, integruj go przez moduł integrations.