Que pouvons-nous vous aider à trouver ? Produits Documentation produit Coupa Documentation technique sur l'intégration API Coupa Core Ressources Ressources de données de référence API des fournisseurs (/fournisseurs)

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és de paiement
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	ConditionsExpédition
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

Remarque

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.

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.