• Dernière modification le: 31 August 2022

API Utilisateurs (/users)

L'API utilisateurs vous permet de créer, mettre à jour ou interroger des utilisateurs.

Aperçu

L'API utilisateurs vous permet de créer, mettre à jour ou interroger des utilisateurs. Cela va des données démographiques de base à la gestion des mots de passe, en passant par la gestion des groupes et des autorisations d'approbation qu'ils peuvent avoir.

L'URL pour accéder aux utilisateurs est : https ://{your_instance_name}/api/users

Voir les meilleures pratiques d'intégration pour plus d'informations.



Actions

L'API Utilisateurs vous permet de :

Verbe Chemin d'accès Action Description
PUBLIER /API/utilisateurs créer Créer l'utilisateur
OBTENIR /API/utilisateurs index Demander aux utilisateurs
OBTENIR /api/users/:id afficher Afficher l'utilisateur
METTRE /api/users/:id mettre à jour Actualiser l'utilisateur

Éléments

Les éléments suivants sont disponibles pour l'API Utilisateurs :

Élément Description Champ obligatoire ? Unique ? Valeur autorisée Api_In Field ? Api_Out Field ? Type de données
groupes de comptes account_groups       oui oui Groupe du compte 
type-de-sécurité-de-compte account_security_type       oui oui nombre entier
actif Une valeur fausse désactivera le compte et ne sera plus disponible pour les utilisateurs. Une vraie valeur la rendra active et disponible pour les utilisateurs.   oui oui boolean
aic-user L'utilisateur dispose-t-il d'une licence de classification AI ? non non

oui/non ;

true/false

oui   boolean
analytics-user L'utilisateur dispose-t-il d'une licence Analytics ?       oui oui boolean
api-user Un utilisateur API est-il un utilisateur ?         oui boolean
approbations-groupes approval_groups       oui oui Groupe d'approbation 
limite-approbation Montant maximum autorisé à approuver.       oui   Limite d'approbation 
authentification-méthode

Quelle méthode d'authentification sera utilisée (coupa_credentials, ldap, saml) ?

Remarque

Les méthodes d'authentification sont sensibles à la casse

  oui oui string(255)
