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>