[{"data":1,"prerenderedAt":7},["ShallowReactive",2],{"docs-entities\u002Fcurrencies\u002Flocalizations\u002Fset":3,"docs-tabs-entities\u002Fcurrencies\u002Flocalizations\u002Fset":6},{"content":4,"lastmod":5},"## Set currency localizations\n\n`PUT \u002Fv1\u002Fcurrencies\u002F:id\u002Flocalizations`\n\nCreates or changes the currency display settings for the specified languages. Only the languages and fields you pass are updated.\n\nScope: `crm`.\n\n## Parameters\n\n| Parameter | Type | Required | Default | Description |\n|----------|-----|:-----:|-----------|----------|\n| `id` (path) | string | yes | — | Currency code from the [currency list](\u002Fdocs\u002Fentities\u002Fcurrencies\u002Flist). Leading and trailing spaces are stripped, and letters are uppercased |\n\n## Request fields (body)\n\n| Field | Type | Required | Description |\n|------|-----|:-----:|----------|\n| `localizations` | object | yes | A non-empty map of languages. Other top-level fields are not accepted |\n| `localizations.{lang}` | object | yes | A non-empty settings object for the `{lang}` language, for example `en` or `ru`. Pass at least one of the fields below in each object |\n| `localizations.{lang}.fullName` | string | no | Full currency name |\n| `localizations.{lang}.formatString` | string | no | Amount display template, `#` is the placeholder for the number |\n| `localizations.{lang}.decPoint` | string | no | Decimal separator |\n| `localizations.{lang}.thousandsVariant` | string | no | Thousands separator variant |\n| `localizations.{lang}.thousandsSep` | string \\| null | no | Thousands separator character. The stored value depends on `thousandsVariant` |\n| `localizations.{lang}.decimals` | number | no | Number of digits after the decimal separator |\n| `localizations.{lang}.hideZero` | boolean | no | Hide trailing zeros in the fractional part |\n\n## Examples\n\n### curl — personal key\n\n```bash\ncurl -X PUT \"https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fcurrencies\u002FQVC\u002Flocalizations\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"localizations\":{\"en\":{\"fullName\":\"Example currency\",\"formatString\":\"# QVC\",\"decimals\":2,\"hideZero\":false},\"ru\":{\"fullName\":\"Example currency\",\"formatString\":\"# QVC\",\"decimals\":2,\"hideZero\":false}}}'\n```\n\n### curl — OAuth application\n\n```bash\ncurl -X PUT \"https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fcurrencies\u002FQVC\u002Flocalizations\" \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"localizations\":{\"en\":{\"fullName\":\"Example currency\",\"formatString\":\"# QVC\",\"decimals\":2,\"hideZero\":false},\"ru\":{\"fullName\":\"Example currency\",\"formatString\":\"# QVC\",\"decimals\":2,\"hideZero\":false}}}'\n```\n\n### JavaScript — personal key\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fcurrencies\u002FQVC\u002Flocalizations', {\n  method: 'PUT',\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\"localizations\":{\"en\":{\"fullName\":\"Example currency\",\"formatString\":\"# QVC\",\"decimals\":2,\"hideZero\":false},\"ru\":{\"fullName\":\"Example currency\",\"formatString\":\"# QVC\",\"decimals\":2,\"hideZero\":false}}}),\n})\nconst { success, data } = await res.json()\n```\n\n### JavaScript — OAuth application\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fcurrencies\u002FQVC\u002Flocalizations', {\n  method: 'PUT',\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\"localizations\":{\"en\":{\"fullName\":\"Example currency\",\"formatString\":\"# QVC\",\"decimals\":2,\"hideZero\":false},\"ru\":{\"fullName\":\"Example currency\",\"formatString\":\"# QVC\",\"decimals\":2,\"hideZero\":false}}}),\n})\nconst { success, data } = await res.json()\n```\n\n## Response fields\n\n| Field | Type | Description |\n|------|-----|----------|\n| `success` | boolean | Always `true` on success |\n| `data` | boolean | Always `true`. The result is confirmed by a second read of the localizations |\n\n## Response example\n\nHTTP `200 OK`:\n\n```json\n{\n  \"success\": true,\n  \"data\": true\n}\n```\n\n## Error response example\n\n422 — the saved values did not match the ones passed. For example, `thousandsVariant` equals `B` while a space was passed in `thousandsSep`:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"BITRIX_ERROR\",\n    \"message\": \"Bitrix24 did not apply the requested currency localizations\"\n  }\n}\n```\n\n## Errors\n\n| HTTP | Code | Description |\n|------|-----|----------|\n| 400 | `MISSING_REQUIRED_FIELDS` | `localizations` is missing or empty, other top-level fields were passed, a language code is empty, or its settings object is empty |\n| 400 | `UNKNOWN_FIELD` | An unknown localization field was passed |\n| 400 | `INVALID_FIELD_VALUE` | An object or an array was passed instead of a scalar value |\n| 400 | `INVALID_ID` | The currency code is empty after spaces are stripped |\n| 404 | `ENTITY_NOT_FOUND` | No currency with the specified code was found |\n| 422 | `BITRIX_ERROR` | Bitrix24 rejected the write, reported a failure, or the second read did not confirm the passed values |\n| 403 | `WRITE_BLOCKED_READONLY_KEY` | The key is in `READONLY` mode |\n| 403 | `BITRIX_ACCESS_DENIED` | The user has no permission for the operation in Bitrix24 |\n| 403 | `SCOPE_DENIED` | The API key does not have the `crm` scope |\n| 401 | `MISSING_API_KEY` | The `X-Api-Key` header is missing |\n| 401 | `TOKEN_MISSING` | The API key has no configured Bitrix24 tokens |\n| 502 | `BITRIX_RESPONSE_INVALID` | A response with an unexpected structure was received |\n| 502 | `BITRIX_UNAVAILABLE` | Bitrix24 is unavailable |\n\nFull list of common API errors — [Errors](\u002Fdocs\u002Ferrors).\n\n## Known specifics\n\nThe write is not transactional: an error does not roll back the values already saved. Before retrying, call [Get currency localizations](\u002Fdocs\u002Fentities\u002Fcurrencies\u002Flocalizations\u002Fget) and compare the current settings with the settings you need.\n\n## See also\n\n- [Get currency localizations](\u002Fdocs\u002Fentities\u002Fcurrencies\u002Flocalizations\u002Fget)\n- [Currency localization fields](\u002Fdocs\u002Fentities\u002Fcurrencies\u002Flocalizations\u002Ffields)\n- [Delete currency localizations](\u002Fdocs\u002Fentities\u002Fcurrencies\u002Flocalizations\u002Fdelete)\n","2026-10-13",{},1794739365124]