avatar-thumb-url La mise à jour Avitar à l'aide de l'API n'est plus prise en charge pour des raisons de sécurité.       Non oui chaîne
fonction commerciale Fonction de l'entreprise         oui string(255)
business-group-security-type business_group_security_type     0, 1 oui oui nombre entier
peut-dépenser-pour cAN_expense_for         oui Utilisateurs
ccw-user L'utilisateur dispose-t-il d'une licence Contingent Workforce ? non non any oui oui boolean
content-groups Groupes de contenu       oui oui Groupe d'entreprise
contract-approval-limit Limite d'approbation du contrat       oui oui Limite d'approbation 
contract-self-approval-limit Limite d'auto-approbation du contrat       oui oui Limite d'approbation 
contrats-utilisateur L'utilisateur dispose-t-il d'une licence Contrats ?       oui oui boolean
pays de résidence Pays de résidence non non tout oui oui Pays 
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
default-account default_account       oui oui Compte
default-account-type default_account_type       oui oui AccountType
adresse-par-défaut default_address       oui oui Adresse
default-currency Ce n'est pas un champ obligatoire. Mais si une valeur n'est pas fournie et que l'enregistrement utilisateur ne contient pas de devise par défaut déjà définie, la devise par défaut est définie sur la devise de reporting de l'instance. oui oui Devises
default-locale en, tr, ja, bg, cs, es, da, de-AT, de-BE, de-CH, de-LU, de, el, en-AU, en-CA, en-CN, en-GB, en-HK, en-IE, en-IN, en-ME, en-MT, en-MY, en-NZ, en-PH, en-SG, en_TW, en-ZA, es-CO, es-MX, es-PR, et, fi, fr-BE, fr-CA, fr-CH, fr-LU, fr, hr, hu, it-CH, it, ko, lt, lv, mt, nl-BE, nl, non, pl, pt-BR, pt, ro, ru, sk, sl, sr, sv, zh-CN, zh-HK, zh-TW, en-ZZ, en, tr, ja, bg, cs, es, da, de-AT, de-BE, de-CH, de-LU, de, el, en-AU, en-CA, en-GB, en-HK, en-IE, en-IN, en-MT, en-MY, en-NZ, en-SG, en-ZA, es-CO, es-MX, es-PR, et, fi, fr-BE, fr-CA, fr-CH, fr-LU, fr, hr, hu, it-CH, it, ko, lt, lv, mt, nl-BE, nl, non, pl, pt-BR, pt, ro, ru, sk, sl, sr, sv, zh-CN, zh-HK, zh-TW, en-ZZ, es-IC oui oui string(10)
département département       oui oui Département
modifier-facture-sur-entrée-rapide Le bouton Modifier la facture redirige l'utilisateur vers l'écran de saisie rapide       oui oui boolean
adresse électronique courrier électronique oui oui   oui oui string(255)
numéro-employé numéro d'employé   oui   oui oui string(255)
canal-paiement-employé Déterminer comment les dépenses seront payées à l'employé. « ERP » par défaut et peut être basculé vers « CoupaPay » si l'instance le permet.   oui oui string(255)
escalade-seuil Seuil de remontée non non tout oui oui Limite d'approbation 
limite d'approbation des dépenses expense_approval_limit       oui oui Limite d'approbation 
limite-dépense-auto-approbation expense_self_approval_limit       oui oui Limite d'approbation 
dépense-utilisateur L'utilisateur possède-t-il une licence de dépenses ?       oui oui boolean
dépenses-déléguées-à Dépenses déléguées à         oui Utilisateur
prénom prénom oui     oui oui string(40)
nom complet nom complet         oui string(255)
generate-password-and-notify Réglez sur Oui si vous voulez que le système invite l'utilisateur au système et qu'il configure son mot de passe Oui, Non oui   chaîne
iD Identifiant unique Coupa         oui nombre entier
inventaires-organisations inventory_organizations       oui oui Organisation d'inventaire 
utilisateur-inventaire L'utilisateur possède-t-il une licence d'inventaire ?       oui oui boolean
limite d'approbation des factures invoice_approval_limit       oui oui Limite d'approbation 
limite d'auto-approbation des factures Montant maximum autorisé pour les auto-approbations de factures       oui   Limite d'approbation 
lastname nom oui     oui oui string(40)
connexion connexion oui oui   oui oui string(255)
gestionnaire Gestionnaire       oui oui Utilisateur
mention-name Mentionner le nom   oui   oui oui string(255)
mot de passe Mot de passe modifié       oui   chaîne
pcard pcard       oui oui Carte d'achat 
téléphone-mobile téléphone portable       oui oui Numéro de téléphone 
travail-téléphone travail par téléphone       oui oui Numéro de téléphone 
acheteur-utilisateur L'utilisateur possède-t-il une licence d'achat ?       oui oui boolean
réquisition-approbation-limite requisition_approval_limit       oui oui Limite d'approbation 
réquisition-auto-approbation-limite request_self_approval_limit       oui oui Limite d'approbation 
risk-assess-user L'utilisateur dispose-t-il d'une licence Risk Assess ?       oui oui boolean
rôles rôles       oui oui Rôle 
salesforce-enabled salesforce_enabled       oui   boolean
salesforce-id salesforce_id oui     oui oui string(255)
limite d'auto-approbation Montant maximum autorisé pour les auto-approbations       oui   Limite d'approbation 
niveau d'ancienneté Le grade ou la bande de travail de l'employé dans la hiérarchie de votre entreprise.       oui oui string(255)
sourcing-user L'utilisateur dispose-t-il d'une licence d'approvisionnement ?       oui oui boolean
spend-guard-user Indique si l'utilisateur dispose d'une licence Spend Guard non non

oui/non ;

true/false

oui   boolean
sso-identifier ID d'authentification unique de l'utilisateur (ID SSO)       oui oui string(255)
supply-chain-user L'utilisateur possède-t-il une licence pour la chaîne d'approvisionnement ?       oui oui boolean
treasury_user L'utilisateur dispose-t-il d'une licence de trésorerie ?       oui oui boolean
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
groupes d'utilisateurs Groupes d'utilisateurs       oui oui Groupe d'utilisateurs 
travail-confirmation-approbation-limite work_confirmation_approval_limit         oui Limite d'approbation 
travaux-entrepôts working_warehouses       oui oui Entrepôt 
groupes de comptes Groupes de comptes auxquels l'utilisateur devrait avoir accès (pour la sécurité des documents basée sur le compte)       oui oui  
allow-employee-payment-account-creation Permettre à l'utilisateur de créer un compte de paiement de l'employé, quel que soit le canal de paiement de l'employé.     Oui/Non oui oui boolean
allow-user-to-upload-invoice-from-mobile Autoriser l'utilisateur à télécharger les images Facture de Coupa Mobile dans la boîte de réception Facture oui oui boolean
entité-juridique Affecte l'utilisateur à l'entité juridique pour définir les exigences de conservation des reçus de notes de frais.       oui oui  
limite d'auto-approbation des factures Montant maximum autorisé pour les auto-approbations de factures         oui  
travel-user L'utilisateur possède-t-il une licence de voyage ?       oui oui boolean
middlename deuxième prénom       oui oui string(255)
msp_user Drapeau booléen pour dire si l'utilisateur est de type MSP         oui boolean

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.