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.
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}
où
{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.