API des comptes (/comptes)
Utilisez l'API des comptes pour créer et gérer des comptes afin d'imiter la structure financière de votre entreprise.
Utilisez l'API des comptes pour créer et gérer des comptes afin d'imiter la structure financière de votre entreprise. Par exemple, si le marketing, l'informatique et les ventes ont leurs propres budgets, vous pouvez créer un compte distinct pour chacun dans Coupa.
L'URL pour accéder aux comptes est : https ://<instance>/api/accounts
Voir les meilleures pratiques d'intégration pour plus d'informations.
Remarque
Les comptes dynamiques sont créés ou mis à jour au moment de l'utilisation en fonction des valeurs de recherche de sauvegarde. Vous géreriez les comptes dynamiques en gérant les valeurs de recherche. Il n'est pas nécessaire de créer un compte en utilisant l'API pour les comptes dynamiques. Si vous le faites, vous risquez de rencontrer un message d'erreur.
Actions
L'API des comptes vous permet de :
| Verbe | Chemin d'accès | Action | Description |
|---|---|---|---|
| PUBLIER | /API/comptes |
créer | Créer un compte |
| OBTENIR | /api/comptes/favoris |
favoris | Favoris |
| OBTENIR | /API/comptes |
index | Demander les comptes |
| OBTENIR | /api/accounts/recent |
récent | Récent |
| OBTENIR | /api/accounts/:id |
afficher | Afficher le compte |
| METTRE | /api/accounts/:id |
mettre à jour | Mettre à jour le compte |
Éléments
Les éléments suivants sont disponibles pour l'API des comptes :
| Élément | Description | Champ obligatoire ? | Unique ? | Valeur autorisée | Api_In Field ? | Api_Out Field ? | Type de données |
|---|---|---|---|---|---|---|---|
| type de compte | account_type | oui | oui | oui | AccountType | ||
| type-de-compte-id | L'ID du type de compte. Ce champ peut ou non s'afficher, selon la configuration de votre compte. | oui | oui | nombre entier | |||
| actif | Une fausse valeur désactive le compte et le rend indisponible pour les utilisateurs. Une vraie valeur la rend active et disponible pour les utilisateurs. | oui | oui | boolean | |||
| code |
Tous les segments concaténés avec un trait d'union ( - ) Il est recommandé de ne pas utiliser de tirets dans le cadre du code de référence externe de la recherche, sinon le système l'interprètera comme un segment séparé |
oui | chaîne | ||||
| 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 | ||||
| iD | Identifiant unique Coupa | oui | nombre entier | ||||
| nom | C'est le surnom du compte. Les utilisateurs peuvent afficher et rechercher dans ce champ uniquement via l'interface utilisateur. | oui | oui | chaîne | |||
| segment-1 | Chaque segment représente le segment du code de compte (par exemple, code : 99-9023-100132, où segment-1 est 99, segment-2 est 9023 et segment-3 est 100132) | oui | oui | string(100) | |||
| segment-10 | Chaque segment représente le segment du code de compte (par exemple, code : 99-9023-100132, où segment-1 est 99, segment-2 est 9023 et segment-3 est 100132) | oui | oui | string(100) | |||
| segment-11 | Chaque segment représente le segment du code de compte (par exemple, code : 99-9023-100132, où segment-1 est 99, segment-2 est 9023 et segment-3 est 100132) | oui | oui | string(100) | |||
| segment-12 | Chaque segment représente le segment du code de compte (par exemple, code : 99-9023-100132, où segment-1 est 99, segment-2 est 9023 et segment-3 est 100132) | oui | oui | string(100) | |||
| segment-13 | Chaque segment représente le segment du code de compte (par exemple, code : 99-9023-100132, où segment-1 est 99, segment-2 est 9023 et segment-3 est 100132) | oui | oui | string(100) | |||
| segment-14 | Chaque segment représente le segment du code de compte (par exemple, code : 99-9023-100132, où segment-1 est 99, segment-2 est 9023 et segment-3 est 100132) | oui | oui | string(100) | |||
| segment-15 | Chaque segment représente le segment du code de compte (par exemple, code : 99-9023-100132, où segment-1 est 99, segment-2 est 9023 et segment-3 est 100132) | oui | oui | string(100) | |||
| segment-16 | Chaque segment représente le segment du code de compte (par exemple, code : 99-9023-100132, où segment-1 est 99, segment-2 est 9023 et segment-3 est 100132) | oui | oui | string(100) | |||
| segment-17 | Chaque segment représente le segment du code de compte (par exemple, code : 99-9023-100132, où segment-1 est 99, segment-2 est 9023 et segment-3 est 100132) | oui | oui | string(100) | |||
| segment-18 | Chaque segment représente le segment du code de compte (par exemple, code : 99-9023-100132, où segment-1 est 99, segment-2 est 9023 et segment-3 est 100132) | oui | oui | string(100) | |||
| segment-19 | Chaque segment représente le segment du code de compte (par exemple, code : 99-9023-100132, où segment-1 est 99, segment-2 est 9023 et segment-3 est 100132) | oui | oui | string(100) | |||
| segment-2 | Chaque segment représente le segment du code de compte (par exemple, code : 99-9023-100132, où segment-1 est 99, segment-2 est 9023 et segment-3 est 100132) | oui | oui | string(100) | |||
| segment-20 | Chaque segment représente le segment du code de compte (par exemple, code : 99-9023-100132, où segment-1 est 99, segment-2 est 9023 et segment-3 est 100132) | oui | oui | string(100) | |||
| segment-3 | Chaque segment représente le segment du code de compte (par exemple, code : 99-9023-100132, où segment-1 est 99, segment-2 est 9023 et segment-3 est 100132) | oui | oui | string(100) | |||
| segment-4 | Chaque segment représente le segment du code de compte (par exemple, code : 99-9023-100132, où segment-1 est 99, segment-2 est 9023 et segment-3 est 100132) | oui | oui | string(100) | |||
| segment-5 | Chaque segment représente le segment du code de compte (par exemple, code : 99-9023-100132, où segment-1 est 99, segment-2 est 9023 et segment-3 est 100132) | oui | oui | string(100) | |||
| segment-6 | Chaque segment représente le segment du code de compte (par exemple, code : 99-9023-100132, où segment-1 est 99, segment-2 est 9023 et segment-3 est 100132) | oui | oui | string(100) | |||
| segment-7 | Chaque segment représente le segment du code de compte (par exemple, code : 99-9023-100132, où segment-1 est 99, segment-2 est 9023 et segment-3 est 100132) | oui | oui | string(100) | |||
| segment-8 | Chaque segment représente le segment du code de compte (par exemple, code : 99-9023-100132, où segment-1 est 99, segment-2 est 9023 et segment-3 est 100132) | oui | oui | string(100) | |||
| segment-9 | Chaque segment représente le segment du code de compte (par exemple, code : 99-9023-100132, où segment-1 est 99, segment-2 est 9023 et segment-3 est 100132) | oui | oui | string(100) | |||
| 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 |
Remarque
- Lorsque vous traitez avec de grands ensembles de données de comptes, limitez toujours votre GET avec certains critères.
- Le type de compte (plan comptable) doit déjà exister dans le système ; vous ne pouvez pas créer de type de compte à l'aide de l'API.
- Le type de compte (plan comptable) doit déjà exister dans le système ; vous ne pouvez pas créer de type de compte à l'aide de l'API.