Genehmigungen API-Beispielaufrufe

Beispiel

In diesem Beispiel haben wir nach einer einzigen Genehmigung mit der ID 12622 gefragt. Wir sind zur URL GEKOMMEN://.coupahost.com/api/requisitions?status=ordered&created-at<instance> [gt]=2010-01-01&created-at[lt]=2010-02-01 

Genehmigungen ERHALTEN ANTWORT

<?xml version="1.0" encoding="UTF-8"?>

<approval>

	 <id type="integer">12622</id>

	 <created-at type="datetime">2012-02-15T14:56:22-08:00</created-at>

	 <updated-at type="datetime">2012-04-23T11:49:25-07:00</updated-at>

	 <position type="integer">1</position>

	 <approval-chain-id nil="true" />

	 <status>genehmigt</status>

	 <approval-date type="datetime">2012-02-15T14:56:59-08:00</approval-date>

	 <note />

	 <type>ManagementHierarchieGenehmigung</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 (CFO)</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 Procurement)</firstname>

			<lastname>Jenkins</lastname>

			<salesforce-id nil="true" />

	 </created-by>

	 <updated-by>

			<id type="integer">17</id>

			<login>coupa_metrics_collecter</login>

			<email>do_not_reply_metrics@coupa.com</email>

			<employee-number nil="true" />

			<firstname>Coupa</firstname>

			<lastname>Metriken</lastname>

			<salesforce-id nil="true" />

	 </updated-by>

</approval>

Wird genehmigt oder abgelehnt

Im Folgenden wird beschrieben, wie Sie die Coupa-API zum Ausführen von Aktionen für Genehmigungen verwenden können.

Wird genehmigt

<instance url>/api/approvals/<approval id>/approve

Wird abgelehnt

<instance url>/api/approvals/<approval id>/ablehnen

Begründung hinzufügen

In beiden Fällen muss eine Genehmigung ausstehend sein (und nicht bereits genehmigt oder abgelehnt), damit die Aktion gültig ist. Es ist auch möglich, einen „Grund“ für die Ablehnung direkt über die XML-Anfrage anzugeben. Verwenden Sie zum Beispiel die folgende Anfrage, um eine Genehmigung per ID von 12612 abzulehnen und einen Grund für "Abgelehnt durch Integration" anzugeben:

https://<instance url>/api/approvals/12612/reject?reason=Abgelehnt%20by%20Integration

 Erfolgreiche Anfragen geben die HTTP-200-Antwort zurück. Der Text der Antwort enthält die erstellte Anforderung. Bei nicht erfolgreichen Anfragen wird http 400 Bad Request zurückgegeben. Der Text der Antwort enthält Validierungsfehler, die als XML formatiert sind.