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. |