Shopware icon

Shopware

Shopware

Actions778

Currency → Update Currency

AI-generated

Overview

This node operation updates an existing currency in the Shopware system. It allows users to modify various attributes of a currency such as its identifier, factor, symbol, ISO code, name, rounding rules, and associated sales channels, among others. This operation is useful for maintaining accurate and up-to-date currency information in e-commerce platforms, ensuring correct pricing and financial calculations across different regions and sales channels.

Use Case Examples

  1. Updating the symbol and factor of a currency to reflect changes in exchange rates.
  2. Modifying the rounding rules for item and total prices in a specific currency.
  3. Assigning a currency to different sales channels with specific configurations.

Properties

Name Meaning
Id Identifier for the currency, used to specify which currency to update.
Factor The conversion factor for the currency relative to a base currency.
Symbol The symbol representing the currency (e.g., $, €, ¥).
Iso Code The ISO code of the currency (e.g., USD, EUR, JPY).
Short Name A short name or abbreviation for the currency.
Name The full name of the currency.
Position The position of the currency symbol relative to the amount (e.g., before or after).
Is System Default Indicates if this currency is the system default. This is a runtime field and cannot be used as part of the criteria.
Tax Free From The amount from which the currency is considered tax-free.
Custom Fields Custom JSON fields for additional currency data.
Item Rounding JSON object defining rounding rules for individual items.
Total Rounding JSON object defining rounding rules for total amounts.
Created At Timestamp of when the currency was created.
Updated At Timestamp of the last update to the currency.
Translated JSON object containing translated fields for the currency.
Sales Channel Default Assignments JSON array defining default assignments of the currency to sales channels.
Orders JSON array of orders associated with the currency.
Sales Channels JSON array defining sales channels associated with the currency.
Sales Channel Domains JSON array defining domains for sales channels associated with the currency.
Promotion Discount Prices JSON array defining promotion discount prices related to the currency.
Product Exports JSON array defining product export configurations related to the currency.
Country Roundings JSON array defining rounding rules for countries using the currency.

Output

JSON

  • id - The identifier of the updated currency.
  • factor - The conversion factor of the updated currency.
  • symbol - The symbol of the updated currency.
  • isoCode - The ISO code of the updated currency.
  • shortName - The short name of the updated currency.
  • name - The full name of the updated currency.
  • position - The position of the currency symbol.
  • isSystemDefault - Indicates if the currency is the system default.
  • taxFreeFrom - The tax-free threshold amount for the currency.
  • customFields - Custom fields associated with the currency.
  • itemRounding - Rounding rules for individual items.
  • totalRounding - Rounding rules for total amounts.
  • createdAt - Creation timestamp of the currency.
  • updatedAt - Last update timestamp of the currency.
  • translated - Translated fields for the currency.
  • salesChannelDefaultAssignments - Default sales channel assignments for the currency.
  • orders - Orders associated with the currency.
  • salesChannels - Sales channels associated with the currency.
  • salesChannelDomains - Domains of sales channels associated with the currency.
  • promotionDiscountPrices - Promotion discount prices related to the currency.
  • productExports - Product export configurations related to the currency.
  • countryRoundings - Country-specific rounding rules for the currency.

Dependencies

  • An API key credential for Shopware Admin API

Troubleshooting

  • Ensure the 'Id' property is correctly set to the currency you want to update; otherwise, the update will fail.
  • Make sure JSON fields (e.g., customFields, itemRounding, totalRounding) are valid JSON strings to avoid parsing errors.
  • If the API returns authentication errors, verify that the Shopware Admin API credentials are correctly configured and have the necessary permissions.
  • Timeouts or SSL issues can be addressed by adjusting the request options such as timeout duration, proxy settings, or allowing unauthorized certificates.

Discussion