Budgetpositionen API-Beispielaufrufe

Abfrageoptionen für Budgetpositionen abrufen

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

Diese Abfrage gibt alle Budgetzeilen mit einem bereits definierten Budgetperiodennamen zurück

https://<instance>.coupa.com/api/budget_lines?period[name]=Q3 GJ09

Diese Abfrage gibt alle Budgetzeilen für den Budgetverantwortlichen mit dem Nachnamen "Carlton" zurück und dass dieser Eigentümer auch Teil des Genehmigungsprozesses mit allen Anforderungen ist, die sich auf sein Budget auswirken.

https://<instance>.coupahost.com/api/budget_lines?owner[Nachname]=Carlton&owner_is_approver=true

Diese Abfrage gibt alle Budgetzeilen zurück, die zu dem Satz von Konten mit dem Namen Kontenplan gehören und bei denen der Abrechnungszeitraum offen ist.

https://<instance>.coupahost.com/api/budget_lines?period[account-type][name]=chart+of+accounts&period[is_open]=true

Budgetposition ABRUFEN

In diesem Beispiel haben wir nach einem einzelnen Budgetzeilendatensatz mit einer ID von

Wir sind zur URL gelangt:

https://<instance url>/api/budget_lines/3
oder
https://<instance url>/api/budget_lines?id=3

Hier ist die Antwort, die den Suchkriterien entspricht:

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

<budget-line>

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

	 <created-at type="datetime">2009-05-04T18:00:58-07:00</created-at>

	 <updated-at type="datetime">2014-04-29T09:55:19-07:00</updated-at>

	 <notes />

	 Für das Unternehmen gekaufte<description> neue IT-Geräte</description>

	 <amount type="decimal">128.000,00</amount>

	 <remaining type="decimal">66883,00</remaining>

	 <owner-is-approver nil="true" />

	 <segment-1>Zentrale</segment-1>

	 <segment-2>Entwicklung</segment-2>

	 <segment-3>Indirekte</segment-3>

	 <segment-4 nil="true" />

	 <segment-5 nil="true" />

	 <segment-6 nil="true" />

	 <segment-7 nil="true" />

	 <segment-8 nil="true" />

	 <segment-9 nil="true" />

	 <segment-10 nil="true" />

	 <segment-11 nil="true" />

	 <segment-12 nil="true" />

	 <segment-13 nil="true" />

	 <segment-14 nil="true" />

	 <segment-15 nil="true" />

	 <segment-16 nil="true" />

	 <segment-17 nil="true" />

	 <segment-18 nil="true" />

	 <segment-19 nil="true" />

	 <segment-20 nil="true" />

	 <error-on-overrun type="boolean">wahr</error-on-overrun>

	 <period>

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

			<created-at type="datetime">2008-10-28T11:27:45-07:00</created-at>

			<updated-at type="datetime">2011-06-07T11:24:05-07:00</updated-at>

			<start-date type="datetime">2009-01-01T00:00:00-08:00</start-date>

			<end-date type="datetime">2009-03-31T01:00:00-07:00</end-date>

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

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

			<segment-1 type="boolean">wahr</segment-1>

			<segment-2 type="boolean">wahr</segment-2>

			<segment-3 type="boolean">wahr</segment-3>

			<segment-4 nil="true" />

			<segment-5 nil="true" />

			<segment-6 nil="true" />

			<segment-7 nil="true" />

			<segment-8 nil="true" />

			<segment-9 nil="true" />

			<segment-10 nil="true" />

			<segment-11 nil="true" />

			<segment-12 nil="true" />

			<segment-13 nil="true" />

			<segment-14 nil="true" />

			<segment-15 nil="true" />

			<segment-16 nil="true" />

			<segment-17 nil="true" />

			<segment-18 nil="true" />

			<segment-19 nil="true" />

			<segment-20 nil="true" />

			<name>Q1 GJ09</name>

			<account-type>

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

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

				 <updated-at type="datetime">2014-03-17T14:59:59-07:00</updated-at>

				 <name>Ace Corporate</name>

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

				 <currency>

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

						<code>USD</code>

				 </currency>

				 <primary-contact>

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

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

						<updated-at type="datetime">2012-01-18T11:01:36-08:00</updated-at>

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

						<name-prefix nil="true" />

						<name-suffix nil="true" />

						<name-additional nil="true" />

						<name-given>Jill</name-given>

						<name-family>Harker</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">17</id>

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

						<updated-at type="datetime">2012-01-18T11:01:36-08:00</updated-at>

						<name nil="true" />

						<street1>28 Nevada Blvd</street1>

						<street2 />

						<city>Laughlin</city>

						<state>NV</state>

						<postal-code>94301</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">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-address>

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

			</account-type>

	 </period>

	 <owner>

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

			<login>tri</login>

			<email>trishanth.vallurupalli@coupa.com</email>

			<employee-number />

			<firstname>Trishanth</firstname>

			<lastname>Vallurupalli</lastname>

			<salesforce-id nil="true" />

			<mycustom-userfield />

	 </owner>

	 <currency>

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

			<code>USD</code>

	 </currency>

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

</budget-line>

 Erstellen einer Budgetzeile

In diesem Beispiel erstellen wir eine Budgetposition für einen bestehenden Zeitraum und einen Betrag von 50000. Wir verwenden keine Coupa-System-IDs für die Referenzobjekte.

Wir haben es unter der URL: https://.coupahost.com/api/budget_lines<instance> gepostet.

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

<budget_lines>

	 <segment_1>San_Francisco</segment_1>

	 <segment_2>Marketing</segment_2>

	 <segment_3>Office_Supplies</segment_3>

	 <description>budget für Mary</description>

	 <period>

			<name>Q2 2012</name>

	 </period>

	 <amount>50000</amount>

	 <owner>

			<firstname>Mary (Manager)</firstname>

			<lastname>Schnee</lastname>

			<login>msnow</login>

	 </owner>

</budget_lines>

Budgetpositionen aktualisieren - vollständige Aktualisierung

In diesen Beispielen aktualisieren wir verschiedene Informationen im Budgetpositionsdatensatz.

Wir haben auf DIE URL GESETZT: https://<instance>.coupahost.com/api/budget_lines/<budget line id>

So aktualisieren Sie beispielsweise den Budgetverantwortlichen für die Budgetzeilen-ID 616:

URL: https://<instance>.coupahost.com/api/budget_lines/616

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

<budget_lines>

	 <notes>Carlton ist der Budgetverantwortliche</notes>

	 <description>dies gilt für den Haushaltszeitraum Q2 - 2010</description>

	 <owner>

			<login>mcarlton</login>

	 </owner>

</budget_lines>

 Budgetpositionen aktualisieren - einfache Aktualisierung

In diesen Beispielen aktualisieren wir ein einzelnes Attribut im Budgetpositionsdatensatz.

Wir haben einen PUT auf die URL:  https://<instance url>/api/budget_lines/<budget line id>

Um beispielsweise den dieser Haushaltslinie zugewiesenen Betrag auf 7500 mit der Haushaltslinien-ID 616 zu aktualisieren,

URL:    https://<instance url>/api/budget_lines/616

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

<budget_lines>

	 <amount>7500</amount>

</budget_lines>