Listar órdenes de compra
Lista las órdenes de compra del espacio de trabajo, opcionalmente dentro de un rango de fechas.
GET/v1/workspaces/{regionId}/purchase-orders
Parámetros
fromstringFecha/marca de tiempo ISO 8601: solo se devuelven los elementos creados en esta fecha o después.
tostringFecha/marca de tiempo ISO 8601: solo se devuelven los elementos creados en esta fecha o antes.
Devuelve
200 OK con el objeto que se muestra en la respuesta.
Más detalles
Lista todas las órdenes de compra del espacio de trabajo, sin un orden concreto. Opcionalmente se limita a un rango de createdAt mediante from/to: pasa los límites de un mes natural para obtener una vista mensual. Un llamador proveedor recibe una vista reducida de cada orden de compra (consulta GetPurchaseOrder): se ocultan la contabilidad interna del comprador y el flujo de aprobación completo.
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.
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"
}
]