Exemples d'appels API des départements

Différentes options de requête pour les départements

Voici d'autres exemples d'utilisation de l'API Departments pour interroger et obtenir le jeu de résultats souhaité.

Cette requête vous donnera les départements avec name=Marketing

https://<instance>.coupahost.com/api/departments?name=Marketing

Cette requête vous donnera les départements mis à jour par un utilisateur particulier avec Login = coupasupport

https://<instance>.coupahost.com/api/departments?created_by[login]=coupasupport

Cette requête vous donnera toutes les notes de frais créées après le 1er janvier 2007

https://<instance>.coupahost.com/api/departments?created_at[gt]=2007-01-01

Obtenir un département unique

Dans cet exemple, nous avons recherché un seul département avec un ID de 1.

Nous avons accédé à l'URL :

https://<instance>.coupahost.com/api/departments/1
ou
https://<instance>.coupahost.com/api/departments?id=1

<?xml version="1.0" encoding="UTF-8"?>
<department>
	 <id type="integer">1</id>
	 <created-at type="datetime">2008-10-27T13:00:48-07:00</created-at>
	 <updated-at type="datetime">2014-03-28T08:53:19-07:00</updated-at>
	 <name>Marketing</name>
	 <active type="boolean">true</active>
	 <created-by>
			<id type="integer">1</id>
			<login>coupasupport</login>
			<email>upgrade@coupa.com</email>
			<employee-number nil="true" />
			<firstname>Coupa</firstname>
			<lastname>Support</lastname>
			<salesforce-id nil="true" />
			<mycustom-userfield />
	 </created-by>
	 <updated-by>
			<id type="integer">69</id>
			<login>coupasupport+rohitdemo@coupa.com</login>
			<email>coupasupport+rohitdemo@coupa.com</email>
			<employee-number nil="true" />
			<firstname>Integration</firstname>
			<lastname>User</lastname>
			<salesforce-id nil="true" />
			<mycustom-userfield />
	 </updated-by>
</department>

Départements - Créer

Dans cet exemple, nous créons un département. Nous n'utilisons aucun ID système Coupa pour les objets de référence.

Nous l'avons publié sur l'URL : https://<instance url>/api/departments/. 

<?xml version="1.0" encoding="UTF-8"?>
<department>
	 <name>Marketing</name>
	 <active>false</active>
</department> 

Actualisation des départements

Dans ces exemples, nous mettons à jour un seul enregistrement Département.

Nous avons effectué un PUT vers l'URL :  https://instance.coupahost.com/api/departments/<id>

Par exemple, pour désactiver un service existant avec l'ID 195

<?xml version="1.0" encoding="UTF-8"?>
<department>
	 <id>195</id>
	 <active>false</active>
</department>

Par exemple, pour mettre à jour le nom d'un département existant avec l'ID 195

<?xml version="1.0" encoding="UTF-8"?>
<department>
	 <id>195</id>
	 <name>new name</name>
</department>