• Dernière modification le: 13 May 2022

API de modification du bon de commande

Utilisez l'API de modification des bons de commande pour modifier les commandes déjà en cours, qu'elles soient approuvées ou envoyées au fournisseur.

Aperçu

Utilisez cette API pour modifier les commandes déjà en cours, qu'elles soient approuvées ou envoyées au fournisseur.

Remarque

Modifications de bon de commande L'API GET n'est pas destinée à récupérer les révisions de bon de commande vers l'ERP.

Pour les révisions de bon de commande, utilisez toujours l'API GET du bon de commande avec export = false et utilisez la valeur « version » pour identifier si le bon de commande est nouveau ou révisé.

Actions

L'API de modification des bons de commande vous permet de :

Verbe Chemin d'accès Action Description
METTRE /api/purchase_order_changes/:id/add_approver ajouter_approbateur Ajouter manuellement un approbateur pour une modification de l'en-tête de la commande
POSTE /api/purchase_order_changes créer Créer une modification de bon de commande
OBTENIR /api/purchase_order_changes index Demander à modifier le bon de commande
METTRE /api/purchase_order_changes/:id/remove_approval supprimer_approbation Supprimer un approbateur ajouté manuellement
OBTENIR /api/purchase_order_changes/:id montrer Afficher une modification de bon de commande
METTRE /api/purchase_order_changes/:id/submit_for_approval soumettre_pour_approbation Soumettre la modification du bon de commande pour approbation
METTRE /api/purchase_order_changes/:id mettre à jour Mettre à jour une modification de 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 date
approbations <approver> attribut avec <login> La valeur doit être incluse pour PUT/PATCH dans une demande de modification de bon de commande existante. Oui* Approbateur actuel <login> doit exister dans Coupa oui oui Approbation
pièces jointes Pièces jointes oui Pièce jointe
créé à Créé automatiquement par Coupa au format AAAA-MM-JJFHH:MM:SS+HH:MMZ oui datetime
créé par Créateur oui Utilisateur
approbation en cours Approbation en cours/en attente oui Approbation
département département oui Département
id_réponse_facile_formulaire ID de la réponse au formulaire Easy Form oui
exporté Indique si une transaction a été exportée oui booléen
prix caché Masquer le prix du fournisseur. Vrai ou faux Non Non oui Modification de l'en-tête de commande
id Identifiant unique de Coupa pour la demande de modification de BC. Demande de mise à jour PUT de la demande de modification existante Oui* ID de demande de modification de BC valide oui oui entier
justification justification oui
order-header-id ID de la commande en cours de modification. Demande de nouvelle demande de modification POST Oui* ID d'en-tête de BC valide oui oui entier
modification-ligne-de-commande Modifications de ligne de commande oui oui
mode de paiement payment_method oui string(255)
délai de paiement modalités de paiement oui oui Modalités de paiement
pcard pcard oui oui Carte d'achat
numéro du BC Numéro de BC oui string(20)
prix caché Masquer le prix du fournisseur. Vrai ou faux oui booléen
motif de rejet Motif du rejet oui Commentaire
demandeur Connexion du compte demandeur oui Utilisateur
id-en-tête-de-demande requisition_header_id oui entier
adresse de livraison Adresse d’expédition oui Adresse
destinataire Destinataire oui oui Utilisateur
condition d'expédition conditions d'expédition oui oui Condition d'expédition
source-part-num source_part_num oui oui string(255)
statut Statut du BC oui string(255)
Fournisseur Fournisseur oui Fournisseur
transmission des emails Liste séparée par des virgules des courriers électroniques Non Non tout oui oui texte
priorité sur la méthode de transmission Passer outre la méthode de transmission Non Non supplier_default, e-mail, ne_pas_transmettre oui oui string(30)
mis à jour à Créé automatiquement par Coupa au format AAAA-MM-JJFHH:MM:SS+HH:MMZ oui datetime
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 entier
nom_fabricant Nom du fabricant oui oui string(255)
numéro_pièce_fabricant Numéro de pièce du fabricant oui oui string(255)
extra_line_attribute oui oui
type_service oui
devise oui oui
jalons oui oui
règles récurrentes Règles récurrentes oui -
total Total du document de modification du bon de commande oui décimal(32,4)
en attente d'annulation Le BC est-il en attente d'annulation ? Vrai ou faux oui booléen
nombre de lignes Nombre de lignes du document de modification du bon de commande oui entier
nombre de lignes en attente d'ajout Nombre de lignes en attente d'ajout dans le document de modification du bon de commande oui entier
nombre de lignes en attente d'effacement Nombre de lignes en attente de suppression dans le document de modification du bon de commande oui entier

Exemples d'appels

Créer une demande de modification de BC

Créer une demande de modification de BC à l'aide de l'API en envoyant un authentifié Appel API :
POST https://{your_instance}.coupahost.com/api/purchase_order_changes

Charge utile

Pour POST, vous devez inclure l'ID de l'en-tête d'origine et tous les éléments à modifier. Utiliser le même format que le bon de commande d'origine pour les modifications d'attribut.

<?xml version="1.0" encoding="UTF-8"?>
<order-header-change>
	<order-header-id>1000</order-header-id>
	<!-- Requested changes to the PO -->
</order-header-change>

Réponse au succès 2011

Coupa renvoie un nouveau <order-header-change> avec un ID pour la modification et le bon de commande complet, y compris toutes les modifications que vous avez spécifiées dans votre charge utile POST.

<?xml version="1.0" encoding="UTF-8"?>
<order-header-change>
	<id type="integer">501</id>
	<created-at type="dateTime">2018-04-06T23:14:50+05:30</created-at>
	<updated-at type="dateTime">2018-04-06T23:14:51+05:30</updated-at>
	<order-header-id type="integer">123750</order-header-id>
	<!-- Original PO with requested changes -->
</order-header-change>

Le <status> du bon de commande sera approved si la modification ne nécessitait pas de nouvelles approbations, ou pending_approval si la modification nécessite de nouvelles approbations.

Actualiser une demande de modification de BC

Vous pouvez modifier une demande de modification de bon de commande en attente d'approbation en envoyant un authentifié Appel API :
POST https://{your_instance}.coupahost.com/api/purchase_order_changes/{id} {id} est le <id type="integer"> dans la réponse de 2011. Vous ne pouvez pas modifier une demande de modification de bon de commande déjà approuvée.

Charge utile

Le format de la charge utile est essentiellement le même que celui de l'auto-test de démarrage (POST), sauf que vous devez inclure l'approbateur actuel pour la modification du bon de commande.

<?xml version="1.0" encoding="UTF-8"?>
<order-header-change>
	<approver>
		<login>Approver Name</login>
	</approver>
	<!-- Requested changes to the PO -->
</order-header-change>

Réponse 200

La réponse est la même qu'un POST : <order-header-change> avec l'ID et le bon de commande complet, y compris les modifications que vous avez spécifiées dans votre charge utile PUT.

<?xml version="1.0" encoding="UTF-8"?>
<order-header-change>
	<id type="integer">501</id>
	<created-at type="dateTime">2018-04-06T23:14:50+05:30</created-at>
	<updated-at type="dateTime">2018-04-06T23:14:51+05:30</updated-at>
	<order-header-id type="integer">123750</order-header-id>
	<!-- Original PO with requested changes -->
</order-header-change>

400 Mauvaise réponse à la demande

Si vous envoyez une mauvaise demande, Coupa fournira une liste d'erreurs.

<?xml version="1.0" encoding="UTF-8"?>
<errors>
	<error>
		<!-- List of errors -->
	</error>
</errors>

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.