Synchronization

Once the Magento connector configuration has been saved and cron jobs are operational, the next sync will occur according to the previous Magento established settings (regardless of Sales Layer configuration).

 

Rules

 

  • In the first synchronization or connector refresh, all products will be sent.
  • Once the connection between Sales Layer and the e-commerce channel has been established, all the changes made in Sales Layer will be sent to the e-commerce channel:
    • it will sync any item that may have undergone modifications (even if it originated from related categories or variants).
    • if the status has changed, for example, to draft, the item will be updated in the e-commerce channel.
    • any modification in the Sales Layer channel will send all the product information included in it (with the required time for the process) in plugin synchronizations.
      • It will sync any item that may be affected or relevant to some connector’s modification (such as adding category mapping, or synchronization settings, for example).
      • Updating the connector will send all the items that match the connector’s filters.
  • It will not sync previous items (that have been synchronized before) and haven’t had any changes or are irrelevant to a connector’s modification. For more information, you can click on the following link that will lead you to our Support Center: https://support.saleslayer.com/es/api/introduccion.
  • When synchronizing items, if the items have fields with multiple options (for example: field ‘color’ having ‘blue’ and ‘red’ values), the values of the field will be added to the Magento storeviews in the first synchronization. However, after that, selecting items to be synchronized into a new store view will not update these attribute values.
  • When sync variants:
    • The top-level parent element (parent product of the variant) will be sent. Therefore, if you want to send categories, we recommend changing the status and modifying them together with the variants you want to synchronize.
    • All variants of that product will be sent. For example, if a product in Sales Layer has 50 variants when modifying only one, 50 will be synchronized.
  • When sync categories:
    • Non-supported features:
      • Additional category fields cannot be configured since Magento 2 does not allow them, only internal fields.
    • URL Key mapping:
      • When searching for a category to link, it will search for any without Sales Layer credentials and an exact URL Key. If found, it will assign it and then synchronize the data, if not, a new one will be created.
      • When synchronizing data, if the field URL Key is not mapped or is mapped and has an empty value, the URL Key will be formatted from the category name. If another category under the same parent has the same URL Key, it will be modified by adding a suffix "-sl-{n}", where {n} will be an incremental number, until a non-used URL Key is found. This process will be repeated for each store ID the data is being synchronized in.

If a full synchronization must be launched, meaning to sync all products, whether they’ve been modified or not, you could use the Force refresh button in Sales Layer Parameters” tab. This action will imply sending your complete catalog, multi-language fields, images, formulas, etc. Impacting how long the synchronization lasts. The sync increases the time duration compared to the scheduled sync duration. 

Forcing the connector does not ensure immediate synchronization, as it will depend on the existing process queue.