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

Aperçu

L'API Révisions de bon de commande vous permet d'accéder en lecture à l'historique des modifications de bon de commande. Cette API contient un enregistrement pour chaque modification d'un bon de commande, que la modification entraîne le renvoi du bon de commande 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 des bons de commande, avec trois différences principales :

1. L'enregistrement contient un élément 'révision-enregistrement'. Il contient des informations sur la « révision interne » ou la modification du bon de commande spécifique capturée dans cet enregistrement.
2. À quelques exceptions près, seuls les champs qui ont été modifiés sont visibles. Les seuls champs qui seront visibles indépendamment de la modification sont l'ID du bon de commande, l'ID de la ligne du bon de commande ou les champs et qui apparaîtront comme 'vrai' si cela a été ajouté ou supprimé.
3. Chaque élément de champ ID de ligne de bon de commande ou ID de bon de commande contient deux nouveaux éléments et <à/>. Le champ contiendra les nouvelles valeurs qui ont été créées ou mises à jour dans cette révision alors que le champ contiendra les valeurs de la révision précédente.  Cela 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évision des bons de commande vous permet de :

 

Colonnes

Il s'agit des colonnes disponibles pour l'API Révisions de bon de commande. Elles sont identiques à l'en-tête de commande :

 

Coupa 15

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

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

Critères de recherche

Le chemin 'de base' pour tous les paramètres de requête est dans l'élément de révision-enregistrement. Passer id=123 extrairait l'enregistrement de révision avec l'ID 123, pas les 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 définir la valeur sur le numéro de bon de commande souhaité.

Objet de référence Options des critères de recherche
ID du bon de commande id_bon_de_commande
Numéro de révision interne révision
Date de modification créé à

 

Définitions de champs

Les champs et qui sont des objets associatifs contiendront l'objet associatif complet.

Mise à jour de champ simple

<?xml version="1.0" encoding="UTF-8"?>
<status>
	 <from type="string">draft</from>
	 <to type="string">created</to>
</status> 

Mise à jour 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>User</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>Update</firstname>
			<lastname>User</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">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>Account</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>Account</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> 

 

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

Articles associés


API Coupa Core

Notre API RESTful fournit un accès fiable pour lire, modifier ou intégrer vos données à la plateforme Coupa.

Démarrez avec l'API

Informations générales sur l'utilisation de l'API Coupa et quand vous devez envisager d'utiliser CSV.

Transition vers OAuth 2.0 et OIDC

Coupa désapprouve les API Keys héritées et nécessite l'utilisation d'OAuth 2.0 / OIDC. À partir de R34, aucune nouvelle clé API ne sera émise et les clés API ne seront plus prises en charge avec R35.

Ressources

Nous avons organisé nos points de terminaison API par type d'objet : données de référence, données transactionnelles et ressources partagées.