La API del catálogo de productos ofrece a los distribuidores y socios de Schneider Electric la posibilidad de recuperar los datos de la oferta de productos.
Esta nueva versión se ha actualizado a ETIM-9.0 (Norma internacional de clasificación de productos técnicos).
Actualmente, la API tiene la capacidad de:
1- Todos los productos que se encuentran en el ámbito del distribuidor serán devueltos junto con otra información necesaria si proporcionamos supplierid, customerid, supplierid-type, customerid-type en los path params.
2- Toda la información relativa a un producto será devuelta a través de esta API si llamamos a esta api con la referencia comercial del producto, supplierid, customerid, supplierid-type, customerid-type en los path params.
3- Si solicitamos la API con los parámetros supplierid, customerid, supplierid-type, customerid-type, date-of-reference, change-type nos devolverá todos los productos que estén en el ámbito del distribuidor y si la fecha de creación del producto es superior a la fecha indicada en el parámetro date-of-reference.
El acceso a la API requerirá autenticación oAuth, consulte los detalles en el portal.
Disponibilidad por País - Lista de países para los cuales ya hemos evaluado el rendimiento, disponibilidad y tiempo de respuesta del API:
Argentina, Australia, Bélgica, Brasil, Bulgaria, Canadá, Chile, Colombia, Croacia, Dinamarca, Finlandia, Francia, Alemania, India, Italia, México, Países Bajos, Nueva Zelanda, Noruega, Perú, Portugal, Rumanía, Eslovenia, España, Suecia, Suiza, Turquía y Reino Unido.
Si tu país no se encuentra en la lista, puedes contactarnos directamente o comunicarte con tu Punto de Contacto de Schneider (POC) para verificar si tu país tiene acceso a este API.
Obtener productos
| Method | GET |
| BaseURL | https://api.se.com/v2/reference-data/product/product-catalog |
| ResourcePath | /products |
Parámetros de consulta:
| Parámetros | Tipo de datos | Obligatorio | Ejemplo | Descripción |
| supplierid | cadena | S | 99887766 | Identificador del proveedor del producto, configurado en el sistema principal de productos de Schneider Electric. |
| supplierid-type | cadena | S |
específico |
Número de ID (DUNS) si está disponible, otro (specific) Valores disponibles: specific (específico), duns Valor predeterminado: specific (específico) |
| customerid | cadena | S | 1122334455 | Su identificador de cliente (DUNS, si está disponible) o el que esté configurado en el sistema principal de productos de Schneider Electric (ofrecido por su contacto comercial) |
| customerid-type | string | S | específico | Número de ID (DUNS) si está disponible, otro (specific) Valores disponibles: specific (específico), duns Valor predeterminado: specific (específico) |
| date-of-reference | cadena | N | 2021-12-01 | Fecha de inicio de los cambios que se hayan realizado en los datos de productos, que se utiliza para consultar los cambios delta. |
| change-type | cadena | N | all | Tipo de cambios de interés desde la fecha de referencia. Valores disponibles: new (nuevo), update (actualizar), delete (eliminar), all (todo) Valor predeterminado: all (todo) |
| product-reference | cadena | N | QA_4659_DES_22 | Una o varias referencias de productos, introducidas como parámetros individuales de consulta. |
| product-identifier | cadena | N |
commercialReference |
Tipo de referencia de producto, referencia comercial o gtin.
|
| etim-version | cadena | N |
ETIM-9.0 |
Versión ETIM, siendo ETIM una norma para la clasificación de los datos de productos. Valores disponibles: ETIM-7.0, ETIM-8.0 |
| english-descriptions | boolean | N |
true |
Si se incluyen o no descripciones en inglés además del idioma local Valor predeterminado: false (falso) |
| mime-filtering | cadena | N | MD36 |
En este filtro, se facilitan diferentes códigos descriptores MIME, como MD01, MD04, MD99, etc. Con relación al filtro MIME solicitado, se mostrarán todos los tipos de documentos asociados al código descriptor MIME, junto con los tipos de documentos permitidos para los correspondientes filtros de datos. - MD01 para imagen del producto - MD04 para vínculo a la página del producto - MD05 para declaración REACH - MD14 para manual de usuario - MD14 para manual de usuario del sistema - MD14 para guía de inicio rápido - MD21 para hoja de instrucciones - MD22 para ficha técnica del producto - MD36 para declaración RoHs / declaración RoHS de China - MD99 para CAD / modelo 3D / vídeo de instrucciones / vídeo promocional / conjunto de imágenes 360 / huella ambiental del producto / manual de fin del ciclo de vida / folleto / catálogo Valores disponibles: MD01, MD04, MD05, MD14, MD21, MD22, MD36, MD99 |
| data-filtering | cadena | N | up-selling |
Filtro de datos de productos. De manera predeterminada, se mostrarán todos los datos, pero permite solicitar un determinado conjunto de datos. Estos son los datos que se admiten para mostrar datos filtrados: all (todo), etim, marketing, logistic-sales (logística y ventas), followup (seguimiento), digital-asset-media (recursos digitales), relationship (relación), accessories (accesorios), mandatory (obligatorio), select (selección), spare-part (repuesto), similar, cross-selling (venta cruzada), up-selling (venta de productos adicionales) Definición : Nota: Si se utiliza filtrado de datos = digital-asset-media AND mime-filtering
Si desea ver una determinada relación de productos, se pueden utilizar estos valores en lugar de relationship (relación): Valores disponibles: all (todo), etim, marketing, logistic-sales (logística y ventas), followup (seguimiento), digital-asset-media (recursos digitales), relationship (relación), accessories (accesorios), mandatory (obligatorio), select (selección), spare-part (repuesto), similar, cross-selling (venta cruzada), up-selling (venta de productos adicionales) |
