API des bons de commande (/purchase_orders)
Utilisez l'API de bon de commande pour créer, mettre à jour ou interroger des bons de commande.
Présentation
Lorsque vous utilisez l'API Bons de commande, vous disposez de quelques points de terminaison de ressources à partir desquels vous pouvez travailler :
| Ressource | Chemin d'accès | Description |
|---|---|---|
| En-têtes de BC | /api/purchase_orders |
Bons de commande complets contenant des lignes de bon de commande, des conditions de paiement, des adresses, etc. Voir les actions et les éléments ci-dessous pour plus de détails |
| Lignes de BC | /api/purchase_order_lines |
Informations détaillées sur les lignes de bon de commande telles que les informations sur l'article et les détails comptables. Voir l'API des lignes de commande et l' API d'allocation des lignes de commande pour plus de détails. |
| Modifications du BC | /api/purchase_order_changes |
Créez et gérez des demandes de modification de bon de commande, qu'elles aient ou non un impact sur les approbations. |
| Insights Reason | /api/reason_insights/ |
Indiquez les raisons de la réouverture d'une commande. |
Objets API du bon de commande
Voici la liste complète des objets de commande disponibles via l'interface utilisateur. Cependant, tous les objets listés ici n'ont pas de points de terminaison. Certains sont uniquement référencés par des objets et ne peuvent pas être mis à jour directement.
wiki.tree()
Actions
L'API Bons de commande vous permet de :
| Verbe | Chemin d'accès | Action | Description |
|---|---|---|---|
| METTRE | /api/purchase_orders/:id/cancel |
annuler | Annuler |
| METTRE | /api/purchase_orders/:id/close |
fermer | Clore un bon de commande. VoirClôture des bonsde commande pour plus d'informations. |
| POSTE | /api/purchase_orders |
créer | Créez un bon de commande dans le cadre de la fonctionnalité des bonsde commande externes. Ne pas utiliser pour les bons de commande Coupa. |
| METTRE | /api/purchase_orders/:id/ignore_window_and_issue |
ignorer_fenêtre_et_problème | Ignorer Les Fenêtres Et Le Problème |
| OBTENIR | /api/purchase_orders |
index | Demander des bons de commande |
| METTRE | /api/purchase_orders/:id/issue |
problème | Émettez et envoyez le bon de commande au fournisseur. |
| METTRE | /api/purchase_orders/:id/issue_without_send |
problème_sans_envoyer | Émettez sans envoyer le bon de commande au fournisseur. |
| METTRE | /api/purchase_orders/:id/release_from_buyer_hold |
libération_de_l_acheteur_en_attente | Valider le bon de commande en attente de l'acheteur |
| METTRE | /api/purchase_orders/:id/reopen |
rouvrir | Rouvrir un bon de commande provisoirement clos. VoirClôture des bonsde commande pour plus d'informations sur la clôture provisoire. |
| OBTENIR | /api/purchase_orders/:id |
montrer | Afficher le bon de commande |
| PATCH | /api/purchase_orders/:id |
mettre à jour | Mettre à jour le bon de commande |
| METTRE | /api/purchase_orders/:id |
mettre à jour | Mettre à jour le bon de commande |
Éléments
| Élément | Description | Demande d'achat | Unique | Valeur autorisée | Dans | Sortie | Type de données |
|---|---|---|---|---|---|---|---|
| acknowledged-at | acknowledged_at | oui | datetime | ||||
| drapeau d'accusé de réception | Le fournisseur a-t-il accusé réception de la commande ? | oui | oui | booléen | |||
| pièces jointes | pièces jointes | oui | oui | Pièce jointe | |||
| changer de type | Dernier type de modification du bon de commande, il indique si le bon de commande a été modifié via une demande de modification ou via une révision | modification, révision, confirmation | oui | string(255) | |||
| coupa-acceleration-status | Statut indiquant si la facture est assortie de conditions de paiement avec remise via la remise statique. | accéléré | oui | string(255) | |||
| créé à | Date de création de l'enregistrement dans Coupa. | oui | datetime | ||||
| créé par | ID Coupa de l'utilisateur qui a créé la facture | oui | Utilisateur | ||||
| devise | Devise de la transaction | oui | oui | Devise | |||
| dossiers-historiques-d-integration-actuels | Enregistrements actuels de l'historique de l'intégration | oui | Historique d'intégration | ||||
| exporté | Indique si une transaction a été exportée | oui | booléen | ||||
| prix caché | Masquer le prix du fournisseur. Vrai ou faux | no | no | oui | booléen | ||
| id | ID interne de Coupa | oui | entier | ||||
| internal-revision | Numéro de révision interne - Augmente chaque fois qu'une commande est modifiée en interne ou qu'une modification implique le renvoi de la commande au fournisseur. | oui | entier | ||||
| arrêt de la facture | Drapeau d'arrêt de facture | oui | booléen | ||||
| dernière exportation à | Date et heure de la dernière exportation de la transaction au format AAAA-MM-JJFHH:MM:SS+HH:MMZ | oui | datetime | ||||
| jalons | Jalons | oui | oui | Achats ::Jalon | |||
| lignes de commande | order_lines | oui | oui | oui | Ligne de commande | ||
| mode de paiement | payment_method | oui | oui | string(255) | |||
| délai de paiement | Modalités de paiement | oui | oui | Modalités de paiement | |||
| pcard | pcard | oui | oui | Carte Pcard | |||
| numéro du BC | Numéro de BC | oui | oui | oui | oui | string(20) | |
| prix caché | Masquer le prix du fournisseur. Vrai ou faux | oui | booléen | ||||
| événements-insights-de-la-raison | Raison des événements de visibilité pour les modifications, les réouvertures, etc. | oui | Événement Reason Insight | ||||
| demandeur | Connexion du compte demandeur | oui | Utilisateur | ||||
| en-tête de demande | En-tête de la demande | oui | En-tête de demande | ||||
| adresse de livraison | ship_to_address | no | no | tout | oui | oui | Adresse |
| ship-to-attention | Utilisateur pour lequel la commande sera adressée. Envoyer à l'attention. | no | no | tout | oui | oui | string(255) |
| destinataire | ship_to_user | oui | oui | oui | Utilisateur | ||
| condition d'expédition | Modalités de paiement | oui | oui | ConditionsExpédition | |||
| statut | Statut du BC | oui | string(50) | ||||
| Fournisseur | Numéro d'ID interne Coupa du fournisseur | oui | oui | oui | Fournisseur | ||
| site-fournisseur | Site fournisseur | no | no | tout | oui | oui | Site fournisseur |
| transmission des emails | Liste séparée par des virgules des courriers électroniques | no | no | tout | oui | oui | texte |
| priorité sur la méthode de transmission | Passer outre la méthode de transmission | no | no | supplier_default, e-mail, ne_pas_transmettre | oui | oui | string(30) |
| transmission-status | Statut de transmission | no | no | créé, différé, traitement_différé, en_attente_manuel, en_attente_d'annulation_manuelle, en_attente_d'achat_en_ligne, planifié_pour_e-mail, envoyé_via_e-mail, planifié_pour_cxml, planifié_pour_xml, envoyé_via_cxml, envoyé_via_xml, envoyé_manuellement, acheté_en_ligne, échec_de transmission | oui | chaîne | |
| type | Type de commande | ExternalOrderHeader | oui | string(255) | |||
| mis à jour à | Dernière mise à jour le (date) | oui | datetime | ||||
| mis à jour par | ID Coupa de l'utilisateur qui a créé la facture | oui | Utilisateur | ||||
| version | Numéro de version du fournisseur du bon de commande - Augmente chaque fois qu'un bon de commande est modifié et déclenche un nouvel envoi au fournisseur. | oui | oui | entier | |||
| classification | Classification | msp, fournisseur, vms | oui | oui | string(255) | ||
| devise | Devise de la transaction | oui | |||||
| confirmer par heure | Confirmer par | oui | entier | ||||
| niveau de confirmation des commandes | Niveau de confirmation | oui | int(11) | ||||
| membres-utilisateurs | Membres utilisateurs | oui | Utilisateur | ||||
| membres du groupe d'utilisateurs | Membres du groupe utilisateurs | oui | Utilisateur | ||||
Notes
- Il y a des champs dépendants qui deviennent interrogeables en fonction de la valeur du champ source. Par exemple, si vous effectuez une requête sur
po-method=email, vous pouvez ajouter un e-mail de proposition comme critère de requête supplémentaire. Veuillez consulter les champs avec Oui*. - Pour les données volumineuses et l'optimisation des performances, vous devez toujours limiter vos résultats à l'aide de certains critères GET.
- Les modifications apportées aux bons de commande n'incrémentent pas toujours le numéro de version. Consultezla rubrique Champs qui entraînent une révisiondu bon de commande pour plus d'informations. Le
updated-atchamp peut toujours être utilisé pour déterminer si des modifications ont été apportées.
Exemples de code
Supprimer une ligne de commande avec PUT
<?xml version="1.0" encoding="UTF-8"?>
<order-header>
<order-lines>
<order-line>
<id>coupa_line_id</id>
<_delete>true</_delete>
</order-line>
</order-lines>
</order-header> Rouvrir un bon de commande provisoirement clos
VoirClôture des bons de commande pour plus d'informations sur la clôture provisoire.
Utilisation d'un ID de perspicacité de motif
<?xml version="1.0" encoding="UTF-8"?>
<order-header>
<reason-insight-id>1</reason-insight-id>
<reason-insight-event-comment>comment body</reason-insight-event-comment>
</order-header>Utilisation d'un code de perspicacité de motif
<?xml version="1.0" encoding="UTF-8"?>
<order-header>
<reason-insight-code>code</reason-insight-code>
<reason-insight-event-comment>comment body</reason-insight-event-comment>
</order-header>Une partie ou la totalité de cette page peut avoir été traduite par machine. Toutes nos excuses pour les inexactitudes.