Lister les bons de commande
Liste les bons de commande de l’espace de travail, éventuellement sur une plage de dates.
GET/v1/workspaces/{regionId}/purchase-orders
Paramètres
fromstringDate/horodatage ISO 8601 : seuls les éléments créés à cette date ou après sont renvoyés.
tostringDate/horodatage ISO 8601 : seuls les éléments créés à cette date ou avant sont renvoyés.
Retour
200 OK avec l’objet présenté dans la réponse.
Plus de détails
Liste tous les bons de commande de l’espace de travail, sans ordre particulier. Peut être limité à une plage de createdAt via from/to : passez les bornes d’un mois civil pour obtenir une vue mensuelle. Un appelant fournisseur reçoit une vue réduite de chaque bon de commande (voir GetPurchaseOrder) : la comptabilité interne de l’acheteur et le circuit de validation complet ne sont pas communiqués.
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.
curl "$PLEAXY_API_BASE_URL/v1/workspaces/{regionId}/purchase-orders" \
-H "X-Api-Key: $PLEAXY_API_KEY"[
{
"id": "string",
"buyerOrgId": "string",
"supplierOrgId": "string",
"supplier": "string",
"amount": number,
"currency": "string",
"status": "draft" | "pending_approval" | "rejected" | "awaiting_fulfillment" | "invoiced" | "paid" | "canceled" | "closed" | "expired",
"invoiceId": "string",
"provider": "aws" | "gcp" | "azure" | "oci",
"payerAccounts": [
{ "id": "string", "label": "string", "detail": "string" }
],
"billToParty": {
"source": "company_profile" | "custom",
"companyName": "string",
"address": { "line1": "string", "line2": "string", "city": "string", "region": "string", "postalCode": "string", "country": "string" },
"addressText": "string",
"taxId": "string"
},
"costCenter": "string",
"costCenterChanges": [ { "from": "string", "to": "string", "reason": "string", "by": "string", "byName": "string", "at": "string" } ],
"budgetOwner": "string",
"buyerName": "string",
"supplierSite": "string",
"notes": "string",
"requestId": "string",
"lineItems": [
{
"lineNo": number,
"scopeType": "sku" | "service" | "account" | "custom",
"scopeId": "string" | null,
"name": "string",
"ruleType": "quantity" | "amount",
"unit": "string",
"unitPrice": number,
"qty": number,
"nteAmount": number,
"lineType": "goods" | "service",
"currency": "string",
"paymentTerms": "string",
"validFrom": "string",
"validUntil": "string",
"consumed": number,
"customerLineNo": "string",
"supplierSku": "string",
"priceSource": "contract" | "list" | "manual"
}
],
"approval": {
"requester": "string",
"requesterEmployeeKey": "string",
"groups": [
{
"id": "string",
"mode": "sequential" | "parallel",
"label": "string",
"status": "pending" | "approved" | "rejected",
"stages": [
{ "id": "string", "label": "string", "approverEmployeeKey": "string", "approverName": "string", "status": "pending" | "approved" | "rejected" }
]
}
],
"groupIndex": number,
"status": "pending" | "approved" | "rejected",
"history": [
{ "stage": "string", "by": "string", "at": "string", "action": "approved" | "rejected" | "limit_exceeded" | "reassigned" | "skipped" }
],
"autonomy": boolean,
"selfApproved": boolean
},
"supplierEmail": { "to": "string", "at": "string" },
"priorInvoiced": { "amount": number, "currency": "string", "basis": "invoiced" | "remaining", "sourceSystem": "sap_ariba" | "coupa" | "oracle", "importId": "string", "fileName": "string", "importedAt": "string", "importedBy": "string" },
"createdAt": "string"
}
]