Pleaxy

Bestellungen anlegen, Rechnungen freigeben und bezahlen und den Workspace einrichten.

API-Referenz

Freigaben

Die Bestellungen und Rechnungen, die auf Sie warten.

Mehr zu dieser Ressource

Die eigene Freigabe-Warteschlange des Aufrufers: die Bestellungen und Rechnungen, deren aktueller Schritt ihn nennt.

Endpunkte

Freigaben auflisten

Listet die Dokumente auf, die auf Ihre Freigabe warten.

GET/v1/workspaces/{regionId}/approvals

Rückgabe

200 OK mit dem in der Antwort gezeigten Objekt.

Weitere Details

Listet die Bestellungen und Rechnungen in diesem Workspace auf, deren aktueller Freigabeschritt den Aufrufer nennt, und für einen Administrator die Dokumente, deren aktueller Schritt niemanden nennt und denen daher eine freigebende Person zugewiesen werden muss.

Geändert am 2026-09-24, eine Sicherheitskorrektur innerhalb von v1: needsAssignment wird nur für einen angemeldeten Administrator gefüllt, den einzigen Aufrufer, der einen Schritt neu zuweisen kann. Für einen API-Schlüssel ist unabhängig von seiner Einkaufsrolle jede Liste leer: Kein Freigabeschritt kann einen Schlüssel nennen.

Antwortfelder

  • purchaseOrders / invoicesarray

    Dokumente in einem Schritt, der den Aufrufer nennt.

  • needsAssignmentobject

    Dokumente, deren aktueller Schritt niemanden nennt. Leer, sofern der Aufrufer kein angemeldeter Administrator ist.

Fehler

  • 401 Unauthorized - Es wurden keine Zugangsdaten übermittelt, oder der Bearer-Token bzw. der X-Api-Key-Wert fehlt, ist ungültig, abgelaufen oder widerrufen.
  • 403 Forbidden - Der Bearer-Token oder API-Schlüssel des Aufrufers gewährt keinen Zugriff auf diesen Workspace (regionId) oder hat nicht die erforderliche Rolle.
GET /v1/workspaces/{regionId}/approvals
Anfrage
curl "$PLEAXY_API_BASE_URL/v1/workspaces/{regionId}/approvals" \
  -H "X-Api-Key: $PLEAXY_API_KEY"
Antwort · 200 OK
{
   "purchaseOrders": [ PurchaseOrder ],
   "invoices": [ Invoice ],
   "needsAssignment": { "purchaseOrders": [ PurchaseOrder ], "invoices": [ Invoice ] }
}
Kontakt aufnehmen