PT | EN | ES

Início  /

Web Service de Produtos (Product)

Atualizado em
05/09/2023

Objetivo

Esta Web Service tem o objetivo de agrupar todos os métodos ligados aos produtos. Os seguintes métodos estão disponíveis:

Lista de produtos (ProductList): listagem com todos os produtos cadastrados para a empresa solicitada.

Lista de produtos alterados (ProductListChanged): listagem de todos os produtos modificados desde a última consulta do usuário.

Remoção da lista de produtos alterados (ProductListChangedDelte): este método atualiza o status de produto consultado para o usuário, retirando da listagem de produtos alterados.

Dados cadastrais (ProductData): retorna todos os dados cadastrais do produto solicitado.

Linhas comerciais (ProductLine): retorna os dados cadastrais das linhas comerciais da empresa. Este cadastro serve de complemento aos dados cadastrais do produto.

Menus do Site Tramontina (ProductMenu): retorna os dados cadastrais dos menus do site Tramontina. Este cadastro serve de complemento aos dados cadastrais do produto.

Estoque (ProductInventory): retorna o estoque da empresa para o produto solicitado.

Onde comprar (WhereToBuy): retorna as lojas que compraram o produto solicitado no período de um ano para os locais solicitados.

Histórico das alterações dos produtos (ProductHistoryChanged): retorna o histórico de todas as alterações e consultas realizadas no produto solicitado.

Preço (ProductPrice): retorna o preço do produto para ser utilizado para o E-Commerce da Tramontina.

 

Índice mostrar

WSDL

Para acessar o WSDL do Web Service, utilize o link abaixo:

https://www.tramontina.net/gas/ws/r/product?WSDA

Acesso

Para acessar o serviço é necessário um usuário e senha de acesso que deverá ser fornecido pela Tramontina.

Método Lista de Produtos (ProductList)

Objetivo

Este método tem o objetivo de retornar uma lista de produtos cadastrados em uma determinada fábrica do grupo Tramontina.

Lista de produtos

O acesso ao serviço é feito pelo método: ProductListRequest.

É necessário informar o User e o Password válidos.

Preencher o parâmetro (Company), conforme descrição abaixo:

ProductListRequest

Company: Código da empresa do Grupo Tramontina, com 2 dígitos, conforme tabela de empresas em anexos. Quando informada uma empresa no exterior, neste parâmetro, serão retornados os produtos comercializados naquela empresa.

Uma lista dos produtos será retornada num XML, conforme exemplo abaixo:

Abaixo explicamos cada campo do XML de retorno, com o respectivo conteúdo:

ProductList

Header

List

Anexos

Tabela de Empresas

Método Lista de Produtos Alterados (ProductListChanged)

Objetivo

Este método tem o objetivo de retornar uma lista dos produtos alterados desde a última atualização do usuário.

Lista de produtos Alterados

O acesso ao serviço é feito pelo método: ProductListChangedRequest.

É necessário informar o User e o Password válidos.

O produto sairá desta lista apenas quando o método “ProductListChangedDeleteRequest” for chamado. Antes de retirar da listagem deve ser consultado os dados com o método “ProductData” e efetuada a atualização dos dados.

Uma lista dos produtos será retornada num XML, conforme exemplo abaixo:

Abaixo explicamos cada campo do XML de retorno, com o respectivo conteúdo:

ProductListChanged

Header

List

Anexos

Tabela da Empresa do Grupo Tramontina

Método Remoção da Lista de Produtos Alterados (ProductListChangedDelete)

Objetivo

Este método tem o objetivo de remover o produto informado da lista de produtos alterados.

Dados Cadastrais

O acesso ao serviço é feito pelo método: ProductListChangedDeleteRequest.

É necessário informar o User e o Password válidos.

Preencher os parâmetros (Company e ProductCode), conforme descrição abaixo:

ProductListChangedDeleteRequest

Company: Código da empresa do Grupo Tramontina que fabrica o produto, com 2 dígitos, conforme tabela de empresas em Anexos.

