Allgemein

...

1. Berechnen, ohne den Auftrag auszulösen → calculate
2. Auftrag auslösen mit Berechnungen → order
   1. der Auftrag wird in die VinX-Tabelle Online-Bestellung geschrieben, welche es erlaubt die Aufträge in VinX zu übernehmen. Dokumentation Benutzersicht: Online- Bestellungen.

Datenschema

Die Zuweisung eines Auftrages an eine Adresse erfolgt entweder direkt mit der Angabe der entsprechenden Id (Adress-Tabelle)

Adressen

Adressen

Die Zuweisung eines Auftrages an eine Adresse erfolgt entweder direkt mit der Angabe der entsprechenden Id (Adress-Tabelle) oder als Unterobjekte von Onlineadressen.

...

Pro Bestellposition müssen zwingend folgende Werte mitgegeben werden:

• articleId: Artikel-Id
• orderedQuantity: Bestellmenge

Optional kann der Preis vom Shop vorgegeben werden:

• unitPrice (oder unitPriceWithTax): Einheitspreis exkl. (oder inkl. MWSt)
• priceCalculationRule = "fromShop"

...

• specialConditionId: sobald eine specialConditionId mitgegeben wird, wird diese berücksichtigt. Falls eine Spezialkondition auf dem Kundenrabatt schon vorliegt, wird diese dann ignoriert. Spezialkonditionen - Hauptseite

Umgang mit Promocodes, Gutscheinen etc.

...

• Im Shop müssen die Spezialkonditionen, Aktionen, Gutscheine etc. verwaltet werden.
• Im VinX muss für die Fibu, Kostenrechnung oder Nachkalkulation je nach Anforderungen mindetstens ein Promo-Artikel angelegt werden. Dieser muss dem Shop bekannt sein, analog zu den Versandkosten.
• Wird ein Rabatt eingelöst, muss der Shop wie folgt vorgehen:
  • Der Warenkorb muss im Modus "nur berechnen" übermittelt werden (Flag "action" = "calculate")
  • Rabatte bestimmen, Z.b. Fixpreis-Promo, z.B. 20.- ab 100.- Bestellwert:
  • Im Warenkorb ist eine neue Bestellposition hinzuzufügen, die 
    • als Artikel den obigen Promoartikel hat
    • als Preis den negative Rabatt hat, im Beispiel hier wären das -20.-
    • in der Preisregel (Feld priceCalculationRule) muss "fromShop" sein. Damit macht der Warenkorb keine Neuberechnung des Preises.
  • Der Warenkorb wird normal übermittelt

Lieferpauschale

Pro Basket gibt es eine Lieferzuschläge siehe Lieferzuschläge - Hauptseite. Für den Warenkorb sind nur die Zuschläge "Für Verkauf" relevant.

Die Lieferzuschläge werden zusätzlich zu anderen Rabatten als Positionen agezeigt. Lieferzuschläge werden nur mit Flag "action" = "calculate" berechnet.  "action" = "order" wird ohne berechnung ins VinX übernommen, dort findet dann die Berechnung statt. 

Beispiel

{
    "action": "calculate",
    "conditionAddressId": 1002,
    "positions": [
        {
            "posNumber": "1",
            "orderedQuantity": 12,
            "articleId": 5000
        }
    ]
}

...