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>