• Dernière modification le: 19 October 2021

Pièces jointes API

Utilisez l'API Pièces jointes pour gérer les pièces jointes sur les objets de référence  et transactionnels Coupa.

Actions

La plupart des ressources Coupa vous permettent d'ajouter des pièces jointes aux ressources de base ainsi que des commentaires sur la ressource. Voir l'API Commentaires pour plus de détails. 

L'API Pièces jointes vous permet d'effectuer les actions suivantes.

Verbe Chemin d'accès Action Description
PUBLIER /api/contracts/:contract_id/attachments créer Créer une pièce jointe
PUBLIER /api/INVOICES/:invoice_id/attachments créer Créer une pièce jointe
PUBLIER /api/expense_reports/:expense_report_id/pièces jointes créer Créer une pièce jointe
PUBLIER /api/purchase_orders/:purchase_order_id/attachments créer Créer une pièce jointe
PUBLIER /api/users/:user_id/attachments créer Créer une pièce jointe
PUBLIER /api/requisitions/:requisition_id/pièces jointes créer Créer une pièce jointe
OBTENIR /api/contracts/:contract_id/attachments index Demander les pièces jointes
OBTENIR /api/inventory_transactions/:id/attachments/:id afficher Afficher la pièce jointe
OBTENIR /api/INVOICES/:invoice_id/attachments index Pièces jointes de la requête
OBTENIR /api/expense_reports/:expense_report_id/pièces jointes index Demander les pièces jointes
OBTENIR /api/purchase_orders/:purchase_order_id/attachments index Pièces jointes de la requête
OBTENIR /api/users/:user_id/attachments index Demander les pièces jointes
OBTENIR /api/requisitions/:requisition_id/pièces jointes index Pièces jointes de la requête
OBTENIR /api/contracts/:contract_id/attachments/:id afficher Afficher la pièce jointe
OBTENIR /api/invoices/:invoice_id/attachments/:id afficher Afficher la pièce jointe
OBTENIR /api/expense_reports/:expense_report_id/attachments/:id afficher Afficher la pièce jointe
OBTENIR /api/purchase_orders/:purchase_order_id/attachments/:id afficher Afficher la pièce jointe
OBTENIR /api/users/:user_id/attachments/:id afficher Afficher la pièce jointe
OBTENIR /api/requisitions/:requisition_id/attachments/:id afficher Afficher la pièce jointe
PATCH /api/contracts/:contract_id/attachments/:id mettre à jour Vous ne pouvez pas mettre à jour des pièces jointes au moyen de l'API
METTRE /api/contracts/:contract_id/attachments/:id mettre à jour Vous ne pouvez pas mettre à jour des pièces jointes au moyen de l'API
PATCH /api/invoices/:invoice_id/attachments/:id mettre à jour Vous ne pouvez pas mettre à jour des pièces jointes au moyen de l'API
METTRE /api/invoices/:invoice_id/attachments/:id mettre à jour Vous ne pouvez pas mettre à jour des pièces jointes au moyen de l'API
PATCH /api/expense_reports/:expense_report_id/attachments/:id mettre à jour Vous ne pouvez pas mettre à jour des pièces jointes au moyen de l'API
METTRE /api/expense_reports/:expense_report_id/attachments/:id mettre à jour Vous ne pouvez pas mettre à jour des pièces jointes au moyen de l'API
PATCH /api/purchase_orders/:purchase_order_id/attachments/:id mettre à jour Vous ne pouvez pas mettre à jour des pièces jointes au moyen de l'API
METTRE /api/purchase_orders/:purchase_order_id/attachments/:id mettre à jour Vous ne pouvez pas mettre à jour des pièces jointes au moyen de l'API
PATCH /api/users/:user_id/attachments/:id mettre à jour Vous ne pouvez pas mettre à jour des pièces jointes au moyen de l'API
METTRE /api/users/:user_id/attachments/:id mettre à jour Vous ne pouvez pas mettre à jour des pièces jointes au moyen de l'API
PATCH /api/requisitions/:requisition_id/attachments/:id mettre à jour Vous ne pouvez pas mettre à jour des pièces jointes au moyen de l'API
METTRE /api/requisitions/:requisition_id/attachments/:id mettre à jour Vous ne pouvez pas mettre à jour des pièces jointes au moyen de l'API
SUPPRIMER /api/requisitions/:requisition_id/attachments/:id     supprimer Supprimer une pièce jointe de l'en-tête de la demande (fonctionne également pour d'autres types de documents, comme les commandes)
SUPPRIMER /api/réquisition_lignes/:réquisition_ligne_id/pièces jointes/:id supprimer Supprimer une pièce jointe de la ligne de la demande (fonctionne également pour d'autres types de documents, comme les commandes)

Éléments

Les éléments suivants sont disponibles pour l'API Pièces jointes :

Élément Description Champ obligatoire ? Unique ? Valeur autorisée Api_In Field ? Api_Out Field ? Type de données
created-at Créé automatiquement par Coupa au format AAAA-MM-JJFHH :MM :SS+HH :MMZ         oui datetime
file-url URL du fichier joint       oui   chaîne
id Identifiant unique Coupa   oui     oui nombre entier
intention intention       oui oui string(40)
lié à lien vers une caractéristique spécifique       oui   string(255)
texte texte       oui   texte
type type oui     oui oui string(255)
mis-à-jour à Créé automatiquement par Coupa au format AAAA-MM-JJFHH :MM :SS+HH :MMZ         oui datetime
uRL uRL       oui   string(255)

Exemple

 L'exemple suivant crée une pièce jointe du fichier, Standard_Terms_Conditions.pdf, pour le contrat 12345.

curl -X POST \

  https ://<INSTANCE>/api/réquisitions/12345/pièces jointes \

  -H "Accepter : application/xml" \

  -H "content-type : multipart/form-data" \

  -H "x-coupa-api-key :<API KEY>" \

  -F "pièce jointe[file]=@/Users/IntegrationAdmin/Contracts/Standard_Terms_Conditions.pdf" \

  -F "pièce jointe[type]=fichier"

  -F "pièce jointe[intention]=Fournisseur"

Articles associés


Différences entre XML et JSON dans Coupa

16 December 2016

API d'exécution d'intégration

24 April 2017

Utilisez cette API pour créer, interroger ou mettre à jour une exécution d'intégration, ainsi que pour mettre à jour le statut.

API de balisage

24 April 2017

Utilisez l'API de balisage pour importer et exporter des balises vers votre système tiers.

API Motif de la contestation

05 August 2017

Une partie ou la totalité de cette page peut avoir été traduite par machine. Toutes nos excuses pour les inexactitudes.