Create a new purchase request
POST/purchase-requests
Creates a new purchase request in draft status. All fields are optional in draft state. Returns the full newly created purchase request so the caller does not need a follow-up GET.
Permissions: requires purchase-requests:write (granted by can_buy). Setting payment_method=INVOICE additionally requires can_pay_on_invoice; setting buyer_code to another user requires can_purchase_on_behalf. Both yield 403 otherwise.
Request
Responses
- 201
- 400
- 401
- 403
- 404
- 422
- 429
- 500
Purchase request created successfully
Response Headers
URL of the created resource
Bad request - validation error
Unauthorized - user not authenticated
Forbidden - request denied by authorization, or blocked by the API firewall
Cost center not found
Supplier is blocked
Too many requests - rate limited by the API firewall; wait out the Retry-After delay before retrying
Response Headers
Delay in seconds a client must wait before retrying the request
Internal server error