Shopify: Eigene Beleg- und Kundennummern über Metafelder übernehmen
Wenn du deine Rechnungs-, Gutschrifts- und Kundennummern in einem eigenen System (z. B. SAP oder einem anderen ERP) vergibst, kann easybill Connect diese Nummern aus Shopify-Metafeldern übernehmen. Die erzeugten easybill-Belege tragen dann deine Nummern statt der von easybill vergebenen.
Schritt 1: Automatischen Import über die GraphQL-API aktivieren
Der Metafeld-Import funktioniert nur mit dem automatischen Import über die GraphQL-API. Wähle in den Shopify-Einstellungen unter "Quelle für automatischen Import" die GraphQL-API.
Schritt 2: Rechnungsnummer vom Shop übernehmen
Aktiviere in den übergreifenden Einstellungen die Option "Rechnungsnummer vom Shop übernehmen". Nur dann werden die importierten Nummern als Belegnummern der easybill-Dokumente verwendet.
Schritt 3: Metafelder in Shopify befüllen
Dein System befüllt die folgenden Metafelder an der Shopify-Bestellung (z. B. über Shopify Flow oder die Shopify-API).
| Zweck | Metafeld (an der Bestellung) | Typ |
|---|---|---|
| Rechnungsnummer | custom.easybill_invoice_number |
Einzeiliger Text |
| Gutschriftsnummern | custom.easybill_credit_note_numbers |
JSON |
Die Gutschriftsnummern werden als JSON-Liste hinterlegt, da Shopify keine Metafelder an Erstattungen erlaubt. Jeder Eintrag ordnet einer Shopify-Erstattung (numerischer Teil der Refund-ID) eine Nummer zu:
[
{ "refund_id": "987654321", "number": "GS-2026-0077" }
]Jede Erstattung wird als eigene Gutschrift mit genau dieser Nummer exportiert.
Schritt 4: Bestellungen ohne Nummer zurückhalten (Import-Gate)
easybill importiert jede Bestellung genau einmal und aktualisiert sie nachträglich nicht. Die Rechnungsnummer muss also gesetzt sein, bevor die Bestellung importiert wird. Wenn dein System die Nummer erst nach Bestelleingang liefert, trage in den Shopify-Einstellungen unter "Bestellungen überspringen" folgende Regel ein:
{% if invoice_number == blank %}skip{% endif %}Bestellungen ohne Nummer werden dann übersprungen und automatisch importiert, sobald die Nummer im Metafeld steht.
Bitte beachte: Die Regel gilt für alle Bestellungen des Shops. Aktiviere sie erst, wenn die Befüllung der Metafelder eingerichtet ist, sonst wird nichts importiert. Verwende genau die Schreibweise == blank.
Dasselbe gilt für Gutschriften: Der Eintrag in custom.easybill_credit_note_numbers muss vorhanden sein, bevor easybill die Erstattung verarbeitet.
Fehlerfälle
Nummern über 255 Zeichen und ungültige JSON-Inhalte werden nicht übernommen und als Import-Fehler am Import-Lauf angezeigt.