L'API Catalogue de produits permet aux distributeurs et partenaires de Schneider Electric de récupérer les données relatives à l'offre de produits.
Cette nouvelle version a été mise à jour avec ETIM-9.0 (Norme de classification internationale des produits techniques).
Actuellement, l'API a la capacité de :
1- Renvoyer tous les produits qui sont dans le périmètre du distributeur avec d'autres informations nécessaires si nous fournissons supplierid, customerid, supplierid-type, customerid-type dans les paramètres du chemin d'accès.
2- Renvoyer toutes les informations liées à un produit via cette API si nous appelons cette API avec la référence commerciale du produit, supplierid, customerid, supplierid-type, customerid-type dans les paramètres du chemin d'accès.
3- Si nous faisons une demande à l'API avec les paramètres supplierid, customerid, supplierid-type, customerid-type, date-of-reference, change-type, alors elle renverra tous les produits qui sont dans le périmètre du distributeur et dont le moment de création du produit est supérieur à la date fournie dans le paramètre date-of-reference.
L'accès à l'API nécessitera une authentification oAuth, veuillez vous référer aux détails sur le portail.
Disponibilité par pays - Liste des pays pour lesquels nous avons déjà testé les performances, la disponibilité et le temps de réponse de l'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 et Vietnam.
Si votre pays ne figure pas dans la liste, vous pouvez nous contacter directement ou contacter votre Point de Contact Schneider (POC) pour vérifier si votre pays a accès à cet API.
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 |
