Zahlungen

    Quittungsvariablen (Liquid-Referenz)

    POSBridge-Variablen im Shopify POS Kassenbon-Editor nutzen — mit fertigen Liquid-Codebeispielen.

    POSBridge schreibt nach jeder Zahlung automatisch Daten auf die Shopify-Bestellung — Trinkgeldbetrag, SumUp Transaktions-ID, Zahlungsart und mehr. Mit wenigen Zeilen Liquid-Code erscheinen diese Infos direkt auf dem gedruckten oder digitalen Kassenbon.

    Kassenbon-Code-Editor öffnen

    1. Öffne Shopify POS auf iPad oder iPhone
    2. Tippe auf das Zahnrad-Symbol (Einstellungen)
    3. Wähle Kassenbons
    4. Tippe auf Code-Editor
    5. Füge deinen Liquid-Code ein und tippe auf Speichern

    Änderungen gelten sofort — der nächste Kassenbon zeigt bereits die neuen Daten.

    Verfügbare Variablen (order.note_attributes)

    VariableInhaltBeispiel
    — Immer gesetzt (jede Zahlung) —
    posbridge_payment_idEindeutige Zahlungs-ID (nützlich für Support-Anfragen)pay_a1b2c3d4
    posbridge_sumup_txSumUp Transaktions-IDT8F2...XA91
    posbridge_charged_centsBelasteter Betrag in Cent (ohne Trinkgeld)1800
    posbridge_charged_modeZahlungsart: FULL oder PARTIALFULL
    — Nur wenn Trinkgeld gewählt wurde —
    posbridge_tip_amountTrinkgeldbetrag (formatiert)2,00 €
    posbridge_tip_subtotalWarenkorbwert ohne Trinkgeld (formatiert)18,00 €
    posbridge_tip_totalGesamtbetrag inkl. Trinkgeld (formatiert)20,00 €

    💡 Das Währungsformat der formatierten Beträge (ob € vor oder nach der Zahl steht) kann unter Einstellungen → POS Extension → Währungsformat auf Quittung angepasst werden.

    Achtung

    Wichtig: posbridge_charged_cents liefert den Betrag als Ganzzahl in Cent — nicht in Euro. Beispiel: 1800 = 18,00 €. Für einen fertig formatierten Euro-Betrag auf dem Kassenbon verwende stattdessen posbridge_tip_subtotal (z.B. 18,00 €).

    Beispiel · So sieht der Kassenbon aus
    ────────────────────────────
            MEIN CAFÉ BERLIN
    ────────────────────────────
     Cappuccino           3,50 €
     Croissant            2,50 €
     Espresso             2,00 €
       ...
    
     Warenwert:          18,00 €
     Trinkgeld:           2,00 €
                        ────────
     GESAMT:             20,00 €
    
     Bezahlart: SumUp Terminal
     SumUp TX:  T8F2...XA91
     Ref:       pay_a1b2c3d4
    
     Vielen Dank für Ihren Besuch!
    ────────────────────────────

    Fertige Code-Snippets zum Kopieren

    Kopiere einen der folgenden Blöcke in den Code-Editor (Shopify POS → Einstellungen → Kassenbons → Code-Editor). Beschriftungen wie Trinkgeld: oder Gesamt: kannst du jederzeit anpassen.

    Snippet 1 — Nur Trinkgeldbetrag anzeigen

    {% assign pb_tip = order.note_attributes | where: "name", "posbridge_tip_amount" | first %}
    {% if pb_tip %}
    Trinkgeld: {{ pb_tip.value }}
    {% endif %}

    Snippet 2 — Volle Aufschlüsselung (Netto + Trinkgeld + Gesamt)

    {% assign pb_tip = order.note_attributes | where: "name", "posbridge_tip_amount"   | first %}
    {% assign pb_sub = order.note_attributes | where: "name", "posbridge_tip_subtotal" | first %}
    {% assign pb_tot = order.note_attributes | where: "name", "posbridge_tip_total"    | first %}
    {% if pb_tip %}
    Nettobetrag: {{ pb_sub.value }}
    Trinkgeld:   {{ pb_tip.value }}
    --------------------
    Gesamt:      {{ pb_tot.value }}
    {% endif %}

    Snippet 3 — Zahlungsreferenz & Zahlungsart (immer verfügbar)

    {%- assign pb_ref  = order.note_attributes | where: "name", "posbridge_payment_id"  | first -%}
    {%- assign pb_tx   = order.note_attributes | where: "name", "posbridge_sumup_tx"    | first -%}
    {%- assign pb_mode = order.note_attributes | where: "name", "posbridge_charged_mode"| first -%}
    
    {% if pb_ref  %}Zahlungs-Ref.: {{ pb_ref.value }}{% endif %}
    {% if pb_tx   %}SumUp TX:      {{ pb_tx.value }}{% endif %}
    {% if pb_mode %}
      {% if pb_mode.value == "FULL"  %}Vollzahlung{% endif %}
      {% if pb_mode.value == "PARTIAL" %}Teilzahlung{% endif %}
    {% endif %}
    Tipp

    Steuerliche Fragen zum Trinkgeld bitte mit deinem Steuerberater klären — die Behandlung variiert je nach Land und Unternehmensform.