API-Beispielaufrufe für die Überarbeitung von Bestellungen

Übersicht

Mit der API für die Überarbeitung von Bestellungen können Sie auf den Änderungsverlauf für Bestellungen zugreifen. Diese API enthält einen Datensatz für jede Änderung einer Bestellung, unabhängig davon, ob die Änderung dazu führt, dass die Bestellung erneut an den Lieferanten gesendet wird (wie eine neue Zeile oder eine geänderte Menge in einer Zeile) oder ob die Änderung intern ist (wie das Ändern eines Kontocodes).

Die API ähnelt in ihrer Struktur der Bestell-API mit drei Hauptunterschieden:

1. Der Datensatz enthält ein Element "Revisionsdatensatz". Dieser enthält Informationen zur spezifischen „internen Überarbeitung“ oder Änderung der in diesem Datensatz erfassten PO.
2. Mit wenigen Ausnahmen sind nur Felder sichtbar, die sich geändert haben. Die einzigen Felder, die unabhängig von der Änderung sichtbar sind, sind die PO-ID, die PO-Zeilen-ID oder die UND-Felder<created/>, <deleted/> die als "wahr" erscheinen, wenn sie hinzugefügt oder entfernt wurden.
3. Jedes Nicht-PO-ID- oder PO-Zeilen-ID-Feldelement enthält zwei neue Elemente <from/> und<to/>. Das <to/> Feld enthält die neuen Werte, die in dieser Revision erstellt oder aktualisiert wurden, während das <from/> Feld die Werte aus der vorherigen Revision enthält.  Dies wird unten im Abschnitt Felddefinitionen näher erläutert.

Die URL für den Zugriff auf Bestellungen lautet: https://<instance>/api/purchase_order_revisions

Coupa 16

Aktionen

Mit unserer API für die Überarbeitung von Bestellungen können Sie:

Spalten

Dies sind die Spalten, die für die API für die Überarbeitung von Bestellungen verfügbar sind. Sie sind identisch mit der Auftragskopfzeile:

Coupa 15

Laden Sie die Coupa 14-Dateien herunter, wenn Sie sie noch benötigen:

• Release 15 Flat File Integration Exportformat
• Release 15 Flat File Integration Importformat

Suchkriterien

Der 'base' -Pfad für alle Abfrageparameter befindet sich innerhalb des Revisionsdatensatz-Elements. Das Übergeben von id=123 würde den Revisionsdatensatz mit der ID 123 abrufen, nicht die Revisionsdatensätze für PO 123. Um nach bestimmten Bestellungen zu suchen, müssen Sie den speziellen Parameter "purchase_order_id" verwenden und den Wert auf die gewünschte Bestellnummer festlegen.

Felddefinitionen

<to/> und <from/> Felder, die assoziative Objekte sind, enthalten das vollständige assoziative Objekt.

Einfache Feldaktualisierung

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

<status>

	 <from type="string">entwurf</from>

	 <to type="string">wurde erstellt</to>

</status> 

Assoziative Feldaktualisierung

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

<updated-by>

	 <from>

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

			<login>test_user@coupa.com</login>

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

			<employee-number />

			<firstname>Test</firstname>

			<lastname>Benutzer</lastname>

			<salesforce-id nil="true" />

			<custom_field_on_the_user>ABC</custom_field_on_the_user>

	 </from>

	 <to>

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

			<login>update_user@coupa.com</login>

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

			<employee-number />

			<firstname>Aktualisieren</firstname>

			<lastname>Benutzer</lastname>

			<salesforce-id nil="true" />

			<custom_field_on_the_user>Vert</custom_field_on_the_user>

	 </to>

</updated-by> 

Beispiel-API-GET-Antwort

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

