Aprobaciones - Referencia de la API

Listar aprobaciones

Lista los documentos que esperan tu aprobación.

GET/v1/workspaces/{regionId}/approvals

Devuelve

200 OK con el objeto que se muestra en la respuesta.

Más detalles

Lista las órdenes de compra y facturas de este espacio de trabajo cuyo paso de aprobación actual nombra al llamador y, para un administrador, los documentos cuyo paso actual no nombra a nadie y, por tanto, necesitan que se asigne un aprobador.

Cambiado el 2026-09-24, una corrección de seguridad dentro de v1: needsAssignment solo se rellena para un administrador con sesión iniciada, el único llamador que puede reasignar un paso. Para una clave de API, sea cual sea su rol de compras, todas las listas están vacías: ningún paso de aprobación puede nombrar a una clave.

Campos de la respuesta

purchaseOrders / invoicesarray
Documentos en un paso que nombra al llamador.
needsAssignmentobject
Documentos cuyo paso actual no nombra a nadie. Vacío salvo que el llamador sea un administrador con sesión iniciada.

Errores

401 Unauthorized - No se presentó ninguna credencial, o el token Bearer o el valor de X-Api-Key falta, no es válido, caducó o fue revocado.
403 Forbidden - El token Bearer o la clave de API del llamador no da acceso a este espacio de trabajo (regionId), o no tiene el rol requerido.

GET /v1/workspaces/{regionId}/approvals

Solicitud

curl "$PLEAXY_API_BASE_URL/v1/workspaces/{regionId}/approvals" \
  -H "X-Api-Key: $PLEAXY_API_KEY"

Respuesta · 200 OK

{
   "purchaseOrders": [ PurchaseOrder ],
   "invoices": [ Invoice ],
   "needsAssignment": { "purchaseOrders": [ PurchaseOrder ], "invoices": [ Invoice ] }
}