Für Shop-Anbindungen kann ein ganzer Warenkorb gerechnet, und mit derselben Schnittstelle auch als Bestellung übermittelt werden. die Datenstruktur sieht wie folgt aus:

Als Wurzelelement steht der Warenkorb, dem die Positionen angehängt sind. Auf dem Warenkorb, wie auch der Position, kann ein Rabatt ausgegeben werden, dieser kann aber nicht übersteuert werden (Output only). Das selbe gilt für die Gebinde-Position.

Optional können diverse Adressen mitgegeben werden, wobei immer die Online*-Adressen verwendet werden sollen (blaue Tabellen). In die gelben Adress-Tabellen sollte geschrieben werden, wenn dies im Projekt explizit so definiert wird.

Im Folgenden wird auf den Warenkorb und die angehängten Positionen eingegangen.

Ein einfacher Warenkorb mit einer Online-Lieferadresse sieht folgendermaßen aus:

Warenkorb-Bestellung

{
  "WarenkorbAktion": 10,
  "AdresseID": 1,
  "ExterneID": "123",
  "FremdsystemID": 1,
  "WarenkorbPosition": [
    {
      "ID": 1,
      "ArtikelID": 3889,
      "Anzahl": 10
    }
  ],
  "OnlineLieferAdresse": [
  	{
  	  "Name": "LA"
  	}
  ]
}

Die Antwort ist dann:

Antwort auf Warenkorb

{
    "ID": null,
    "BereichID": null,
    "AdresseID": 1,
    "ExterneID": "123",
    "FremdsystemID": 1,
    "Hinweis": null,
    "InklMWST": true,
    "KundenkonditionID": null,
    "LieferAdresseID": null,
    "Lieferdatum": null,
    "OnlineAdresseID": null,
    "OnlineLieferAdresseID": null,
    "OnlineRechnungsAdresseID": null,
    "PreisgruppeID": 2,
    "RechnungsAdresseID": null,
    "SaferPayBetrag": null,
    "SaferPayID": null,
    "SaferPayToken": null,
    "TotalBetragNettoExkl": 20.7,
    "TotalBetragNettoInkl": 21.2,
    "ZahlungswegKarteID": null,
    "WarenkorbAktion": 10,
    "LieferbedingungID": null,
    "ZahlungskonditionID": null,
    "OnlineLieferAdresse": [
        {
            "ID": null,
            "DatumErfassung": "2019-01-22T00:00:00.000Z",
            "Eintragtyp": 1,
            "LandID": null,
            "OnlineAktiv": false,
            "OnlineMailIstVerifiziert": false,
            "OnlinePasswortIstGeaendert": false,
            "Verarbeitet": false,
            "Name": "LA"
        }
    ],
    "WarenkorbPosition": [
        {
            "ID": 1,
            "Anzahl": 10,
            "ArtikelID": 3889,
            "Bezeichnung": "Coca-Cola 6-Pack 1.5 L PET EW",
            "EinzelPreisExkl": 2.24,
            "EinzelPreisInkl": 2.3,
            "MWSTProzentArtikel": 2.5,
            "MWSTProzentInPreis": 2.5,
            "PreisErmittlung": null,
            "TotalBetragNettoExkl": 20.7,
            "TotalBetragNettoInkl": 21.2,
            "AnzahlAbzug": 0,
            "GebuehrenArtikelID": null,
            "BetragGebuehrenExkl": 0,
            "BetragGebuehrenInkl": 0,
            "WarenkorbRabatt": [],
            "WarenkorbGebindePosition": []
        }
    ],
    "WarenkorbRabatt": []
}

Warenkorb

Der Warenkorb ist eine temporäre Struktur, die nicht abgespeichert werden kann. Sie wird für das Berechnen der Preise und die Umwandlung in eine Bestellung verwendet (= Verteilung der übermittelten Daten auf die diversen Online-Tabellen). In Folge ist nur ein POST möglich:

Aufruf

URI	Methode	Return
./Warenkorb	POST	Warenkorb vervollständigt mit den angehängten Objekten

Daten

Hier werden nur diejenigen Felder beschrieben, die irgendeine Logik hinterlegt haben, oder Einfluss auf die Berechnung haben. Die vollständige Beschreibung der Tabelle kann über die Metadaten abgefragt werden.

