O Catálogo de Produtos API fornece aos distribuidores e parceiros da Schneider Electric a capacidade de obter dados de oferta de produtos.
Esta nova versão foi actualizada para ETIM-9.0 (norma de classificação internacional para produtos técnicos).
Atualmente, a API tem a capacidade de:
1- Todos os produtos que estão no âmbito do distribuidor, esses produtos com outras informações necessárias serão devolvidos se fornecermos supplierid, customerid, supplierid-type, customerid-type no path params.
2- Todas as informações relativas a um produto serão devolvidas através desta API se chamarmos esta API com a referência comercial do produto, supplierid, customerid, supplierid-type, customerid-type no path params.
3- Se solicitarmos a API com os parâmetros supplierid, customerid, supplierid-type, customerid-type, date-of-reference, change-type, serão devolvidos todos os produtos que estão no âmbito do distribuidor e se a hora de criação do produto for superior à data indicada no parâmetro date-of-reference.
O acesso à API requer autenticação oAuth, consulte os pormenores no portal.
Disponibilidade por País - Lista de países para os quais já testamos o desempenho, disponibilidade e tempo de resposta do API:
Argentina, Austrália, Áustria, Bélgica, Brasil, Bulgária, Canadá, Chile, Colômbia, Croácia, Dinamarca, Equador, Estônia, Finlândia, França, Alemanha, Grécia, Hungria, Índia, Indonésia, Irlanda, Itália, Cazaquistão, Letônia, Lituânia, México, Holanda, Nova Zelândia, Noruega, Peru, Polônia, Portugal, Romênia, Rússia, Sérvia, Singapura, Eslovênia, Espanha, Suécia, Suíça, Tanzânia, Turquia, Ucrânia, Reino Unido, Estados Unidos e Vietnã.
Se o seu país não consta na lista, você pode entrar em contato diretamente conosco ou com o seu Ponto de Contato da Schneider (POC) para verificar se o seu país tem acesso a este API.
Get Products (Obter Produtos)
| Método | GET |
| BaseURL | https://api.se.com/v2/reference-data/product/product-catalog |
| ResourcePath | /products |
ConsultaParams:
| Parâmetro | Tipo de dados | Obrigatório | Exemplo | Descrição |
| supplierid | corda | Y | 99887766 | Identificador do fornecedor do produto, configurado no sistema mestre de produtos Schneider Electric. |
| supplierid-type | corda | Y | specific | (DUNS) número de identificação se disponível, caso contrário (Específico) Valores disponíveis: específico, duns Valor padrão: específico |
| customerid | corda | Y | 1122334455 | Seu identificador de cliente (Duns se disponível) ou aquele configurado no sistema mestre de produtos Schneider Electric (entregue por seu contato de vendas) |
| customerid-type | corda | Y | specific | (DUNS) número de identificação se disponível, caso contrário (Específico) Valores disponíveis: específico, duns Valor padrão: específico |
| date-of-reference | corda | N | 2021-12-01 | Data de início para quaisquer alterações feitas nos dados do produto, que é usada para consulta de alterações delta. |
| change-type | corda | N | all | Tipo de mudanças de interesse desde a data de referência. Valores disponíveis: novo, atualizar, excluir, todos Valor padrão: todos |
| product-reference | corda | N | QA_4659_DES_22 | Uma ou várias referências de produtos, inseridas como parâmetros de consulta individual. |
| product-identifier | corda | N | commercialReference | Tipo de referência do produto, referência comercial ou gtin. Valores disponíveis: CommercialReference, gtin |
| etim-version | corda | N | ETIM-9.0 | Versão ETIM, onde ETIM é um padrão para classificação dos dados do produto. Valores disponíveis: ETIM-7.0, ETIM-8.0 |
| english-descriptions | boolean | N | true | Se as descrições em inglês estão ou não incluídas, além do idioma local Valor padrão: falso |
| mime-filtering | corda | N | MD36 | Neste filtro, forneça vários códigos descritores de mímica, como MD01,MD04,MD99,etc. Para o filtro mímico solicitado, todos os tipos de documentos associados ao código descritor de mímica serão devolvidos junto com o tipo de documento que são permitidos para os respectivos filtros de dados. - MD01 para Imagem do produto - MD04 para Link de página do produto - MD05 para Declaração REACh - MD14 para Guia do usuário - MD14 para Guia do usuário do sistema - MD14 para Guia de início rápido - MD21 para Folha de instruções - MD22 para Folha de dados do produto - MD36 para Declaração RoHs / Declaração RoHS China - MD99 para CAD / Modelo 3D / Como fazer vídeo / Vídeo promocional / 360 conjunto de imagens / Manual de instruções do produto / Brochura / Catálogo Valores disponíveis: MD01, MD04, MD05, MD14, MD21, MD22, MD36, MD99 |
| data-filtering | corda | N | up-selling | Filtro de dados do produto. Por padrão, todos os dados são devolvidos, mas isto permite que um conjunto especificado de dados seja solicitado. Estes são os valores suportados que podem ser usados para retornar dados filtrados: todos, etim, marketing, logística-vendas, acompanhamento, digital-asset-media, relacionamento, acessórios, obrigatório, seletivo, spare-part, similar, cross-selling, up-selling Definition : Nota: Se utilizar data-filtering = digital-asset-media AND mime-filtering
Se você quiser retornar uma relação específica de Produto, estes valores podem ser usados em vez de relationship : Valores disponíveis: tudo, etim, marketing, logística-vendas, acompanhamento, digital-asset-media, relacionamento, acessórios, obrigatório, seleto, spare-part, similar, cross-selling, up-selling |
