Übergabe moveIT WEBCON an Webshop
- 15 Jul 2024
- 2 Minuten zu lesen
- Drucken
- DunkelLicht
- pdf
Übergabe moveIT WEBCON an Webshop
- Aktualisiert am 15 Jul 2024
- 2 Minuten zu lesen
- Drucken
- DunkelLicht
- pdf
Artikel-Zusammenfassung
Fanden Sie diese Zusammenfassung hilfreich?
Vielen Dank für Ihr Feedback
Nach Abschluss einer Konfiguration in moveIT WEBCON muss ein JSON Objekt an einen Shop Controller mittels HTTP POST übergeben werden.
Aufbau des JSON Objektes
Kopfinformationen
Feldname | Datentyp | Format | Beschreibung | Verfügbar ab |
LeafletId | Char | X(32) | Merkzettel-ID | 46.10.00 |
EnvironmentID | Int | 6 | Umgebungs-ID über die die Installation eindeutig identifiziert werden kann. | 48.60.HF |
DocTyp | Int | 9 | Belegtyp (1=Angebot / 2=Auftrag) | 48.60.HF |
GUID | Char | X(40) | GUID des Beleges, der die Konfiguration enthält | 48.60.HF |
BasePosition | Char | X(2048) | Soll eine abgeschlossene, in den Warenkorb übergebene Konfiguration geändert werden, so muss der URL Parameter &BasePosition= angegeben werden, welcher mit der GUID der Position 1 (GUID aus Abschnitt 1.1.2 Positionsinformationen der ersten Position „1“) der zu ändernden Konfiguration belegt wird. Diese GUID wird nach Abschluss der Änderung der Konfiguration bei der erneuten Übergabe an den Warenkorb mitgegeben, wodurch der WebShop erkennen kann, dass es sich um eine Änderung handelt und auch welche Position durch die „Neue“ ersetzt werden soll. | 49.30.00 |
AdditionalResponseData | Char | X(2048) | Ähnlich wie BasePosition ist „AdditionalResponseData“ auch ein URL-Parameter, dessen Inhalt beim Aufruf von moveIT WEBCON bis zur Übergabe an den Warenkorb durchgeschleust wird und dadurch der WebShop darauf reagieren kann. Der URL-Parameter kann frei belegt werden. Als möglicher Einsatzzweck kann „AdditionalResponseData“ in Verbindung mit „BasePosition“ z.B. mit „ChangeAndReplace“ belegt werden, damit der Web-Shop bei der Übergabe erkennt, dass er die BasePosition, die im Warenkorb liegt, mit der neuen Position überschreibt. Oder wenn notwendig kann hier eine Session ID mit übergeben werden. | 49.30.00 |
Positionsinformationen
Inhalt wird je Position generiert
Feldname | Datentyp | Format | Beschreibung | Verfügbar ab |
Model | Char | X(24) | Modell-Nummer | 46.10.00 |
ModelDescription | Char | X(128) | Beschreibung des Artikels | 46.10.00 |
GrossPrice | Dez | American Format ->>>,>>>,>>>,>>9.99 | Verkaufspreis netto in Fremdwährung (D.h. Rabatte und Währung werden vom im Backend definierten Standardkunden verwendet) | 46.10.00 |
Currency | Char | X(3) | Währung | 46.10.00 |
Quantity | Dez | ->>>,>>>,>>>,>>9.99 | Menge | 46.10.00 |
Unit | Char | X(8) | Einheit | 46.10.00 |
ImageUrl | Char | X(2048) | Link zum Bild zu dem Artikel/der Konfiguration | 46.10.00 |
ProductText | LongChar | Unbegrenzt | Generierter Produkt-Text aus der Konfiguration im HTML Format | 46.10.00 |
GUID | Char | X(40) | GUID der Position (Eindeutige im System vergebene ID) | 48.60.HF |
EAN | Char | X(20) | Sollte die Position eine EAN haben, so wird diese übergeben | 48.60.HF |
ReferenceArticleNumber | Char | X(24) | Wird auf moveIT@web Seite eine Artikelreferenzierung durchgeführt so wird der Referenzartikel übergeben. | 48.60.HF |
GLN | Char | X(13) | Im Feld „GLN/ILN“ kann die tatsächliche, eigene Lieferantennummer hinterlegt werden, welche dann übergeben wird. | 48.60.HF |
PurchasePrice | Dez | American Format ->>>,>>>,>>>,>>9.99 | Errechneter Einkaufspreis – ist nur dann korrekt, wenn auch auf moveIT@web Seite Einkaufskonditionen gepflegt sind. ACHTUNG: Ist dies gepflegt, sollte unbedingt eine Verschlüsselte Kommunikation durchgeführt werden. | 48.60.HF |
Beispiel JSON Payload:
{
"LeafletId": "997-20061819-24-24",
"GUID": "f2c31881-49bd-939a-5414-efdf288325f7",
"DocTyp": 2,
"EnvironmentID": 997,
"BasePosition": "",
"AdditionalResponseData": "",
"1": {
"Model": "G_Gliederung",
"ModelDescription": "Gliederung für Garagentor",
"GrossPrice": 123.45,
"PurchasePrice": 100.22,
"Currency": "EUR",
"Quantity": 1,
"Unit": "Stk",
"ImageUrl": "isswebdata\\Data\\WebConfigGraphics\\0104-6\\PosGraphic_1.jpg",
"ProductText": "<div>text<\/div>",
"GUID": "219020-11293993939-122",
"EAN": "",
"ReferenceArticleNumber": "",
"GLN": "1222321",
"2": {
"Model": "GARAGENTOR",
"ModelDescription": "Unterposition 1",
"GrossPrice": 123.45,
"PurchasePrice": 100.22,
"Currency": "EUR",
"Quantity": 1,
"Unit": "Stk"
"ImageUrl": "isswebdata\\Data\\WebConfigGraphics\\0104-6\\PosGraphic_2.jpg",
"ProductText": "<div>text<\/div>"
"GUID": "219020-11293993939-122",
"EAN": "",
"ReferenceArticleNumber": "",
"GLN": "1222321"
}
}
}
Hat eine Position eine Unter-Position (weil es eine Gliederungsposition und ihre zugeordneten Unterposition ist), so werden diese Unterpositionen noch innerhalb der ersten Position als weitere angeführt, wobei alle die gleichen Felder wie die Gliederungsposition haben.
Die Übergabe an einen Shop Controller oder Endpoint erfolgt mittels HTTP-POST, wo das JSON als FormData im Request gesendet wird:
.png "image(102).png")
War dieser Artikel hilfreich?
