Exemples d'appels d'API de révisions de bons de commande

Aperçu

L'API de révisions de bons de commande vous permet de lire l'accès à l'historique des modifications de bons de commande. Cette API contient un enregistrement pour chaque modification apportée à un BC, que la modification entraîne le renvoi du BC au fournisseur (comme une nouvelle ligne ou une quantité modifiée sur une ligne) ou si la modification est interne (comme la modification d'un code de compte).

La structure de l'API est similaire à celle de l'API du bon de commande, avec trois différences principales :

1. L'enregistrement contient un élément « enregistrement de révision ». Cela contient des informations sur la « révision interne » spécifique ou la modification du bon de commande capturé dans cet enregistrement.
2. À quelques exceptions près, seuls les champs qui ont changé de champ sont visibles. Les seuls champs qui seront visibles indépendamment du changement sont le numéro de bon de commande, le numéro de ligne de bon de commande ou les <deleted/> champs <created/> et qui apparaissent comme « vrais » s'ils ont été ajoutés ou supprimés.
3. Chaque élément de champ non ID de bon de commande ou ID de ligne de bon de commande contient deux nouveaux éléments <from/> et<to/>. Le <to/> champ contiendra les nouvelles valeurs qui ont été créées ou mises à jour dans cette révision tandis que le <from/> champ contiendra les valeurs de la révision précédente.  Ceci est expliqué plus en détail ci-dessous dans la section Définitions des champs.

L'URL pour accéder aux bons de commande est : https ://<instance>/api/purchase_order_revisions

Coupa 16

Actions

Notre API de révisions de bons de commande vous permet de :

 

Colonnes

Ce sont les colonnes disponibles pour l'API de révisions de bons de commande. Ils sont identiques à l'en-tête de la commande :

 

Coupa 15

Télécharger les fichiers Coupa 14 si vous en avez encore besoin :

  • Version 15 Format d'exportation d'intégration de fichiers plats
  • Version 15 Format d'importation d'intégration de fichiers plats

Critère de recherche

Le chemin « de base » pour tous les paramètres de la requête se trouve dans l'élément revision-record. Le passage de l'ID=123 entraînerait le retrait de l'enregistrement de révision avec l'ID 123, et non des enregistrements de révision pour le BC 123. Pour rechercher des bons de commande spécifiques, vous devez utiliser le paramètre spécial "purchase_order_id" et fixer la valeur au numéro de bon de commande souhaité.

Objet de référence Rechercher des options de critères
ID de bon de commande purchase_order_id
Numéro de la révision interne révision
Date à laquelle la modification a été effectuée created-at

 

Définition du champ

<to/> et <from/> les champs qui sont des objets associatifs contiendront l'objet associatif complet.

Mise à jour simple du champ

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

<status>

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

	 <to type="string">créé</to>

</status> 

Actualisation du champ associatif

<?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>Utilisateur</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>Mettre à jour</firstname>

			<lastname>Utilisateur</lastname>

			<salesforce-id nil="true" />

			<custom_field_on_the_user>DEF</custom_field_on_the_user>

	 </to>

</updated-by> 

Exemple de réponse GET API

<?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">11/12/2010T14:27:15-08:00</created-at>

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

	 </revision-record>

	 <comments />

	 <test-text-field>

			<from type="string">test_receipt</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">11/12/2010T14: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>Soutien</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>Soutien</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">11/12/2010T04:40:42-08:00</from>

						<to type="datetime">2010-12-11T00:00:00-08:00: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">11/12/2010T14: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>Soutien</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>Soutien</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>Compte</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>Compte</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">11/12/2010T14: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>Assistance</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>Assistance</lastname>

				 <login>coupasupport</login>

			</to>

	 </updated-by>

	 <version>

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

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

	 </version>

</order-header-revision> 

 

Articles associés


API de violation des dépenses

24 April 2017

Utilisez l'API de violation de frais pour envoyer des violations de frais à votre système tiers.

API de kilométrage de la ligne de dépenses

29 November 2017

API d'allocation des lignes de frais

30 November 2017

API d'allocation de kilométrage de la ligne de dépenses

30 November 2017

Une partie ou la totalité de cette page peut avoir été traduite par machine. Toutes nos excuses pour les inexactitudes.