PUT sortiments/{qnipsSortimentId}/group} · Web API v3 · Entwurf

API-ReferenzWeb API v3 · Entwurfsortiments

PUT sortiments/{qnipsSortimentId}/group}

Web API v3 · Entwurf v3sortiments

Entwurf; für neue Integrationen die aktuelle POS API v3 verwenden.

PUT/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

05: Name wurde nicht angegeben, wird aber in mind. einer Sprache erwartet

### PUT sortiments/{qnipsSortimentId}/group} [PUT]
+ 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
        {
            "ErrorMessage":"some explanation"
            "StackTrace":"text"
        }

+ 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 Resource
        // 1000: Body enthält syntaktische Fehler und kann nicht deserialisiert werden
        // 12001: qnipsSortimentId unbekannt
        // 12002: Id-Feld nicht gesetzt
        // 12003: Keine Warengruppe unter der angegebenen UpGroupId gefunden
        // 12005: Name wurde nicht angegeben, wird aber in mind. einer Sprache erwartet
        // 12006: Kein Item unter angegebener Id gefunden
        // 12007: UpGroupId darf nicht geändert werden. Löschen Sie den item statt dessen und legen Sie ihn in der anderen Warengruppe neu an

Request

cURLKopieren

curl --request PUT \
  'http://pos.dev.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
{
    "ErrorMessage":"some explanation"
    "StackTrace":"text"
}

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 Resource
// 1000: Body enthält syntaktische Fehler und kann nicht deserialisiert werden
// 12001: qnipsSortimentId unbekannt
// 12002: Id-Feld nicht gesetzt
// 12003: Keine Warengruppe unter der angegebenen UpGroupId gefunden
// 12005: Name wurde nicht angegeben, wird aber in mind. einer Sprache erwartet
// 12006: Kein Item unter angegebener Id gefunden
// 12007: UpGroupId darf nicht geändert werden. Löschen Sie den item statt dessen und legen Sie ihn in der anderen Warengruppe neu an