API de modification du bon de commande
Utilisez l'API de modification des bons de commande pour modifier les commandes déjà en cours, soit dans les approbations, soit envoyées au fournisseur.
Aperçu
Utilisez cette API pour modifier les commandes déjà en cours, que ce soit dans les approbations ou envoyées au fournisseur.
L'API GET de modification des bons de commande n'est pas destinée à récupérer les révisions des bons de commande vers l'ERP.
Pour les révisions de bon de commande, utilisez toujours PO GET API avec exported = false, et utilisez la valeur « version » pour identifier si le bon de commande est un nouveau ou un bon de commande révisé.
Actions
L'API de modification du bon de commande vous permet de :
Verbe | Chemin d'accès | Action | Description | ||
---|---|---|---|---|---|
METTRE | /api/purchase_order_changes/:id/add_approver |
add_approver | Ajouter manuellement un approbateur pour un changement d'en-tête de commande | ||
PUBLIER | /api/purchase_order_changes |
créer | Créer une modification de bon de commande. Impossible de SOUMETTRE UN post-appel pour les bons de commande en état de brouillon ou en attente d'approbation. | ||
OBTENIR | /api/purchase_order_changes |
index | Demande de modifications de la commande d'achat | ||
METTRE | /api/purchase_order_changes/:id/remove_approval |
remove_approval | Supprimer un approbateur ajouté manuellement | ||
OBTENIR | /api/purchase_order_changes/:id |
afficher | Afficher une modification de bon de commande | ||
METTRE | /api/purchase_order_changes/:id/submit_for_approval |
submit_for_approval | Soumettre la modification du bon de commande pour approbation | ||
METTRE | /api/purchase_order_changes/:id |
mettre à jour | Mettre à jour la modification du bon de commande. Impossible de mettre à jour les enregistrements créés via le Coupa Supplier Portal. |
Éléments
Élément | Description | Req'd | Unique | Valeur autorisée | Dans | Sortie | Type de données |
---|---|---|---|---|---|---|---|
acknowledged-at | reconnu_à | oui | date | ||||
approbations | <approver> attribut avec <login> valeur doit être inclus pour METTRE/CORRIGER une demande de modification de BC existante. |
Oui* | L'approbateur actuel <login> doit exister dans Coupa |
oui | oui | Approbation | |
pièces jointes | Pièces jointes | oui | Pièce jointe | ||||
created-at | Créé automatiquement par Coupa au format AAAA-MM-JJFHH :MM :SS+HH :MMZ | oui | datetime | ||||
créé par | Utilisateur qui a créé | oui | Utilisateur | ||||
approbation-actuelle | Approbation en cours/en attente | oui | Approbation | ||||
département | département | oui | Département | ||||
id_réponse_formulaire_facile | ID de la réponse au formulaire simplifié | oui | |||||
exported | Indique si la transaction a été exportée | oui | boolean | ||||
hide-price | Masquer le prix du fournisseur. Vrai ou Faux | Non | Non | oui | Modification de l'en-tête de la commande | ||
id | Identifiant unique de Coupa pour la demande de changement de BC. Demande de mise à jour de la demande de modification existante | Oui* | ID de demande de modification de bon de commande valide | oui | oui | nombre entier | |
justification | justification | oui | |||||
order-header-id | ID de la commande en cours de modification. Demandé pour une nouvelle demande DE MODIFICATION POST | Oui* | ID d'en-tête de bon de commande valide | oui | oui | nombre entier | |
order-line-changes | Modifications des lignes de commande | oui | oui | ||||
mode-de-paiement | mode_de_paiement | oui | string(255) | ||||
délai de paiement | modalités de paiement | oui | oui | Modalités de paiement | |||
pcard | pcard | oui | oui | Carte d'achat | |||
po-number | Numéro du BC | oui | string(20) | ||||
prix masqué | Masquer le prix du fournisseur. Vrai ou Faux | oui | boolean | ||||
rejet-motif | Motif du rejet | oui | Commentaire | ||||
demandeur | Demande d'accès au compte | oui | Utilisateur | ||||
en-tête-id de la demande | id_en-tête_de_demande | oui | nombre entier | ||||
adresse d'expédition | Adresse d'expédition | oui | Adresse | ||||
expédier à l'utilisateur | Expédier à l'utilisateur | oui | oui | Utilisateur | |||
délai 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 | Gestion des Fournisseurs | oui | Fournisseur | ||||
transmission-mails | Liste des e-mails de transmission séparés par une virgule | Non | Non | any | oui | oui | texte |
transmission-méthode-override | Remplacement de la méthode de transmission | Non | Non | supplier_default, email, 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 de la commande - Augmente chaque fois qu'une commande est modifiée et déclenche un nouvel envoi au fournisseur. | oui | nombre entier | ||||
manufacturer_name | Nom du fabricant | oui | oui | string(255) | |||
manufacturer_part_number | Numéro de pièce du fabricant | oui | oui | string(255) | |||
attribut_ligne_supplémentaire | oui | oui | |||||
service_type | 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écimale(32,4) | ||||
en attente-annulation | Le BC est-il en attente d'annulation ? Vrai ou Faux | oui | boolean | ||||
lines-count | Nombre de lignes dans le document de modification du BC | oui | nombre entier | ||||
lines-pending-add-count | Nombre de lignes en attente d'ajout dans le document de modification du BC | oui | nombre entier | ||||
lines-pending-delete-count | Nombre de lignes en attente de suppression dans le document de modification du BC | oui | nombre entier |
Exemples d'appels
Créer une demande de modification de BC
Créer une demande de modification de BdC à l'aide de l'API en envoyant un appel d'API authentifié : POST https ://{votre_instance}.coupahost.com/api/purchase_order_changes
Charge utile
Pour PUBLIER, vous devez inclure l'ID de l'en-tête d'origine et tous les éléments que vous souhaitez modifier. Utilisez 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>
201 Réponse positive
Coupa renvoie un nouveau <order-header-change>
avec un ID pour le changement et le bon de commande complet, y compris tous les changements que vous avez spécifiés 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 approuvé
si le changement ne nécessite pas de nouvelles approbations, ou pending_approval
si le changement nécessite de nouvelles approbations.
Mettre à jour une demande de modification de BC
Vous pouvez modifier une demande de modification de BC en attente d'approbation en envoyant un appel d'API authentifié : PUBLIEZ https ://{your_instance}.coupahost.com/api/purchase_order_changes/{id}
où {id}
est l' <id type="integer">
attribut dans la réponse 201. Vous ne pouvez pas modifier une demande de modification de BC déjà approuvée.
Charge utile
Le format de la charge utile est essentiellement le même que celui de la PUBLICATION, sauf que vous devez inclure l'approbateur actuel pour le changement de BC.
<?xml version="1.0" encoding="UTF-8"?>
<order-header-change>
<approver>
<login>Nom de l'approbateur</login>
</approver>
<!-- Requested changes to the PO -->
</order-header-change>
200 réponses
La réponse est la même qu'un MESSAGE : le <order-header-change>
avec l'ID et le bon de commande complet, y compris toutes 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>