Lieferanten-API-Beispielaufrufe

Abfrageoptionen für Lieferanten ABRUFEN

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

Diese Abfrage gibt alle Lieferanten mit einer auf cXML:https:///api<instance url>/suppliers? po-method = cxml gesetzten Bestellmethode zurück.

Diese Abfrage gibt alle Lieferanten mit einer Zahlungsfrist von 30 Tagen: 
https:///api<instance url>/suppliers? payment-term [code]=Net+30 zurück.
 
Diese Abfrage gibt alle Lieferanten zurück, bei denen Zahlungsrabatt gewährt wird, wenn innerhalb von 10 Tagen nach Rechnungsstellung und der Lieferant derzeit im System aktiv ist: https:///api<instance url>/suppliers? payment-term [days-for-discount-payment]=10&status=active.
 
Diese Abfrage gibt alle Lieferanten zurück, die nach dem 1. Januar erstellt wurden, 2010 12:00:00: https://<instance url>/api/suppliers?created-at[gt]= 2010-01-01T 12:00:00
 
Diese Abfrage gibt alle Lieferanten zurück, deren PO-Methode auf cXML eingestellt ist und bei denen der Käufer-Domain-Wert das Wort "domain" enthält: https:/<instance url>//api/suppliers? po-method = cxml&cxml-domain [contains]=domain
 
Diese Abfrage gibt alle Lieferanten zurück, denen die cXML-Rechnungsstellung erlaubt ist und bei denen die cXML-Rechnungseinrichtung des Lieferanten-Domain-Wertes das Wort "supplier" enthält: https<instance>://.coupahost.com/api/suppliers?allow-cxml-invoicing=true&cxml-supplier-domain [contains]=supplier
 
Diese Abfrage gibt alle Lieferanten zurück, deren primäre Kontakt-E-Mail-Adresse die value "coupa.com" and the supplier address where the city is Charleston: https:/<instance url>//api/suppliers? primary-contact [email][contains]= coupa.com&primary-address [city]=Charleston
 
Diese Abfrage gibt alle Lieferanten zurück, die mindestens 5 Benutzerbewertungen im System haben.   https://<instance url>/api/suppliers?reviewss-count[gt]=5
 

Lieferant abrufen

In diesem Beispiel haben wir einen einzelnen Lieferantensatz mit der ID 6 abgefragt.

Wir sind zur URL gelangt:

https://<instance url>/api/suppliers/6
oder
https://<instance url>/api/suppliers?id=6

Hier ist die Antwort, die den Suchkriterien entspricht:

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

