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>