Special Actions and API Notes
Certain functions or actions are available via the API and require additional explanation. These will be documented below.
Mark Object as Exported - Marking an object as exported requires its own request. Any other changes included may be ignored during the update.
- A PUT to the record's URL with
exported=true
as a parameter:
HTTP PUT -->https://<example>.coupahost.com/api/purchase_orders/25?exported=true
where 25 is the purchase order number to set exported.
Submit Requisition For Approval - Requisitions can be automatically submitted for approval when they are created via the API. To submit a requisition, add the following to the URL you when you are creating the requsition: "/new/submit_for_approval
"
- HTTP POST -->
https://<example>.coupahost.com/api/requisitions/new/submit_for_approval
Void a Receipt (release 008) - Existing Inventory_Transactions can be voided via the API. Add the following to the URL you when you are making a PUT to the receipt: /void
- HTTP PUT -->
https://<example>.coupahost.com/api/inventory_transactions/123/void
where 123 is the Coupa ID of the Receipt.
Purchase Order Version - An edit to a Purchase Order which results in a new Purchase Order Version (resend to supplier) will reset the exported flag to false.
Error Response - If an error occurs, Coupa will return a message in the following format:
<?xml version="1.0" encoding="UTF-8"?> <errors> <error>This is a sample error message from the API.</error> </errors>
Coupa generally recommends that customers send POs to suppliers from the Coupa system, rather than issuing POs to suppliers from their ERP system.