<suppliers type="array">

	<supplier>

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

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

		<updated-at type="datetime">2009-07-01T11:59:33-07:00</updated-at>

		<name>VWR</name>

		<number></number>

		<status>aktiv</status>

		<website></website>

		<po-method>cxml</po-method>

		<cxml-url>http://www.dummy.com</cxml-url>

		<cxml-domain>http://demo.coupahost.com</cxml-domain>

		<cxml-identity>Coupa</cxml-identity>

		<cxml-supplier-domain>http://www.vwr.com</cxml-supplier-domain>

		<cxml-supplier-identity>VWR-Test</cxml-supplier-identity>

		<cxml-secret>test</cxml-secret>

		<cxml-protocol>cXML</cxml-protocol>

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

		<account-number></account-number>

		<duns></duns>

		<tax-id></tax-id>

		<coupa-connect-secret></coupa-connect-secret>

		<invoice-matching-level>2-Wege</invoice-matching-level>

		<primary-contact>

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

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

			<name-additional nil="true"></name-additional>

			<name-family>Front</name-family>

			<name-fullname nil="true"></name-fullname>

			<name-given>Morgendämmerung</name-given>

			<name-prefix nil="true"></name-prefix>

			<name-suffix nil="true"></name-suffix>

			<notes nil="true"></notes>

		</primary-contact>

		<primary-address>

			<attention nil="true"></attention>

			<city>Portland</city>

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

			<name>VWR</name>

			<postal-code>82323</postal-code>

			<state>Oder</state>

			<street1>09 Addison Ave</street1>

			<street2></street2>

			<country>

				<code>US</code>

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

				<name>Vereinigte Staaten</name>

			</country>

		</primary-address>

		<payment-term>

			<code>2/10 Net 30 (30 Tage netto</code>

			<days-for-discount-payment type="integer">10</days-for-discount-payment>

			<days-for-net-payment type="integer">30</days-for-net-payment>

			<discount-rate type="float">2.0</discount-rate>

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

		</payment-term>

	</supplier>

</suppliers>

Lieferant erstellen - Aktiv und Detail

In diesem Beispiel erstellen wir einen aktiven Lieferanten. Wir verwenden keine Coupa-System-IDs für die Referenzobjekte.

Wir haben es unter der URL: https://<instance url>/api/suppliers veröffentlicht.

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

<supplier>

	 <name>CDW</name>

	 <number>cdw2323</number>

	 <status>aktiv</status>

	 <po-method>prompt</po-method>

	 <po-email />

	 <account-number>2323</account-number>

	 <duns />

	 <tax-id>283923</tax-id>

	 <invoice-matching-level>3-fach-Abgleich</invoice-matching-level>

	 <payment-term>

			30 <code>Tage netto</code>

	 </payment-term>

	 <primary-contact>

			<email>joe.smith@cdw.com</email>

			<name-family>Smith</name-family>

			<name-given>Joe</name-given>

			<name-prefix nil="true" />

			<name-suffix nil="true" />

			<notes nil="true" />

			<phone-work>

				 <area-code>650</area-code>

				 <country-code>1</country-code>

				 <extension nil="true" />

				 <number>4442932</number>

			</phone-work>

			<phone-mobile>

				 <area-code nil="true" />

				 <country-code>1</country-code>

				 <extension nil="true" />

				 <number />

			</phone-mobile>

			<phone-fax>

				 <area-code nil="true" />

				 <country-code>1</country-code>

				 <extension nil="true" />

				 <number />

			</phone-fax>

	 </primary-contact>

	 <primary_address>

			<street1>1234 Concur Drive</street1>

			<street2 />

			<city>San Mateo</city>

			<state>CA</state>

			<postal_code>93325</postal_code>

			<country>

				 <code>US</code>

			</country>

	 </primary_address>

</supplier>

Lieferantenerstellung - Entwurf und Basis

In diesem Beispiel erstellen wir einen vorläufigen Lieferanten. Wir verwenden keine Coupa-System-IDs für die Referenzobjekte.

Wir haben es unter der URL: https://<instance url>/api/suppliers veröffentlicht.  Dadurch wurde der Lieferant in einem Entwurfsstatus erstellt.

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

<supplier>

	 <name>CDW</name>

	 <po-method>prompt</po-method>

	 <account-number>2323</account-number>

	 <duns />

	 <tax-id />

	 <invoice-matching-level>3-fach-Abgleich</invoice-matching-level>

	 <payment-term>

			30 <code>Tage netto</code>

	 </payment-term>

</supplier> 

Lieferanten aktualisieren - vollständiges Update

In diesen Beispielen aktualisieren wir verschiedene Informationen im Lieferantendatensatz.

Wir haben einen PUT auf die URL: https://<instance url>/api/suppliers/<supplier id> 

Um beispielsweise die PO-Methode des Lieferanten für die Lieferanten-ID 83 auf cXML zu aktualisieren:

URL: https://<instance url>/api/lieferanten/83

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

<supplier>

	 <po-method>cxml</po-method>

	 <cxml-url>https://testurl.com</cxml-url>

	 <cxml-domain>Netzwerk-ID</cxml-domain>

	 <cxml-identity>coupa</cxml-identity>

	 <cxml-supplier-domain>Netzwerk-ID</cxml-supplier-domain>

	 <cxml-supplier-identity>supplierID1</cxml-supplier-identity>

	 <cxml-secret>shhhhh</cxml-secret>

	 <cxml-protocol>cxml</cxml-protocol>

</supplier>

So aktualisieren Sie beispielsweise die primären Kontaktinformationen des Lieferanten und mehrere andere Lieferantenprofilinformationen für die Lieferanten-ID 83: 

URL: https://<instance url>/api/lieferanten/83

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

<supplier>

	 <account-number>123456</account-number>

	 <duns>DUNS-123</duns>

	 <tax-id>taxid-123</tax-id>

	 <invoice-matching-level>keine</invoice-matching-level>

	 <primary-contact>

			<email>supplier@test.com</email>

			<name-family>Donovan</name-family>

			<name-given>Fred</name-given>

			<phone-work>

				 <area-code>415</area-code>

				 <country-code>1</country-code>

				 <extension nil="true" />

				 <number>4471010</number>

			</phone-work>

			<phone-fax>

				 <area-code>415</area-code>

				 <country-code>1</country-code>

				 <extension nil="true" />

				 <number>4471012</number>

			</phone-fax>

	 </primary-contact>

</supplier> 

So aktualisieren Sie beispielsweise das Lieferantenprofil einschließlich der Adressaktualisierung für die Lieferanten-ID 83: 

URL: https://<instance url>/api/lieferanten/83

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

<supplier>

	 <name>Petra (USA)</name>

	 <number>1-112</number>

	 <primary-address>

			<street1>425 Market Street # 2250</street1>

			<street2 />

			<city>San Francisco</city>

			<state>CA</state>

			<postal_code>94105</postal_code>

			<country>

				 <code>US</code>

			</country>

	 </primary-address>

</supplier>

So aktualisieren Sie beispielsweise die Zahlungsbedingung und die Versandbedingung für die Lieferanten-ID 83:

URL: https://<instance url>/api/lieferanten/83

<supplier>

 <shipping-term>

	<id>1</id>

</shipping-term>

 <payment-term>

	<id>5<id>

 </payment-term>

</supplier>

Zulieferer aktualisieren - einfaches Update

In diesen Beispielen aktualisieren wir ein einzelnes Attribut im Lieferantendatensatz.

Wir haben einen PUT auf die URL:  https://<instance url>/api/suppliers/<supplier id> 

So aktualisieren Sie beispielsweise den Lieferantenstatus für Lieferanten mit Lieferanten-ID 83 auf inaktiv:

Lieferant aktualisieren - auf inaktiv eingestellt

URL:  https://<instance url>/api/lieferanten/83

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

<supplier>

	 <status>inaktiv</status>

</supplier>

So aktualisieren Sie beispielsweise die Lieferanten-Bestellmethode, um sie mit der Lieferanten-ID 83 aufzurufen:

Lieferant aktualisieren - Bestellmethode ändern

URL:  https://<instance url>/api/lieferanten/83

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

<supplier>

	 <po-method>prompt</po-method>

</supplier> 

So aktualisieren Sie beispielsweise die E-Mail-Adresse des primären Lieferantenkontakts mit der Lieferanten-ID 83:

Lieferant aktualisieren - Kontakt-E-Mail ändern

URL: https://<instance url>/api/lieferanten/83

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

<supplier>

	 <primary-contact>

			<email>test@test.com</email>

	 </primary-contact>

</supplier>