Metafelder schreiben

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 nahezu alle Lexware-Daten zu Kontakten, Rechnungen und Gutschriften in Metafelder der zugehörigen Shopify-Bestellung übertragen. Dadurch kannst du diese Daten mit anderen Shopify-Apps oder deiner eigenen Schnittstelle teilen und direkt im Shopify-Admin anzeigen.

Für Metafelder wird die Shopify-Berechtigung WRITE_ORDERS benötigt.

Welche Metafelder gibt es?

Es lassen sich nahezu alle Lexware-Daten in Metafelder übertragen. Da jede Bestellung mehrere Rechnungen und mehrere Gutschriften besitzen kann, sind viele Metafelder Listen.

Hauptrechnung

Die Hauptrechnung (oder Primärrechnung) ist die erste von dieser App erstellte Rechnung. Sie ist nach dem in den Einstellungen festgelegten Erstellungszeitpunkt verfügbar.

Rechnungsnummer (invoice_number)
Datentyp: single_line_text_field; Definitionstyp: Ein Wert, Einzeiliger Text
RE1000
Rechnung: ID (invoice_id)
Datentyp: number_integer; Definitionstyp: Ein Wert, Ganze Zahl
1000
Rechnung: Titel (invoice_title)
Datentyp: single_line_text_field; Definitionstyp: Ein Wert, Einzeiliger Text
Rechnung zur Bestellung #1000
Rechnung-PDF: Download (invoice_pdf_save)
Datentyp: url; Definitionstyp: Ein Wert, URL
https://lexoffice.app/invoice/1000/$token/download
Rechnung-PDF: Ansehen (invoice_pdf_view)
Datentyp: url; Definitionstyp: Ein Wert, URL
https://lexoffice.app/invoice/1000/$token
Rechnung (JSON) (invoice_json)
Datentyp: json; Definitionstyp: JSON
<Invoice>

Kontakt

Der Kontakt, der für den Shopify-Kunden angelegt bzw. ihm zugewiesen wurde.

Kontakt-ID (contact_id)
Datentyp: number_integer; Definitionstyp: Ein Wert, Ganze Zahl
1000

Alle Rechnungen

Jede Bestellung kann mehrere Rechnungen besitzen, die entweder als Werte-Liste (getrennt durch Zeilenumbrüche) oder JSON-Array in Metafelder übertragen werden können.

Rechnungsnummern (invoices_number)
Datentyp: list.single_line_text_field; Definitionstyp: Werteliste, Einzeiliger Text
RE1000
RE1001
...
Rechnungen: IDs (invoices_id)
Datentyp: list.single_line_text_field; Definitionstyp: Werteliste, Einzeiliger Text
1000
1001
...
Rechnungen: Titel (invoices_title)
Datentyp: list.single_line_text_field; Definitionstyp: Werteliste, Einzeiliger Text
Rechnung zu #1000
Rechnung zu #1001
...
Rechnung-PDFs: Download (invoices_pdf_save)
Datentyp: list.url; Definitionstyp: Werteliste, URL
https://lexify.me/invoice/1000/$token
https://lexify.me/invoice/1001/$token
...
Rechnung-PDFs: Ansehen (invoices_pdf_view)
Datentyp: list.url; Definitionstyp: Werteliste, URL
https://lexify.me/invoice/1000/$token/download
https://lexify.me/invoice/1001/$token/download
...
Rechnungen (JSON) (invoices_json)
Datentyp: json; Definitionstyp: JSON
Array<Invoice>

Alle Gutschriften

Jede Bestellung kann mehrere Gutschriften besitzen, die entweder als Werte-Liste (getrennt durch Zeilenumbrüche) oder JSON-Array in Metafelder übertragen werden können.

Gutschriften-Nummern (credits_number)
Datentyp: list.single_line_text_field; Definitionstyp: Werteliste, Einzeiliger Text
GU1000
GU1001
...
Gutschriften: IDs (credits_id)
Datentyp: list.single_line_text_field; Definitionstyp: Werteliste, Einzeiliger Text
1000
1001
...
Gutschriften: Titel (credits_title)
Datentyp: list.single_line_text_field; Definitionstyp: Werteliste, Einzeiliger Text
Gutschrift zu #1000
Gutschrift zu #1001
...
Gutschrift-PDFs: Download (credits_pdf_save)
Datentyp: list.url; Definitionstyp: Werteliste, URL
https://lexify.me/credit/1000/$token
https://lexify.me/credit/1001/$token
...
Gutschrift-PDFs: Ansehen (credits_pdf_view)
Datentyp: list.url; Definitionstyp: Werteliste, URL
https://lexify.me/credit/1000/$token/download
https://lexify.me/credit/1001/$token/download
...
Gutschriften (JSON) (credits_json)
Datentyp: json; Definitionstyp: JSON
Array<CreditNote>

Wir empfehlen die JSON-Metafelder (invoice_json, invoices_json und credits_json) nur zu verwenden, wenn die benötigten Werte über andere Metafelder nicht verfügbar sind.

Wie erstelle ich ein Metafeld?

Du kannst Metafelder in den Einstellungen verwalten:

  1. Öffne die Metafeld-Einstellungen.
  2. Scrolle zum Bereich "Metafelder schreiben"
  3. Wähle den gewünschten Lexware-Wert im Dropdown-Menü aus
  4. Lege Namensraum und Schlüssel fest oder übernehme die Standardwerte
  5. Lege das Metafeld über den Hinzufügen-Button an 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.

Der Namensraum muss mindestens 3 und maximal 255 Zeichen lang sein.

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.

Wann werden Metafelder erstellt?

Metafelder werden durch Webhooks verwaltet und unmittelbar nach Fertigstellung der Lexware-Operationen an Shopify gesendet.

In der Bestellansicht kannst du nachvollziehen, welche Metafelder übertragen wurden.

Wo werden die Metafelder erstellt?

Diese App erstellt ausschließlich Metafelder für die Shopify-Ressource Orders (Bestellungen).

Werden Metafelder aktualisiert?

Ja, unter Umständen:

  • Wenn die App eine Shopify-Bestellung verarbeitet oder Belege importiert, werden die konfigurierten Metafelder aktualisiert.
  • Lexware-Webhooks aktualisieren zwar die Belegdaten in der App, die Shopify-Metafelder aber nicht in jedem Fall sofort. Eine spätere Verarbeitung oder ein erneuter Belegimport aktualisiert sie.

Wie bekomme ich andere Daten in Metafelder?

Wenn du neben den vorhandenen Metafeldern eine Angabe vermisst, schicke uns eine Nachricht. Die Chancen stehen gut, dass wir dir helfen können!

App im Shopify App Store ansehen