Ga naar inhoud

Doorzoek handleidingen voor Multistore Inventory Sync.

    Markdown downloadenSla een kopie van deze handleiding op

    Metafields synchroniseren

    AI-overzicht

    Leer hoe je product- en variantmetafields synchroniseert van een Source store naar een Destination store in Tipo Sync. Je schakelt het delen van metafields in bij de Source store en het synchroniseren van metafields bij de Destination store en kiest dan welke metafields je synchroniseert met namespace.key. De gegevenstypen moeten exact overeenkomen tussen de twee winkels.

    Meer weergevenMinder weergeven
    • Referentietypen en MetaObjects worden niet ondersteund; de gegevenstypen van metafields moeten in beide winkels overeenkomen.
    • Open in de Source store Settings, schakel Share Metafields in, kies de resource Product of Variant en voeg definities toe als namespace.key.
    • Open in de Destination store Stores, open de details van de koppeling, schakel Metafields sync in en selecteer de resources.
    • Klik op Save; ontbrekende definities worden automatisch aangemaakt in de Destination store.
    • Een lege waarde in de Source overschrijft nooit een bestaande waarde in de Destination.

    Samenvatting gemaakt door AI. Er kunnen fouten in staan, dus raadpleeg de volledige handleiding hieronder.

    Deze handleiding legt uit hoe je metafields van je Source store naar je Destination store synchroniseert in de Tipo-app.

    • Product metafields
    • Variant metafields (als je dit inschakelt)

    De Tipo-app kan metafields synchroniseren voor:

    • materiaal, maattabel, specificaties
    • aangepaste badges (bijv. “best_seller”)
    • extra productdetails die door thema’s of apps worden gebruikt

    Metafields zijn aangepaste velden in Shopify die worden gebruikt om extra productgegevens op te slaan, zoals:


    • Meerregelige tekst
    • Opgemaakte tekst
    • Geheel getal
    • Decimaal
    • Datum en tijd
    • Datum
    • Afmeting
    • Volume
    • Gewicht
    • Waar of onwaar
    • Beoordeling
    • URL
    • Geld
    • Link
    • JSON

    🚫 Nog niet ondersteund:
    Referentietypen (bijv. productreferentie, collectiereferentie) worden momenteel niet ondersteund.


    🛠️ Stap 1: Metafields configureren in de Source store

    Section titled “🛠️ Stap 1: Metafields configureren in de Source store”
    1. Open de app > klik op Settings > zet Share Metafields aan
    2. Kies de resource die je wilt delen:
      • Product resource – Deel productmetafields.
      • Variant resource – Deel variantmetafields.
    3. Voeg specifieke metafield-definities toe om te beperken welke metafields worden gedeeld.
      • Klik op het pictogram Browse metafields, of

      • Voer de metafield-definitie in het volgende formaat in:

        namespace.key

    Bijvoorbeeld:

    ```
    custom.materialseo.titlespecifications.weight
    ```

    4. Click Save to update the changes


    🛠️ Stap 2: Metafields configureren in de Destination store

    Section titled “🛠️ Stap 2: Metafields configureren in de Destination store”
    1. Open de app > klik op Stores > klik op de URL van de source store om de verbindingsdetails te openen
    1. Zet Metafields sync aan
    2. Kies wat je wilt synchroniseren

    Selecteer onder Allow data een of beide:

    • Product Resource → productmetafields synchroniseren
      • Variant Resource → variantmetafields synchroniseren
    1. Klik op het zoekpictogram rechts om alle ondersteunde metafields te zien > klik op de knop Select valid metafield to sync
    1. Klik op Save om de wijzigingen op te slaan

    🔄 Wat er gebeurt tijdens de synchronisatie

    Section titled “ 🔄 Wat er gebeurt tijdens de synchronisatie”

    1) Als de Destination store de metafield-definitie niet heeft

    Section titled “1) Als de Destination store de metafield-definitie niet heeft”

    De app maakt de metafield-definitie automatisch aan in de Destination store (indien nodig).

    Nadat deze is aangemaakt, verschijnen de gesynchroniseerde metafieldwaarden op het product of de variant in de Destination store.

    2) Als metafields bestaan maar niet “gestructureerd” zijn (ongestructureerde metafields)

    Section titled “2) Als metafields bestaan maar niet “gestructureerd” zijn (ongestructureerde metafields)”

    In sommige gevallen kunnen metafields worden gesynchroniseerd, ook als ze in de Destination store niet volledig zijn gedefinieerd of gestructureerd.

    Om ze in Shopify Admin te bekijken:

    • Ga naar store Settings → Metafields and metaobjects
    • Kies Product (of Variant)
    • Open View unstructured metafields

    💡 Tip: Je kunt deze metafields later handmatig definiëren en structureren om je winkelgegevens schoon en consistent te houden.

    3) Als de Source store geen waarde heeft, wordt de Destination niet overschreven

    Section titled “3) Als de Source store geen waarde heeft, wordt de Destination niet overschreven”

    Als een metafield in de Destination store bestaat maar de waarde in de Source store leeg is, overschrijft Tipo Sync de waarde in de Destination store niet.

    4) Gegevenstypen moeten overeenkomen (zeer belangrijk)

    Section titled “4) Gegevenstypen moeten overeenkomen (zeer belangrijk)”

    Metafield-gegevenstypen moeten exact overeenkomen tussen Source en Destination.

    Voorbeelden van niet-overeenkomende gegevenstypen:

    • single_line_text_field vs multi_line_text_field
    • number_integer vs number_decimal
    • product_reference vs text

    ⚠️ Als de gegevenstypen niet overeenkomen, kan de synchronisatie mislukken of wordt die metafield overgeslagen.


    📌 Voorbeeld: een productmetafield synchroniseren – “Material”

    Section titled “📌 Voorbeeld: een productmetafield synchroniseren – “Material””

    Je wilt een aangepaste productmetafield met de naam Material (bijv. “Cotton”, “Leather”, “Wool”) van je Source Store naar je Destination Store synchroniseren met onze app.

    In je Source Store:

    1. Ga naar Shopify Admin > open de winkel Settings > Metafields and metaobjects > kies Product (of Variant)
    2. Klik op Add definition (als deze nog niet is aangemaakt) > vul de metafield-definitie in:
      • Name: Material
      • Namespace: custom
      • Key: material
      • Type: Single line text

    => Dit geeft je de volledige metafieldsleutel: custom.material

    Herhaal deze stap in je Destination Store (moet dezelfde sleutel en hetzelfde type hebben).

    Stap 2: Voeg metafieldgegevens toe aan producten

    Section titled “Stap 2: Voeg metafieldgegevens toe aan producten”

    Ga in je Source Store naar een product en scrol naar beneden naar Metafields > voer onder Material in: Cotton

    Dit product heeft nu de metafield custom.material = "Cotton".

    Stap 3: Synchronisatie configureren in de Tipo-app

    Section titled “Stap 3: Synchronisatie configureren in de Tipo-app ”
    • Open onze app in de Destination Store > ga naar Connect Configuration > Metafield Sync
    • Kies Specific Metafields > voer de metafieldsleutel exact in: custom.material

    Resultaat

    • Onze app vindt custom.material in de Source Store
    • Als deze niet bestaat in het Destination-product, maakt de app deze aan
      => Resultaat: custom.material = "Cotton" in beide winkels
    • Als deze in de Destination store bestaat maar de Source leeg is, overschrijven we de waarde niet

    V1: Hoe stel ik namespace.key in je winkel in?

    Section titled “V1: Hoe stel ik namespace.key in je winkel in?”

    Om een specifieke metafield te synchroniseren, voer je de metafield-definitiesleutel in dit formaat in: namespace.key (bijvoorbeeld: custom.color).

    Zo vind je dit in je Shopify-beheeromgeving:

    1. Ga naar je Shopify Admin > navigeer naar Settings > Custom Data > Products
    2. Klik op de metafield die je wilt synchroniseren
      → Je ziet de waarden Namespace en Key
    3. Combineer ze in dit formaat: namespace.key
      → Voorbeeld: custom.description

    V2: Waarom worden mijn metafields niet gesynchroniseerd?

    Section titled “V2: Waarom worden mijn metafields niet gesynchroniseerd?”

    Als je metafields niet correct worden gesynchroniseerd, kan dat een van de volgende oorzaken hebben:

    1. Metafieldsynchronisatie is niet ingeschakeld
      Zorg dat metafieldsynchronisatie voor beide winkels is ingeschakeld:
      • Schakel Share Metafields in de Source Store in.
      • Schakel Receive Metafields in de Destination Store in.
    1. Metafield-definitiesleutel is niet toegevoegd

    Naast het inschakelen van metafieldsynchronisatie moet je ook de metafield-definitiesleutel (namespace.key) toevoegen die je wilt synchroniseren.

    • Ga naar Settings → Share Metafields
    • Zorg dat Enable is aangevinkt
    • Voeg onder Allow data de metafield-definitie in dit formaat toe:
      namespace.key
      Voorbeeld: custom.material
    1. Niet-ondersteunde metafieldtypen
      Sommige metafield-gegevenstypen worden niet ondersteund, zoals Reference types of MetaObjects.

    Rood: niet-ondersteunde metafields die niet door de app kunnen worden gesynchroniseerd

    1. Niet-overeenkomende metafieldtypen tussen winkels
      De metafield in je Source en Destination moet hetzelfde gegevenstype en dezelfde structuur hebben.
      Veelvoorkomende verschillen zijn:
    • Eén metafield is Single line text, terwijl de andere Multi-line text is.
    • Eén metafield gebruikt Single value, terwijl de andere List of values gebruikt.

    Om deze problemen op te lossen, controleer je of de metafields in beide winkels dezelfde namespace, key en gegevenstype hebben, en probeer daarna opnieuw te synchroniseren.


    🙋 Heb je nog steeds ondersteuning nodig?

    Als je nog steeds hulp nodig hebt, neem dan gerust contact met ons op via hi@tipo.io. We helpen je graag verder.