SOG-Helpcenter Logo SOG Business - Software

Shop XML-Connect


Mit dem SOG ERP (VACOS) Modul Shop XML-Connect ist es möglich per XML Funktionen der Warenwirtschaft zu nutzen, einen Produktkatalog im XML Format aufzubereiten und SOG ERP (VACOS) Datenbanktabellen für einen Shopserver zu replizieren.

Beteiligte Programme

Shop Datenabgleich (p889)

f450 Kundenstammdaten
f451 Versandadressen der Kunden
f452 Ansprechpartner pro Kunden
f453 Versandartenbezeichnungen je Sprache
f454 Zahlungsbedingungen je Sprache
f455 Lieferbedingung je Sprache
f456 Artikelstammdaten
f457 Artikelbezeichnungen je Sprache
f458 Bildstamm
f459 Artikel Bild Verknüpfungen
f460 Mengeneinheitsbezeichnungen je Sprache
f461 Gruppenbeziehungen
f462 Gruppen Artikelbeziehungen
f463 Gruppenbezeichnungen je Sprache
f466 Terminraster
f467 Bildbeschreibungen je Sprache
f468 Artikelreferenzen
f469 Artikeldokumente
f470 Steuersatz für Replizierungen


Shop Katalogaufbereitung (p887)

Diese Funktion erstellt aus den von der Shopdatenaktualisierung (p889) bereitgestellten Daten einen Produktkatalog im XML Format des Mikrosoft Commerce Servers für den SOG Shop. Das XML Schema ist in xml\catalogxmlschema.xml beschrieben. Als Template für die Aufbereitung wird das im Programmparameter (pp887) hinterlegte Template benutzt.
Der Dateiname für die Ausgabe wird ebenfalls im Programmparameter (pp887) hinterlegt.

Shop Kommunikationsserver (p888)

Es sind drei Verarbeitungsmöglichkeiten vorgesehen:

  1. Online über den TCP/IP Service mit einer Online Antwort im XML Format. Auf den in der Antwort enthaltenen Fehlerstatus muss der Shop entsprechend reagieren. SOGERPSrv.

  2. Offline über genau eine ASCII-Datei für den Testbetrieb

  3. Offline über die Ablage von XML Dateien in einem Verzeichnis. Diese Dateien werden mit dem p198 EDI Import vom XML Format in das SOG ERP (VACOS) EDI Format umgesetzt und anschließend importiert. Hierdurch wird erreicht, dass der Import Offline erfolgte, ein Importprotokoll erstellt wird und bei Fehlern eine Aufgabe für einen SOG ERP (VACOS) Sachbearbeiter erstellt wird.


Die XML Schnittstelle für die Anfragen/Übergaben an die Warenwirtschaft ist im XSD Format in xml\VacosInetAnfrage.xsd beschrieben.
Die XML Schnittstelle für die Antworten/Quittungen von der Warenwirtschaft ist im XSD Format in xml\VacosInetAntwort.xsd beschrieben.

Folgende Funktionen sind möglich:

Funktion

Prüfungen/Rückgaben

Kundenanmeldung

 

Terminermittlung

 

Preisermittlung

 

Auftragsprüfung

 

Auftragsbuchung

 

  • Prüfung ob Kontonummer vorhanden

  • Liefersperre

  • wahlweise Kreditlimit

  • sofort lieferbare Menge

  • Nachlieferungsmenge mit spätestem Termin

  • Bruttopreis

  • Nettopreis

  • Nettowert

  • Zu-/Abschläge mit Bezeichnung

  • nächste Menge in der Staffel

  • nächster Preis in der Staffel

  • Warenwert

  • Steuer

  • Gesamtwert

  • je Auftragsposition alle Daten wie bei den Funktionen Termin- und Preisermittlung

  • alle Daten wie bei der Auftragsprüfung

  • Auftragsnummer aus der Warenwirtschaft


Es können mehrer Funktionen in einem XML Dokument übergeben werden. Die Funktionen bauen nicht logisch aufeinander auf, sondern sind für einen Internetshop gedacht. D.h. es ist keine Kundenanmeldung vor einer Preisermittlung notwendig. Es kann auch nur die Funktion Auftragsbuchung genutzt werden, wenn lediglich Aufträge an SOG ERP (VACOS) übergeben werden sollen.

Folgende Fehlermeldungen sind möglich:

Fehlerstatus

Bedeutung

1

Konto nicht vorhanden

2

Ansprechpartner nicht vorhanden

3

Sprache nicht vorhanden

4

Währung nicht vorhanden

5

Artikel nicht vorhanden

6

Keine Positionen übergeben

99

Positionen fehlerhaft (kritisch). Nur im Auftragskopf.

101

Kunde nicht für Auftragserfassung zugelassen

102

Kunde hat Liefersperre

103

Kreditlimit überschritten

104

Angabe einer Einmalrechnungsanschrift nicht erlaubt (bei f010.sammelkz = 0)

105

Angabe einer Rechnungsanschrift erforderlicht (bei f010.sammelkz > 1)

151

Angebotsnummer nicht vorhanden

152

Angebotspositionsnummer nicht vorhanden

153

In einem Angebot ist keine Angebotsnummer erlaubt

161

Vorgegebene Auftragsnummer bereits vorhanden

201

Fehler Preisermittlung

202

Fehler Zu-/ Abschlag unbekannt

203

Mehr als 4 Zu-/ Abschläge

301

Fehler Terminermittlung

302

Fehler keine Terminermittlung ohne Menge möglich

401

Artikel nicht für Auftragserfassung zugelassen

402

Artikel für diesen Kunden gesperrt

403

Partieermittlung fehlgeschlagen.

404

MengenReservierung fehlgeschlagen

999

Positionen fehlerhaft (unkritisch). Nur im Auftragskopf.

 


die Fehlercodes 1 bis 99 führen dazu, dass eine Auftragsbuchung nicht in SOG ERP (VACOS) übernommen wird.

Shop Webservice (SOGERPSrv)

Der Shop Webservice ermöglicht, unter Nutzung des SOAP-Protokolls, die Live-/ Realtime Abfrage von relevanter Daten der Warenwirtschaft SOG ERP (VACOS) aus dem Shopsystem.

Folgende Funktionen sind möglich:

Funktion

Beschreibung

Vorgangsauskunft

 

Vorgangspositionsauskunft

 

Lieferscheinauskunft

 

Lieferpositionsauskunft

 

  • Abfrage der relevanten Daten aus dem Kopfbereich eines einzelnen/ mehrerer Vorgänge

  • Abfrage der relevanten Positionsdaten eines einzelnen/ mehrerer Vorgänge

  • Abfrage der relevanten Daten aus dem Kopfbereich eines einzelnen/ mehrerer Lieferscheine

  • Abfrage der relevanten Positionsdaten eines einzelnen/ mehrerer Lieferscheine