ProductCode: Código do produto Tramontina com 8 dígitos.

Observação: os produtos listados no método de lista de produtos modificados apenas serão considerados como atualizados, saindo da listagem, após a consulta neste método.

Abaixo explicamos cada campo do XML de retorno, com o respectivo conteúdo:

ProductData

Header

Anexos

Tabela de Empresa do Grupo Tramontina

Método de Lista de Produtos com Preços Alterados (

ProductPriceListChanged)

Objetivo

Este método tem o objetivo de retornar uma lista dos produtos que tiveram os preços alterados desde a última atualização do usuário.

Lista de preços dos produtos Alterados

O acesso ao serviço é feito pelo método: ProductPriceListChangedRequest.

É necessário informar o User, o Password válidos.

Preencher o parâmetro (EcommerceStoreCode), conforme descrição abaixo:

ProductPriceListChangedRequest

EcommerceStoreCode: Código da loja Ecommerce do Grupo Tramontina que vende o produto, com 3 dígitos, conforme tabela de lojas do Ecommerce em Anexos.

O produto sairá desta lista apenas quando o método “ProductPriceListChangedDeleteRequest” for chamado. Antes de retirar da listagem deve ser consultado os dados com o método “ProductPrice” e efetuada a atualização dos dados.

Uma lista dos produtos será retornada num XML, conforme exemplo abaixo:

Abaixo explicamos cada campo do XML de retorno, com o respectivo conteúdo:

ProductPriceListChanged

Header

List

Anexos

Tabela de Empresas do Grupo Tramontina

Tabela de Lojas Ecommerce do Grupo Tramontina

Método Remoção da lista de produtos com preços alterados (ProductPriceListChangedDelete)

Objetivo

Este método tem o objetivo de remover o preço do produto informado da lista de preço de produtos alterados.

Dados Cadastrais

O acesso ao serviço é feito pelo método: ProductPriceListChangedDeleteRequest.

É necessário informar o User e o Password válidos.

Preencher os parâmetros (EcommerceStoreCode, Company e ProductCode), conforme descrição abaixo:

ProductPriceListChangedDeleteRequest

  • EcommerceStoreCode: Código da loja Ecommerce do Grupo Tramontina que vende o produto, com 3 dígitos, conforme tabela de lojas do Ecommerce em Anexos.
  • Company: Código da empresa do Grupo Tramontina que fabrica o produto, com 3 dígitos, conforme tabela de empresas em Anexos.
  • ProductCode: Código do produto Tramontina com 8 dígitos.

Observação: os produtos listados no método de lista de preços de produtos modificados apenas serão considerados como atualizados, saindo da listagem, após a consulta neste método.

Abaixo explicamos cada campo do XML de retorno, com o respectivo conteúdo:

ProductData

Header

Anexos

Tabela de Empresas do Grupo Tramontina

Tabela de Lojas do Ecommerce do Grupo Tramontina

Método Dados Cadastrais (ProductData)

Objetivo

Este método tem o objetivo de retornar os dados cadastrais de um determinado produto.

Dados Cadastrais

O acesso ao serviço é feito pelo método: ProductDataRequest.

É necessário informar o User e o Password válidos.

Preencher os parâmetros (Company e ProductCode), conforme descrição abaixo:

ProductDataRequest

  • Company: Código da empresa do Grupo Tramontina que fabrica o produto, com 2 dígitos, conforme tabela de empresas em Anexos. Quando informado o EAN13 em ProductCode, não existe necessidade de preencher esta informação.
  • ProductCode: Código do produto Tramontina com 8 dígitos ou código EAN13 do produto.

Todos os dados do produto serão retornados num XML, conforme exemplo abaixo:

Abaixo explicamos cada campo do XML de retorno, com o respectivo conteúdo:

ProductData

Header

Product

ProductComposition (Conteúdo do Jogo)

ProductGrouping (Similar)

ProductGroupingInfo (Agrupamento por caracteristica técnica)

