Skip to main content
GET
Query Shop Currencies

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

x-tenant-id
string<uuid>
required

The tenant ID for the target ERP instance.

Path Parameters

salesChannelId
string
required

Sales channel id of the shop whose currency assignments are retrieved. This is a tenant-local, composite identifier and not a UUID (ADR-69) - it is opaque to the caller and must be taken verbatim from a sales channel listing; the internal shop key (kShop) is never accepted here.

Response

Success.

currencyCode
string
required

Code of the currency in its canonical form - uppercase for ISO 4217 alpha-3 codes, lowercase x- prefix for tenant-defined codes. This is the identifier of the currency (ADR-85); the internal surrogate key (kWaehrung) is not exposed. The accepted forms are identical to those of the save command on this route, so every code that can be assigned is also listed here. Only the FORM of the code is validated - membership in the ISO 4217 register is not verified, because the Wawi ships no register. A currency in the Wawi master data whose code matches neither form has no identifier this contract could expose and is therefore not listed, assigned or not.

codeSource
enum<integer>
required

Source of CurrencyCode - standardized ISO 4217 code or tenant-defined code (ADR-85). Derived from the form of the stored code: a code in ISO 4217 alpha-3 form is reported as Iso, a code in the ISO 4217 private-use namespace (x- prefix) as UserAssigned. A tenant-defined code that happens to have ISO alpha-3 form is therefore reported as Iso - telling those two apart requires the central code registry from the pending ADR-85 implementation tickets. The property exists so consumers do not have to infer the code type by regular expression.

Available options:
0,
1
isAssigned
boolean
required

Currency is assigned to the shop. False for every currency that is part of the Wawi currency master data but not of the shop's assignments - the result is the full catalogue, not the assignment set.

isDefault
boolean
required

Currency is the shop default currency. Only ever true when IsAssigned is also true.

name
string

Display name of the currency as stored in the Wawi currency master data, or null if unset.