Articles in this section

Shopify Plus: Custom Mappings

  • Updated

Marketplacer accelerator (Cerberus) allows custom mapping rules when synchronizing to Shopify Plus. Currently, these are the types of synchronization supported:

  • Marketplacer Advert > Shopify Product
  • Marketplacer Variant > Shopify Product Variant

The new custom mapping will override the content if custom mapping rules are used to map to the fields that the Marketplacer Shopify Plus Accelerator uses as part of its default flow. 

An example could be mapping Marketplacer "specification" to Shopify "description". The content seller input in the description field is overwritten with the content in the specification field.

Note: For a custom mapping to be valid, it can only be mapped to a compatible field. This is the same type of field taking into account non-null. 
Marketplacer Advert fields Shopify product fields

Advert fields here that types are:

  • Float
  • Decimal
  • Int
  • String
  • ID
  • ISO8601DateTime
  • Boolean
    Example: taxCode, createdAt, title, etc.

Product fields here that types are:

  • Int
  • String

Example: productType, redirectNewHandle, title

Metafields which value types (*) are:

  • single_line_text_field
  • number_integer

(*) Metafield value types need to be pre-defined in Metafield definition through Shopify admin. 

Brand fields here that types are:

  • Float
  • Decimal
  • Int
  • String
  • ID
  • ISO8601DateTime
  • Boolean
    Example: ID, logo, name, slug, etc.
 

Variant fields here that types are:

  • Float
  • Decimal
  • Int
  • String
  • ID
  • ISO8601DateTime
  • Boolean
    Example: barCode, createdAt, label, etc

ProductVariant fields here that types are:

  • String
  • int
    Example: barcode, SKU, taxCode, etc.

Metafields which value types (*) are:

  • single_line_text_field
  • number_integer

(*) Metafield value types need to be pre-defined in Metafield definition through Shopify admin.  

 

Set up custom mappings

  1. In Marketplacer accelerator Cerberus, click Custom Mapping from the the Shopify section.
  2. Next, Sync the custom metafields from Shopify into Marketplacer by selecting the 'Sync metafield definitions from Shopify' option.
  3. The SI or Technical Partners can create a rule for either Marketplacer Advert or Marketplacer Variant. Click Add a new Custom Mapping in either of them. You will be prompted to select a field in Marketplacer Advert. For example, choose to add a custom mapping for Marketplacer Variant.
  4. First, you must select a Marketplacer field and choose a compatible Shopify field that is mapped. For example, Marketplacer’s Tax Code is to be mapped to Shopify’s Tax Code.
  5. Click Done and Apply to save your changes.
  6. To remove the custom mapping you don't want to use, click Delete.
  7. Alternatively, click Static Custom Mapping to map a static value to Shopify’s field. You do not need a particular Marketplacer’s field to map to Shopify's field.
  8. Complete the form including Label, Description, Type, and Value.
    Note: Type and Value are important as Type will decide the compatible Shopify’s field to map and Value is the actual value will be statically set and sent to Shopify.
  9. Click Done and Apply to save your changes.
    Note: Currently, the Shopify fields supported are still limited but could be extended. Any mapping changes made will not apply to existing records but will apply to future syncs.

Customization options

If you want to synchronize other data between Marketplacer Accelerator (Cerberus) and Shopify Plus, you must consult an SI, Technical Partner’s developer, or specialized provider. They will also help you customize the connection between platforms using Marketplacer’s GraphQL API and Partner Access code.

You can find detailed documentation about the GraphQL API here and the Partner Access Code here.
Any customization made by the SI or Technical partner will be the responsibility of the Operator and Partner to support.

Was this article helpful?
0 out of 0 found this helpful

Related articles

On this page