API des fournisseurs (/fournisseurs)
Utilisez l'API des fournisseurs pour créer, mettre à jour, interroger et supprimer les fournisseurs dans Coupa.
Aperçu
Utilisez l'API des fournisseurs pour créer, mettre à jour et interroger les fournisseurs dans Coupa.
L'URL pour accéder aux fournisseurs est : https://<instance>/api/suppliers
Consultez la rubrique Bonnes pratiques d'intégration pour plus d'informations.
Objets API
wiki.tree();
Actions
L'API Fournisseurs vous permet de :
Verbe | Chemin d'accès | Action | Description |
---|---|---|---|
POSTE | /api/suppliers |
créer | Créer un fournisseur |
POSTE | /api/suppliers/create_supplier_user_preferences |
préférences_utilisateur_créateur_fournisseur | Créer des préférences utilisateur fournisseur |
OBTENIR | /api/suppliers |
index | Interroger les fournisseurs |
EFFACER | /api/suppliers/logout_iframe_session |
session_déconnexion_iframe | Session iframe de déconnexion (CSP) |
OBTENIR | /api/suppliers/:id |
montrer | Afficher le fournisseur |
POSTE | /api/suppliers/sync_supplier_user_locale |
sync_supplier_user_locale | Synchroniser les paramètres régionaux utilisateur du fournisseur |
METTRE | /api/suppliers/:id |
mettre à jour | Mettre à jour le fournisseur |
Éléments
Les éléments suivants sont disponibles pour l'API des fournisseurs :
Élément | Description | Champ obligatoire ? | Unique ? | Valeur autorisée | Champ Api_In ? | Champ Api_Out ? | Type de données |
---|---|---|---|---|---|---|---|
numéro-compte | Numéro de compte | oui | oui | chaîne | |||
autoriser-demandes-de-modification | Permet aux fournisseurs de créer des demandes de modification à partir du CSP | oui | oui | booléen | |||
autoriser-l-accès-csp-sans-deux-facteurs | Permet au fournisseur d'accéder aux données du client à partir du CSP sans authentification à deux facteurs. | oui | oui | booléen | |||
autoriser-cxml-facturation | Autoriser la facturation cXML pour le fournisseur | oui | oui | booléen | |||
autoriser-inv-choisir-compte-de-facturation | Autoriser inv choisir le compte de facturation | oui | oui | booléen | |||
autoriser-inv-de-connexion | Si oui, le fournisseur peut créer des factures par rapport à ses bons de commande ou contrats dans le CSP | oui | oui | booléen | |||
autoriser-inv-no-backup-doc-from-connect | Si la réponse est oui, le fournisseur peut créer des factures sans bon de commande ni contrat de support dans le CSP. | oui | oui | booléen | |||
autoriser-lignes-non-avalisées-de-connexion | Si oui, le fournisseur peut créer des factures non avalisées sans bon de commande ni contrat dans le CSP. | oui | oui | booléen | |||
groupes commerciaux | groupes commerciaux | oui | oui | GroupeContenu | |||
acheteur en attente | Bloquer tous les bons de commande pour examen par l'acheteur | oui | oui | booléen | |||
contacts | no | no | tout | oui | Contacts des informations fournisseur | ||
marchandise | Catégorie d'achat par défaut, sélectionnable dans la liste déroulante | oui | oui | ||||
url-société | URL de la société | oui | chaîne | ||||
coupa-connect-secret | Secret de connexion Coupa | oui | chaîne | ||||
coupa-pay-uniquement-financement | Ne payer que les factures financées via Coupa Pay | oui | oui | booléen | |||
créé à | Créé automatiquement par Coupa au format AAAA-MM-JJFHH:MM:SS+HH:MMZ | oui | datetime | ||||
créé par | Créateur | oui | Utilisateur | ||||
domaine cxml |
"De" , notre domaine Domaine cXML |
|
oui | oui | chaîne | ||
cxml-mot-de-passe-http | Mot de passe HTTP cXML | oui | |||||
cxml-http-nom-utilisateur | Nom d'utilisateur HTTP cXML | oui | oui | chaîne | |||
identité-cxml |
"De", notre identité Identité cXML |
|
oui | oui | chaîne | ||
domaine-acheteur-facture-cxml | Domaine acheteur pour la facturation cXML | oui | oui | chaîne | |||
identité-acheteur-facture-cxml | Identité de l'acheteur pour la facturation cXML | oui | oui | chaîne | |||
cxml-secret-facture | Clé secrète pour l'authentification de facturation cXML | oui | oui | chaîne | |||
domaine-fournisseur-facture-cxml | Domaine du fournisseur pour la facturation cXML | oui | oui | chaîne | |||
cxml-facture-identité-fournisseur | Identité du fournisseur pour la facturation cXML | oui | oui | oui | chaîne | ||
protocole cxml |
Protocole de transmission |
|
oui | oui | chaîne | ||
secret cxml | Secret partagé |
|
oui | oui | chaîne | ||
version-cxml-ssl | Version SSL cXML | oui | oui | chaîne | |||
domaine-fournisseur-cxml |
"À", domaine du fournisseur Domaine du fournisseur cXML |
|
oui | oui | chaîne | ||
cxml-identité-fournisseur |
"À", identité du fournisseur Identité du fournisseur cXML |
|
oui | oui | chaîne | ||
cxml-url | URL d'envoi des bons de commande si leur transmission est "cxml" |
|
oui | oui | chaîne | ||
paramètres régionaux par défaut | Paramètres régionaux par défaut pour envoyer des e-mails à ce fournisseur | no | no | tout | oui | string(255) | |
désactiver-cert-verify |
Désactiver la vérification des certificats |
oui | oui | booléen | |||
nom complet | Nom complet | oui | oui | chaîne | |||
duns | Numéro DUNS du fournisseur | oui | oui | chaîne | |||
entreprise | Entreprise | Vrai | oui | oui | Entreprise | ||
factures en attente d'examen de la comptabilité fournisseurs | Empêchez l'approbation des factures de ce fournisseur avant leur examen par la comptabilité fournisseurs. | oui | booléen | ||||
id | ID interne Coupa | oui | entier | ||||
e-mails de facture | Adresses e-mail enregistrées autorisées à envoyer des factures par e-mail à invoices@yourhost.coupahost.com . |
oui | oui | ||||
niveau de rapprochement des factures | Niveau de correspondance des factures | oui | 2, 3, 3-way-direct, aucun | oui | oui | chaîne | |
Nom | Nom du fournisseur | oui | oui | oui | oui | string(100) | |
numéro | Numéro du fournisseur | oui | oui | oui | chaîne | ||
en attente | Fournisseur en attente | oui | oui | booléen | |||
boutique en ligne | Site Web du fournisseur | oui | oui | oui | |||
parent | parent | oui | oui | Fournisseur | |||
mode de paiement | Mode de paiement par défaut, sélectionnable dans la liste déroulante | oui | facture, pcard, invoice_only, pcard_only, virtual_card | oui | oui | string(255) | |
délai de paiement | Modalités de paiement par défaut, sélectionnables dans la liste déroulante | oui | oui | ||||
modalité de paiement id-pour-api | ID des conditions de paiement pour l'API | oui | |||||
méthode de changement de commande |
Méthode de transmission des modifications du bon de commande |
true | false | cxml, xml, courrier électronique, invite, mark_as_sent, buy_online | oui | oui | string(255) |
e-mail de BC | E-mail où les bons de commande sont envoyés si la transmission des bons de commande est "e-mail" |
|
oui | oui | string(255) | ||
méthode po | Méthode de transmission des bons de commande | cxml, xml, courrier électronique, invite, mark_as_sent, buy_online | oui | oui | string(255) | ||
montant-prix | Montant du prix | oui | oui | ||||
adresse principale | Adresse principale | oui | Adresse du fournisseur | oui | oui | Informations relatives à l’adresse fournisseur | |
contact-principal | Adresse électronique du contact principal du fournisseur | oui | oui | oui | |||
adresses de paiement | Adresses de paiement | oui | oui | AdresseDePaiement | |||
types-comptes-restreints | Types de comptes avec restrictions | oui | oui | TypeCompte | |||
pourcentage d'économies | Économies pour l'utilisation de ce fournisseur | oui | oui | décimal | |||
envoyer-des-factures-aux-approbations | Si oui, toutes les factures seront envoyées via les approbations, quel que soit le montant total. | oui | oui | booléen | |||
configurations scf | Configurations finance de la supply chain en liste blanche pour les fournisseurs | oui | oui | chaîne | |||
condition d'expédition | Conditions d'expédition du fournisseur, sélectionnables dans la liste déroulante | oui | oui | ||||
statut | Statut du fournisseur | oui | chaîne | ||||
url-vitrine | Site Web du fournisseur | oui | chaîne | ||||
adresses-fournisseurs | no | no | tout | oui | [] | ||
oui | SiteFournisseur | ||||||
statut du fournisseur | Statut du fournisseur | oui | Brouillon | ||||
code fiscal | Code fiscal du fournisseur | oui | oui | ||||
numéro d'identification fiscale | Numéro DUNS du fournisseur | oui | oui | chaîne | |||
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 | ||||
site Web | Site Web du fournisseur | oui | oui | chaîne | |||
liste blanche-jj | Liste blanche des fournisseurs pour la remise dynamique | false | false | tout | oui | oui | booléen |
Paramètres de jj | Paramètres de remise dynamique pour le fournisseur | oui | oui | chaîne | |||
contacts du support-client | Contient la liste des titulaires de compte fournisseur (contacts du support client) avec leur objectif | oui | oui | [] | |||
diversités | Liste des différences entre fournisseurs. | Référez-vous aux codes de marquage de diversité | oui | oui | [] | ||
id-entité-commerciale | Entité commerciale | oui | oui | entier | |||
modalités de paiement | oui | chaîne | |||||
catégories d'achat préférées | Liste des marchandises préférées | oui | oui | chaîne | |||
étiquettes | Liste des étiquettes | oui | oui | chaîne | |||
marquage | Liste des étiquettes | oui | [] | ||||
type | Type | oui | string(255) | ||||
diversité-catégories | Catégories de diversité | oui | [] | ||||
organisation logistique | Organisation logistique | oui | |||||
niveau_confirmation_commande | Niveau de confirmation de la commande | not_applicable, en-tête, ligne | oui | entier | |||
confirmer_par_heures | Confirmer par (en heures) | , | oui | oui | décimal(10,0) | ||
fournisseur_unique | Indique si le fournisseur est un fournisseur occasionnel | oui | oui | booléen | |||
scope_three_émissions | Indique si le fournisseur suit les émissions de type 3 | oui | oui | booléen | |||
ne_pas_accélérer | N'accélérez pas les délais de paiement. Ce champ correspond à « Ne pas proposer d'accélération des paiements ». | no | oui | booléen |
- Il existe des champs dépendants qui peuvent être interrogés en fonction de la valeur du champ source. Par exemple, si vous effectuez une requête avec po-method=email, vous pouvez ajouter po-email comme critère de requête supplémentaire. Veuillez consulter les champs avec Oui*.
- Pour un ensemble de données volumineux et l'optimisation des performances, limitez toujours vos résultats avec certains critères GET.
- Si vous ne définissez pas de statut pour le fournisseur, le système prend par défaut la valeur Brouillon.
- Si vous ne définissez pas de méthode de paiement par défaut, le système utilise par défaut la facture.
- Pour que l'API reconnaisse les champs personnalisés, les champs doivent être définis en tant qu'API modifiable dans la configuration.
- Si le Coupa Supplier Portal (CSP) est activé dans votre environnement, la case à cocher Autoriser le fournisseur à créer une facture est activée par défaut.
- Lors de la mise à jour de l'adresse principale du fournisseur, vous pouvez mettre à jour chaque attribut de l'objet adresse, mais vous ne pouvez pas associer un ID d'adresse différent à l'enregistrement du fournisseur.
- Lors de la mise à jour du contact principal dans l'enregistrement fournisseur, vous pouvez mettre à jour chaque attribut des informations de contact, mais vous ne pouvez pas attribuer un ID de contact complètement différent à l'enregistrement fournisseur.
Codes marqueurs de diversité
Code de marquage de diversité | Description |
---|---|
MBE | Entreprise détenue par une minorité |
WEB | Entreprise détenue par une femme |
SBE | Petite entreprise |
LGBTBE | Entreprise LGBT |
DOB | Entreprises détenues par des personnes handicapées |
OBNL | Organisme à but non lucratif |
DBE | Entreprise défavorisée |
SDB | Petite entreprise défavorisée |
SDVBE | Entreprise détenue par un ancien combattant invalide de guerre |
WOSB | Petite entreprise détenue par une femme |
VOB | Entreprise détenue par un ancien combattant |
DVBE | Entreprise détenue par un ancien combattant handicapé |
SDVOSB | Petite entreprise détenue par un ancien combattant invalide de guerre |
HUBZone | Zone d'activité historiquement sous-utilisée |
SBA8A | SBA-8(A) |
ACDBE | Entreprise défavorisée de concession aéroportuaire |
ANC | Entreprise d'un natif de l'Alaska |
HBCU | École supérieure ou université historiquement noire / Institution minoritaire |
LSA | Zone de surplus de main-d'œuvre |
VVO | Entreprise détenue par un ancien combattant du Vietnam |
ABILITYONE | Programme Ability One |
EDWOSB | Petite entreprise détenue par des femmes économiquement défavorisées |
NAO | Appartenant aux Amérindiens |
IOB | Entreprise détenue par des autochtones |
AMS | Fournisseur aborigène ou d'une communauté minoritaire |
BOB | Entreprise détenue par des Noirs |
MGOB | Entreprise détenue par un groupe minoritaire |
EMB | Entreprises des minorités ethniques (EMB) |
Une partie ou la totalité de cette page peut avoir été traduite par machine. Toutes nos excuses pour les inexactitudes.