Special Features of Field Mapping

In VTEX, Categories have a mandatory field called VTEX Global Category. The values in this field come from a list of Google Merchant Category IDs. This means that to avoid synch problems with categories, you must add to your Sales Layer catalog this information. In the following link, you will find the list of all the possible values: https://support.google.com/merchants/answer/6324436?hl=en.

In order to have visible products in VTEX you will need to have SKUs with price, stock information, and images. You can do this in the Variants section or the Products one (if you do not have variants). In this last case, you can use the product tab to fill in the information. That is to say if your Sales layer products don’t have a variant, all mandatory information will have to be added to Products.

On the other hand, if your Sales Layer products have variants, and you configure SKUs from this tab, the connector will not take into consideration any fields mapped in the Products tab, that are repeated in the Variants section.

Custom fields: VTEX calls them specifications. For these specifications to appear in your VTEX store as a result of synchronization, you must register the group they will belong to, define the field names, and include their values. These are the fields that determine the characteristic attributes of your SKU.

If you want to create groups of fields (specifications) you can do so from the Products or Variants sections. You can define characteristics in Products, and attributes in Variants by adding the name of the group as a prefix in the field followed by _ (Groupname_Attributename), such as the example:

For this particular image, the group name is Size, and attribute names are Global and National.

Each field defined for variants or products, mapped in the connector, has to have a value in the Sales Layer catalog, otherwise, it will not synchronize. If it already exists in VTEX, it will be eliminated. So, if you do not want it to synchronize, remember to disable the field in the connector (as described before), otherwise verify that there are no null fields.

As mentioned before, VTEX has a Status field that manages whether a product is active or inactive. If you want to use this feature in the same way that VTEX and in a different way that Sales Layer, you can add a field in the Products tab (and in your Sales Layer catalog) called status, where you can manage this.