Was sind Funktionsattribute?
In JTL-Wawi werden Funktionsattribute zentral unter Menü Artikel → Attribute angelegt (Bereich „Artikel" → Attribut anlegen → Funktionsattribut) und anschließend je Artikel mit einem Wert befüllt. BISpicy liest beim JTL-Sync die Attribute mit dem Präfix bis_ aus und übernimmt sie automatisch in BIS ERP und die POS-Kasse.
Vorteile
- Bidirektional. Gebinde, Preise und Pfand lassen sich in JTL oder direkt in BIS ERP pflegen — der Sync gleicht beide Seiten ab. Änderungen aus BIS ERP schreibt er als Funktionsattribute nach JTL zurück, wenn im Kundencenter unter Anbindungen → JTL-Wawi die Richtung für „Artikel“ auf „BISpicy → JTL“ oder „Bidirektional“ steht. Bei „JTL → BISpicy“ schreibt BISpicy keine Funktionsattribute nach JTL.
- Keine Doppelpflege. Keine Stücklisten-Artikel für Gebinde, keine zusätzlichen Pfand-Stammsätze, keine Im-/Exportdateien.
- Automatischer Abgleich. Änderungen erscheinen beim nächsten Sync auf der jeweils anderen Seite — in BIS ERP, der Kasse und JTL.
bis_. Werte werden aus tArtikelAttributSprache für Sprache 0 und 1 gelesen. Umlaute werden automatisch von Windows-1252 auf UTF-8 konvertiert.Gebinde / Verpackungseinheiten
Die Gebinde selbst (Kiste, Träger, Palette) übernimmt BIS ERP aus der Gebindeliste des Artikels in JTL-Wawi (in JTL Artikel → Gebinde/EAN): Name, Menge und EAN. Funktionsattribute braucht es dafür nicht. Mit den Attributen bis_gebinde_N_… legen Sie vor allem den Preis eines Gebindes fest. BIS ERP ordnet sie über die Menge dem Gebinde aus der JTL-Gebindeliste zu. Ohne Attribut rechnet BIS ERP Einzelpreis mal Menge. Ein Gebinde, das nur per Funktionsattribut beschrieben ist und in der Gebindeliste fehlt, legt BIS ERP zusätzlich an. Einrichtung: Gebinde in BIS ERP einrichten, Verkauf: Gebinde an der Kasse scannen.
Nummerierung: bis_gebinde_1_*, bis_gebinde_2_*, … — beliebig viele Gebinde pro Artikel.
Pflichtfelder
Für ein Gebinde aus der JTL-Gebindeliste genügen Menge und Preis, Name und EAN kommen dann aus JTL. Alle Pflichtfelder brauchen Sie nur für ein Gebinde, das es nur als Funktionsattribut gibt.
| Attribut | Typ | Beispiel | Was es bewirkt |
|---|---|---|---|
bis_gebinde_1_name | Text | Kiste | Anzeigename der Verpackungseinheit. Erscheint auf Bon, Rechnung, Lieferschein und Kundendisplay. |
bis_gebinde_1_menge | Ganzzahl | 20 | Anzahl Einzelartikel pro Gebinde (z. B. 20 Flaschen pro Kiste). Auch als Staffelpreis-Mindestmenge. |
bis_gebinde_1_ean | Text | 4001234567899 | EAN/Barcode des Gebindes. Die Kasse erkennt die Verpackungseinheit anhand dieser EAN beim Scannen. |
bis_gebinde_1_preis | Dezimal | 22.00 | Verkaufspreis des Gebindes. Brutto oder Netto je nach preistyp — Umrechnung erfolgt automatisch anhand der Steuerklasse. |
Optionale Felder
| Attribut | Typ | Beispiel | Was es bewirkt |
|---|---|---|---|
bis_gebinde_1_preistyp | Text | brutto / netto | Steuert, ob die Preise als Brutto- oder Nettowert interpretiert werden. Standard: brutto. |
bis_gebinde_1_preis_{kundengruppe} | Dezimal | bis_gebinde_1_preis_gastro = 16.50 | Preis für genau eine Kundengruppe. {kundengruppe} = Name der Kundengruppe in Kleinschreibung, Leerzeichen werden zu _ (z. B. b2b_staffel_1). Kundengruppen ohne eigenes Attribut bekommen den Global-Preis. |
bis_gebinde_1_preis_b2b | Dezimal | 18.00 | Sonderfall von preis_{kundengruppe}: Preis für die Kundengruppe „B2B". Gilt nur für diese eine Gruppe — andere B2B-Gruppen (z. B. „B2B Staffel 1") bekommen den Global-Preis, sofern kein eigenes Attribut gesetzt ist. |
bis_gebinde_1_sonderpreis | Dezimal | 19.99 | Zeitlich begrenzter Aktionspreis (global). |
bis_gebinde_1_sonderpreis_von / _bis | Datum | 2026-06-01 | Zeitfenster des Sonderpreises (YYYY-MM-DD). Leer = ab sofort bzw. unbefristet. |
bis_gebinde_1_sonderpreis_{kundengruppe} | Dezimal | — | Aktionspreis für eine bestimmte Kundengruppe, mit eigenem Zeitfenster. sonderpreis_b2b = Aktionspreis der Gruppe „B2B". |
bis_gebinde_1_kundengruppe | Text | — | Veraltet. Wird nicht mehr ausgewertet — stattdessen preis_{kundengruppe} verwenden. |
preis_{kundengruppe}, z. B. preis_b2b für die Gruppe „B2B"), sonst 2. der Global-Preis (preis). Es gibt keinen pauschalen „B2B-Preis für alle B2B-Gruppen" — jede Gruppe bekommt entweder ihren eigenen Preis oder den Global-Preis. In BIS ERP bearbeitbar unter Preise & Kanäle des Artikels (Preise bearbeiten am Gebinde) — auch ganz ohne JTL.Pfand am Basisartikel
Markiert einen Artikel als Pfandartikel (z. B. Glasflasche) und definiert den Pfandwert. Beim POS-Verkauf erscheint Pfand automatisch als eigene Position auf dem Bon.
| Attribut | Typ | Werte | Was es bewirkt |
|---|---|---|---|
bis_pfand_typ |
Text | EINWEG / MEHRWEG / KEIN | Pfandart. EINWEG = klassisches Einwegpfand (i. d. R. 0,25 €). MEHRWEG = Mehrwegflasche. KEIN oder leer = kein Pfand. |
bis_pfand_betrag |
Dezimal | z. B. 0.25 | Flaschenpfand pro Stück. Brutto bei B2C-Kundengruppen, Netto bei B2B-Kundengruppen. |
bis_kistenpfand_betrag |
Dezimal | z. B. 1.50 | Pfand für die Kiste selbst (nicht pro Flasche). Ist das Attribut in JTL gesetzt, übernimmt der Abgleich seinen Wert, auch über einen in BIS ERP geänderten Wert. Fehlt es, bleibt der Wert aus BIS ERP stehen. |
bis_kiste_ab |
Ganzzahl | z. B. 12 | Schwelle der Kistenautomatik: je volle Anzahl Flaschen bucht die Kasse eine Kiste (bei 12: ab 12 Flaschen eine, ab 24 zwei). Wirkt nur zusammen mit bis_kistenpfand_betrag. Übernahme wie dort: in JTL gesetzt gilt, fehlt es, bleibt der Wert aus BIS ERP. |
bis_pfand_artikel |
Text | EINWEG / MEHRWEG / KASTEN | Gehört an Ihren Pfandartikel selbst (etwa „Pfand 0,25 €“), nicht an die Ware. BISpicy trägt dessen Artikelnummer bei der passenden Pfandart im Kundencenter unter Verkauf → Pfandarten ein: gleiche Pfandart und gleicher Betrag (aus bis_pfand_betrag am Pfandartikel, sonst sein Verkaufspreis). Unter dieser Nummer steht das Pfand dann auf dem Bon und im JTL-Auftrag. Eine schon eingetragene Artikelnummer bleibt, eine neue Pfandart legt der Abgleich nicht an. Pfandarten pflegen |
Beispiel — minimaler Pfand-Setup ohne Gebinde-VPE
bis_pfand_betrag = 0.25
bis_kistenpfand_betrag = 1.50
bis_kiste_ab = 12
Verkauf 1 Flasche → 0,25 € Flaschenpfand. Verkauf 12 Flaschen → 12 × 0,25 € + 1 × 1,50 € Kistenpfand (automatisch). Verkauf 18 Flaschen → 18 × 0,25 € + 1 × 1,50 € (die zweite Kiste kommt erst ab 24). Verkauf 24 Flaschen → 24 × 0,25 € + 2 × 1,50 €. Der Kassierer kann die Kistenpfand-Position bei Bedarf aus dem Warenkorb entfernen, falls der Kunde die Flaschen ohne Kiste mitnimmt; weitere Scans desselben Artikels bringen die Kiste in diesem Verkauf nicht zurück. Das Flaschenpfand bleibt zwingend.
Beispiel — mit Gebinde-VPE (Kiste als scanbarer Artikel)
bis_pfand_betrag = 0.25
bis_kistenpfand_betrag = 1.50
bis_kiste_ab = 12
bis_gebinde_1_name = Kiste
bis_gebinde_1_menge = 12
bis_gebinde_1_ean = 4001234567899
bis_gebinde_1_preis = 22.00
Master-Schalter Kistenautomatik
Die Kistenautomatik bucht Kistenpfand von selbst, sobald die Flaschenzahl eines Artikels im Warenkorb die Schwelle aus bis_kiste_ab erreicht: je volle Schwelle eine Kiste, ohne dass der Kassierer die Kiste extra scannen muss. Sie greift nur bei Artikeln, an denen bis_kiste_ab und bis_kistenpfand_betrag beide gesetzt sind. In BIS ERP sehen Sie die Werte am Artikel im Abschnitt Kistenpfand-Automatik („Kiste automatisch ab“, „Kistenpfand-Betrag“), sobald dort ein Pfand-Typ gewählt ist.
Im Kundencenter unter Anbindungen → JTL-Wawi, Abschnitt „Kistenpfand-Automatik“, schalten Sie die Automatik mit „Kistenautomatik aktivieren“ für Ihren ganzen Betrieb ein oder aus:
- Aktiviert (Standard): Verkauft der Kassierer 24 Flaschen eines Artikels mit
bis_kiste_ab = 12, bucht die Kasse automatisch Kistenpfand für zwei Kisten, je Kiste mit dem Wert ausbis_kistenpfand_betrag. - Deaktiviert: Keine automatische Kistenpfand-Position mehr. Flaschenpfand aus
bis_pfand_*bleibt davon unberührt und wird weiterhin pro Flasche berechnet.
Die Einstellung verteilt sich automatisch an alle angebundenen POS-Kassen. Eine Änderung im Kundencenter wirkt beim nächsten Sync der Kasse — keine Updates der App nötig.
Kundengruppen- & Sonderpreise am Basisartikel
Für den normalen Artikel (nicht das Gebinde) brauchen Sie kein Funktionsattribut. B2B-/Kundengruppen-Preise, Sonderpreise (Aktionspreise), Staffelpreise und individuelle Kundenpreise pflegen Sie ganz normal in JTL-Wawi an den Standard-Preisfeldern des Artikels. Der BISpicy-Connector liest sie beim JTL-Sync automatisch aus den nativen JTL-Preistabellen aus.
bis_*-Funktionsattribute brauchen Sie nur für Gebinde und Pfand. B2B-Preise und Sonderpreise des Basisartikels kommen aus JTLs eigener Preisverwaltung — kein Attribut nötig.Wo wird in JTL gepflegt?
- Kundengruppen-Preis (z. B. B2B): Artikel öffnen → Reiter „Preise / VK-Preise" → Preis je Kundengruppe hinterlegen.
- Sonderpreis (Aktionspreis): Artikel → „Preise" → Sonderpreis mit Gültigkeits-Zeitraum (optional je Kundengruppe).
- Staffelpreis: Artikel → „Preise" → Staffel mit „ab Menge".
- Individueller Kundenpreis: kundenspezifischer Artikelpreis (JTL-Preis mit Kundenbezug).
Preisfindung an der Kasse
Sind mehrere Preise gültig, gewinnt der speziellste — in dieser Reihenfolge:
→ Kundengruppen-Preis (z. B. B2B)
→ Staffelpreis (ab Menge)
→ Sonderpreis (im Gültigkeitszeitraum)
→ Standardpreis
Die Kundengruppe des aktiven Kunden steuert zusätzlich, ob Preise und Pfand als Brutto (B2C) oder Netto (B2B) erscheinen.
| JTL-Quelle (nativ) | Inhalt | → BIS ERP / POS |
|---|---|---|
tArtikel.fVKNetto | Standard-Verkaufspreis | Basispreis |
tPreis + tPreisDetail (ab Menge 0) | Preis je Kundengruppe (z. B. B2B) | productCustomerGroupPrices |
tPreisDetail (ab Menge > 0) | Staffelpreis | productTierPrices |
tArtikelSonderpreis + tSonderpreise | Sonderpreis mit Zeitraum | Sonderpreis-Felder |
tPreis mit Kundenbezug | Individueller Kundenpreis | product_customer_prices |
Aktionen: „Kaufe X, erhalte Y gratis" ab POS 1.1.13
Aktionen wie 1+1, 3+1 oder „kaufe Artikel A, erhalte Artikel B gratis" pflegen Sie am Auslöser-Artikel (dem Artikel, den der Kunde kauft) über bis_promo_*-Funktionsattribute. Ein Promo pro Artikel — keine Nummerierung. Der Aktionsname entsteht automatisch als „JTL-Aktion {SKU}".
| Funktionsattribut | Typ | Pflicht | Bedeutung |
|---|---|---|---|
bis_promo_buy | Ganzzahl | ja (≥ 1) | N — zu kaufende Menge (z. B. 3 bei „3+1") |
bis_promo_get | Ganzzahl | ja (≥ 1) | M — Anzahl Gratis-Einheiten (z. B. 1 bei „3+1") |
bis_promo_free_sku | Text | nein | SKU des Gratis-Artikels. Leer = derselbe Artikel (1+1, 3+1). Gesetzt = „kaufe diesen Artikel, erhalte den anderen gratis". Muss eine lokal vorhandene SKU sein, sonst Fallback auf selben Artikel. |
bis_promo_deposit | 0 / 1 | nein | Pfand auf der Gratis-Einheit berechnen. 1 = ja (Standard), 0 = nein. |
Beispiel — 3+1 auf denselben Artikel
bis_promo_get = 1
Verkauf von 4 Stück → 3 berechnet, 1 als 0,00-€-Position. Ist der Artikel pfandpflichtig, bleibt das Pfand der Gratis-Einheit voll berechnet (bis_promo_deposit=1) — nur der Artikelpreis ist 0 €.
Beispiel — kaufe Artikel A, erhalte Artikel B gratis
bis_promo_get = 1
bis_promo_free_sku = SKU-DES-GRATIS-ARTIKELS
Datenfluss
|
| JTL-Abgleich im eingestellten Takt (Standard: alle 5 Minuten) oder von Hand
v
BIS ERP
|- articles.depositType / depositAmount <- bis_pfand_*
|- articlePackagingUnits.* <- bis_gebinde_*
`- productTierPrices.* <- bis_gebinde_*_preis / sonderpreis
|
| Abgleich mit der Kasse
v
BISpicy POS
|- Verpackungseinheit scannbar (EAN)
|- Staffelpreis automatisch angewandt
|- Pfand als eigene Position addiert
`- Brutto/Netto je Kundengruppe
Sync-Verhalten
- Hinzufügen / Ändern. Bei jedem Sync werden die FA-Daten neu eingelesen.
- Löschen. Entfernen Sie die Attribute eines Gebindes in JTL, entfernt der nächste Abgleich dieses Gebinde auch in BIS ERP; in BIS ERP von Hand angelegte Gebinde bleiben. Pfand entfernen Sie mit
bis_pfand_typ = KEIN. Löschen Sie dagegen alle Pfand-Attribute, bleibt das zuletzt übernommene Pfand in BIS ERP stehen. Ebenso beibis_kiste_abundbis_kistenpfand_betrag: Fehlt das Attribut, ändert der Abgleich den Wert in BIS ERP nicht. - Mehrsprachig. Werte werden für Sprache 0 und 1 aus
tArtikelAttributSprachegelesen. - Encoding. Windows-1252 → UTF-8 für Umlaute.
- Validierung. Bei fehlenden Pflichtfeldern wird der Eintrag übersprungen und im Sync-Log als Warnung protokolliert.
Mapping-Tabelle: Funktionsattribut → BIS-ERP-Spalte
| Funktionsattribut | Ziel-Tabelle | Ziel-Spalte |
|---|---|---|
bis_gebinde_N_name | articlePackagingUnits | name, shortName |
bis_gebinde_N_menge | articlePackagingUnits | quantityPerUnit |
bis_gebinde_N_ean | articlePackagingUnits | ean, barcode |
bis_gebinde_N_preis | articlePackagingUnits / productTierPrices | sellingPrice + Staffelpreis |
bis_gebinde_N_preistyp | productTierPrices | brutto/netto-Berechnungsrichtung |
bis_gebinde_N_preis_{kundengruppe} | articlePackagingUnitGroupPrices | Gebinde-Preis je Kundengruppe |
bis_gebinde_N_sonderpreis | productTierPrices | Sonderpreis-Felder |
bis_pfand_typ | articles | depositType (EINWEG/MEHRWEG/none) |
bis_pfand_betrag | articles | depositAmount |
bis_kistenpfand_betrag | articles | crateDepositAmount |
bis_kiste_ab | articles | crateDepositThreshold |
bis_pfand_artikel | Pfandarten (Kundencenter → Verkauf → Pfandarten) | Artikelnummer der Pfandart |
Häufige Fragen
Die Kistenautomatik braucht am Artikel beide Werte, bis_kiste_ab und bis_kistenpfand_betrag, und sie muss im Kundencenter unter Anbindungen → JTL-Wawi eingeschaltet sein. Die Kiste kommt erst, wenn die Flaschenzahl des Artikels die Schwelle erreicht: bei bis_kiste_ab = 12 ab 12 Flaschen eine, ab 24 zwei. Hat der Kassierer die Kistenpfand-Position im laufenden Verkauf entfernt, bucht die Kasse für diesen Artikel im selben Verkauf keine Kiste mehr nach. Neue Werte aus JTL erreichen die Kasse mit ihrem nächsten Abgleich.
Der Abgleich übernimmt bis_kiste_ab und bis_kistenpfand_betrag, sobald das Attribut in JTL einen Wert über 0 hat, auch wenn in BIS ERP vorher ein anderer Wert stand. Prüfen Sie, ob der JTL-Abgleich seit der Änderung gelaufen ist (Standard: alle 5 Minuten) und ob das Attribut am richtigen Artikel hängt. Die Kasse erhält den neuen Wert mit ihrem nächsten Abgleich.
Setzen Sie in JTL bis_pfand_typ auf KEIN. Löschen Sie nur die Pfand-Attribute, bleibt das zuletzt übernommene Pfand in BIS ERP stehen; dann entfernen Sie es dort am Artikel.