ProductAccessories

MenuTree

ProductLike (Produtos Relacionados)

ProductSearch

WebSite

ProductVariation (Variações dos produtos Similares)

ProductEcommerce

ProductCertificacion

ProductVisualization

ProductLinks

AttributesValues

ProductBuyTogether

Anexos

Tabela de Empresas do Grupo Tramontina

Tabela de Lojas Ecommerce do Grupo Tramontina

Tabela de Idiomas

Tabela de Medidas

Tabela de Tipos de arquivos

Tabela de Tipos de acessórios

Tabela Vendável

Tabelas de Tipo de Menu

Tabela Tipos de Visualização

Tabela de Indicadores de Comercialização

Tabela dos Recursos de Imagem

Tabela dos Tipos de Descrição de Produto

Tabela de Tipos de item Compre Junto

Método Linhas Comerciais dos produtos (ProductLine)

Objetivo

Este método tem o objetivo de retornar o cadastro de todas as linhas comerciais dos produtos. Serve como cadastro adicional aos dados do produto, aonde é referenciado no produto a linha comercial que ele pertence.

Linha comercial

O acesso ao serviço é feito pelo método: ProductLineRequest.

É necessário informar o User e o Password válidos.

Um XML será retornado com o cadastro das linhas, conforme exemplo abaixo:

Abaixo explicamos cada campo do XML de retorno, com o respectivo conteúdo:

ProductLine

Header

Line

LineFiles

Anexos

Tabela de Empresas do Grupo Tramontina

Tabela de Idiomas

Tabela de Tipos de arquivos

Método Menus do site (ProductMenu)

Objetivo

Este método tem o objetivo de retornar o cadastro dos menus do site. Serve como cadastro adicional aos dados do produto, aonde é referenciado o menu do site que ele está ligado.

Menus do site

O acesso ao serviço é feito pelo método: ProductMenuRequest.

É necessário informar o User e o Password válidos.

Um XML será retornado com os dados do cadastro, conforme exemplo abaixo:

Abaixo explicamos cada campo do XML de retorno, com o respectivo conteúdo:

ProductMenu

Header

Menu

Observação: Os campos: Company e LineCode, somente estarão preenchidos quando o menu estiver ligado a uma linha comercial. A descrição neste caso deve ser associada a descrição da linha.

Anexos

Tabela de Empresas do Grupo Tramontina

Tabela de Idiomas

Tabela de Tipos do menu

Método Estoque (ProductInventory)

Objetivo

Este método tem o objetivo de retornar a quantidade em estoque do produto na empresa solicitada.

Estoque de produto

O acesso ao serviço é feito pelo método: ProductInventoryRequest.

É necessário informar o User e o Password válidos.

Preencher os parâmetros (Company e ProductCode), conforme descrição abaixo:

ProductInventoryRequest

  • Company: Código da empresa do Grupo Tramontina aonde será verificado o estoque, com 2 dígitos, conforme tabela de empresas em Anexos. Quando informado o EAN13 em ProductCode, não existe necessidade de preencher esta informação.
  • ProductCode: Código do produto Tramontina com 8 dígitos ou código EAN13 do produto.

O estoque do produto na empresa, será retornado num XML, conforme exemplo abaixo:

Abaixo explicamos cada campo do XML de retorno, com o respectivo conteúdo:

ProductInventoryResponse

Header

Inventory

Anexos

Tabela de Empresas do Grupo Tramontina

Método Estoque Lotes (ProductInventoryEcommerceBatch)

Objetivo

Este método tem o objetivo de retornar a quantidade em estoque do produto em lote na empresa solicitada.

Estoque de produto em Lote

O acesso ao serviço é feito pelo método: ProductInventoryEcommerceBatch.

É necessário informar o User, o Password e o EcommerceStoreCode válidos.

O estoque dos produtos na empresa por lote, retornará um XML, conforme exemplo abaixo:

ProductInventoryEcommerceBatchResponse

Header

InventoryEcommerce

