Beispielaufrufe der Vertrags-API

Verschiedene Abfrageoptionen für Verträge

Hier finden Sie weitere Beispiele dafür, wie Sie die Vertrags-API zum Abfragen und Abrufen des gewünschten Ergebnissatzes verwenden können.

Diese Abfrage gibt Ihnen die Verträge, die inaktiv sind
https://<instance>.coupahost.com/api/contracts?status=inactive

Diese Abfrage gibt Ihnen den Vertrag für einen Lieferanten mit number = 1, name = test & city = Seattle
https://<instance>.coupahost.com/api/contracts?number=1&name=test&supplier[primary_address[city]]=Seattle

Mit dieser Abfrage erhalten Sie alle Verträge für einen Lieferanten mit einem Vornamen des primären Ansprechpartners = Allison
https://<instance>.coupahost.com/api/contracts?supplier[primary-contact[name-given]]=Allison

Vertrags-API-GET-Beispiel

In diesem Beispiel haben wir nach einem einzelnen Vertragsdatensatz mit der ID 2 gefragt.

Wir sind auf die URL GEKOMMEN:
https://<instance url>/api/contracts/2
oder
https://<instance url>/api/contracts?id=2

Hier ist die Antwort, die den Suchkriterien entspricht:

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

<contract>

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

	 <created-at type="datetime">2008-10-27T13:26:13-07:00</created-at>

	 <updated-at type="datetime">2014-03-20T15:20:45-07:00</updated-at>

	 <name>Amazon.com</name>

	 <number>2</number>

	 <version nil="true" />

	 <start-date type="datetime">2008-10-26T17:00:00-07:00</start-date>

	 <end-date type="datetime">2012-10-26T17:00:00-07:00</end-date>

	 <status>inaktiv</status>

	 <minimum-value type="decimal">0,00</minimum-value>

	 <maximum-value type="decimal">0,00</maximum-value>

	 <terms nil="true" />

	 <preferred nil="true" />

	 <savings-pct type="decimal">10,0</savings-pct>

	 <min-commit type="decimal">0,00</min-commit>

	 <max-commit type="decimal">0,00</max-commit>

	 <supplier-invoiceable type="boolean">false</supplier-invoiceable>

	 <is-default type="boolean">false</is-default>

	 <supplier-account nil="true" />

	 <use-order-windows type="boolean">false</use-order-windows>

	 <order-window-tz nil="true" />

	 <requisition-message nil="true" />

	 <po-message nil="true" />

	 <supplier>

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

			<name>Amazon.com</name>

			<number nil="true" />

			<supplier-diversity />

			<primary-contact>

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

				 <created-at type="datetime">2008-10-27T12:56:39-07:00</created-at>

				 <updated-at type="datetime">2008-10-27T12:56:39-07:00</updated-at>

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

				 <name-prefix nil="true" />

				 <name-suffix nil="true" />

				 <name-additional nil="true" />

				 <name-given>Allison</name-given>

				 <name-family>Livingston</name-family>

				 <name-fullname nil="true" />

				 <notes nil="true" />

				 <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">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 />

				 </updated-by>

			</primary-contact>

			<primary-address>

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

				 <created-at type="datetime">2008-10-27T12:56:39-07:00</created-at>

				 <updated-at type="datetime">2009-08-20T09:35:04-07:00</updated-at>

				 <name>Amazon.com</name>

				 <street1>1516 2nd Ave</street1>

				 <street2 />

				 <city>Seattle</city>

				 <state>WA</state>

				 <postal-code>98101</postal-code>

				 <attention nil="true" />

				 <active type="boolean">wahr</active>

				 <business-group-name nil="true" />

				 <country>

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

						<code>US</code>

						<name>Vereinigte Staaten</name>

				 </country>

				 <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">16</id>

						<login>rohit</login>

						<email>rohit.jalisatgi@coupa.com</email>

						<employee-number />

						<firstname>Rohit</firstname>

						<lastname>Jalisatgi</lastname>

						<salesforce-id nil="true" />

						<mycustom-userfield />

				 </updated-by>

			</primary-address>

	 </supplier>

	 <content-groups type="array">

			<content-group>

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

				 <created-at type="datetime">2006-08-27T19:40:04-07:00</created-at>

				 <updated-at type="datetime">2013-03-29T21:11:14-07:00</updated-at>

				 <name>Alle</name>

				 <description>Alle Benutzer können Dokumente sehen, die dieser Gruppe zugewiesen sind</description>

				 <updated-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 />

				 </updated-by>

			</content-group>

			<content-group>

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

				 <created-at type="datetime">2013-10-09T10:15:01-07:00</created-at>

				 <updated-at type="datetime">2013-10-09T10:15:01-07:00</updated-at>

				 <name>Welches Muster?</name>

				 <description nil="true" />

				 <created-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>Benutzer</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>Benutzer</lastname>

						<salesforce-id nil="true" />

						<mycustom-userfield />

				 </updated-by>

			</content-group>

	 </content-groups>

	 <schedule>

			<day0>jederzeit</day0>

			<day1>jederzeit</day1>

			<day2>jederzeit</day2>

			<day3>jederzeit</day3>

			<day4>jederzeit</day4>

			<day5>jederzeit</day5>

			<day6>jederzeit</day6>

	 </schedule>

	 <contract-terms type="array" />

	 <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>Benutzer</lastname>

			<salesforce-id nil="true" />

			<mycustom-userfield />

	 </updated-by>

</contract>

Frage nach allen Verträgen
https://<instance>/api/contracts/ 

Abfrage, um Verträge herauszufinden, die inaktiv sind
/api/contracts?status=<

Fragen Sie nach Verträgen bestimmter Lieferanten
https:///api<instance>/contracts?number=<>&name=<>&supplier[primary_address[city]]=<>
https://<instance>/api/contracts?supplier[primary_address[city]]=<>

Vertragserstellung - inaktiver Status

In diesem Beispiel erstellen wir einen Vertrag im inaktiven Status. Wir verwenden Coupa-System-IDs für Inhaltsgruppen-Referenzobjekte.

Wir haben es unter der URL : https://<instance url>/api/contracts gepostet.

Dadurch wurde der Vertrag im inaktiven Status erstellt

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

<contract>

	 <name>YRIAmazon.com</name>

	 <number>119</number>

	 <start-date>2014-04-01T17:00:00-07:00</start-date>

	 <end-date>2014-04-26T17:00:00-07:00</end-date>

	 <status>inaktiv</status>

	 <supplier>

			<name>Amazon.com</name>

	 </supplier>

	 <content-groups>

			<content-group>

				 <id>1</id>

				 <name>Alle</name>

				 <description>Alle Benutzer können Dokumente sehen, die dieser Gruppe zugewiesen sind</description>

			</content-group>

	 </content-groups>

</contract>

Contracts API PUT BEISPIELE

Beispielcode für die Statusaktualisierung eines Vertrags

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

<contract>

	 <id>73</id>

	 <status>veröffentlicht</status>

</contract>

Beispielcode zum Aktualisieren des Namens eines Vertrags

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

<contract>

	 <name>Amazon.com</name>

</contract>