Introduction

This section explains how to deal with salutations in Shopware and your documents. It also explains how to deal with different formats of salutations between your data and Shopware.

Configuration

You have to configure which source salutation will be mapped to which salutation in Shopware. This makes it possible to support different salutation formats between your source data and Shopware. The configuration follows this pattern:

{
  "salutations": {
    "salutationKeys": {
      "shopware-salutation-technical-name-1": [
        "synQup-salutation-1",
        "synQup-salutation-2"
      ],
      "shopware-salutation-technical-name-2": [
        "synQup-salutation-3",
        "synQup-salutation-4"
      ]
    },
    "fallbackKey": "shopware-salutation-technical-name-3"
  }
}

You can find the technical names to use in the administration panel of Shopware (go to Settings -> Salutations). Please refer to the documentation of Shopware for more information.

This is how a configuration for your salutations could look like:

{
  "salutations": {
    "salutationKeys": {
      "mr": [
        "Herr",
        "Hr.",
        "Mr",
        "Mr."
      ],
      "mrs": [
        "Frau",
        "Mrs",
        "Ms."
      ]
    },
    "fallbackKey": "not_specified"
  }
}
  • The salutations "Mr", "Hr", "Mr" and "Mr." are mapped to the Shopware salutation whose technical name is "mr"
  • The salutations "Ms", "Mrs" and "Ms." are mapped to the Shopware salutation whose technical name is "mrs"
  • All missing salutations are mapped to the Shopware salutation whose technical name is "not_specified". So every salutation that is not configured is mapped automatically to the salutation specified with the key fallbackKey.