Anexos

Tabela de Empresas do Grupo Tramontina

Tabela de Tipos

Método Onde Comprar (WhereToBuy)

Objetivo

Este método tem o objetivo de retornar os endereços das lojas que compraram o produto informado no período de um ano. Serão considerados os parâmetros solicitados para a restrição da busca.

Não serão considerados clientes que estejam classificados como não aparecer no onde comprar.

Onde Comprar

O acesso ao serviço é feito pelo método: WhereToBuyRequest.

É necessário informar o User e o Password válidos.

Preencher os parâmetros (ProductCode e Country), conforme descrição abaixo:

WhereToBuyRequest

  • ProductCode: Código do produto Tramontina com 8 dígitos ou código EAN13 do produto.
  • Country: Código do país onde será efetuada a pesquisa. Vide tabela de países em Anexos
  • State: (Campo de preenchimento opcional) UF a ser considerada na pesquisa ou outra divisão utilizada no país.
  • City: (Campo de preenchimento opcional) Cidade a ser considerada na pesquisa. (Quando o campo não for preenchido não irá retornar os dados para o registro Store, quando o país for Brasil)
  • Neighborhood: (Campo de preenchimento opcional) Bairro a ser considerado na pesquisa.

As lojas que adquiriram o produto no período de um ano, serão retornadas num XML, conforme exemplo abaixo:

Segue abaixo a explicação de cada tag de retorno do XML:

WhereToBuyResponse

Header

WhereToBuy

State

City

Store

Apenas preenchido quando informado valor na tag City do Request. Para o exterior sempre preenchido.

Anexos

Tabela de Paises

Método Histórico das alterações dos produtos (ProductHistoryChanged)

Objetivo

Este método tem o objetivo de retornar o histórico das alterações e consultas realizadas no produto.

Histórico das alterações

O acesso ao serviço é feito pelo método: ProductHistoryChanged.

É necessário informar o User e o Password válidos.

Preencher o parâmetro (ProductCode), conforme descrição abaixo:

ProductHistoryChanged

ProductCode: Código do produto Tramontina com 8 dígitos ou código EAN13 do produto.

As alterações realizadas e as consultas efetuadas, serão retornadas num XML, conforme exemplo abaixo:

Segue abaixo a explicação de cada tag de retorno do XML:

ProductHistoryChangedResponse

Header

History

HistoryList

Método Preço Ecommerce Tramontina (ProductPrice)

Objetivo

Este método tem o objetivo de retornar o preço do produto utilizado no Ecommerce interno da Tramontina. É de uso exclusivo interno da Tramontina para atualização do site Ecommerce da Tramontina.

Preço do produto

O acesso ao serviço é feito pelo método: ProductPriceRequest.

É necessário informar o User e o Password válidos.

Preencher os parâmetros (EcommerceStoreCode e ProductCode), conforme descrição abaixo:

ProductPriceRequest

  • EcommerceStoreCode: Código da loja do Ecommerce do Grupo Tramontina aonde será verificado o preço, com 3 dígitos, conforme tabela de lojas do Ecommerce em Anexos.
  • ProductCode: Código do produto Tramontina com 8 dígitos.

O preço do produto na empresa, será retornado num XML, conforme exemplo abaixo:

Abaixo explicamos cada campo do XML de retorno, com o respectivo conteúdo:

ProductPriceResponse

Header

ProductPrice

Anexos

Tabela de Lojas do Ecommerce do Grupo Tramontina

Método para listar os WebSites (ProductWebSite)

Objetivo

Este método tem o objetivo de retornar o cadastro dos WebSites da Tramontina. Serve como cadastro adicional aos dados do produto, aonde é referenciado o WebSite que ele está ligado.

WebSite

O acesso ao serviço é feito pelo método: ProductWebSite.

É necessário informar o User e o Password válidos.

Um XML será retornado com os dados do cadastro, conforme exemplo abaixo:

Abaixo explicamos cada campo do XML de retorno, com o respectivo conteúdo:

