Schnittstellenleitfaden: Unterschied zwischen den Versionen
Zur Navigation springen
Zur Suche springen
FBO (Diskussion | Beiträge) |
FBO (Diskussion | Beiträge) Keine Bearbeitungszusammenfassung |
||
| Zeile 1: | Zeile 1: | ||
* ''' | * '''Stammdatenexport an externe Webshop-Systeme''' | ||
* ''' | * '''Auftragsimport aus externen Webshop-Systemen''' | ||
''Stand | ''Stand Frühjahr 2026'' | ||
=Vorbemerkungen= | =Vorbemerkungen= | ||
| Zeile 56: | Zeile 56: | ||
* Die Einstellungen für für den Datenaustausch mit Shopware oder Magento u.ä. finden Sie [[WEBDRINK-Schnittstelle|hier]]. | * Die Einstellungen für für den Datenaustausch mit Shopware oder Magento u.ä. finden Sie [[WEBDRINK-Schnittstelle|hier]]. | ||
=Stammdatenexport als CSV= | |||
Die Daten werden mit einer FTP-Verbindung übertragen. Nach erfolgreichem Verbindungsaufbau werden die [[wikipedia:de:CSV_%28Dateiformat%29|CSV]]-Daten in einem zu definierenden Ordner kopiert. | Die Daten werden mit einer FTP-Verbindung übertragen. Nach erfolgreichem Verbindungsaufbau werden die [[wikipedia:de:CSV_%28Dateiformat%29|CSV]]-Daten in einem zu definierenden Ordner kopiert. | ||
==Formatkennzeichen== | |||
{| class="wikitable" | {| class="wikitable" | ||
| Zeile 79: | Zeile 79: | ||
|} | |} | ||
==Feldbeschreibungen Datei "Kunden.csv“== | |||
Nachfolgend wird ein Kundendatensatz beschrieben. | Nachfolgend wird ein Kundendatensatz beschrieben. | ||
| Zeile 162: | Zeile 162: | ||
<!--////////// Tabelle ENDE //////////--> | <!--////////// Tabelle ENDE //////////--> | ||
==Optional: Feldbeschreibungen Datei "Lieferadressen.csv“== | |||
Nachfolgend wird ein Adressdatensatz beschrieben. Diese Liste enthält zusätzliche Adressen eines Kunden. Die Datei ist optional. Sind keine Zusatzadressen vorhanden, wird die Baissadresse des Kundendatensatzes als Lieferadresse verwendet. | Nachfolgend wird ein Adressdatensatz beschrieben. Diese Liste enthält zusätzliche Adressen eines Kunden. Die Datei ist optional. Sind keine Zusatzadressen vorhanden, wird die Baissadresse des Kundendatensatzes als Lieferadresse verwendet. | ||
| Zeile 213: | Zeile 213: | ||
<!--////////// Tabelle ENDE //////////--> | <!--////////// Tabelle ENDE //////////--> | ||
==Feldbeschreibungen Datei "Artikel.csv“== | |||
Nachfolgend wird ein Artikeldatensatz beschrieben. | Nachfolgend wird ein Artikeldatensatz beschrieben. | ||
| Zeile 296: | Zeile 296: | ||
<!--////////// Tabelle ENDE //////////--> | <!--////////// Tabelle ENDE //////////--> | ||
==Optional: Feldbeschreibungen Datei "Favoriten.csv“== | |||
Nachfolgend wird ein Kundensortimentsdatensatz beschrieben. Diese Liste enthält die bisher bestellten Artikel eines Kunden. Die Datei ist optional. | Nachfolgend wird ein Kundensortimentsdatensatz beschrieben. Diese Liste enthält die bisher bestellten Artikel eines Kunden. Die Datei ist optional. | ||
| Zeile 319: | Zeile 319: | ||
<!--////////// Tabelle ENDE //////////--> | <!--////////// Tabelle ENDE //////////--> | ||
==Optional: Feldbeschreibungen Datei "Sonderpreise.csv“== | |||
Nachfolgend wird eine Tabelle mit kundenspezifischen oder zeitlich beschränkten Sonderpreisen beschrieben. Die Datei ist optional. | Nachfolgend wird eine Tabelle mit kundenspezifischen oder zeitlich beschränkten Sonderpreisen beschrieben. Die Datei ist optional. | ||
| Zeile 364: | Zeile 364: | ||
''Aktionspreise''': Ist das Feld '''KDNr''' leer, wird der eingetragene Preis '''NettoVK''' als zeitlich gesteuerter '''Aktionspreis''' behandelt, der im Zeitraum von '''Start ''' bis '''Ende''' unter Beachtung der Zugehörigkeit eines Kunden zur Preisgruppe in „Gruppe“, der Vorgabe der Möglichkeit zum '''Überschreiben''' eines möglichen Sonderpreises eines Kunden für den Artikel und Einschränkung der Gültigkeit eines Aktionspreises auf eine maximale Abverkaufsmenge '''Vorrat''' gilt. | ''Aktionspreise''': Ist das Feld '''KDNr''' leer, wird der eingetragene Preis '''NettoVK''' als zeitlich gesteuerter '''Aktionspreis''' behandelt, der im Zeitraum von '''Start ''' bis '''Ende''' unter Beachtung der Zugehörigkeit eines Kunden zur Preisgruppe in „Gruppe“, der Vorgabe der Möglichkeit zum '''Überschreiben''' eines möglichen Sonderpreises eines Kunden für den Artikel und Einschränkung der Gültigkeit eines Aktionspreises auf eine maximale Abverkaufsmenge '''Vorrat''' gilt. | ||
=Auftragsimport als XML= | |||
Die Daten werden mit einer FTP-Verbindung übertragen. Nach erfolgreichem Verbindungsaufbau werden die [[wikipedia:de:Extensible_Markup_Language|XML]]-Daten aus einem zu definierenden Ordner geladen. | Die Daten werden mit einer FTP-Verbindung übertragen. Nach erfolgreichem Verbindungsaufbau werden die [[wikipedia:de:Extensible_Markup_Language|XML]]-Daten aus einem zu definierenden Ordner geladen. | ||
| Zeile 403: | Zeile 403: | ||
</customer> | </customer> | ||
==Die Entität "order"== | |||
Die Entität ist primär, notwendig und einmalig. Sie enthält Informationen zur Bestellung. | Die Entität ist primär, notwendig und einmalig. Sie enthält Informationen zur Bestellung. | ||
| Zeile 526: | Zeile 526: | ||
<!--////////// Tabelle ENDE //////////--> | <!--////////// Tabelle ENDE //////////--> | ||
== Die Entität "paymentDetails"== | |||
Die Entität ist in <order> enthalten, optional und einmalig. Sie enthält optionale Informationen zur Zahlweise | Die Entität ist in <order> enthalten, optional und einmalig. Sie enthält optionale Informationen zur Zahlweise | ||
| Zeile 548: | Zeile 548: | ||
|} | |} | ||
<!--////////// Tabelle ENDE //////////--> | <!--////////// Tabelle ENDE //////////--> | ||
==Die Entität "DeliveryDetails"== | |||
Die Entität ist in <order> enthalten, optional und wiederholbar. Sie enthält optionale Informationen zu Transportkosten | Die Entität ist in <order> enthalten, optional und wiederholbar. Sie enthält optionale Informationen zu Transportkosten | ||
| Zeile 576: | Zeile 576: | ||
<!--////////// Tabelle ENDE //////////--> | <!--////////// Tabelle ENDE //////////--> | ||
==Die Entität "article"== | |||
Die Entität ist in <order> enthalten, (thoretisch) optional und wiederholbar. Sie enthält Informationen zu Bestellposten | Die Entität ist in <order> enthalten, (thoretisch) optional und wiederholbar. Sie enthält Informationen zu Bestellposten | ||
| Zeile 649: | Zeile 649: | ||
<!--////////// Tabelle ENDE //////////--> | <!--////////// Tabelle ENDE //////////--> | ||
==Die Entität "customer"== | |||
Die Entität ist primär, notwendig und einmalig. Sie enthält Informationen zum Kunden | Die Entität ist primär, notwendig und einmalig. Sie enthält Informationen zum Kunden | ||
| Zeile 782: | Zeile 782: | ||
<!--////////// Tabelle ENDE //////////--> | <!--////////// Tabelle ENDE //////////--> | ||
==Die Entität "DeliveryAddress" | ==Die Entität "DeliveryAddress"== | ||
Die Entität ist in <customer> enthalten, optional und einmalig. Sie enthält optionale Informationen zur Lieferadresse | Die Entität ist in <customer> enthalten, optional und einmalig. Sie enthält optionale Informationen zur Lieferadresse | ||
| Zeile 839: | Zeile 839: | ||
|} | |} | ||
<!--////////// Tabelle ENDE //////////--> | <!--////////// Tabelle ENDE //////////--> | ||
==Die Entität "BankDetails"== | |||
Die Entität ist in <customer> enthalten, optional und einmalig. Sie enthält optionale Informationen zur Bankverbindung | Die Entität ist in <customer> enthalten, optional und einmalig. Sie enthält optionale Informationen zur Bankverbindung | ||
| Zeile 866: | Zeile 866: | ||
|} | |} | ||
<!--////////// Tabelle ENDE //////////--> | <!--////////// Tabelle ENDE //////////--> | ||
{{Hinweis|Abhängig vom <priceMode> werden die Preise Brutto oder Netto übergeben. Ausnahme ist der Wert <sumTotal>, welcher immer die Gesamtsumme inklusive der gesetzlichen Steuer enthält.}} | {{Hinweis|Abhängig vom <priceMode> werden die Preise Brutto oder Netto übergeben. Ausnahme ist der Wert <sumTotal>, welcher immer die Gesamtsumme inklusive der gesetzlichen Steuer enthält.}} | ||
| Zeile 872: | Zeile 871: | ||
{{Hinweis|Die Tags <discountPercent und <discountFix> definieren mögliche Rabatte sowie Gutscheine. Bei prozentualen Rabatten sind diese direkt in den Artikelpreisen berücksichtigt. Bei einem Einmalbetrag werden die Werte in dem Tag <sumTotal> berücksichtigt.}} | {{Hinweis|Die Tags <discountPercent und <discountFix> definieren mögliche Rabatte sowie Gutscheine. Bei prozentualen Rabatten sind diese direkt in den Artikelpreisen berücksichtigt. Bei einem Einmalbetrag werden die Werte in dem Tag <sumTotal> berücksichtigt.}} | ||
== | ==Beispiel einer Auftragsdatei== | ||
<order> | <order> | ||