POST sortiments/{qnipsSortimentId}/group} · Web API v3 · Deutsch

API-ReferenzWeb API v3 · Deutschsortiments

POST sortiments/{qnipsSortimentId}/group}

Web API v3 · Deutsch v3sortiments

Aktualität laut Confluence unklar. Die englische POS API v3 ist die aktuelle Referenz.

POST/sortiments/{qnipsSortimentId}/group/{Id}

Parameter

qnipsSortimentIdstringErforderlich

das ist die qnipsSortimentId, die beim Call auf GET sortiments?thirdPartySortimentIdentifier={string1}&name={string2} zurückgeliefert wurde.

Beispiel: 'sortiment123'

Request-Header

DevKey

{Ihr Key}

TrackingUnitId

{trackingUnitId}

Originaler Blueprint-Ausschnitt

API BlueprintKopieren

earbeiten [/sortiments/{qnipsSortimentId}/group/{Id}]
### POST sortiments/{qnipsSortimentId}/group} [POST]
+ Parameters
    + qnipsSortimentId (string, `'sortiment123'`) ... das ist die `qnipsSortimentId`, die beim Call auf `GET sortiments?thirdPartySortimentIdentifier={string1}&name={string2}` zurückgeliefert wurde. 

+ Request

    + Headers

            DevKey: {Ihr Key}
            TrackingUnitId: {trackingUnitId}
    
    + Body

            {
               "Id":”123”,
               "UpGroupId":"234",
               "Name":[
                    { "lang":"de-DE", "val":"Getränke" }, 
                    { "lang":"de-CH", "val":"Getränke" }, 
                    { "lang":"it-CH", "val":"Bevande" },
                    { "lang":"fr-UK", "val":"Boissons" }
                ]
            }

+ Response 200

+ Response 500

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

+ Response 403 

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

        // HTTP-Unauthorized: DevKey oder trackingUnitId nicht angegeben oder nicht vorhanden
            
+ Response 400

        {
            "ErrorId":123,
            "ErrorText":"Details zum Fehler"
        }
        
        // hier alle möglichen ErrorCodes inkl. Texte für diese Ressource
        // 12001: qnipsSortimentId unbekannt
        // 12002: Id-Feld nicht gesetzt
        // 12003: Keine Warengruppe unter der angegebenen UpGroupId gefunden
        // 12004: Es gibt bereits eine Warengruppe unter der angegebenen Id
        // 12005: Name wurde nicht angegeben, wird aber in mind. einer Sprache erwartet

Request

cURLKopieren

curl --request POST \
  'http://pos.prelive.qnips.com/api/pos/v3/sortiments/{qnipsSortimentId}/group/{Id}' \
  --header 'DevKey: {YOUR_DEV_KEY}' \
  --header 'TrackingUnitId: {trackingUnitId}' \
  --data-raw '{
   "Id":”123”,
   "UpGroupId":"234",
   "Name":[
        { "lang":"de-DE", "val":"Getränke" }, 
        { "lang":"de-CH", "val":"Getränke" }, 
        { "lang":"it-CH", "val":"Bevande" },
        { "lang":"fr-UK", "val":"Boissons" }
    ]
}
'

Dokumentationsbeispiel. Platzhalter vor der Verwendung ersetzen.

Response

200500403401400

Kein Response-Body in dieser Referenz angegeben.

Response 500Kopieren

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

Response 403Kopieren

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

Response 401Kopieren

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

Response 400Kopieren

{
    "ErrorId":123,
    "ErrorText":"Details zum Fehler"
}

// hier alle möglichen ErrorCodes inkl. Texte für diese Ressource
// 12001: qnipsSortimentId unbekannt
// 12002: Id-Feld nicht gesetzt
// 12003: Keine Warengruppe unter der angegebenen UpGroupId gefunden
// 12004: Es gibt bereits eine Warengruppe unter der angegebenen Id
// 12005: Name wurde nicht angegeben, wird aber in mind. einer Sprache erwartet