Ware anzeigen

Gibt die Details einer einzelnen Ware zurück.

Request

GET /api/oauth/v2/resource/wares/{uuid}

Header

Header	Wert
Authorization	Bearer {access_token}

URL-Parameter

Parameter	Typ	Pflicht	Beschreibung
uuid	string	Ja	Eindeutige ID der Ware

Response

Erfolg (200 OK)

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Hyaluronsäure-Serum",
    "description": "30 ml Serum für die tägliche Anwendung",
    "number": "1042",
    "internalNumber": "HYA-030",
    "type": "ware",
    "price": 39.90,
    "vat": 20,
    "color": "#00adba",
    "sellable": true,
    "deliverable": true,
    "invoiceSortIndex": 0,
    "archived": false,
    "deleted": false,
    "category": "d4e5f6a7-b8c9-0123-defa-123456789012",
    "groups": [{ "name": "Aktion" }],
    "storages": ["f6a7b8c9-d0e1-2345-fabc-345678901234"],
    "distributors": ["b2c3d4e5-f6a7-8901-bcde-f12345678901"],
    "tenancies": ["f0e1d2c3-b4a5-6789-fedc-ba9876543210"],
    "stock": {
      "stockEffective": 24,
      "stockAvailable": 22,
      "stockMinimum": 5,
      "stockTarget": 30,
      "purchasingPriceNet": 18.50,
      "sellingPriceNet": 33.25,
      "unit": "Stück",
      "unitBase": 1,
      "unitBaseSign": false,
      "deliveryNotice": null,
      "storageNotice": null,
      "distributorNotice": null
    }
  }
}

Hinweis: Ohne die Lizenz Lagerverwaltung fehlt der Schlüssel stock im Response-Objekt komplett – er ist nicht null. Details zu allen Feldern und ein Response-Beispiel ohne Lizenz findest du unter Waren abrufen.

Hinweis: Eine archivierte oder gelöschte Ware liefert weiterhin 200 – archived bzw. deleted steht dann auf true. Nur eine rein virtuelle Ware liefert 404.

Response-Felder

Gleiche Feldstruktur wie eine Zeile aus Waren abrufen, unter data statt data[].

Beispiele

bash

curl -X GET "https://my.offisy.at/api/oauth/v2/resource/wares/b2c3d4e5-f6a7-8901-bcde-f01234567890" \
  -H "Authorization: Bearer {access_token}"

Server

Client-ID

Client-Secret

Parameter

uuid *string

Zuerst Token anfordern

Mögliche Fehler

Status	Code	Beschreibung
401	invalid_client	Ungültiger oder fehlender Access Token
403	insufficient_scope	Scope wares nicht vorhanden
404	not_found	Ware nicht gefunden oder rein virtuell