...
In VinX wird unter anderem über die FremdsystemID die Standard Shop Adresse (Konditionen) ermittelt.
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 | Preise werden inkl. und exkl. ausgegeben |
| 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 | I | key | Ref nach ../Adresse, nur möglich wenn bekannt (Abgleich Adressen) |
| LieferAdresseID | ID der Lieferadresse | I | key | Ref nach ../Adresse, nur möglich wenn bekannt (Abgleich Adressen) |
| RechnungsAdresseID | ID der Rechnungsadresse | I | key | Ref nach ../Adresse, nur möglich wenn bekannt (Abgleich Adressen) |
| ExterneID | Id/Schlüssel des Warenkorbes im Shop. Wird bei der Speicherung in die Folgetabellen (z.B. Beleg) 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, Empfehlung leer lassen, ausser eigene Preislogik |
| 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 Zahlungsweg 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] | nicht übersteuerbar |
| EinzelPreisExkl | Preis des Artikel exkl. MWSt | I/O | float | Wird bei Preisermittlung = 55 übernommen, ansonsten ignoriert und ausgegeben |
| EinzelPreisInkl | dito inkl. | I/O | float | Wird bei Preisermittlung = 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 | I/O | integer | leer lassen = Preisberechnung wie in VinX mit 55 kann überschrieben werden |
| 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] | |
| 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 | Bemerkungen |
|---|---|---|---|---|
| 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] |
Vorgehen Adressen
Bestellung als Gast
Mindestanforderung: OnlineLieferadresse
...
OnlineAdresse wird bei diesem Fall nicht ausgefüllt. Die Konditionen-Adresse wird anhand der FremdsystemID gefunden (Standard Shop-Adresse).
Bestellung mit Login
Mindestanforderung: OnlineAdresse mit Angabe von OnlineBenutzername (matching mit VinX Adresse, bei erster Bestellung Shop-Standard als Konditionsadresse)
Optional: OnlineLieferadresse, OnlineRechnungsadresse
Muatation bei einer Adresse mit Login
Eine Änderung einer OnlineAdresse (Hauptadresse) sollte im VinX mitgeteilt werden. Für optionale OnlineLiefer- und OnlineRechnungs-adressen ist dies nicht nötig.
...
| Info |
|---|
Wird eine Änderung der Hauptadresse nicht mitgeteilt, wird diese im VinX auch nicht angepasst. |
Beispiel Bestellung mit Promo-Code und Versandkosten
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
--Aufruf:
{
"WarenkorbAktion": 10,
"ExterneID": "123",
"FremdsystemID": 1,
"WarenkorbPosition": [
{
"ID": 1,
"ArtikelID": 3889,
"Anzahl": 10
},
{
"ID": 2,
"Anzahl": 1,
"ArtikelID": 700,
"EinzelPreisInkl": 15.0,
"PreisErmittlung": 55
},
{
"ID": 3,
"Anzahl": -1,
"ArtikelID": 2035,
"EinzelPreisInkl": 5.0,
"PreisErmittlung": 55
}
],
"OnlineLieferAdresse": [
{
"Name": "LA"
}
]
}
--Antwort:
{
"ID": null,
"BereichID": null,
"AdresseID": null,
"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": 31.37,
"TotalBetragNettoInkl": 33,
"ZahlungswegKarteID": null,
"WarenkorbAktion": 10,
"LieferbedingungID": null,
"ZahlungskonditionID": null,
"OnlineLieferAdresse": [
{
"ID": null,
"DatumErfassung": "2019-04-29T00:00:00.000Z",
"Eintragtyp": 1,
"LandID": 1,
"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": 22.44,
"TotalBetragNettoInkl": 23,
"AnzahlAbzug": 0,
"GebuehrenArtikelID": null,
"BetragGebuehrenExkl": 0,
"BetragGebuehrenInkl": 0,
"WarenkorbRabatt": [],
"WarenkorbGebindePosition": [
{
"Anzahl": 1,
"GebindeArtikelID": "50009",
"MWSTProzentArtikel": 0,
"MWSTProzentInPreis": 0,
"PreisExkl": 0,
"PreisInkl": 0
}
]
},
{
"ID": 2,
"Anzahl": 1,
"ArtikelID": "700",
"Bezeichnung": "Lieferbeitrag Fr. 5.- (da Warenwert unter Fr. 100.-)",
"EinzelPreisExkl": "13.93",
"EinzelPreisInkl": "15",
"MWSTProzentArtikel": 7.7,
"MWSTProzentInPreis": 7.7,
"PreisErmittlung": "55",
"TotalBetragNettoExkl": "13.93",
"TotalBetragNettoInkl": "15",
"AnzahlAbzug": "0",
"GebuehrenArtikelID": null,
"BetragGebuehrenExkl": "0",
"BetragGebuehrenInkl": "0",
"WarenkorbRabatt": [],
"WarenkorbGebindePosition": [
{
"Anzahl": 1,
"GebindeArtikelID": "",
"MWSTProzentArtikel": 0,
"MWSTProzentInPreis": 0,
"PreisExkl": 0,
"PreisInkl": 0
},
{
"Anzahl": 1,
"GebindeArtikelID": "",
"MWSTProzentArtikel": 0,
"MWSTProzentInPreis": 0,
"PreisExkl": 0,
"PreisInkl": 0
}
]
},
{
"ID": 3,
"Anzahl": -1,
"ArtikelID": "2035",
"Bezeichnung": "SCHÜWO Geschenkgutschein",
"EinzelPreisExkl": "5",
"EinzelPreisInkl": "5",
"MWSTProzentArtikel": 0,
"MWSTProzentInPreis": 0,
"PreisErmittlung": "55",
"TotalBetragNettoExkl": "-5",
"TotalBetragNettoInkl": "-5",
"AnzahlAbzug": "0",
"GebuehrenArtikelID": null,
"BetragGebuehrenExkl": "0",
"BetragGebuehrenInkl": "0",
"WarenkorbRabatt": [],
"WarenkorbGebindePosition": [
{
"Anzahl": -1,
"GebindeArtikelID": "",
"MWSTProzentArtikel": 0,
"MWSTProzentInPreis": 0,
"PreisExkl": 0,
"PreisInkl": 0
}
]
}
],
"OnlineAdresse": [],
"WarenkorbRabatt": []
} |
...