ProductWebSite

Header

WebSites

Método para listar os filtros existentes (ProductFilter)

Objetivo

Este método tem o objetivo de retornar o cadastro dos filtros dos produtos. Serve como cadastro adicional aos dados do produto, aonde é referenciado o filtro que cabe ao produto.

Filtros

O acesso ao serviço é feito pelo método: ProductFilterRequest.

É necessário informar o User e o Password válidos.

Um XML será retornado com os dados do cadastro, conforme exemplo abaixo:

Abaixo explicamos cada campo do XML de retorno, com o respectivo conteúdo:

ProductFilter

Header

Filters

Anexos

Tabela de Idiomas

Método para listar os valores para os filtros (ProductValueFilter)

Objetivo

Este método tem o objetivo de retornar o cadastro dos valores possíveis para o filtro. Serve como cadastro adicional aos dados do produto, aonde é referenciado ao produto e ao filtro.

Valores dos Filtros

O acesso ao serviço é feito pelo método: ProductValueFilterRequest.

É necessário informar o User e o Password válidos.

Um XML será retornado com os dados do cadastro, conforme exemplo abaixo:

Abaixo explicamos cada campo do XML de retorno, com o respectivo conteúdo:

ProductValueFilter

Header

ValuesFilter

Anexos

Tabela de Idiomas

Tabela de Tipos

Método para listar a árvore de navegação dos WebSites (ProductTree)

Objetivo

Este método tem o objetivo de retornar o cadastro dos valores possíveis para a árvore de navegação dos WebSites. Serve como cadastro adicional aos dados do produto, aonde é referenciado ao produto.

Árvore de navegação

O acesso ao serviço é feito pelo método: ProductTreeRequest.

É necessário informar o User e o Password válidos.

Um XML será retornado com os dados do cadastro, conforme exemplo abaixo:

Abaixo explicamos cada campo do XML de retorno, com o respectivo conteúdo:

ProductTree

Header

Trees

Anexos

Tabela de Idiomas

Erros

Tabela de Erros Retornados

Fault

Abaixo segue exemplo de um retorno de erro:

Existe um limite de número de acesso por dia (30.000 acessos). Quando for atingido a marca de 90%, será enviado um e-mail notificando isso e ao atingir 100% um e-mail é enviado avisando e o acesso fica bloqueado naquele dia, retornando apenas no próximo dia. Também temos um limite de acessos por segundo (3 acessos), quando atingido um e-mail é enviado e bloqueado o acesso dentro daquele segundo.

Queremos saber a sua opinião!

Para nos ajudar a melhorar a qualidade do conteúdo de nossa base de conhecimento, responda às questões a seguir:

Documento publicado com sucesso!

O seu documento foi publicado e está pronto para ser acessado.

Marcações de Código

Para inserir um trecho de código, selecione a aba Texto no campo de edição Conteúdo e cole o código dentro do seguinte container:

<pre><code class=language-XXX><strong>COLE O CÓDIGO AQUI</strong></code></pre>

Para definir o tipo de marcação visual, na referência acima, substitua o texto XXX por uma das linguagens disponíveis nesta URL:

https://prismjs.com/index.html#supported-languages

Recurso em desenvolvimento

Este recurso está em desenvolvimento pela equipe técnica e ainda não está disponível para uso.

Caixas de Destaque

Utilize os códigos a seguir para incluir caixas de destaques no texto.

Clique sobre o código para copiá-lo, cole no documento e substitua CONTEÚDO pela informação a ser destacada.

Informação:

[sc name="info"]CONTEÚDO[/sc]

Alerta:

[sc name="alerta"]CONTEÚDO[/sc]

Documento excluído com sucesso!

O seu documento foi excluído e não está mais disponível.

Documento salvo com sucesso!

O seu documento foi salvo e está aguardando ser publicado na fila de revisão:

Conteúdo de acesso restrito

Para acessar este conteúdo, é necessário realizar o seu login ou solicitar permissão de acesso: