Metafelder lesen

Was sind Metafelder?

Mit Metafeldern kannst du die Funktionalität und das Erscheinungsbild deines Shopify-Shops anpassen, indem du spezielle Informationen speichern kannst, die normalerweise nicht im Shopify-Adminbereich erfasst werden. Mehr dazu im Shopify Help Center.

Du kannst Metafelder, die von Shopify-Apps oder deiner eigenen Schnittstelle verwaltet werden, in Platzhalter übertragen und auf deinen Rechnungen und Gutschriften abbilden.

Wie wandle ich ein Metafeld in einen Platzhalter um?

Definiere das Metafeld zuerst in Shopify an der gewünschten Ressource und hinterlege dort einen Wert. Unter Metafelder lesen richtest du anschließend das Einlesen in die App ein. Dafür benötigst du ein App-Abonnement mit Metafeldfunktion:

  1. Öffne die Metafeld-Einstellungen.
  2. Scrolle zum Bereich "Metafelder lesen"
  3. Wähle die gewünschte Ressource im Dropdown-Menü aus
  4. Lege Namensraum und Schlüssel fest
  5. Füge die Lesekonfiguration über Hinzufügen hinzu und speichere die Einstellungen

Was ist der Namensraum?

Das Gruppieren von Metafeldern innerhalb eines Namensraums („Namespace“) verhindert, dass Metafelder mit anderen Metafeldern mit demselben Schlüsselnamen in Konflikt geraten. Zusammen ergeben Namensraum und Schlüssel eine eindeutige ID für das Metafeld.

Was ist der Schlüssel?

Der Schlüssel ("Key") dient in Verbindung mit dem Namensraum zur eindeutigen Identifizierung eines Metafeldes. Schlüssel können bis zu 64 Zeichen lang sein und alphanumerische Zeichen, Bindestriche, Unterstriche und Punkte enthalten.

Welche Ressourcen gibt es?

Es können Metafelder der folgenden Ressourcen gelesen werden:

  • Shop Shop

    Dein Shopify-Shop

  • Bestellung Order

    Die zugehörige Bestellung

  • Kunde Order.Customer

    Der Kunde der zugehörigen Bestellung

  • Unternehmensstandort Order.Company.Location

    Der Unternehmensstandort der B2B-Bestellung

  • Produkt Order.LineItem.Product
    Nur in Positionstexten verfügbar

    Das Produkt der aktuellen Artikelposition
  • Variante Order.LineItem.Variant
    Nur in Positionstexten verfügbar

    Die Variante des Produkts der aktuellen Artikelposition

Wann werden Metafelder gelesen?

Metafelder werden bei der Verarbeitung einer Bestellung gelesen. Die Platzhalter enthalten daher den Stand zum jeweiligen Verarbeitungszeitpunkt. Eine Änderung in Shopify wird erst beim erneuten Einlesen übernommen. Bei einem fehlgeschlagenen Standortabruf bleibt ein zuvor eingelesener Wert erhalten; ein erfolgreich festgestelltes fehlendes Metafeld wird geleert.

Was geschieht mit mehrzeiligen Metafeld-Werten?

Ist der Wert eines Metafeldes eine Liste, werden die einzelnen Elemente mit dem Trenn­zeichen , an­ein­ander­ge­reiht.

Wie lautet die Bezeichnung des erzeugten Platzhalters?

Die Bezeichnung des Platzhalters setzt sich aus der Ressource, dem Namensraum und dem Schlüssel (getrennt mit . und angeführt von METAFIELD) zusammen.

Beispiel: [% METAFIELD.VARIANT.GLOBAL.KEY %]

Du kannst Platzhalter nach ihrer Erstellung aus der Tabelle in den Einstellungen kopieren.

Wie verwende ich eine separate Rechnungs-E-Mail-Adresse pro Unternehmensstandort?

  1. Definiere in Shopify am Unternehmensstandort ein Metafeld, beispielsweise custom.invoice_email vom Typ Einzeiliger Text.
  2. Hinterlege am jeweiligen Standort eine gültige Rechnungs-E-Mail-Adresse als Wert.
  3. Wähle unter Einstellungen → Metafelder → Metafelder lesen die Ressource Unternehmensstandort, den Namensraum custom und den Schlüssel invoice_email. Erteile bei Bedarf die Berechtigung zum Lesen von Unternehmen, füge den Eintrag hinzu und speichere.
  4. Trage unter Einstellungen → Rechnungen → Rechnungen per E-Mail versenden im Feld Empfänger den Platzhalter [% METAFIELD.COMPANY_LOCATION.CUSTOM.INVOICE_EMAIL %] ein und speichere.

Die App verwendet den Unternehmensstandort der jeweiligen B2B-Bestellung. Metafelder direkt am Unternehmen werden nicht eingelesen. Aktiviere zusätzlich den automatischen Rechnungsversand; dafür benötigt dein App-Abonnement auch die E-Mail-Funktion.

Ist der Platzhalter leer oder enthält er keine gültige E-Mail-Adresse, verwendet die App die Standard-E-Mail-Adresse der Bestellung. Pflege deshalb für alle betroffenen Standorte eine gültige Adresse.

App im Shopify App Store ansehen