Shopware icon

Shopware

Shopware

Actions778

Currency → Create Currency

AI-generated

Overview

This node operation allows users to create a new currency entry in the Shopware system. It is useful for scenarios where businesses need to add new currencies with specific attributes such as ISO code, symbol, rounding rules, and other financial details to support multi-currency transactions and pricing.

Use Case Examples

  1. Adding a new currency like Euro (EUR) with specific rounding rules and symbols to an e-commerce platform.
  2. Creating a custom currency for a regional market with unique tax and rounding configurations.

Properties

Name Meaning
Response Specifies the data format for the response, either basic or detailed.
Id Unique identifier for the currency.
Factor Conversion factor for the currency relative to a base currency.
Symbol Symbol representing the currency (e.g., $, €, ¥).
Iso Code ISO code of the currency (e.g., USD, EUR).
Short Name Short name or abbreviation of the currency.
Name Full name of the currency.
Position 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 Amount from which the currency is tax-free.
Custom Fields Custom JSON fields for additional currency attributes.
Item Rounding JSON object defining rounding rules for individual items.
Total Rounding JSON object defining rounding rules for total amounts.
Created At Timestamp when the currency was created.
Updated At Timestamp when the currency was last updated.
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 of sales channels associated with the currency.
Sales Channel Domains JSON array of sales channel domains associated with the currency.
Promotion Discount Prices JSON array of promotion discount prices related to the currency.
Product Exports JSON array of product export configurations related to the currency.
Country Roundings JSON array defining rounding rules for countries using the currency.

Output

JSON

  • id - Unique identifier of the created currency.
  • name - Name of the created currency.
  • isoCode - ISO code of the created currency.
  • symbol - Symbol of the created currency.
  • factor - Conversion factor of the created currency.
  • position - Position of the currency symbol.
  • isSystemDefault - Indicates if the currency is the system default.
  • taxFreeFrom - 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 - Sales channel domains 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 all required fields (Id, Factor, Symbol, Iso Code, Short Name, Name, Item Rounding, Total Rounding) are provided and correctly formatted.
  • Verify that the API credentials are valid and have permissions to create currencies.
  • Check the JSON format for fields like Custom Fields, Item Rounding, Total Rounding, and other JSON properties to avoid parsing errors.
  • If the response is empty or unexpected, try changing the Response property between Basic and Detail to get more information.

Links

Discussion