Flyerline - Einrichten

Das Modul Flyerline muss aktiviert sein.

Shop-spezifische Einstellungen (API-Key & Umgebung)

Unter Addons → Flyerline wählt man zunächst den Shop aus. Pro Shop stehen jetzt zwei zusätzliche Einstellungen zur Verfügung:

Live Mode (Umschalter)
- aktiv — es wird die produktive Flyerline-Umgebung verwendet (https://www.flyerline.ch).
- inaktiv — es wird die Test-/Staging-Umgebung verwendet (https://qas.flyerline.ch).
API-Key (Textfeld)
- Shop-spezifischer Key für die Flyerline-API.

Globale Aufschläge

Unter Addons->Flyerline muss man zunächst auswählen für welchen Shop die Einstellungen gelten. Sobald man einen Shop ausgewählt hat werden die eingestellten Aufschläge angeizeigt.

Klickt man auf “Aufschlag hinzufügen“ öffnet sich ein Modal und man kann einen Aufschlag hinzufügen.

Hybridartikel einrichten

Es können Hybrid-Artikel konfiguriert werden. Bei diesen Artikeln wird lediglich das Flyerline-Produkt voreingestellt. Im Shop können dann die gewünschten Attribute ausgewählt werden.

Eingerichtet wird ein Hybridartikel unter Produkte->Artikel->bearbeiten im Tab “Flyerline Artikel”.

Preisstaffel anlegen

Wenn das Modal Flyerline aktiviert ist muss bei “Produkte->Preisstaffeln” der Button “+ Flyerline-Preistaffel anlegen“ anegzeigt werden. Klickt man auf diesen Button öffnet sich ein Modal und man kann ein Flyerlineprodukt konfigurieren für das eine Preisstaffel angelegt werden soll. Klickt man auf speichern wird die Preisstaffel angelegt.

Bei der Preisstaffel wird eine weitere Spalte “Flyerline-Artikel” angezeigt. Klickt man auf den Button öffnet sich ein Modal und man sieht die Flyerline-Konfiguration für diese Staffeleintrag.

Dienstleister-XML-Export – verfügbare Felder

Im Dienstleister-XML-Export (Smarty-Template) steht pro Bestellposition die Flyerline-Konfiguration als Cart-Info-Eintrag orderFlyerlineConfiguration zur Verfügung. Sie wird als JSON gespeichert und im Template dekodiert:

{assign var="orderFlyerlineConfiguration" value=$orderItem.info.orderFlyerlineConfiguration|json_decode:1}

Anschließend kann auf die folgenden Felder zugegriffen werden (z.B. $orderFlyerlineConfiguration.articleNumber).

Hinweis zu Geldbeträgen
Alle Preis- und Kostenfelder (priceValue, grossPriceValue, unitPrice, unitPriceWithVat, productionCostValue) sind ganzzahlig in der kleinsten Währungseinheit (Rappen/Cent) angegeben. Für die Ausgabe im Export müssen sie durch 100 geteilt werden, z.B. $orderFlyerlineConfiguration.priceValue / 100.

Feld	Typ	Beschreibung

Feld	Typ	Beschreibung
`productId`	int	Flyerline-Produkt-ID.
`configurationId`	int	ID der Flyerline-Konfiguration (SKU).
`isConfigurationComplete`	bool	Gibt an, ob die Konfiguration vollständig ist.
`productName`	string	Produktname (z.B. für ItemDescription).
`articleNumber`	string	Flyerline-Artikelnummer – im Export als ItemCode verwendet.
`quantity`	int	Auflage/Menge (aus dem Attribut „Auflage").
`currency`	string	Währung des Nettopreises (z.B. CHF).
`priceValue`	int	Gesamt-Nettopreis in kleinster Währungseinheit.
`grossPriceValue`	int	Gesamt-Bruttopreis in kleinster Währungseinheit.
`unitPrice`	int	Netto-Stückpreis (`priceValue / quantity`) in kleinster Währungseinheit.
`unitPriceWithVat`	int	Brutto-Stückpreis (`grossPriceValue / quantity`) in kleinster Währungseinheit.
`productionCostValue`	int	Netto-Produktionskosten in kleinster Währungseinheit.
`productionCostCurrency`	string	Währung der Produktionskosten. (neu in PL-23400)
`machineCode`	string	Maschinencode der Konfiguration.
`proboCode`	string	Probo-Code der Konfiguration. (neu in PL-23400)
`proboOverrides`	string	Probo-Overrides (zusätzliche Vorgaben für die Produktion). (neu in PL-23400)
`shippingDate`	string	Versanddatum im Format `Y-m-d H:i:s`. Im Export typischerweise via `date_format` formatiert.
`selectedAttributes`	array	Liste der gewählten Konfigurations-Attribute (siehe unten).

Felder eines Eintrags in `selectedAttributes`

Über selectedAttributes wird im Template iteriert (foreach). Jeder Eintrag enthält:

Feld	Typ	Beschreibung

Feld	Typ	Beschreibung
`id`	int	ID des Attributs.
`name`	string	Name des Attributs (z.B. „Auflage", „Maschine", „Papier").
`option`	object	Die gewählte Option mit den Feldern `option.id` (int) und `option.name` (string).

Hinweis zum Maschinencode
Im bestehenden Export wird der Maschinencode nicht direkt aus machineCode ausgegeben, sondern über das Attribut mit Namen „Maschine" und die Lookup-Tabelle flyerlineMachineCodes ermittelt. Das Feld machineCode steht zusätzlich direkt in der Konfiguration zur Verfügung.