Gibt die Definition von Bundle-Preis-Benefits zurück.
Hintergrund : Der Benefit-Typ „Bundle-Preis“ für Verkaufs-Aktionen bietet die Möglichkeit, Sets von Artikeln definieren zu können, die vergünstigt angeboten werden („3 für 2“ oder „2 XY zum Preis von …“ etc.).
Anmerkung zur Rückgabespalte „Quantity“ :
Der Wert gibt an, wieviele Artikel aus einem Set („ItemSetID“) gewählt werden müssen. Der Kunde muß zwar genau diese Anzahl (genauer : die Anzahl an Artikeln aller für das Bundle definierten Sets) bestellen, um den Bundle-Preis zu erhalten, aber trotzdem können natürlich MEHR Artikel, die zu einem Set des Bundles gehören, bestellt werden (überzählige Artikel werden dann eben zum Normalpreis verkauft, sofern sich nicht insgesamt ergibt, daß das Bundle als gesamtes gesehen merhfach geordert wird).
HTTP-Method | GET |
HTTP-Auth | Optional |
Tags | |
Engine-Kategorie | order management |
Engine-Typ | Daten-Ermittlung |
Letzte Aktualisierung | 7.0.7 (2015-01-29) |
Name 1) | Standard-Wert | Beschreibung 2) | SQL-Datentyp3) | ab Version |
---|---|---|---|---|
CampaignID | ID einer Verkaufs-Aktion, zu der der Bundle-Preis-Benefit ausgegeben werden soll | integer | 7.0.5 | |
BenefitID | NULL | ID eines Bundle-Preis-Benefits, dessen Definition ausgegeben werden soll. Wird nur beachtet, wenn „CampaignID = NULL“ ist. | integer | 7.0.5 |
GetAssignedSets | 0 | Gibt an, ob in der Rückgabemenge auch die zugeordneten Sets ermittelt werden sollen („1“ - wenn gar keine Sets zugeordnet sind, ist das Ergebnis leer !) oder nicht („0“). | bit | 7.0.5 |
Spaltenname | Beschreibung | SQL-Datentyp4) | ab Version |
---|---|---|---|
BenefitID | ID eines Bundle-Preis-Benefits für Verkaufs-Aktionen - natürlich identisch mit „BenefitID“ wenn angegeben | integer | 7.0.5 |
BundlePricingTypeID | ID der Art, wie der (Ziel-)Preis für das Bundle „BenefitID“ bestimmt wird | tinyint | 7.0.5 |
BundlePriceOrDiscount | Bei „BundlePricingTypeID = 0“ der Festpreis, bei „BundlePricingTypeID IN (1,2)“ der prozentuale Rabatt und sonst „NULL“ | decimal(12,2) | 7.0.5 |
TotalQuantity | Summe aller „Quantity“-Werte der „ItemSetID“s, die „BenefitID“ zugeordnet sind (redundante Information aus Performance-Gründen für die Bestimmung, ob im Warenkorb das Bundle „BenefitID“ vorliegt) | integer | 7.0.5 |
NetBasedPricing | Bestimmt je nach „BundlePricingTypeID“, ob der Festpreis (ID „0“) in brutto oder netto angegeben ist bzw. (alle anderen IDs) welcher Preis (ob brutto oder netto) bei der Bestimmung „günstigster/teuerster Artikel“ herangezogen werden soll | bit | 7.0.6 |
Spaltenname | Beschreibung | SQL-Datentyp5) | ab Version |
---|---|---|---|
BenefitID | ID eines Bundle-Preis-Benefits für Verkaufs-Aktionen - natürlich identisch mit „BenefitID“ wenn angegeben | integer | 7.0.5 |
BundlePricingTypeID | ID der Art, wie der (Ziel-)Preis für das Bundle „BenefitID“ bestimmt wird | tinyint | 7.0.5 |
BundlePriceOrDiscount | Bei „BundlePricingTypeID = 0“ der Festpreis, bei „BundlePricingTypeID IN (1,2)“ der prozentuale Rabatt und sonst „NULL“ | decimal(12,2) | 7.0.5 |
TotalQuantity | Summe aller „Quantity“-Werte der „ItemSetID“s, die „BenefitID“ zugeordnet sind (redundante Information aus Performance-Gründen für die Bestimmung, ob im Warenkorb das Bundle „BenefitID“ vorliegt) | integer | 7.0.5 |
NetBasedPricing | Bestimmt je nach „BundlePricingTypeID“, ob der Festpreis (ID „0“) in brutto oder netto angegeben ist bzw. (alle anderen IDs) welcher Preis (ob brutto oder netto) bei der Bestimmung „günstigster/teuerster Artikel“ herangezogen werden soll | bit | 7.0.6 |
ItemSetID | ID eines Sets von Artikeln (durch die Bedingung „ItemConditionID“ definiert), die Bestandteil des Bundles „BenefitID“ sind | integer | 7.0.5 |
SortNo | Bestimmt die Reihenfolge von „ItemSetID“ innerhalb aller „BenefitID“ zugeordneten Sets | tinyint | 7.0.5 |
Quantity | Gibt an, wieviele Artikel aus dem Set „ItemSetID“ gewählt werden müssen | tinyint | 7.0.5 |
DistinctItemsOnly | Nur relevant wenn „Quantity > 1“ ! Darf der Kunde denselben Artikel mehrfach auswählen („0“) oder nicht („1“) ? | bit | 7.0.5 |
ItemConditionID | ID der Artikel-Bedingung, die das Set „ItemSetID“ definiert. Die genaue Definition der Bedingung erhält man durch im_GetItemConditions_Ad. | integer | 7.0.5 |
ItemConditionDescription | Bezeichnung der Artikel-Bedingung „ItemConditionID“ | varchar(255) | 7.0.5 |
Die Prozedur hat keine Output-Parameter.
Code | Beschreibung | Quelle 6) |
---|---|---|
-569 | Der Benutzer hat kein Ausführungsrecht für die Prozedur | nur indirekt |
-567 | Die Prozedur darf z. Zt. nicht ausgeführt werden | nur indirekt |
-566 | Die Prozedur darf mit den übergebenen Parametern nicht ausgeführt werden | nur indirekt |
-535 | Das Datum liegt nicht in der Vergangenheit | nur indirekt |
-530 | Der Wert ist nicht konvertierbar | nur indirekt |
-510 | Der Benutzer ist nicht registriert | nur indirekt |
-504 | Es ist ein Problem aufgetreten, das nicht gelöst werden kann, Prozedur wird daher abgebrochen | nur indirekt |
-500 | Falsche Parameter | direkt und indirekt |
Die Rückgabe erfolgt als XML-Dokument welches gegen das Schema Response/EngineProcedure_v1_0.xsd validiert.
7.0.7 | 2015-01-29 | Interne Änderung : Datentyp-Erweiterung des „ReferenceKey“ [für „_mi_StartProcedure“-Aufruf] |
7.0.6 | 2014-06-23 | 1. Neue Rückgabespalte „NetBasedPricing“ 2. Rückgabespalte „AbsDiscountSurchargeTypeID“ ist entfallen |
7.0.5 | 2014-05-26 | Erstmalig in dieser Version erstellt |
Der folgende Link öffnet in einem separaten Fenster den Engine Playground der fest mit dem dbap-demo System verbunden ist:
Unformatierte Ausgabe:
curl -X GET 'http://<partner>-<project>.dstore.de/default/engine/om_GetCampaignBundlePricing_Ad?CampaignID=<value>'
Mit xmllint 7) formatierte Ausgabe:
curl -X GET 'http://<partner>-<project>.dstore.de/default/engine/om_GetCampaignBundlePricing_Ad?CampaignID=<value>' | xmllint --format -
use dStore_php\WebService; $service = new WebService\Service( WebService\Scheme::HTTP,'<partner>-<project>.dstore.de', 80); $request = new WebService\Requests\Engine\Procedure\Request( new WebService\Requests\AccessData('default'), 'om_GetCampaignBundlePricing_Ad', array( 'CampaignID' => <value>, // 'BenefitID' => NULL, // 'GetAssignedSets' => 0 ) ); $service->execute($request); $xml_result = $request->getResponse()->getBody()->toSimpleXmlDocument(); $ResultSet = $xml_result->getRowsAsArray();
XML zur Ausführung mit der Methode engine/execute, z.B. per
curl --header 'Content-Type: application/xml' -X POST 'http://<partner>-<kunde>.dstore.de/default/engine/execute' -d '<xml-daten>'
<?xml version="1.0" encoding="UTF-8"?> <ListOfBatches> <Batch No="0"> <Procedure Name="om_GetCampaignBundlePricing_Ad"> <Parameters> <Parameter Name="CampaignID"><!-- integer value --></Parameter> <!-- <Parameter Name="BenefitID">NULL</Parameter> --> <!-- <Parameter Name="GetAssignedSets">0</Parameter> --> </Parameters> </Procedure> </Batch> </ListOfBatches>