Zum Inhalt springen
meniodeveloper
menio DashboardVorschau

POST baskets/{basketId}/grant · Web API v3 · Deutsch

API-ReferenzWeb API v3 · Deutschbaskets

POST baskets/{basketId}/grant

Web API v3 · Deutsch v3baskets
Aktualität laut Confluence unklar. Die englische POS API v3 ist die aktuelle Referenz.
POST/baskets/{basketId}/grant?redeemedInPos={redeemedInPos}

Erst durch das Markieren eines baskets als granted betrachtet das menio-System die ermittelten Rewards als legitim und schreibt diese dem Konsumenten gut. Es werden dabei genau die Rewards als granted markiert, die bei dem letzten POST baskets/{basketId}-Call für den basket mit der angegebenen basketId ermittelt und zurückgeliefert wurden.

Geben Sie für den redeemedInPos-Parameter den Wert true wenn Ihr System bei dem aktuellen Händler die menio-Rabatte direkt verrechnet.

Parameter

basketIdstringErforderlich

Geben Sie hier die Id des baskets, den Sie als abgeschlossen markieren wollen

Beispiel: 1234567890
redeemedInPosboolErforderlich

Verwenden Sie true wenn Ihr System bei dem aktuellen Händler die menio-Rabatte direkt verrechnet.

Beispiel: true

Request-Header

DevKey
{Ihr Key}
TrackingUnitId
{trackingUnitId}
Originaler Blueprint-Ausschnitt
API Blueprint
### POST baskets/{basketId}/grant [POST]
Erst durch das Markieren eines baskets als `granted` betrachtet das qnips-System die ermittelten Rewards als legitim und schreibt diese
dem Konsumenten gut. Es werden dabei genau die Rewards als `granted` markiert, die bei dem letzten 
*[POST baskets/{basketId}](#reference/baskets/basket-hochladen/post-baskets%2F%7Bbasketid%7D%3Fconsumeridenttoken%3D%7Btoken1%7D%26giftcardid%3D%7Btoken2%7D)*-Call für den basket mit der angegebenen 
basketId ermittelt und zurückgeliefert wurden. 

Geben Sie für den `redeemedInPos`-Parameter den Wert `true` wenn Ihr System bei dem aktuellen Händler die qnips-Rabatte direkt verrechnet.

+ Parameters
    + basketId (string, `1234567890`) ... Geben Sie hier die Id des baskets, den Sie als abgeschlossen markieren wollen
    + redeemedInPos (bool, `true` ) ... Verwenden Sie **true** wenn Ihr System bei dem aktuellen Händler die qnips-Rabatte direkt verrechnet.

+ Request

    + Headers

            DevKey: {Ihr Key}
            TrackingUnitId: {trackingUnitId}

+ Response 200

+ Response 500

        // HTTP-InternalServerError: Ein unbekannten Problem bei der Verarbeitung aufgetreten

+ Response 401 

        // HTTP-Unauthorized: DevKey oder trackingUnitId nicht angegeben oder nicht vorhanden

+ Response 403 

        // HTTP-Forbidden: trackingUnitId ist noch nicht vom Merchant aktiviert
            
+ Response 400

        {
            "ErrorId":12000,
            "ErrorText":"Details zum Fehler"
        }
        
        // hier alle möglichen ErrorCodes inkl. Texte für diese Ressource
        // 11001: basketId unbekannt