Exemples d'appels API fournisseurs
OBTENIR les options de requête fournisseur
Voici d'autres exemples d'utilisation de l'API du fournisseur pour interroger et obtenir le jeu de résultats souhaité.
Cette requête renverra tous les fournisseurs dont la méthode de bon de commande est définie sur cXML :https://<instance url>/api/suppliers?po-method=cxml
Cette requête renverra tous les fournisseurs dont le délai de paiement est Net 30 :
https://<instance url>/api/suppliers?payment-term[code]=Net+30
Cette requête renverra tous les fournisseurs pour lesquels une remise de paiement est accordée si, dans les 10 jours suivant la facturation, le fournisseur est actuellement actif dans le système : https://<instance url>/api/suppliers?payment-term[days-for-discount-payment]=10&status=active
Cette requête renverra tous les fournisseurs créés après le 1er janvier 2010 12:00:00: https://<instance url>/api/suppliers?created-at[gt]=2010-01-01T12:00:00
Cette requête renverra tous les fournisseurs dont la méthode de bon de commande est définie sur cXML et dont la valeur du domaine de l'acheteur contient le mot "domaine" : https://<instance url>/api/suppliers?po-method=cxml&cxml-domain[contains]=domain
Cette requête renverra tous les fournisseurs autorisés à utiliser la facturation cXML et dont la configuration de la facture cXML de la valeur du domaine du fournisseur contient le mot "fournisseur" : https://<instance>.coupahost.com/api/suppliers?allow-cxml-invoicing=true&cxml-supplier-domain[contains]=supplier
Cette requête renverra tous les fournisseurs dont l'adresse e-mail du contact principal contient la valeur "coupa.com" et l'adresse du fournisseur dont la ville est Charleston : https://<instance url>/api/suppliers?primary-contact[email][contains]=coupa.com&primary-address[city]=Charleston
Cette requête renverra tous les fournisseurs qui ont au moins 5 évaluations d'utilisateurs dans le système. https://<instance url>/api/suppliers?reviews-count[gt]=5
Obtenir le fournisseur
Dans cet exemple, nous avons recherché un enregistrement de fournisseur unique avec un ID de 6.
Nous avons accédé à l'URL :
https://<instance url>/api/suppliers/6
ou
https://<instance url>/api/suppliers?id=6
Voici la réponse correspondant aux critères de recherche :
<?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>active</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-ay</invoice-matching-level>
<primary-contact>
<email>upgrade@coupa.com</email>
<id type="integer">6</id>
<name-additional nil="true"></name-additional>
<name-family>Frontage</name-family>
<name-fullname nil="true"></name-fullname>
<name-given>Dawn</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>OR</state>
<street1>09 Addison Ave</street1>
<street2></street2>
<country>
<code>US</code>
<id type="integer">223</id>
<name>United States</name>
</country>
</primary-address>
<payment-term>
<code>2/10 Net 30</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>Création de fournisseur - Actif et Détail
Dans cet exemple, nous créons un fournisseur actif. Nous n'utilisons aucun ID système Coupa pour les objets de référence.
Nous l'avons posté sur l'URL : https://<instance url>/api/suppliers.
<?xml version="1.0" encoding="UTF-8"?>
<supplier>
<name>CDW</name>
<number>cdw2323</number>
<status>active</status>
<po-method>prompt</po-method>
<po-email />
<account-number>2323</account-number>
<duns />
<tax-id>283923</tax-id>
<invoice-matching-level>3-way</invoice-matching-level>
<payment-term>
<code>Net 30</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>Création de fournisseurs - Brouillon et de base
Dans cet exemple, nous créons un brouillon de fournisseur. Nous n'utilisons aucun ID système Coupa pour les objets de référence.
Nous l'avons posté sur l'URL : https://<instance url>/api/suppliers. This created the supplier in a draft status.
<?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-way</invoice-matching-level>
<payment-term>
<code>Net 30</code>
</payment-term>
</supplier> Mettre à jour le fournisseur - Mise à jour complète
Dans ces exemples, nous mettons à jour différentes informations sur le dossier fournisseur.
Nous avons effectué un PUT vers l'URL : https://<instance url>/api/suppliers/<supplier id>
Par exemple, pour mettre à jour la méthode de bon de commande du fournisseur en cXML pour l'ID fournisseur 83 :
URL : https://<instance url>/api/suppliers/83
<?xml version="1.0" encoding="UTF-8"?>
<supplier>
<po-method>cxml</po-method>
<cxml-url>https://testurl.com</cxml-url>
<cxml-domain>NetworkID</cxml-domain>
<cxml-identity>coupa</cxml-identity>
<cxml-supplier-domain>NetworkID</cxml-supplier-domain>
<cxml-supplier-identity>supplierID1</cxml-supplier-identity>
<cxml-secret>shhhhh</cxml-secret>
<cxml-protocol>cxml</cxml-protocol>
</supplier>Par exemple, pour mettre à jour les coordonnées principales du fournisseur et plusieurs autres informations de profil fournisseur pour l'ID fournisseur 83 :
URL : https://<instance url>/api/suppliers/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>none</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> Par exemple, pour mettre à jour le profil fournisseur, y compris la mise à jour de l'adresse pour l'ID fournisseur 83 :
URL : https://<instance url>/api/suppliers/83
<?xml version="1.0" encoding="UTF-8"?>
<supplier>
<name>Petra (US)</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>Par exemple, pour mettre à jour les conditions de paiement et d'expédition pour l'ID fournisseur 83 :
URL : https://<instance url>/api/suppliers/83
<supplier>
<shipping-term>
<id>1</id>
</shipping-term>
<payment-term>
<id>5<id>
</payment-term>
</supplier>Mettre à jour le fournisseur - simple mise à jour
Dans ces exemples, nous mettons à jour un attribut unique dans l'enregistrement du fournisseur.
Nous avons effectué un PUT vers l'URL : https://<instance url>/api/suppliers/<supplier id>
Par exemple, pour mettre à jour le statut du fournisseur sur Inactif pour le fournisseur ayant l'ID 83 :
Mettre à jour le fournisseur - Inactif
URL : https://<instance url>/api/suppliers/83
<?xml version="1.0" encoding="UTF-8"?>
<supplier>
<status>inactive</status>
</supplier>Par exemple, pour mettre à jour la méthode de bon de commande du fournisseur afin d'afficher l'ID fournisseur 83 :
Mettre à jour le fournisseur - Changer la méthode du BC
URL : https://<instance url>/api/suppliers/83
<?xml version="1.0" encoding="UTF-8"?>
<supplier>
<po-method>prompt</po-method>
</supplier> Par exemple, pour mettre à jour l'adresse électronique du contact fournisseur principal avec l'ID fournisseur 83 :
Actualiser le fournisseur - Modifier l'adresse électronique du contact
URL : https://<instance url>/api/suppliers/83
<?xml version="1.0" encoding="UTF-8"?>
<supplier>
<primary-contact>
<email>test@test.com</email>
</primary-contact>
</supplier>
Une partie ou la totalité de cette page peut avoir été traduite par machine. Toutes nos excuses pour les inexactitudes.