“Où puis-je trouver tous les détails techniques d’un produit ?”
L’API Catalogue de Produits vous donne accès à des données techniques complètes sur les produits Schneider Electric — le tout à partir d’une source unique.
Cette nouvelle version a été mise à jour selon la norme ETIM 10.0 (norme internationale de classification des produits techniques).
L’API Catalogue de Produits vous donne accès à des données techniques complètes sur les produits Schneider Electric — le tout à partir d’une source unique.
Grâce à cette API, vous pouvez:
- Récupérer la liste complète des produits pertinents pour votre activité
- Accéder à des spécifications détaillées telles que les dimensions, le poids, l’emballage, les caractéristiques techniques, la classification ETIM, etc.
- Intégrer des brochures, documents et médias directement dans vos systèmes
C’est la même source de données que celle utilisée sur notre site web — prête à être utilisée dans votre boutique en ligne, ERP, ou même pour créer votre propre configurateur de produits.
Conditions d’Utilisation et Capacités de l’API Catalogue de Produits
L’API Catalogue de Produits permet de récupérer des données produits et des informations associées aux ressources. Trois types de requêtes sont disponibles, chacune nécessitant des paramètres spécifiques pour fonctionner correctement:
- Récupérer tous les produits dans le périmètre de votre distributeur (produits commercialisés) :
Paramètres obligatoires:
- supplierID*
- customerID*
- supplierID-type*
customerID-type*
- Récupérer les informations détaillées d’un produit spécifique
Paramètres obligatoires:
- Référence commerciale du produit
- supplierID*
- customerID*
- supplierID-type*
customerID-type*
- Récupérer le périmètre Delta : produits ajoutés, supprimés ou mis à jour depuis une date spécifique
Paramètres obligatoires:
- supplierID*
- customerID*
- supplierID-type*
- customerID-type*
- date-of-reference*
- change-type
Seuls les produits créés après la date de référence spécifiée seront retournés.
Remarques: Les paramètres supplierID, customerID, supplierID-type et customerID-type seront confirmés lors de l’intégration.
Évaluation de la disponibilité par pays - Catalogue des pays dans lesquels nous avons effectué des tests de performance, de disponibilité et de temps de réponse pour cette API:
Argentine, Australie, Autriche, Belgique, Brésil, Bulgarie, Canada, Chili, Colombie, Croatie, Danemark, Équateur, Estonie, Finlande, France, Allemagne, Grèce, Hongrie, Inde, Indonésie, Irlande, Italie, Kazakhstan, Lettonie, Lituanie, Mexique, Pays-Bas, Nouvelle-Zélande, Norvège, Pérou, Pologne, Portugal, Roumanie, Russie, Serbie, Singapour, Slovénie, Espagne, Suède, Suisse, Tanzanie, Turquie, Ukraine, Royaume-Uni, États-Unis, Vietnam.
Si votre pays ne figure pas dans cette liste, veuillez nous contacter directement ou vous adresser à votre interlocuteur Schneider Electric désigné pour vérifier l’accessibilité de l’API dans votre pay
Authentification requise: L’accès à l’API nécessite une authentification OAuth. Veuillez consulter le portail API pour des instructions détaillées.
Get Products
| Méthode | GET |
| BaseURL | https://api.se.com/v2/reference-data/product/product-catalog |
| ResourcePath | /products |
Paramètres de requête :
| Paramètre | Type de donnée | Obligatoire | Exemple | Description |
| supplierid | chaîne | Y | 99887766 | Identifiant du fournisseur du produit, configuré dans le système de base de données des produits de Schneider Electric. |
| supplierid-type | chaîne | Y | spécifique | Numéro d'identification (DUNS) si disponible, sinon (Specific) Valeurs disponibles : specific, duns Valeur par défaut : specific |
| customerid | chaîne | Y | 1122334455 | Votre identifiant client (Duns si disponible) ou celui configuré dans le système de gestion des produits Schneider Electric (fourni par votre contact commercial). |
| customerid-type | chaîne | Y | spécifique | Numéro d'identification (DUNS) si disponible, sinon (Specific) Valeurs disponibles : specific, duns Valeur par défaut : specific |
| date-of-reference | chaîne | N | 2021-12-01 | Date de début de toutes les modifications apportées aux données du produit, qui est utilisée pour rechercher les modifications delta. |
| change-type | chaîne | N | tout | Type de changements d'intérêt depuis la date de référence. Valeurs disponibles : new, update, delete, all Valeur par défaut : all |
| product-reference | chaîne | N | QA_4659_DES_22 | Une ou plusieurs références de produits, saisies en tant que paramètres de requête individuels. |
| product-identifier | chaîne | N | référence commerciale | Type de référence du produit, référence commerciale ou gtin.
Valeur par défaut : commercialReference |
| etim-version | chaîne | N | ETIM-9.0 | Version ETIM, où ETIM est une norme de classification des données sur les produits. Valeurs disponibles : ETIM-7.0, ETIM-8.0 Valeur par défaut : ETIM-9.0 |
| english-descriptions | boolean | N | vrai | Si des descriptions en anglais sont incluses en plus de la langue locale. Valeur par défaut : false |
| mime-filtering | chaîne | N | MD36 | Dans ce filtre, fournissez plusieurs codes de descripteurs mime tels que MD01, MD04, MD99, etc. Pour le filtre mime demandé, tous les types de documents associés au code descripteur mime seront renvoyés avec le type de document qui est autorisé pour les filtres de données respectifs. - MD01 pour Image du produit - MD04 pour Lien vers la page du produit - MD05 pour Déclaration REACh - MD14 pour Guide de l'utilisateur - MD14 pour Guide de l'utilisateur du système - MD14 pour Guide de démarrage rapide - MD21 pour Feuille d'instructions - MD22 pour Fiche technique du produit - MD36 pour Déclaration RoHs / Déclaration RoHS Chine - MD99 pour CAO / Modèle 3D / Vidéo d'utilisation / Vidéo promotionnelle / Jeu d'images 360 / Environnement du produit / Manuel de fin de vie / Brochure / Catalogue Valeurs disponibles : MD01, MD04, MD05, MD14, MD21, MD22, MD36, MD99 |
| data-filtering | chaîne | N | up-selling | Filtre sur les données du produit. Par défaut, toutes les données sont renvoyées, mais cette option permet de demander un ensemble spécifique de données. Voici les valeurs prises en charge qui peuvent être utilisées pour renvoyer des données filtrées : all, etim, marketing, logistic-sales, followup, digital-asset-media, relationship, accessories, mandatory, select, spare-part, similar, cross-selling, up-selling. Definition : Remarque : si vous utilisez data-filtering = digital-asset-media AND mime-filtering
Si vous voulez renvoyer une relation de produit spécifique, ces valeurs peuvent être utilisées à la place de la relation (relationship) : Valeurs disponibles : all, etim, marketing, logistic-sales, followup, digital-asset-media, relationship, accessories, mandatory, select, spare-part, similar, cross-selling, up-selling Valeur par défaut : all |
