Modul: Website / Webshop / Gateway
Modul: Website
Konfiguration -> E-Commerce -> Live Chat
Für die Website bzw. den Onlineshop kann ein Live Chat aktiviert werden, über den Website-Besucher mit einem Bediener/Mitarbeiter in Kontakt treten, oder automatisierte Antworten über einen Chatbot erhalten können.
Der Bediener/Mitarbeiter kann die Livechats entweder über ein sich öffnendes Chat-Popup oder im Menüpunkt Kommunikation -> Dialog einsehen und beantworten.
Wie der Live Chat konfiguriert und aktiviert wird, ist in den Untermenüpunkten beschrieben.
Über Chatkanäle können Besucher der Website mit einem Mitarbeiter in Kontakt treten. Welcher Chatkanal für eine Website aktiv ist, kann in den Website-Einstellungen unter E-Mail & Marketing -> Livechat festgelegt werden. Zusätzlich ist zu beachten, dass der Chatkanal auch für die Website veröffentlicht wurde (Chatkanal öffnen, und den Button anwählen, wird das Welt-Icon grün dargestellt, ist der Chatkanal veröffentlicht
)
In der Kanal-Übersicht kann der angemeldete Mitarbeiter bzw. Benutzer einem Chatkanal beitreten oder diesen verlassen.
Bei Neuanlage oder Auswählen eines Kanals, kann der Name des Kanals vergeben, sowie Einstellungen zu den Mitarbeitern, die diesen Kanal bedienen, zur farblichen Darstellung des Chat-Icons usw. getroffen werden.
Die im Reiter Bediener hinterlegten Mitarbeiter sind im Livechat für die Korrespondenz mit einem Website-Besucher - der eine Nachricht in den Chat geschrieben hat - verfügbar.
Über den Button kann entweder ein bestehender Mitarbeiter als Bediener zum Chatkanal hinzugefügt werden, in dem dieser aus der Liste der Mitarbeiter ausgewählt wird,
oder durch Auswahl des Buttons ein neuer Bediener erstellt werden (und optional zu diesem ein Mitarbeiter angelegt werden)
Text und Farbe der Livechat-Schaltfläche können hier angepasst werden
Text und Farbe des Livechat-Fensters können hier angepasst werden, sowie ein Platzhalter und eine Willkommensnachricht für den Chat hinterlegt werden.
Im Reiter Kanalregeln kann über den Button eine Kanal-Regel hinzugefügt werden.
Die Livechat Schaltfläche wird angezeigt
Die Livechat Schaltfläche wird mit dem Text angezeigt, der im Reiter Optionen -> Livechat-Schaltfläche hinterlegt ist.
Der Livechat wird automatisch geöffnet. Zusätzlich kann ein Timer eingestellt werden, nach wie vielen Sekunden der Chat automatisch geöffnet wird
Die Livechat-Schaltlfläche wird nicht angezeigt
Hier kann ein Chatbot hinterlegt werden, der die Beantwortung bzw. Verwaltung von Chats übernimmt. Wie der Chatbot agiert, kann im Chatbot-Skript eingestellt werden.
Bei gesetzter Einstellung wird der Chatbot nur aktiv, wenn derzeit kein Bediener (Mitarbeiter) für die Beantwortung von Chats verfügbar ist.
Wird eine URL gesetzt, sind die Einstellungen der Kanalregel nur für diese Seite auf der Website gültig
Die getroffenen Einstellungen gelten nur, wenn der Besucher aus dem hinterlegten Land kommt. Für diese Einstellung wird GeoIP benötigt, um das Land des Website-Besuchers feststellen zu können.
Im Reiter Widget werden Möglichkeiten geboten, um den Livechat auf einer Website einzubinden
Konfiguration -> Live Chat -> Vorformulierte Antworten
Vorformulierte Antworten können innerhalb eines Chats von Bedienern/Mitarbeitern verwendet werden. Durch die Eingabe von :Abkürzung im Chatfenster kann eine Antwort (der Text aus der Spalte Ersatz) ausgewählt und abgeschickt werden.
Konfiguration -> Live Chat -> Chatbots
Mithilfe eines Chatbots können von Website-Besuchern begonnene Chats anhand eines Chatbot-Skripts abgearbeitet werden (Beantwortung, Weiterleitung an einen Bediener/Mitarbeiter, Durchführen von Aktionen, z.B. Erstellen eines Leads).
Es können mehrere Chatbots angelegt werden.
Nach Auswahl des Buttons kann der Chatbot auf der Website getestet werden, z.B. um die richtigen Abläufe des Chatbot-Skripts zu überprüfen.
Über die Schaltfläche werden die Chat-Kanäle angezeigt, für die der Chatbot aktiviert ist.
Über das Chatbot-Skript kann auch die Erstellung eines Leads eingestellt werden. Wurden über den Chatbot Leads erstellt, werden diese über die Schaltfläche angezeigt.
Beispiel für die Erstellung eines Leads über das Chatbot-Skript
Anhand des Chatbot-Skripts wird festgelegt, wie der Chatbot agiert, z.B. die Begrüßungsnachricht, welche Fragen gestellt werden, und auf welche Antwort welche Aktion folgt.
Eine neue Skriptzeile kann über hinzugefügt werden, die genauen Schritte werden dann im neu geöffneten Fenster eingestellt.
Diese Nachricht wird beim entsprechenden Schritt im Chat-Fenster angezeigt.
Es stehen verschiedene Schritttypen zur Auswahl, die eine entsprechende Aktion setzen oder erwarten:
Beim Schrittyp "Text" wird der angegebene Text im Chat gepostet.
Beim Schritttyp "Frage" kann als Text eine Frage hinterlegt werden, die der Chatbot stellt, und mehrere Antworten hinterlegt werden, mit denen der Chatnutzer (Websitebesucher) antworten kann. Optional kann zu einer Antwort auch ein Link hinterlegt werden, zu dem direkt weitergeleitet wird, wenn die entsprechende Antwort ausgewählt wird.
Beim Schrittyp "Email" ersucht der Chatbot den Chatnutzer (Websitebesucher) um die Angabe einer E-Mail-Adresse
Beim Schritttyp "Email" ersucht der Chatbot den Chatnutzer (Websitebesucher) um die Angabe einer Telefonnummer
Beim Schritttyp "An Mitarbeiter weiterleiten" wird der Chat an einen Bediener (Mitarbeiter) für die weitere Beantwortung weitergeleitet, sofern einer verfügbar/online ist (Bediener ist nach 30 min Inaktivität nicht mehr verfgübar für den Chat).
Beispiel an Schritten bei Weiterleitung an Mitarbeiter:
Vom Chatbot wird eine Text-Eingabe abgewartet, bevor zum nächsten Skript-Schritt übergegangen wird.
Vom Chatbot wird eine mehrere Zeilen umfassende Text-Eingabe abgewartet, bevor zum nächsten Skript-Schritt übergegangen wird.
Beim Schritttyp "Lead erstellen" wird vom Chatbot ein Lead in der Kundenpflege erstellt
Beispiel für die Erstellung eines Leads durch das Chatbot-Skript
Der Skript-Schritt wird nur aufgerufen, wenn auf eine Frage diese Antwort gegeben wurde.
Die Bedingung kann leer gelassen werden, wenn dieser Schritt immer erfolgen soll.
Sobald der Chat-Benutzer die Antwort "Interesse an den Produkten" auswählt, wird zuerst nach der E-Mail-Adresse gefragt. Nach Eingabe der E-Mail-Adresse wird der Lead erstellt.
Der erstellte Lead kann z.B. über den Chatbot -> Leads -> Lead auswählen aufgerufen werden.
Im Lead ist der Nachrichtenverlauf des Chats hinzugefügt
Konfigurations-Unterpunkt von "E-Commerce", PayPal, Stripe, Banküberweisung, Mollie
Konfiguration -> E-Commerce -> Zahlungsanbieter
In dieser Übersicht werden alle im ETRON Onlineshop zur Verfügung stehenden und ggf. aktivierten Zahlungsanbieter bzw. Zahlungsmethoden angezeigt.
Beim Auswählen eines Zahlungsanbieters wird die Konfiguration der jeweiligen Methode aufgerufen.
Deaktiviert
Bezahlmethode steht im Shop nicht zur Verfügung
Aktiviert Bezahlmethode steht im Shop zur Verfügung
Testmodus Bezahlmethode kann nur zu Testzwecken verwendet werden
Die aktivierten und damit verfügbaren Zahlungsanbieter stehen im ETRON Onlineshop für die Bezahlung zur Auswahl.
Sollen für den ETRON Onlineshop eigene Zahlungsmethoden angeboten werden, die nicht über eine API-Schnittstelle an einen externen Dienst angebunden werden müssen, kann unter Aktion -> Duplizieren die Option Banküberweisung als passendes Schema dupliziert und entsprechend bearbeitet werden.
Online-Zahlungsanbieter, E-Commerce Zahlungsanbieter
Konfiguration -> E-Commerce -> Zahlungsanbieter -> Mollie
Um die Bezahlmethode Mollie einzurichten muss der Status auf Aktiviert oder Testmodus gesetzt sein und im Reiter Anmeldedaten das Feld API Key ausgefüllt werden.
Bei der Erstellung eines Mollie Accounts sieht die Ansicht in etwa so aus:
Durch die Auswahl von Verbinden Sie Mollie mit Ihrer Website kann die Verbindung zum ETRON Onlineshop getestet werden. Wenn alle erforderlichen Informationen in Mollie hinterlegt und die Website überprüft wurde, kann der Live API Key abgerufen und kopiert werden.
Für weitere Informationen und Fragen hat Mollie ein eigenes Helpcenter:
Um die Bezahlmethode PayPal einzurichten, müssen im Reiter Anmeldedaten folgende Felder ausgefüllt werden:
E-Mail: Hier muss die für den Login bei PayPal verwendete E-Mail-Adresse angegeben werden.
PDT Identity Token: In Ihrem PayPal-Konto müssen unter Menü -> Kontoeinstellungen -> Produkte und Dienstleistungen/Website-Zahlungslösungen -> Website-Einstellungen -> Aktualisieren die folgenden Einstellungen vorgenommen werden:
Automatische Rückleitung für Websitezahlungen: Ein Die Rückleitungs-URL muss auf https://<Shop-Domain>/shop/confirmation gesetzt werden.
Übertragung der Zahlungsdaten: Ein Sobald die Einstellung auf "Ein" geändert wird, erscheint das Identitäts-Token. Dieses muss bei der Bezahlmethode im Feld Übertragung der Zahlungsdaten/Identitäts-Token eingetragen werden.
Wenn die PayPal-Integration mit einem PayPal-Sandbox-Account getestet werden soll, sollte der Status der Bezahlmethode auf Testmodus gestellt werden.
PayPal -> Kontoeinstellungen -> Website-Zahlungslösungen -> Website-Einstellungen
Die Funktion "Verschlüsselte Websitezahlungen" muss deaktiviert werden.
PayPal -> Kontoeinstellungen -> Website-Zahlungslösungen -> API Zugriff -> REST-API-Integrationen
Es sollte geprüft werden, ob bereits Webhook-Apps erstellt wurden, die mit der Domain verknüpft sind. Da diese für den ETRON Onlineshop nicht erforderlich sind und potenziell Fehler verursachen können, sollten sie gelöscht oder deaktiviert werden.
Online-Zahlungsanbieter, E-Commerce Zahlungsanbieter
Um die Bezahlmethode Stripe einzurichten muss der Status auf Aktiviert gesetzt und im Reiter Anmeldedaten folgende Felder ausgefüllt werden:
Publishable Key: Wird dafür verwendet, um den Account mit Stripe zu identifizieren.
Secret Key: Wird dafür benötigt, den Händleraccount mit Stripe zu signieren.
Webhook Signing Secret: Wird der Webhook auf dem Stripe Account aktiviert, wird dieses Secret benötigt um die von Stripe an ETRON onRetail gesendeten Nachrichten zu authentifizieren. Dafür muss ein Webhook erstellt werden. Bei dieser Übersicht den "Endpoint hinzufügen"-Button auswählen:
Nach der Auswahl erscheint Stripe-Ereignisse überwachen. Hier wird der Webhook konfiguriert.
Den Link, der Webseite, mit der Stripe verbunden werden soll, kopieren und unter Endpoint-URL einfügen.
Stripe hat die Funktion viele Informationen zu überwachen und Ereignisse als Logeinträge abzuspeichern. Die gewünschten Daten auswählen, die bei Auswahl des Produktes bis hin zum Bezahlen überwacht werden sollen. Dann auf "Endpoint hinzufügen" klicken, um den Webhook Secret zu generieren. Der Webhook kann jederzeit bearbeitet werden.
Bei Klick auf Einblenden wird der Geheimschlüssel eingeblendet. Diesen kopieren, und im Stripe Webhook Secret Feld eingeben, womit dann die Konfiguration für Stripe im Webshop abgeschlossen werden kann.
Um Stripe richtig zu testen, muss ein Testeinkauf über den Webshop getätigt werden. Als Zahlungsmethode wählen Sie hierfür Stripe aus und können die Testkarte verwenden, um einen Einkauf zu simulieren.
Eine Übersicht aller durchgeführten Zahlungstransaktionen. Hier kann überprüft werden ob eine Zahlung erfolgreich durchgeführt wurde.
Wire Transfer, Zahlungsart, Sofortüberweisung, Banküberweisung, Vorkasse, Auf Rechnung, bei Abholung, Nachnahme
Konfiguration -> E-Commerce -> Zahlungsanbieter
Mit einer anpassbaren Zahlungsart können Zahlungsinstruktionen wie Bankverbindung und Verwendungszweck oder Hinweise für die Abholung an den Kunden übermittelt werden.
Angezeigt als Der Anzeigename der Zahlungsmethode kann mit diesem Feld überschrieben werden.
Enable QR Codes
Wenn aktiviert, kann der Kunde den generierten QR-Code scannen und mit dem Mobiltelefon via einer Bank-App schnell überweisen. Alle erforderlichen Felder werden automatisch ausgefüllt. Wird nur richtig angezeigt, wenn ein Bankkonto richtig angelegt wurde.
Kommunikation Für die Zuordnung der Zahlung an den richtigen Auftrag oder dem Kunden 1. Basierend auf der Dokumentenreferenz: Auftragsnummer 2. Basierend auf Kunden-ID: Kundennummer
Höchstbetrag Die Höhe des Betrages, ab dem diese Zahlungsmethode in Anspruch genommen werden kann, kann festgelegt werden.
Länder Wenn Länder angeführt werden, ist die Zahlungsmethode nur für Kunden aus diesen Ländern auswählbar.
Konfigurations-Unterpunkt von "E-Commerce"
Konfiguration -> E-Commerce -> Zahlungssymbole
Hier ist eine Übersicht über alle verfügbaren Zahlungssymbole, die hier auch konfiguriert und angelegt werden können.
Konfigurations-Unterpunkt von "E-Commerce"
Konfiguration -> E-Commerce -> Zahlungs-Token
Wenn ein Kunde die erste Zahlung leistet, wird die Karte je nach Konfiguration der Zahlungsabwicklung mit dem Token gespeichert.
Konfigurations-Unterpunkt von "E-Commerce"
Konfiguration -> E-Commerce -> Zahlungstransaktionen
Hier ist eine Übersicht über alle durchgeführten Zahlungstransaktionen. Dadurch kann überprüft werden, ob eine Zahlung erfolgreich durchgeführt wurde.
Konfigurations-Unterpunkt von "E-Commerce"
Konfigurations-Unterpunkt von "E-Commerce"
Konfiguration > E-Commerce > Webseite > Websites
In der Übersicht der Websites sieht man alle angelegten Websites und kann diese konfigurieren und neue anlegen.
die Bezeichnung der Website
die Domain, die zur Website führt, beginnend mit https://
Ein Logo, das auf der Website angezeigt wird, kann hier hinterlegt werden
Hier können die auf der Website verfügbaren Sprachen ausgewählt werden. Es werden jene Sprachen angezeigt, die im System verfügbar sind.
Die Sprache, in der die Website standardmäßig dargestellt wird.
Auf der Produktseite im Onlineshop werden die hier hinterlegten Felder zusätzlich angezeigt.
Über "Zeile hinzufügen" können die zusätzlichen Felder hinzugefügt werden
Konfigurations-Unterpunkt von "E-Commerce"
Konfiguration -> E-Commerce -> Weiterleitungen
Wenn Adressen im ETRON onRetail Onlineshop vorübergehend oder dauerhaft umgezogen oder nicht mehr erreichbar sind, dann können diese Seiten hier manuell umgeleitet werden.
Property name
Description
Definition
id
Webshop Order Number
string, max 255 characters, unique
created_at_utc
Order creation date
format utc with timezone
updated_at_utc
Order update date
datetime, format utc with timezone
status
Webshop Order Status
string
shipping_method
ShippingObject
Versandart
currency
Currency Code (nur info wie der Kunde bezahlt, die Line items sind immer in Euro)
3 characters
comment
Customer order comment
string, max. 255 characters, optional
taxmodel
Kennzeichen ob Brutto oder Netto verrechnet wurde: Preisangaben in Line items sind dann auch brutto od netto
"GROSS" or "NET"
_payment
OrderPaymentObject
Zahlungsinformation
_lines
array of OrderLineObject
Rechnungszeilen (Produkt, Versandkosten, Rabatte, Gesamtsumme)
_shipping_address
OrderAddressObject
Versandadresse des Kunden (optional bei Bestellungen ohne materielle Güter)
_billing_address
OrderAddressObject
Rechnungsadresse des Kunden
Property name
Description
Definition
type
Webshop Shipping Method Identifier
string, max 255 characters
description
Description information for shipping method (like address if packup at store)
string, max 255 characters, optional
Property name
Description
Definition
method
Webshop Payment Method Identifier
string, max 255 characters One of cc, paypal, sofort, invoice, banktransfer, cod
cctype
Type of credit card (various)
string, max 255 characters, if method="cc" One of Visa, MC/MasterCard, Amex (exact values may vary)
Property name
Description
Definition
type
Type of line item
one of "product", "shipping", "discount", "total" (is special because all other lines sum up to equal total line)
is_line
Flag whether line should appear in billing documents
true (if type=product or shipping) / false (if type=discount or total)
quantity
Line item quantity
numeric, needed if type="product"
sku
SKU of product
needed if type="product"
name
Name of product
needed if type="product", string max 255 characters
unitprice
Base price of product (noch nicht rabattiert)
needed if type="product", decimal, 2 decimals if order taxmodel="GROSS", 4 decimals precision of order taxmodel="NET"
discount_amount
Discount calculated on product line
optional if type="product", decimal, 2 decimals if order taxmodel="GROSS", 4 decimals precision of order taxmodel="NET"
amount
Line price of product
(=unitprice * quantity - discount_amount) needed if type="product", decimal, 2 decimals if order taxmodel="GROSS", 4 decimals precision of order taxmodel="NET"
tax_amount
Tax amount of line price
(tax of amount) needed if type="product", decimal, 2 decimals if order taxmodel="GROSS", 0 if order taxmodel="NET"
taxclass
Tax class identifier of product
string
Property name
Description
Definition
id
Webshop Address Entry ID
numeric
salutation
Customer Prefix (Mr,Mrs,Herr,Frau)
string, max 255 characters, optional
firstname
Customer First Name
string, max 255 characters
lastname
Customer Last Name
string, max 255 characters
street
Customer Street Address
string, max 255 characters. May contain "\n" for line breaks
zip
Customer ZIP
string, max 255 characters
city
Customer City
string, max 255 characters
country
Customer Country Code
2 characters ISO Country code
company
Customer Company Name Code
string, max 255 characters, optional
Customer eMail Address
string, max 255 characters
phone
Customer Phone Number
string, max 255 characters, optional
vat_id
Customer VAT Number
string, max 255 characters, optional
JSON API FELD
Transformation
onRetail Datenziel
Anpassung
Related US
id
1:1
-
Neues Feld für die Webshop Order ID
created
Umwandlung zu Datetime
sale.order.create_date
-
updated
Umwandlung zu Datetime
sale.order.write_date
-
status
Mapping Tabelle
-
sale.order Stati auf die des Webshops mappen
shipping_method
Mapping Tabelle
delivery.carrier
-
currency
Mapping Tabelle
res.currency
-
comment
1:1
-
Neues Feld
taxmodel
1:1
-
Neues Feld, Berechnung der Preise
_payment
OrderPaymentObject
-
_lines
array of OrderLineObject
_shipping_address
OrderAddressObject
_billing_address
OrderAddressObject
JSON API FELD
Transformation
onRetail Datenziel
Anpassung
Related US
method
Mapping Table
-
Mapping Table
additional_information
Mapping Table
-
Mapping Table. Bei Info success, Zahlung zur sale.order hinzufügen
JSON API FELD
Transformation
onRetail Datenziel
Anpassung
Related US
type
-
sale.order
Versandkosten/Rabatt zuordnen
quantity
1:1
sale.order.line.product_uom_qty
-
sku
1:1
sale.order.line.product_id
-
name
-
sale.order.line.product_id.name
Feld verwerfen, Name ist abhängig von der gewählten Sprache
unitprice
1:1
sale.order.line.price...
Berechnung/Datenziel abhängig vom Typ
amount
1:1
sale.order.line.price_subtotal
-
tax_amount
1:1
-
Neues Feld, Berechnung der Steuer durch onRetail muss möglicherweise umgangen werden
taxclass
1:1
product.product.tax_id.code
-
JSON API FELD
Transformation
onRetail Datenziel
Anpassung
Related US
id
1:1
-
Neues Feld für die Webshop Kunden ID
prefix
Mapping Table
res.partner.title
Mapping
firstname
Concat
res.partner.name
Vor- und Nachname zuammenführen
lastname
Concat
res.partner.name
Vor- und Nachname zuammenführen
street
String Bereinigen
res.partner.street
-
zip
1:1
res.partner.zip
-
city
1:1
res.partner.city
-
country
1:1
res.partner.country_id.code
-
company
Neuanlage Unternehmen bei Neukunden, ansonsten Feld verwerfen
res.company
Weshop Kunden ID
1:1
res.partner.email
-
phone
1:1
res.partner.phone
-
vat
1:1
res.partner.vat
-
Property name
Description
Definition
id
Webshop Order Number
numeric
status
Order Status (wird auf der Gateway gemappt)
string, max 255 characters
processing: Bestellung in Bearbeitung
complete: Bestellung wurde versendet
cancelled: Bestellung wurde storniert
JSON API FELD
Transformation
onRetail Datenquelle
Anpassung
Related US
id
1:1
-
Neues Feld für die Webshop Order ID
status
Mapping Table
sale.order.state
sale.order und Webshop Stati mappen
Kategorien werden in allen konfigurierten Sprachen übertragen. Kategoriebilder liegen auf einem externen Bilderspeicher (SFTP oder Amazon S3). Als Bildangaben sind immer alle zum Basisordner relativen Pfadangaben anzugeben.
Beispiel für Kategorien in nur 1 Sprache (scopeId = "default"):
Beispiel für Kategorien in zwei Sprachen "de" (Deutsch) und "en" (Englisch) mit den gleichnamigen scopeIds:
Property name
Description
Definition
id
Eindeutiger Schlüssel für Kategorie
alphanumeric string, unique, max 255 characters
name
Kategoriename
string (utf8), max 255 characters
parent_id
Referenz auf einen eindeutigen Schlüssel einer Kategorie
alphanumeric string
position
Position/Reihenfolge der Kategorie innerhalb der Hierarchie (Elemente mit gleichem parent_id)
numeric, unsigned int
visible
true=Kategorie ist sichtbar im Menü, false=Kategorie ist nicht sichtbar im Menü
boolean
image
relativer Pfad zum Kategorie-Bild am Bilderspeicher
url, optional
JSON API FELD
Transformation
onRetail Datenquelle
Anpassung
Aufwand
id
1:1
product.public.category.id
-
#0f0
name
1:1
product.public.category.name
Begrenzung auf 255 Zeichen, HTML Sonderzeichen filtern
#0f0
parent_id
1:1
product.public.category.parent_id
-
#0f0
position
1:1
product.public.category.sequence
-
#0f0
visible
1:1
-
visible Attribut zur Kategorie hinzufügen
#ff0
image
1:1
product.public.category.image
-
#0f0
Produkte und beim Produkt definierte Kategoriezuweisungen werden gemeinsam exportiert.
Vom Datenaustauschformat unterstützt werden einfache und konfigurierbare Produkte in einer und mehreren Sprachen, sowie optionale Unterstützung für Multistore (Price per Store)/Multi-Inventory (Inventory per Store).
Attribute wie weight, sku und status sind globale Attribute (d.h. sprach/store-unabhängig). Die Attribute _categories (Kategoriezuordnungen) und _images (Bildzuordnungen) sind optional und immer global (also sprach/store-unabhängig).
Ein Scope (Geltungsbereich) ist der Abschnitt, der sprach- bzw. storebezogene Produktdaten definiert (Preise, Produkttexte)
Produktbilder liegen auf einem externen Bilderspeicher (SFTP oder Amazon S3). Als Bildangaben sind immer alle zum Basisordner relativen Pfadangaben anzugeben.
Property name
Description
Definition
sku
eindeutige Produktkennung
alphanumeric string, unique, max 255 characters
weight
Produktgewicht in kg
decimal
status
Produkt-Freigabe für Webshop: 1=freigegeben, 0=nicht freigegeben
numeric
stock
Lagerstand für Webshop
numeric
barcodes
Mit Komma getrennte EAN Liste
string (utf8) Zahlen, Komma und Leerzeichen erlaubt
new_date_from
Datum für "Neu ab"
date, format YYYY-MM-DD, optional, new-to > new-from
new_date_to
Datum für "Neu bis"
date, format YYYY-MM-DD, optional, new-to > new-from
featured
Markierung
true/false
sale_stepping
Mengenangabe in der das Produkt verkauft werden darf. Verkaufte Menge muss ein Vielfaches der Mengenabgabe sein.
numeric >=1, Standardwert 1
manufacturer
Manufacturer Name
string(utf8)
manufacturer_link
Link zur Produktseite des Herstellers
string(utf8)
_categories
array of CategoryObject
(optional)
_images
array of ImageObjects, Pfade/Urls zu den Bildern
_price
PriceObject
_linked_skus
array of ProductLinkObject
Produktverknüpfungen für Up-, Cross-selling und Related Products
_scopes
array of ProductProperties
Übersetzungen von Produktfeldern
_variation_config
VariationObject
nur bei konfigurierbaren Produkten
Property name
Description
Definition
url
url zum Produktbild
string(utf8)
position
Position/Reihung des Bildes
numeric, ganze Zahl
Property name
Description
Definition
regular
normaler Webshop Verkaufspreis (netto)
decimal, 4 decimals precision
special
reduzierter Webshop Sonderpreis (netto)
decimal, 4 decimals precision, optional
special_date_from
Datum ab Gültigkeit Sonderpreis
date, format utc with timezone, optional
special_date_to
Datum bis Gültigkeit Sonderpreis
date, format utc with timezone, optional
taxclass
Kennzeichen für Steuerklasse (wird auf Gateway gemappt)
alphanumeric string, max 255 chars
_tiers
array of PriceTierObject
optional
Property name
Description
Definition
pricelist_id
Kundengruppen-Kennung (wird auf Gateway gemappt). "0" or "" (empty) = allgemeine Preisstaffel (nicht kundengruppenabhängig)
alphanumeric string, optional
quantity
Ab Menge (bei Staffelpreis), sonst 1
numeric, min. 1
price
Preis netto
decimal, 4 decimals precision
Liste aller übersetzten Felder eines Produktes
Property name
Description
Definition
name
Produktname
string (utf8), max 255 chars
short_description
Webshop Kurzbeschreibung
string (utf8)
description
Webshop Langbeschreibung
string (utf8)
delivery-ready
Text für "Versandbereit in" Angabe
string (utf8)
Property name
Description
Definition
attributes
array of attribute names
Liste der Attributnamen, welche die Konfiguration des Artikels bestimmen
children
array of product SKUs
Liste der Produkt-SKUs, aus denen das konfig. Produkt besteht
Beispiel: Konfigurierbares Produkt mit 2 Varianten (Farbe=Grün und Farbe=Blau). Farbvariante Blau kostet 13 € inkl. 20% MwSt, Farbvariante Grün kostet 12 € inkl. 20% MwSt..
Property name
Description
Definition
type
Type of the listed SKUs
can be "upsell", "crosssell" or "related" (Upselling, Crossselling oder Zubehoer Produkte)
skus
array of product SKUs
Liste der Upsell-Produkt-SKUs
Beispiel: Produkt mit Links
JSON API FELD
Transformation
onRetail Datenquelle
Anpassung
Aufwand
sku
1:1
product.product.product_code
-
#0f0
weight
1:1
product.product.weight
-
#0f0
status
1:1
-
Neues Feld product.template.webshop_active
#ff0
stock
Summe der Lagerstände der zu verwendeten Läger
-
Neue Einstellung welche Läger für den Webshop verwendet werden sollen. Neues computed Feld product.product.webshop_stock
#ff0
barcodes
1:1
product.template.barcodes
barcodes Feld zu product.product hinzufügen
#0f0
new_date_from
1:1
-
Neues Datum Feld in product.template
#0f0
new_date_to
1:1
-
Neues Datum Feld in product.template
#0f0
featured
1:1
-
Neues bool Feld in product.template
#0f0
sale_stepping
1:1
-
Neues Feld
#0f0
manufacturer
1:1
manufacturer.manufacturer.name
Neues Model für Hersteller
manufacturer_link
1:1
product.manufacturer_url
Neues Feld
_categories
CategoryObject
product.template.public_categ_ids
-
_images
1:1
product.template/product.image_ids
Mehrere Bilder im Template und der Variante hinterlegen
#ff0
_price
PriceObject
-
-
_linked_skus
array of ProductLinkObject
-
-
_scopes
array of ProductProperties
-
-
_variation_config
array of VariationObject
-
Auflösen der vorhandenen Attribute von product.template
JSON API FELD
Transformation
onRetail Datenquelle
Anpassung
Aufwand
url
url generieren
product.image, ir.attachment
-
#0f0
position
1:1
product.image.sequence
Neues Feld sequence
#F00
Für die Preisverwaltung wird eine Preisliste für den Webshop bei der Installation angelegt die nicht gelöscht werden kann. Preislisteneinträge die eine Mengenangabe haben, werden als PriceTierObject
exportiert. Einträge ohne Mengenangabe werden als special Preis exportiert. Bei mehrfachen anzuwendenden Preisen, wird der niedrigste Preis exportiert.
Prio:
Artikel > Kategorie > Global
JSON API FELD
Transformation
onRetail Datenquelle
Anpassung
Aufwand
regular
Berechnung, Normaler Preis wenn kein Webshoppreis
product.pricelist
-
#0f0
special
Berechnung der möglichen Preise
product.pricelist
-
#F00
special_date_from
1:1
product.pricelist
-
#ff0
special_date_to
1:1
product.pricelist
-
#ff0
taxclass
Mappingtabelle
product.product.tax_id.code
Mapping
#ff0
tiers
array of PriceTierObject
-
-
JSON API FELD
Transformation
onRetail Datenquelle
Anpassung
Aufwand
pricelist_id
1:1
product.pricelist.id
-
#ff0
quantity
1:1
product.pricelist.item.min_quantity
-
#ff0
price
Berechnung der möglichen Preise
product.pricelist
#F00
Übersetzungen befinden sich im Model ir.translation Im Feld source steht die englische Übersetzung, die der anderen installierten Sprachen im Feld value
JSON API FELD
Transformation
onRetail Datenquelle
Anpassung
Aufwand
name
1:1
-
Neues Feld für den Webshop Produktnamen. Begrenzung auf 255 Zeichen. Produktname wenn Webshopproduktname nicht vorhanden ist
#ff0
short_description
1:1
product.template.description_sale
HTML Sonderzeichen filtern
#ff0
description
1:1
-
Neues Textfeld
#ff0
delivery-ready
1:1
-
Neues Char Feld für product.template
#0f0
JSON API FELD
Transformation
onRetail Datenquelle
Anpassung
Aufwand
attributes
1:1
array of product.template.attribute_line_ids
-
#0f0
children
1:1
array of product.template.product_variant_ids
-
#0f0
JSON API FELD
Transformation
onRetail Datenquelle
Anpassung
type
1:1
depending on what we export: (upsell, crosssell or related)
-
skus (type="upsell")
1:1
array of product.template.alternative_product_ids
-
skus (type="crosssell")
1:1
-
array of Neues m2m Feld
skus (type="related")
1:1
array of product.template.accessory_product_ids
-