Sie befinden sich hier:
API für berechtigte Sonderangebote
Verwenden Sie die API für berechtigte Sonderangebote, um Kunden eine Liste der Sonderangebote bereitzustellen, die für Kundeneinkäufe berechtigt sind. Die API kann die Liste der berechtigten Sonderangebote für Kontakte, Accounts und Treueprogrammmitglieder abrufen.
Erforderliche Editionen
| Verfügbarkeit: Lightning Experience |
| Verfügbarkeit: Enterprise, Unlimited und Developer Edition mit Echtzeit-Angebotsverwaltung |
Stellen Sie Ihren Kunden eine Liste der Sonderangebote bereit, die für ihren Einkaufswagen in Frage kommen. Die API verwendet die Einkaufswagendetails eines Kunden als Anforderung und stellt die Details der berechtigten aktiven Sonderangebote für den Einkaufswagen als Antwort bereit. Wenn Sie nach geeigneten Sonderangeboten für ein Element suchen, scannt die API 5 Ebenen der Kategoriehierarchie des Produkts.
Wenn ein Einkaufswagen ein Produkt enthält, das im Salesforce-Katalog nicht vorhanden ist, ignoriert die API die nicht synchronisierten Produkte bei der Auswertung von Sonderangeboten auf Zeilenebene und übergreifenden Sonderangeboten und zeigt berechtigte Sonderangebote für den Einkaufswagen an.
Wenn eine Organisation über mehrere Regelbibliotheken vom Typ "Verwaltung globaler Sonderangebote" verfügt, müssen Systemintegratoren angeben, welche Regelbibliothek von der API ausgeführt wird. Außerdem müssen sie bestätigen, dass die Anforderung der API Werte enthält, die die Kontextdefinition der Regelbibliothek zum Auswerten von Einkaufswagen erfordert.
Die API-Antwort enthält die folgenden Sonderangebotsdetails.
- Primäre Details des Sonderangebots wie Start- und Enddatum
- Benutzerdefinierte Feldwerte des Sonderangebots
- Obergrenzen des Sonderangebots
- Regeln für Sonderangebote, die für den Einkaufswagen des Kunden berechtigt sind
- Die benutzerdefinierten Feldwerte des Sonderangebots, die in der Kontextdefinition des Sonderangebots zugeordnet sind.
Integrieren Sie die API für berechtigte Sonderangebote in externe Systeme, die Kundeneinkäufe verwalten, um Kunden ihre berechtigten Sonderangebote in Echtzeit bereitzustellen. Siehe Berechtigte Sonderangebote.
Nachdem die Nutzung eines Sonderangebots die Obergrenze des Sonderangebots für einen bestimmten Einkaufswagen erreicht hat, stellt die API für berechtigte Sonderangebote die Belohnung in der API-Ausgabe für keinen Kunden bereit. Nachdem die Nutzung einer Belohnung durch einen Kunden die Obergrenze auf Kundenebene des Sonderangebots erreicht hat, bietet die API für berechtigte Sonderangebote dem Kunden die Belohnung nicht mehr an.
So sieht die Anforderung der API für berechtigte Sonderangebote aus, wenn die API über die Online-Shopping-Site von Cloud Kicks ausgeführt wird.
{
"cart":{
"Accessory":[
{
"activityStartDate":"2023-06-14T12:45:19Z",
"contactId":"003xx000004WjzAAAS",
"transactionAmount":85,
"currencyISOCode":"INR",
"cartLineDetails":[
{
"CartLineProductCategory":"Sneaker Shields",
"cartLineProductCatalogId:"0ZSSB0000002d8X4AQ"",
"AttributeKey:"Premium"
}
]
}
]
}
}API für berechtigte Sonderangebote für Sonderangebote mit Gutscheinen
Wenn einem Sonderangebot Gutscheine hinzugefügt werden, verwendet die API für berechtigte Sonderangebote die Einkaufswagendetails eines Kunden als Anforderung und antwortet mit den Details der aktiven Gutscheine für die Sonderangebote, die für den Einkaufswagen des Kunden berechtigt sind. Der Kunde kann den Gutschein des Sonderangebots verwenden, den er auf seinen Einkaufswagen anwenden möchte.
Bei berechtigten Sonderangeboten, die einen Gutschein enthalten, enthält die Antwort der API die folgenden Gutscheindetails.
- Gutscheincode
- Start- und Enddatum
- Status
Die API gibt nur Sonderangebote zurück, die mindestens einen aktiven und gültigen Gutschein für das Aktivitätsdatum des Kunden aufweisen. Obwohl ein Sonderangebot aus mehreren Gutscheinen bestehen kann, zeigt die API den Gutscheincode in diesen Szenarien nicht an.
- Wenn mehrere aktive Gutscheine für das Aktivitätsdatum berechtigt sind
- Wenn für das Aktivitätsdatum kein Gutschein aktiv ist
- Wenn der berechtigte aktive Gutschein seine Nutzungsobergrenze erreicht hat