Feld	Funktion	Richtung	Format	Bemerkungen
id	Id des Warenkorbes, wird in der Antwort unverändert zurückgegeben. Kann zu Steuerzwecken verwendet werden.	I	key
InklMWST	Gibt an, ob der Kunde MWSt-pflichtig ist.	O	boolean	Alle Preise verstehen sich immer ohne MWSt. Ausnahme sind einige berechnete (Komfort)Felder in der Ausgabe.
BereichID	Id des Bereichs, in dem der Warenkorb gerechnet werden soll	I	key	Kann leer gelassen werden, falls nicht mit Bereichen gearbeitet wird Ref nach ../Bereich
AdresseID	ID der Bestelladresse, ist massgebend für die Preisfindung (Preisgruppe, Rabatte etc.)	I	key	Ref nach ../Adresse
LieferAdresseID	ID der Lieferadresse	I	key	Ref nach ../Adresse
RechnungsAdresseID	ID der Rechnungsadresse	I	key	Ref nach ../Adresse
ExterneID	Id/Schlüssel des Warenkorbes im Shop. Wird bei der Speicherung in die Folgetabellen weitergereicht.	I	string[30]	Über diese ID kann der Shop ein Tracking der Weiterverarbeitung der Bestellung machen, indem er in den Online-Tabellen die generierte Bestellung sucht und weiterverfolgt.
FremdsystemID	Id des Shopsystems, muss im VinX/PerformX angelegt und mitgeteilt werden. Dient der Unterscheidung der angebundenen Systeme.	I	key	z.B. 1=Test, 2=Prod, 3=QS
PreisgruppeID	Zu verwendende Preisgruppe. Wenn leer gelassen findet eine Preisgruppenfindung statt,	I/O	key	Ref nach ../Preisgruppe
WarenkorbAktion	Auszuführende Aktion: 10: nur rechnen 20: rechnen und als Bestellung speichern	I	integer
ZahlungswegKarteID	Falls im Shop bezahlt wird muss hier der verwendetet Zahlweg angegeben werden	I	key	Ref nach ../Zahlungsweg
ZahlungskonditionID	Falls im Shop bezahlt wird kann hier zusätzlich eine Zahlungskondition angegeben werden (z.B. Sofortbezahl-Rabatt)	I	key	Ref nach ../Zahlungskondition
SaferPayBetrag	Bezahlter Betrag falls im Shop bezahlt	I	number[20,4]
TotalBetragNettoExkl	Total Nettobetrag des Warenkorb exkl MWSt	O	number[20,4]	TotalBetragNetto aller Positionen - möglicher Auftragsrabatt
TotalBetragNettoInkl	dito inkl.	O	number[20,4]

WarenkorbPosition

Die Warenkorbpositionen sind immer an den Warenkorb gebunden und sind als Unterelemente mitzugeben (siehe auch Beispiel-Aufruf oben).

Daten

Es werden wiederum nur diejenigen Felder beschrieben, die irgendeine Logik hinterlegt haben, oder Einfluss auf die Berechnung haben. Die vollständige Beschreibung der Tabelle kann über die Metadaten abgefragt werden.

Feld	Funktion	Richtung	Format	Bemerkungen
id	Id der Position, muss eindeutig sein	I	key
Anzahl	Bestellmenge	I	number[20,4]
ArtikelID	Id des Bestellartikels	I	key	Ref nach ../Artikel
Bezeichnung	Artikelbezeichnung	O	string[40]
EinzelPreisExkl	Preis des Artikel exkl. MWSt	I/O	float	Wird bei Preisermittlung = [50, 55] übernommen, ansonsten ignoriert und ausgegeben
EinzelPreisInkl	dito inkl.	I/O	float	Wird bei Preisermittlung = [50, 55] übernommen, ansonsten ignoriert und ausgegeben
MWSTProzentArtikel	MWSt-Satz, der dem Artikel zugrunde liegt	O	number[20,4]
MWSTProzentInPreis	MWSt-Satz welcher im Grundpreis bereits enthalten ist	O	number[20,4]
PreisErmittlung	Art des Preises, kann je nach Systemeinstellung übernommen oder ignoriert werden. Gültig sind: 10 Spezialpreis 20 Aktionspreis 30 Preis aus Preisgruppe 40 Basispreis 50 Preis überschrieben 55 Internetpreis	I/O	integer
TotalBetragNettoExkl	Total Nettobetrag der Position exkl MWSt	O	number[20,4]	EinzelPreis * Anzahl - Betrag aller Rabattpositionen + (Anzahl * Preis aller Gebindepositionen)
TotalBetragNettoInkl	dito inkl.	O	number[20,4]
BetragGebuehrenExkl	Betrag der hinterlegten Gebühren exkl MWSt	O	number[20,4]	Anzahl * GebuehrenArtikel.Grundpreis
BetragGebuehrenInkl	dito inkl.	O	number[20,4]	Anzahl * GebuehrenArtikel.Grundpreis
GebuehrenArtikelID	Id des Gebühren-Artikel	O	key	Ref nach ../Artikel

WarenkorbRabatt

WarenkorbRabatt kann auf dem Warenkorb (Auftragrabatt) wie auf der Position erscheinen und kann nicht überschrieben werden.

Daten

Feld	Funktion	Richtung	Format
RabattBasisExkl	Betrag auf welchem der Rabatt angewandt wurde (vor Rabatt) exkl. MWST	O	number[20,4]
RabattBasisInkl	dito inkl.	O	number[20,4]
BetragExkl	Rabattbetrag exkl. MWST	O	number[20,4]
BetragInkl	dito inkl.	O	number[20,4]
Bezeichnung	Rabattbezeichnung	O	string[40]

WarenkorbGebindePosition

WarenkorbGebindePosition wird auf der Position ausgegeben und kann nicht überschrieben werden.

Daten

Feld	Funktion	Richtung	Format	Bemerkungen
Anzahl	Menge des Gebinde	O	number[20,4]
GebindeArtikelID	Id des Gebinde-Artikel	O	key	Ref nach ../Artikel
MWSTProzentArtikel	dito Position	O	number[20,4]	Gebinde ist in VinX immer 0.0
MWSTProzentInPreis	dito Position	O	number[20,4]	Gebinde ist in VinX immer 0.0
PreisExkl	Preis des Gebinde-Artikel exkl. MWST	O	number[20,4]
PreisInkl	dito inkl.	O	number[20,4]

Copy of Funktion Warenkorb

Warenkorb

Aufruf

Daten

WarenkorbPosition

Daten

WarenkorbRabatt

Daten

WarenkorbGebindePosition

Daten