API des demandes (/demandes)
Utilisez l'API des demandes pour créer, mettre à jour et interroger des demandes.
L'URL pour accéder aux demandes est : https://{your_instance_name}/api/requisitions
Consultez la rubriqueBonnes pratiques d'intégration pour plus d'informations.
Objets API des demandes
Il s'agit de la liste complète des objets de dépenses 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 des demandes vous permet de :
| Verbe | Chemin d'accès | Action | Description |
|---|---|---|---|
| METTRE | /api/requisitions/:id/add_approver |
ajouter_approbateur | Ajouter manuellement un approbateur pour une demande |
| POSTE |
|
ajouter_au_panier | Ajouter au panier |
| POSTE | /api/requisitions |
créer | Créer une demande à l'état de brouillon, qui devra ensuite être soumise manuellement |
| OBTENIR | /api/requisitions/current_cart |
panier_actuel | Envoyer le panier actuel pour l'utilisateur, s'il n'y a pas de panier actuel, puis créer et envoyer |
| OBTENIR | /api/requisitions |
index | Demander des demandes |
| OBTENIR | /api/requisitions/mine |
mine | /api/requisitions/mine |
| METTRE | /api/requisitions/:id/remove_approval |
supprimer_approbation | Supprimer un approbateur ajouté manuellement |
| METTRE | /api/requisitions/:id/save_for_later |
enregistrer_pour_plus tard | Enregistrer pour plus tard pour les demandes d'API |
| OBTENIR | /api/requisitions/:id |
montrer | Afficher la demande |
| POSTE | /api/requisitions/submit_for_approval |
soumettre_pour_approbation | Créer une demande et essayer de la soumettre pour approbation / action de l'acheteur |
| METTRE | /api/requisitions/:id |
mettre à jour | Actualiser la demande |
| METTRE | /api/requisitions/:id/update_and_submit_for_approval |
mettre_à_jour_et_soumettre_pour_approbation | Mettre à jour la demande et la soumission pour l'approbation |
Éléments
| Élément | Description | Demande d'achat | Unique | Valeur autorisée | Dans | Sortie | Type de données |
|---|---|---|---|---|---|---|---|
| approbations | approbations | oui | Approbation | ||||
| approbateur | approbateur | oui | Utilisateur | ||||
| pièces jointes | pièces jointes | oui | Pièce jointe | ||||
| note d'acheteur | Tous les commentaires ou notes de l'acheteur | oui | oui | texte | |||
| créé à | Créé automatiquement par Coupa au format AAAA-MM-JJFHH:MM:SS+HH:MMZ | oui | datetime | ||||
| créé par | Créateur | oui | oui | oui | Utilisateur | ||
| devise | Code de devise | oui | USD | ||||
| approbation en cours | Approbation en cours/en attente | oui | Approbation | ||||
| département | Département de la demande | oui | oui | Département | |||
| exporté | Indique si une transaction a été exportée | oui | booléen | ||||
| référence-po-externe | Référence de bon de commande externe permettant aux clients de fournir des numéros de bon de commande en remplacement des numéros de bon de commande générés automatiquement. | no | oui | tout | oui | string(255) | |
| prix caché | Masquer le prix du fournisseur. Vrai ou faux | no | no | oui | RequisitionHeader | ||
| id | Identifiant Coupa unique | oui | entier | ||||
| justification | Commentaires de justification de demande | oui | oui | texte | |||
| comptage de lignes | Nombre de lignes d'en-tête | no | no | tout | oui | entier | |
| jalons | Jalons | oui | oui | Achats ::Jalon | |||
| devise mobile | Devise par défaut utilisée | oui | USD | ||||
| total mobile | total | oui | décimal | ||||
| need-by-date | Date de besoin de l'article | oui | oui | datetime | |||
| pcard | Nom de PCard | oui | oui | Carte Pcard | |||
| prix caché | Masquer le prix du fournisseur. Vrai ou faux | oui | booléen | ||||
| id-entrepôt-réception | ID de l'entrepôt de réception | no | no | tout | oui | oui | entier |
| règles récurrentes | Règles récurrentes | oui | |||||
| rejet-commentaire-motif | commentaire du dernier motif de rejet | oui | chaîne | ||||
| titre_demande | Titre facultatif de la demande | oui | oui | string(50) | |||
| demandé par | demandé par | oui | oui | Utilisateur | |||
| demandeur | demandé par | oui | oui | Utilisateur | |||
| lignes de demande | lignes_de_demande | oui | oui | oui | RequisitionLine | ||
| adresse de livraison | Nom de l'adresse | oui | oui | oui | Adresse | ||
| ship-to-attention | Adresse d'expédition - Attention | oui | oui | string(255) | |||
| statut | statut de la transaction | oui | oui | string(50) | |||
| soumis à | soumis_à | oui | datetime | ||||
| étiquettes | oui | oui | [] | ||||
| marquage | oui | oui | [] | ||||
| total | Total en monnaie propre | oui | décimal | ||||
| mis à jour à | Créé automatiquement par Coupa au format AAAA-MM-JJFHH:MM:SS+HH:MMZ | oui | datetime | ||||
| mis à jour par | Utilisateur ayant réalisé la mise à jour | oui | Utilisateur | ||||
| membres_utilisateurs | Membres utilisateurs | oui | Utilisateur | ||||
| membres_groupes_utilisateurs | Membres du groupe utilisateurs | oui | Utilisateur |
Remarque
L'élément create_by provient par défaut de la clé utilisateur de l'API, mais il peut être remplacé par l'API de demande. Contactez le support Coupa pour autoriser l'API de demande à remplacer la valeur de la clé utilisateur API.
Remarque
- Dans une ligne de demande, vous pouvez utiliser une description (format libre) ou un article (article de catalogue). Si un ID d'article est utilisé, l'article doit exister. Le
n'est pas utilisé et est ignoré. - Les devises, les utilisateurs dans le champ demandé par et les fournisseurs doivent être dans le système avec le statut actif.
- Article : Si un fournisseur préféré et un prix sont disponibles pour un article, il sera utilisé sauf si le prix unitaire est spécifié. Si un prix unitaire est spécifié, il remplacera le prix par défaut disponible pour l'article. Bien qu'il ne soit pas erroné de spécifier une description et un article, l'utilisation d'un article affecte à la description de l'article la description de l'article, en ignorant les informations transmises dans le champ de description.
- Valeur par défaut : Sauf indication contraire dans le fichier XML, le système respectera les valeurs par défaut correspondantes dans le système. Tels que les modalités de paiement et d'expédition par défaut du dossier fournisseur.
- Numérotation des lignes : l'API attend que le numéro de ligne s'incrémente de un pour chaque nouveau numéro de ligne. Si vous utilisez le même numéro de ligne, le système ignorera toutes les autres lignes du même numéro.
- Dans le cadre de la mise à jour de la version 30.2.2, nous avons résolu un problème qui vous empêchait de créer une demande pour des utilisateurs en dehors du groupe de contenu du demandeur. Désormais, l'API de demande reflète la fonctionnalité de l'interface utilisateur.
Lorsque l’utilisateur « créé par » est défini via l’API, l’accès au groupe de contenu de cet utilisateur est validé pour la création de la demande. Voir le tableau ci-dessous pour référence :
| allow_create_by_override_via_api | Le créateur a accès via le groupe de contenu | Le demandeur a accès via le groupe de contenu | Autoriser la création via API |
|---|---|---|---|
| VRAI | O | S/O | O |
| VRAI | N | S/O | N |
| FAUX | S/O | S/O | O |
Comportement par défaut des articles fournisseur
Lorsqu'une demande avec des lignes basées sur la quantité est créée via l'API, l'article fournisseur est défini par défaut sur la ligne de demande à l'aide des règles suivantes :
| charge utile API | Résultat attendu |
|---|---|
| Identifiant de l’article | Article fournisseur préféré ou au prix le plus bas |
| ID article, fournisseur | Article fournisseur préféré ou au prix le plus bas correspondant à l'ID fournisseur fourni |
| ID article, fournisseur, numéro de pièce source | Article fournisseur préféré ou au prix le plus bas correspondant à l'ID fournisseur et au numéro de pièce source fournis |
| ID d'article, fournisseur, numéro de pièce source, numéro de pièce auxiliaire du fournisseur | Article fournisseur préféré ou au prix le plus bas correspondant à l'ID fournisseur fourni, au numéro de pièce source et au numéro de pièce fournisseur |
| ID d'article, fournisseur, contrat | Article fournisseur préféré ou au prix le plus bas correspondant à l'ID fournisseur et à l'ID contrat fournis |
| ID article, fournisseur, contrat, prix | Article fournisseur préféré ou au prix le plus bas correspondant à l'ID fournisseur et à l'ID contrat fournis (le prix n'est pas utilisé dans la correspondance) |
| ID d'article, fournisseur, contrat, numéro de pièce source | Article fournisseur préféré ou au prix le plus bas correspondant à l'ID fournisseur, à l'ID contrat et au numéro de pièce source fournis |
| ID d'article, fournisseur, contrat, numéro de pièce d'origine, numéro de pièce auxiliaire du fournisseur | Article fournisseur préféré ou au prix le plus bas correspondant à l'ID fournisseur et à l'ID contrat fournis, au numéro de pièce source et au numéro de pièce fournisseur |
Remarque
- Si l'article fournisseur est associé à un catalogue, le catalogue doit être à l'état "accepté" et la date actuelle doit être comprise entre les dates de début et de fin du catalogue.
- Si l'article fournisseur est associé à un contrat, le contrat doit être à l'état "publié" et la date actuelle doit être comprise entre les dates de début et de fin du catalogue.
Une partie ou la totalité de cette page peut avoir été traduite par machine. Toutes nos excuses pour les inexactitudes.