Eine Bestellung soll in einem Aufruf als Ganzes gespeichert werden, um die Datenkonsistenz zu gewährleisten (Der REST-Server verarbeitet jeden Aufruf in einer eigenen Transaktion). 

Die hier verwendenden Elemente sind:

• OnlineAdressen (kann jederzeit auch ausserhalb einer Bestellung übermittelt werden)
• OnlineBestellungen (oder OnlineBestellAdresse wenn Substruktur von OnlineAdresse)
• OnlineBestellPositionen

Je nachdem ob die OnlineAdresse schon vorhanden ist oder nicht, sind folgende Übergabestrukturen möglich:

OnlineBestellung 
        OnlineBestellPositionen
 

OnlineBestellung
       OnlineAdresse
       OnlineBestellPositionen

Alle Entitäten können auch direkt über die normalen CRUD-Operationen manipuliert werden, was aber wegen der Datenkonsistenz nur für die OnlineAdresse empfohlen wird. 

Beispielaufruf

Bestellung mit vorhandener Adresse: POST auf ./OnlineBestellung mit folgenden Daten:

{
  "Datum": "2016-10-10",
  "AdresseID": 1,
  "Hinweis": "Dies ist ein Hinweis",
  "OnlineBestellPosition": [
    {
      "ArtikelID": 16,
      "Anzahl": 8,
      "Preis": 8,
      "Total": 64,
      "PreisErmittlung": 50
    },{
      "ArtikelID": 14,
      "Anzahl": 5,
      "Preis": 5.52,
      "Total": 27.6,
      "PreisErmittlung": 50
    }
  ]
}

{
	"Datum": "2016-10-10",
	"AdresseID": 5753,
	"Hinweis": "Hallo Hinweis",
	"childlist": [{
		"meta": {
			"name": "OnlineBestellPosition",
			"parameters": [{
				"name": "ArtikelID"
			},
			{
				"name": "Anzahl"
			},
			{
				"name": "Preis"
			},
			{
				"name": "Total"
			},
			{
				"name": "PreisErmittlung"
			}]
		},
		"data": [
			[123, 3, 5.50, 16.50, 50],
			[124, 7, 7.95, 55.65, 50]
		]
	}]
}

Allfällige adhoc-Rechnungs-, Liefer- oder Bestell-Adresse [OnlineAdresse]

Eine Bestellung kann abweichende Liefer- und Rechnungsadressen haben. Falls diese noch nicht in VinX vorhanden sind, müssen diese zuerst angelegt werden, damit deren Referenzen in der Bestellung angegeben werden können.

Über OnlineAdresse können sämtliche Adressen verwaltet werden, die mit der Bestellung, der Lieferung und der Fakturierung von Online-Bestellungen zu tun haben.

Diese Online-Adressen sind getrennt vom regulären Adressstamm, und werden manuell bei Bedarf in den Adressstamm übernommen oder auf bestehende Adressen abgebildet.

Bitte beachten Sie, dass die Online-Adressen von VinX periodisch gelöscht werden. Eine permanente Abbildung der Adress-Strukturen eines Shops in den Online-Adressen ist somit nicht möglich! 

Aufruf 

Feldebeschreibung (nur die wichtigsten Felder)

Beschreibung Beleg [OnlineBestellung]

Aufruf 

Feldebeschreibung (nur die wichtigsten Felder)

Beschreibung Positionen [OnlineBestellPosition]

Aufruf 

In der Regel sollten nur Leseoperationen (GET) ausgeführt werden, da die Struktur mit der Bestellung übergeben werden soll, und nachträgliche Änderungen zu Inkonsistenzen führen können.

Feldebeschreibung (nur die wichtigsten Felder)