Overview

The CRM Sync allows you to synchronize your customer (Retailer) data into Fashion Cloud so that we may:

• Allow you to work with all of your Retailers / Locations via Fashion Cloud
• Store your identifiers so you can easily reference Retailers / Locations within Fashion Cloud
• Automatically sync updates from your system to be reflected within Fashion Cloud (e.g. Access Rights)

Cadence

While CRM Sync can be used ad hoc at key moments (onboarding, ERP change, etc), we strongly recommend setting up a continuous sync (e.g. daily). This ensure any changes you make within your system are quickly reflected within Fashion Cloud, helping avoid manual work and optimizing your workflows.

Entities

1. Retailer Organization: — name, address, and optional phone number
2. Locations:
3. One or more stores belonging to that retailer, each with a name, address, and GLN.
4. Optionally, access rights — which Fashion Cloud features the retailer is permitted to use.

<aside> ☝️

External ID

The identifier field(s) for the Retailer Organization & Location allow you to supply your identifiers for these records. identifier allows us to complete two key functions:

1. Show your identifiers within Fashion Cloud for easy reference
2. Use as a stable identifier from your system to understand when records are being updated

As such, please ensure you include identifier for each Retailer Org or Location.

</aside>

Full Data Structure

{
  "identifier":   "YOUR-RETAILER-ID",           // Required
  "name":         "Retailer Name GmbH",         // Required
  "address": {                                 
    "line1":   "Street and number",             //   Required
    "line2":   "Floor / Suite",                 //   Optional
    "zip":     "12345",                         //   Required
    "city":    "City",                          //   Required
    "country": "DE"                             //   Required  (ISO 3166-1 alpha-2)
  },
  "phone": "+49 30 12345678",                   // Optional
  "accessRights": {                             // Optional - default: false
    "canUseProductData":          true,
    "canUseMarketingFiles":        true,
    "canUseB2bPlatform":           true,
    "canUsePreorderPlatform":      false,
    "canUseForErp":                false,
    "canUseForEcommerce":          false,
    "canUseForDigitalShopWindow":  false,
    "canUseEndlessAisle":          false
  },
  "users": ["[email protected]", "[email protected]"],
  "stores": [                                   // Required – minimum 1 entry
    {
      "identifier":  "YOUR-STORE-ID",           //   Required
      "name":        "Store Name",              //   Required
      "address": {                              
        "line1":   "Street and number",         //   Required
        "line2":   "Suite / Floor",             //   Optional
        "zip":     "12345",                     //   Required
        "city":    "City",                      //   Required
        "country": "DE"                         //   Required  (ISO 3166-1 alpha-2)
      },
      "gln":         "4012345000017",           //   Optional  (13-digit GS1)
      "invoiceGln":  "4012345000024",           //   Optional
      "shippingGln": "4012345000031",           //   Optional
      "buyerGln":    "4012345000048"            //   Optional
    }
  ]
}

Field Reference