Exemples d'appels d'API approuvés
Exemple
Dans cet exemple, nous avons demandé une seule approbation avec un ID de 12622. Nous avons accédé à l'URL ://.coupahost.com/api/requisitions?status=ordered&created-at<instance> [gt]=2010-01-01&created-at[lt]=2010-02-01
Les approbations OBTIENNENT UNE RÉPONSE
<?xml version="1.0" encoding="UTF-8"?>
<approval>
<id type="integer">12622</id>
<created-at type="datetime">15/02/2012T14:56:22-08:00</created-at>
<updated-at type="datetime">23/04/2012T11:49:25-07:00</updated-at>
<position type="integer">1</position>
<approval-chain-id nil="true" />
<status>approuvé</status>
<approval-date type="datetime">15/02/2012T14:56:59-08:00</approval-date>
<note />
<type>ManagementHierarchyApproval</type>
<approvable-type>RequisitionHeader</approvable-type>
<approvable-id type="integer">2696</approvable-id>
<approver>
<id type="integer">3</id>
<login>vpierre</login>
<email>upgrade+vp@coupa.com</email>
<employee-number />
<firstname>Victor (directeur financier)</firstname>
<lastname>Pierre</lastname>
<salesforce-id nil="true" />
</approver>
<created-by>
<id type="integer">9</id>
<login>bjenkins</login>
<email>upgrade+bj@coupa.com</email>
<employee-number />
<firstname>Bob (VP Approvisionnement)</firstname>
<lastname>Jenkins</lastname>
<salesforce-id nil="true" />
</created-by>
<updated-by>
<id type="integer">17</id>
<login>coupa_metrics_gatherer</login>
<email>do_not_reply_metrics@coupa.com</email>
<employee-number nil="true" />
<firstname>Coupa</firstname>
<lastname>Indicateurs</lastname>
<salesforce-id nil="true" />
</updated-by>
</approval>
Approbation ou rejet en cours
Ce qui suit décrit comment vous pouvez utiliser l'API Coupa pour effectuer des actions sur les approbations.
Approbation en cours
<instance url>/api/approbations/<approval id>/approuver
Rejet en cours
<instance url>/api/approbations/<approval id>/rejet
Ajout d'un motif
Dans les deux cas, une approbation doit être en attente (et non déjà approuvée ou rejetée) pour que l'action soit valide. Il est également possible de fournir un « Raison » pour le rejet via la requête XML directement. Par exemple, pour rejeter une approbation par l'ID de 12612 et fournir une raison de « Rejeté par l'intégration », vous devez utiliser la demande suivante :
https ://<instance url>/api/approvals/12612/reject ?reason=Rejected%20by%20Integration
Les demandes réussies renverront une réponse HTTP 200. Le corps de la réponse inclura la demande créée. Les demandes infructueuses renverront HTTP 400 Bad Request. Le corps de la réponse comprendra des erreurs de validation formatées en XML.