Product Catalog V2 | Partner APIs

“¿Dónde puedo encontrar todos los detalles técnicos de un producto?”

La API del Catálogo de Productos te da acceso a datos técnicos completos de los productos de Schneider Electric, todo desde una única fuente.

Esta nueva versión ha sido actualizada a ETIM 10.0 (el estándar internacional de clasificación para productos técnicos).

DESCARGAR ESPECIFICACIÓN

La API del Catálogo de Productos te da acceso a datos técnicos completos de los productos de Schneider Electric, todo desde una única fuente.

Con esta API puedes:

Recuperar la lista completa de productos relevantes para tu negocio
Acceder a especificaciones detalladas como dimensiones, peso, embalaje, características técnicas, clasificación ETIM y más
Integrar folletos, documentos y contenido multimedia directamente en tus sistemas

Es la misma fuente de datos que usamos en nuestro sitio web, lista para que la utilices en tu e-commerce, ERP o incluso para construir tu propio configurador de productos.

Condiciones de uso y capacidades de la API del Catálogo de Productos

La API permite recuperar datos de productos e información asociada a sus recursos.Hay tres tipos de solicitudes disponibles, cada una con parámetros específicos obligatorios:

Recuperar todos los productos dentro del alcance de tu distribuidor (productos comercializados):

Parámetros obligatorios:

supplierID*
customerID*
supplierID-type*
customerID-type*

Recuperar información detallada de un producto específico

Parámetros obligatorios:

Referencia comercial del producto
supplierID*
customerID*
supplierID-type*
customerID-type*

Recuperar el alcance Delta: productos añadidos, eliminados o actualizados desde una fecha específica

Parámetros obligatorios:

supplierID*
customerID*
supplierID-type*
customerID-type*
date-of-reference
change-type

Solo se devolverán productos creados después de la fecha indicada en date-of-reference.

Notas: Los valores de supplierID, customerID, supplierID-type y customerID-type se confirmarán durante el proceso de onboarding.

Requisito de Autenticación: El acceso a la API requiere autenticación OAuth. Consulta el portal de APIs para obtener instrucciones detalladas.

Evaluación de disponibilidad por país - Catálogo de países donde se ha realizado pruebas de rendimiento, disponibilidad y tiempos de respuesta para esta API:

Argentina, Australia, Austria, Bélgica, Brasil, Bulgaria, Canadá, Chile, Colombia, Croacia, Dinamarca, Ecuador, Estonia, Finlandia, Francia, Alemania, Grecia, Hungría, India, Indonesia, Irlanda, Italia, Kazajistán, Letonia, Lituania, México, Países Bajos, Nueva Zelanda, Noruega, Perú, Polonia, Portugal, Rumanía, Rusia, Serbia, Singapur, Eslovenia, España, Suecia, Suiza, Tanzania, Turquía, Ucrania, Reino Unido, Estados Unidos, Vietnam.

Si tu país no está incluido en la lista, por favor contáctanos directamente o comunícate con tu Punto de Contacto (POC) designado en Schneider para consultar la accesibilidad de la API en tu región.

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. Valores disponibles: commercialReference, gtin Valor predeterminado: commercialReference
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 Valor predeterminado: ETIM-9.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 : - all (todo): todos los datos relacionados con el producto (se trata de la opción predeterminada) - etim: solo datos de la clasificación, las funciones y la valoración ETIM - marketing: solo datos de marketing, como descripciones, palabras clave y recursos - logistic-sales (logística y ventas): datos de las unidades de embalaje e información sobre pedidos y precios - followup (seguimiento): solo datos de sustitución de productos - relationship (relación): la relación de todos los productos (salvo la sustitución obsoleta) - digital-asset-media (recursos digitales): solo la parte MIME de los recursos digitales (vídeo de instrucciones, imagen del producto, imagen del producto en situaciones de la vida real, vídeo promocional) Nota: Si se utiliza filtrado de datos = digital-asset-media AND mime-filtering Luego, la BSL devolverá todos los códigos MD para digital-asset-media (How To Video, Image of product, Image of product in real life situation, Promotional video) + los códigos MD no considerados por digital-asset-media. Si desea ver una determinada relación de productos, se pueden utilizar estos valores en lugar de relationship (relación): - accessories (accesorios): accesorios opcionales de productos - mandatory (obligatorio): productos adicionales obligatorios - select (selección): productos adicionales seleccionables que no se pueden pedir solos - spare-part (repuesto): recambios - similar: producto alternativo de Schneider Electric - cross-selling (venta cruzada): artículos relacionados o complementarios - up-selling (venta de productos adicionales): producto comparable de alta calidad 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) Valor predeterminado: all (todo)