<order-header-revision>

	 <revision-record>

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

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

			<created-at type="datetime">2010-12-11T14:27:15-08:00</created-at>

			<created-by type="integer">1</created-by>

	 </revision-record>

	 <comments />

	 <test-text-field>

			<from type="string">test_receipts</from>

			<to type="string" />

	 </test-text-field>

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

	 <order-lines>

			<order-line>

				 <testfield>

						<from type="string" />

						<to type="string" />

				 </testfield>

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

				 <line-num type="integer">1</line-num>

				 <need-by-date>

						<from type="datetime">2010-07-23T07:00:00-07:00</from>

						<to type="datetime">2010-07-23T00:00:00-07:00</to>

				 </need-by-date>

				 <source-part-num>

						<from type="string" />

						<to type="string" />

				 </source-part-num>

				 <updated-at>

						<from type="datetime">2010-12-10T20:40:45-08:00</from>

						<to type="datetime">2010-12-11T14:27:13-08:00</to>

				 </updated-at>

				 <updated-by>

						<from>

							 <email>matt.support+supportAPI@coupa.com</email>

							 <employee-number nil="true" />

							 <firstname>Matt</firstname>

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

							 <lastname>Support</lastname>

							 <login>matt.support+supportAPI@coupa.com</login>

						</from>

						<to>

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

							 <employee-number />

							 <firstname>Coupa</firstname>

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

							 <lastname>Support</lastname>

							 <login>coupasupport</login>

						</to>

				 </updated-by>

			</order-line>

			<order-line>

				 <testfield>

						<from type="string" />

						<to type="string" />

				 </testfield>

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

				 <line-num type="integer">2</line-num>

				 <need-by-date>

						<from type="datetime">2010-12-11T04:40:42-08:00</from>

						<to type="datetime">2010-12-11T00:00:00-08:00</to>

				 </need-by-date>

				 <source-part-num>

						<from type="string" />

						<to type="string" />

				 </source-part-num>

				 <updated-at>

						<from type="datetime">2010-12-10T20:40:45-08:00</from>

						<to type="datetime">2010-12-11T14:27:13-08:00</to>

				 </updated-at>

				 <updated-by>

						<from>

							 <email>matt.support+supportAPI@coupa.com</email>

							 <employee-number nil="true" />

							 <firstname>Matt</firstname>

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

							 <lastname>Support</lastname>

							 <login>matt.support+supportAPI@coupa.com</login>

						</from>

						<to>

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

							 <employee-number />

							 <firstname>Coupa</firstname>

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

							 <lastname>Support</lastname>

							 <login>coupasupport</login>

						</to>

				 </updated-by>

			</order-line>

	 </order-lines>

	 <ship-to-user>

			<from>

				 <email>coupauser+2010-12-10T20:40:37-0800@coupa.com</email>

				 <employee-number nil="true" />

				 <firstname>Test</firstname>

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

				 <lastname>Konto</lastname>

				 <login>query_user_2010-12-10T20:40:37-0800</login>

			</from>

			<to>

				 <email>coupauser+2010-12-10T17:48:07-0800@coupa.com</email>

				 <employee-number />

				 <firstname>Test</firstname>

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

				 <lastname>Konto</lastname>

				 <login>flow_user_2010-12-10T17:48:07-0800</login>

			</to>

	 </ship-to-user>

	 <updated-at>

			<from type="datetime">2010-12-10T20:40:46-08:00</from>

			<to type="datetime">2010-12-11T14:27:14-08:00</to>

	 </updated-at>

	 <updated-by>

			<from>

				 <email>matt.support+supportAPI@coupa.com</email>

				 <employee-number nil="true" />

				 <firstname>Matt</firstname>

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

				 <lastname>Support</lastname>

				 <login>matt.Support+supportAPI@coupa.com</login>

			</from>

			<to>

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

				 <employee-number />

				 <firstname>Coupa</firstname>

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

				 <lastname>Support</lastname>

				 <login>coupasupport</login>

			</to>

	 </updated-by>

	 <version>

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

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

	 </version>

</order-header-revision>