Riferimento API

Approvazioni

Gli ordini d’acquisto e le fatture in attesa di una tua azione.

Altro su questa risorsa

La coda di approvazione del chiamante: gli ordini d’acquisto e le fatture il cui passaggio corrente lo indica.

Elencare le approvazioni

Elenca i documenti in attesa della tua approvazione.

GET/v1/workspaces/{regionId}/approvals

Restituisce

200 OK con l’oggetto mostrato nella risposta.

Più dettagli

Elenca gli ordini d’acquisto e le fatture di questo workspace il cui passaggio di approvazione corrente indica il chiamante e, per un amministratore, i documenti il cui passaggio corrente non indica nessuno e che quindi richiedono l’assegnazione di un approvatore.

Modificato il 2026-09-24, una correzione di sicurezza all’interno della v1: needsAssignment viene compilato solo per un amministratore che ha effettuato l’accesso, l’unico chiamante che può riassegnare un passaggio. Per una chiave API, qualunque sia il suo ruolo procurement, ogni elenco è vuoto: nessun passaggio di approvazione può indicare una chiave.

Campi della risposta

  • purchaseOrders / invoicesarray

    I documenti a un passaggio che indica il chiamante.

  • needsAssignmentobject

    I documenti il cui passaggio corrente non indica nessuno. Vuoto a meno che il chiamante non sia un amministratore che ha effettuato l’accesso.

Errori

  • 401 Unauthorized - Non è stata presentata alcuna credenziale, oppure il token Bearer o il valore di X-Api-Key è mancante, non valido, scaduto o revocato.
  • 403 Forbidden - Il token Bearer o la chiave API del chiamante non dà accesso a questo workspace (regionId), oppure non ha il ruolo richiesto.
GET /v1/workspaces/{regionId}/approvals
Richiesta
curl "$PLEAXY_API_BASE_URL/v1/workspaces/{regionId}/approvals" \
  -H "X-Api-Key: $PLEAXY_API_KEY"
Risposta · 200 OK
{
   "purchaseOrders": [ PurchaseOrder ],
   "invoices": [ Invoice ],
   "needsAssignment": { "purchaseOrders": [ PurchaseOrder ], "invoices": [ Invoice ] }
}
Contattaci