Bestellungen abrufen

Gibt eine paginierte Liste aller offenen Bestellungen des Unternehmens zurück.

Benötigte Lizenz

Dieser Endpoint erfordert die Lizenz Lagerverwaltung.

Hinweis: Dieser Endpoint liefert ausschließlich offene Bestellungen. Erledigte Bestellungen werden gelöscht – es gibt keine Historie erledigter Bestellungen. Eine erledigte Bestellung verschwindet einfach aus den Ergebnissen, ohne eigenes Ereignis. Plane dafür einen periodischen Vollabgleich ein – eine Bestellung, die dort fehlt, gilt als erledigt.

Request

GET /api/oauth/v2/resource/wares/purchases

Header

Header	Wert
Authorization	Bearer {access_token}

Query-Parameter

Parameter	Typ	Pflicht	Beschreibung
offset	integer	Nein	Startposition (Standard: 0)
limit	integer	Nein	Anzahl Ergebnisse (Standard: 50, Max: 200)
wareId	string (UUID)	Nein	Nur Bestellungen einer bestimmten Ware zurückgeben
createdSince	string (ISO 8601)	Nein	Nur Bestellungen, die ab diesem Zeitpunkt angelegt wurden (createdAt >=)
createdUntil	string (ISO 8601)	Nein	Nur Bestellungen, die bis zu diesem Zeitpunkt angelegt wurden (createdAt <=)
updatedSince	string (ISO 8601)	Nein	Nur Bestellungen, die ab diesem Zeitpunkt geändert wurden (updatedAt >=)
updatedUntil	string (ISO 8601)	Nein	Nur Bestellungen, die bis zu diesem Zeitpunkt geändert wurden (updatedAt <=)

Hinweis: deletedSince wird auf diesem Endpoint nicht unterstützt und ohne Fehler ignoriert. Da erledigte Bestellungen ohnehin gelöscht werden und keine Historie hinterlassen, erkennst du eine Erledigung nur über einen periodischen Vollabgleich – siehe den Hinweis oben.

Response

Erfolg (200 OK)

{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "amount": 10,
      "notice": "Nachbestellung für Aktion Sommer",
      "createdAt": "2026-05-20T08:30:00+01:00",
      "updatedAt": "2026-05-20T08:30:00+01:00",
      "createdBy": "d4e5f6a7-b8c9-0123-defa-123456789012",
      "updatedBy": "d4e5f6a7-b8c9-0123-defa-123456789012",
      "ware": "c3d4e5f6-a7b8-9012-cdef-012345678901"
    }
  ],
  "meta": {
    "total": 6,
    "offset": 0,
    "limit": 50
  }
}

Response-Felder

Feld	Typ	Beschreibung
data	Array	Liste der offenen Bestellungen
data[].id	string (UUID)	Eindeutige ID der Bestellung
data[].amount	number	Bestellte Menge
data[].notice	string | null	Notiz zur Bestellung
data[].createdAt	string (ISO 8601)	Erstellungszeitpunkt
data[].updatedAt	string (ISO 8601)	Letzter Änderungszeitpunkt
data[].createdBy	string (UUID) | null	ID des Mitarbeiters, der die Bestellung angelegt hat
data[].updatedBy	string (UUID) | null	ID des Mitarbeiters, der die Bestellung zuletzt geändert hat
data[].ware	string (UUID) | null	ID der bestellten Ware, nachladbar über Ware anzeigen
meta.total	integer	Gesamtanzahl der offenen Bestellungen
meta.offset	integer	Aktuelle Startposition
meta.limit	integer	Anzahl der zurückgegebenen Einträge

Beispiele

bash

curl -X GET "https://my.offisy.at/api/oauth/v2/resource/wares/purchases?offset=0&limit=50&wareId=b2c3d4e5-f6a7-8901-bcde-f01234567890&createdSince=beispiel&createdUntil=beispiel&updatedSince=2026-04-15T10%3A00%3A00&updatedUntil=2026-04-15T10%3A00%3A00" \
  -H "Authorization: Bearer {access_token}"

Server

Client-ID

Client-Secret

Parameter

offset integer

limit integer

wareId string

createdSince string

createdUntil string

updatedSince string

updatedUntil string

Zuerst Token anfordern

Mögliche Fehler

Status	Code	Beschreibung
400	validation_error	Ungültiger wareId oder ein Zeitstempel-Filter enthält einen ungültigen Wert
400	validation_error	createdSince liegt nach createdUntil, oder updatedSince nach updatedUntil
401	invalid_client	Ungültiger oder fehlender Access Token
403	insufficient_scope	Scope wares nicht vorhanden
403	insufficient_scope	Lizenz Lagerverwaltung nicht vorhanden
404	not_found	Ware zu wareId nicht gefunden oder keine Berechtigung