Référence de l’API

Validations

Les bons de commande et factures qui attendent votre action.

En savoir plus sur cette ressource

La file de validation propre à l’appelant : les bons de commande et factures dont l’étape en cours le désigne.

Lister les validations

Liste les documents qui attendent votre validation.

GET/v1/workspaces/{regionId}/approvals

Retour

200 OK avec l’objet présenté dans la réponse.

Plus de détails

Liste les bons de commande et factures de cet espace de travail dont l’étape de validation en cours désigne l’appelant et, pour un administrateur, les documents dont l’étape en cours ne désigne personne et qui ont donc besoin qu’un valideur soit affecté.

Modifié le 2026-09-24, correctif de sécurité au sein de la v1 : needsAssignment n’est rempli que pour un administrateur connecté, le seul appelant qui peut réaffecter une étape. Pour une clé API, quel que soit son rôle achats, chaque liste est vide : aucune étape de validation ne peut désigner une clé.

Champs de la réponse

  • purchaseOrders / invoicesarray

    Les documents à une étape qui désigne l’appelant.

  • needsAssignmentobject

    Les documents dont l’étape en cours ne désigne personne. Vide sauf si l’appelant est un administrateur connecté.

Erreurs

  • 401 Unauthorized - Aucun identifiant n’a été fourni, ou la valeur du jeton Bearer / de X-Api-Key est manquante, invalide, expirée ou révoquée.
  • 403 Forbidden - Le jeton Bearer ou la clé API de l’appelant ne donne pas accès à cet espace de travail (regionId), ou n’a pas le rôle requis.
GET /v1/workspaces/{regionId}/approvals
Requête
curl "$PLEAXY_API_BASE_URL/v1/workspaces/{regionId}/approvals" \
  -H "X-Api-Key: $PLEAXY_API_KEY"
Réponse · 200 OK
{
   "purchaseOrders": [ PurchaseOrder ],
   "invoices": [ Invoice ],
   "needsAssignment": { "purchaseOrders": [ PurchaseOrder ], "invoices": [ Invoice ] }
}
Nous contacter