Das Warenwirtschaftssystem v.Soft verfügt über eine Schnittstelle zu Shopify.
Im Folgenden findest du eine Übersicht darüber, welche Funktionen verfügbar sind. Bei Bedarf kann die Schnittstelle erweitert werden. Komm hierzu gerne auf uns zu.
Stand 29.11.2023 – Version 1.0
1 Funktionsumfang
1.1 Kunden- und Auftragsabgleich
1.1.1 Allgemeines
1.1.2 Feldzuordnungen Kundenupload zum Shop
1.1.3 Feldzuordnungen Kundendownload zu v.Soft (Update nur, wenn Shop führendes System ist)
1.1.4 Feldzuordnungen Auftrag
1.1.5 Feldzuordnungen Auftragspositionen
1.2 Artikelabgleich
1.2.1 Allgemeines
1.2.2 Feldzuordnungen Artikel (keine Varianten-Aufteilung)
1.2.3 Feldzuordnungen Artikelvarianten (keine Varianten-Aufteilung)
1.3 Lagerabgleich
2 Ersteinrichtung
3 Anhang
3.1 Änderungsnachweis
3.1.1 Version 1.0 – Initialversion
3.2 Kontakt & Support
1 Funktionsumfang
1.1 Kunden- und Auftragsabgleich
1.1.1 Allgemeines
Bi-Direktionaler Kundenabgleich
Kunden werden zwischen Shop und v.Soft synchron gehalten. Es ist einstellbar, welches System das
führende System ist. Bei Unstimmigkeiten wird das führende System priorisiert.
Wenn v.Soft das führende System ist, werden Shop-Kunden in v.Soft lediglich neu angelegt, falls sie
noch nicht vorhanden sind. Aktualisiert werden diese dann allerdings nicht mehr.
Kundenabgleich aus Auftrag
Beim Auftragsabgleich werden die Kunden der Aufträge in v.Soft angelegt bzw. aktualisiert.
Erstellen von Kunden-Datensätzen via Vorlagekunde
Initialisieren von neuen Datensätze in v.Soft über wählbaren Vorlagekunden.
E-Mail und Dubletten-Prüfung
Prüfung auf bereits vorhandenen Datensatz mit derselben E-Mail-Adresse (wenn ja wird der
vorhandene Datensatz aktualisiert) sowie standardmäßige v.Soft Dubletten-Prüfung.
Abgleich der Auftragszeilen
Normaler Variantenabgleich:
Die Auftragszeilen werden über die SKU (oder die Varianten-ID bei Varianten) den v.Soft-(Varianten)-
Artikeln zugeordnet.
Varianten-Aufteilung aktiv:
Die Auftragszeilen werden über den EAN-Code eindeutig den v.Soft-Variantenartikeln zugeordnet
(siehe Allgemeines).
Nicht verknüpfte Artikel können über eine Individualentwicklung ignoriert werden.
1.1.2 Feldzuordnungen Kundenupload zum Shop
| Shopify | v.Soft | Anmerkung |
| Vorname | Vorname | |
| Nachname | Nachname / Firma | |
| Telefon | Telefon 1 | |
| Standardadresse | Adressdaten (Rechnungsadresse) | Straße, PLZ, Ort, Land, Vor- & Nachname, Telefon 1 |
| Weitere Adressen | Lieferadressen | Straße, PLZ, Ort, Land, Vor- & Nachname |
1.1.3 Feldzuordnungen Kundendownload zu v.Soft (Update nur, wenn Shop führendes
System ist)
| Shopify | v.Soft | Anmerkung |
| Vorname | Vorname | |
| Nachname | Nachname / Firma | |
| Firma | Zusatzname | Wird aus der ersten Adresse des Shopkunden geholt |
| Nur bei Neuanlage oder wenn Shop führendes System ist | ||
| Standardadresse | Adressdaten (Rechnungsadresse) | Straße (beide Adresszeilen aus dem Shop), PLZ, Ort, Land, Telefon => Telefon 1 (nur bei Neuanlage oder wenn Shop führendes System ist) => wenn keine Standardadresse vorhanden, wird nur das Land mit dem Standard-Land aus v.Soft belegt und keine Rechnungsadresse übernommen (nur Lieferadresse, falls vorhanden) |
| Weitere Adressen | Lieferadressen | Vorname, Nachname, Firma => Zusatzname, Straße (beide Adresszeilen aus dem Shop), PLZ, Ort, Land (Standard-Land, wenn keines vorhanden), Adress-ID => Beschreibung |
1.1.4 Feldzuordnungen Auftrag
| Shopify | v.Soft | Anmerkung |
| Versandart | Lieferbedingungen | Zuweisungstabelle |
| Zahlungsart | Zahlungsbedingung | Zuweisungstabelle |
| Land | Land | Anhand des ISO-Codes, aus Rechnungsadresse der Bestellung (falls vorhanden), ansonsten aus Lieferadresse |
| Erstelldatum | Bestellung vom | |
| Bestellnummer | Bestellung | |
| Währung | Währung | Anhand des ISO-Codes |
| Aus Kunden der Bestellung | ||
| Anmerkungen | Internethinweis | |
| Erstelldatum | Angefragtes Lieferdatum + X Tage | X Tage: Setting „Lieferzeit in Tagen“ |
| Erstelldatum | Bestätigtes Lieferdatum + X Tage | Falls „Zusätzlich bestätigtes Lieferdatum setzen“ aktiviert ist, ansonsten maximales Datum (31.12.9998) |
1.1.5 Feldzuordnungen Auftragspositionen
| Shopify | v.Soft | Anmerkung |
| Versandkosten | Eigene Auftragsposition für Versandartikel | Versandartikel aus Zuweisungstabelle der Lieferbedingungen, Bruttobetrag aus der Bestellzeile |
| Zusatzfeld 1-5 | Lagerort (falls Lagerdokumentation in Schnittstellenkonfiguration aktiviert ist) | |
| Zusatzfeld 1-5 | Lagerplatz (falls Lagerdokumentation in Schnittstellenkonfiguration aktiviert ist) | |
| Artikel | Artikel | Varianten-Aufteilung aktiv: anhand des EAN-Codes der Variante ansonsten: anhand der SKU oder der eindeutigen ID der Variante |
| Menge | Menge | |
| Preis | Bruttopreis | Wird mit Menge zum Bruttobetrag umgerechnet, Berechnung von Nettopreis erfolgt automatisch anhand des USt-Satzes des v.Soft-Artikels |
1.2 Artikelabgleich
1.2.1 Allgemeines
Artikelabgleich/Abgeglichene Daten
Artikel werden grundsätzlich nur von v.Soft zum Shop übertragen.
Variantenartikel
Varianten-Aufteilung aktiv (wenn mehr als 99 Varianten pro Artikel enthalten sein können):
Für jede Farbe (bzw. das erste Artikelattribut) wird im Shop ein Hauptartikel angelegt. Die Größen
werden dann in Shopify als Variante eines Hauptartikels generiert (über die Eigenschaften).
Übertragen wird außerdem EAN-Code und VKP. Die Produktnummer wird aus Artikelnummer und
Zusatz generiert.
Ansonsten:
Ein einziger Hauptartikel wird angelegt, dieser enthält alle Varianten.
EAN-Codes (nur, wenn Varianten-Aufteilung aktiv)
Die EAN-Codes (bis zu 50 Zeichen) sind dafür da, um Artikelvarianten eindeutig vom Shop zu v.Soft
zuzuordnen. Ein EAN-Code setzt sich aus der Artikelnummer, der Farbe und der Größe zusammen,
getrennt durch Bindestriche. Sonderzeichen werden durch Unterstriche ersetzt (mehrere
Unterstriche hintereinander werden zu einem zusammengefasst) und alles wird kleingeschrieben.
Inaktivieren/Löschen von Artikeln
Beim Setzen des Hakens „Löschen“ in der eCommerce-Zeile des Artikels wird dieser im Shop gelöscht
und die eCommerce-Zeile entfernt.
1.2.2 Feldzuordnungen Artikel (keine Varianten-Aufteilung)
| Shopify | v.Soft | Anmerkung |
| Titel | Bezeichnung 1 + 2 | Nur bei Neuanlage, wenn „Artikelbezeichnung aktualisieren“ in Schnittstelle deaktiviert ist |
| Beschreibung | Verkaufs-Beschreibung | Nur bei Neuanlage |
| Anbieter | Hersteller | Nur bei Neuanlage |
| Produkttyp | Artikelgruppe | Nur bei Neuanlage |
| Status | Status | Entwurf, wenn inaktiv, ansonsten aktiv |
| Preis | Listenpreis brutto / Internet VKP brutto | Abhängig von Setting „Internetpreis benutzen“ |
| Vergleichspreis | UVP brutto | Nur, wenn der UVP brutto größer 0 ist |
| SKU / Tags | Artikelnummer | in die SKU bei Hauptartikeln, in die Tags bei Variantenartikeln (letzteres nur bei Neuanlage) |
| Barcode | Barcode | |
| Gewicht | Gewicht Artikel | Ohne Verpackung |
| Anzahl verfolgen | Bestandsführung im Artikel aktiv | |
| Verkauf fortsetzen, auch wenn Produkte nicht vorrätig sind | Bestandsführung im Artikel aktiv oder Paketartikel | Paketartikel oder Bestandsführung aktiv => keine Überverkäufe möglich |
| Auf Lager | Lagerbestand | siehe Lagerabgleich |
1.2.3 Feldzuordnungen Artikel (Varianten-Aufteilung)
| Shopify | v.Soft | Anmerkung |
| Titel | Bezeichnung 1 + 2 | |
| Beschreibung | Verkaufs- Beschreibung | |
| Anbieter | Hersteller | |
| Produkttyp | Artikelgruppe | |
| Tags | Merkmale | |
| properties | Merkmale ohne „Zertifikat“ | Metafeld |
| certificates | Merkmale mit „Zertifikat“ | Metafeld |
| volume_pricing | Verkaufs Staffelpreis | Metafeld |
1.3.1 Feldzuordnungen Artikelvarianten (keine Varianten-Aufteilung)
| Shopify | v.Soft | Anmerkung |
| SKU | EAN-Code | |
| Gewicht | Gewicht Artikel | Ohne Verpackung |
| Preis | VK-Preis brutto | |
| Variante | Artikelattribute 1-3 | |
| Varianten | Liste aller vorhandenen Artikelattribut-Werte des Artikels | |
| Auf Lager | Lagerbestand | siehe Lagerabgleich |
1.3.2 Feldzuordnungen Artikelvarianten (Varianten-Aufteilung)
| Shopify | v.Soft | Anmerkung |
| SKU | EAN-Code | |
| Barcode | [Artikelnummer]/[Farbe]/[Größe] | |
| Preis | VK-Preis brutto | |
| Variante | Artikelattribute 1 & 2 | |
| Varianten | Liste aller vorhandenen Artikelattribut-Werte des Artikels | |
| Lagerverwaltung | Übernimmt der Shop |
1.4 Lagerabgleich
Lagerbestandsabgleich
Kompletter Lagerabgleich einmal täglich/wöchentlich (nur bei Abgleich über automatischen Dienst)
sowie ständiger ’schneller Lagerabgleich‘ (Artikel mit Lagerbewegungen seit dem letzten Abgleich).
Übergabe von tatsächlichem Bestand (Reservierungen werden abgezogen). Berücksichtigung von
Paketartikeln (Bestand errechnet sich aus Komponenten)
2 Ersteinrichtung
In diesem Abschnitt wird genau erklärt, was alles mindestens gemacht werden muss, wenn die
Shopify-Schnittstelle das erste Mal eingerichtet wird.
- Shopify-Schnittstelle via Schnittstellencode aktiveren (erhältlich unter support@vepos.net)
(Konfiguration -> Schnittstellen -> eCommerce). - Shopify-Backend: private App erstellen und Zugangsdaten kopieren (Apps -> Private App
erstellen). - Konfiguration Shopify-Schnittstelle
- Zugangsdaten: Zugangsdaten zum Shop eintragen (URL sowie Integrationsdaten)
- Allgemein: Pfad für Protokolle eintragen
- Restliche Pflichtfelder füllen
- Zahlungs- und Lieferbedingungen zuordnen
- Länder für Shopify-Schnittstelle freischalten & in Shopify-Schnittstelle die Grundkonfiguration neu laden (unten rechts unter „Aktionen“)
- Dienst einrichten & aktivieren
3 Anhang
3.1 Änderungsnachweis
3.1.1 Version 1.0 – Initialversion
Erste Version der Dokumentation, enthält die Abschnitte Funktionsumfang, Konfiguration und
Ersteinrichtung
3.2 Kontakt & Support
Interesse an unserer Schnittstelle? Melde dich gern bei uns unter 0911 37 84 37 – 0 oder schreibe eine E-Mail an vzweschke@vepos.net.Die Schnittstelle ist bereits bei dir im Einsatz, aber du hast dazu Fragen? Unser Support hilft dir gerne weiter – unter 0911 37 84 37 – 20 sowie support@vepos.net