PT | EN | ES

Início  /

Web Service de Orçamento (Budget)

Atualizado em
06/09/2023

Objetivo

Este Web Service tem o objetivo de agrupar todos os métodos ligados aos orçamentos. Os seguintes métodos estão disponíveis:

  • Orçamentos (Budget): Grava o orçamento na Tramontina e devolve o identificador.
  • Pesquisa de clientes (CustomerSearch): Retorna os dados cadastrais do cliente. Indicando se pode ser alterado.
  • Registro do cliente (CustomerRegister): Atualiza os dados cadastrais do cliente, ou cadastra o cliente caso não esteja cadastrado.

WSDL

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

https://www.tramontina.net/gas/ws/r/budget?WSDL

Acesso

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

Método Orçamento (Budget)

Este método tem por objetivo, gravar o orçamento na Tramontina e devolver um identificador. Conforme a localidade o orçamento será direcionado para a unidade que atende a região.
A loja que está fazendo o orçamento precisa estar cadastrada. O Cadastro é feito através do método de CustomerRegister. Para verificar se a loja está cadastrada usar o método CustomerSearch.

Orçamento

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

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

Preencher os parâmetros (TaxIdNumber, IPAddress, ProductCode, Packing e Quantity), conforme descrição abaixo:

BudgetRequest

  • TaxIdNumber: Identificador da empresa (CPF/CNPJ).
  • Note: (Campo de preenchimento opcional) Observação.
  • IPAddress: Endereço IP do servidor onde está hospedado o site.
  • Phone: (Campo de preenchimento opcional) Telefone da pessoa que está fazendo o orçamento ou pessoa de contato.
  • Email: (Campo de preenchimento opcional) E-mail da pessoa que está fazendo o orçamento ou pessoa de contato.
  • Contact: (Campo de preenchimento opcional) Nome da pessoa que está fazendo o orçamento ou pessoa de contato.

Itens (Repetir para cada item que está sendo orçado)

  • ProductCode: Código do produto Tramontina.
  • Packing: Quantidade de peças da caixa (Embalagem).
  • Quantity: Quantidade de caixas.

A confirmação com o identificador é retornada, conforme exemplo abaixo:

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

BudgetResponse

Header

Método Pesquisa de cliente (CustomerSearch)

Objetivo

Este método tem por objetivo, verificar a existência de um cliente e retornar os dados do cadastro. Deve ser utilizado para identificar a necessidade de mudança ou cadastro do cliente antes de fazer o orçamento.

Pesquisa de cliente

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

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

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

CustomerSearchRequest

  • TaxIdNumber: Identificador da empresa (CPF/CNPJ).

A confirmação com os dados do cliente é retornada, conforme exemplo abaixo:

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

CustomerSearchResponse

Header

Customer

Anexos

Tabela de Paises

Método Registro do cliente (CustomerRegister)

Objetivo

Este método tem por objetivo, gravar os dados cadastrais do cliente. Caso o cliente já esteja cadastrado os dados são modificados. Caso não exista cadastrado ele será efetuado. É necessário que este método seja usado antes de efetuar o orçamento. Para identificar a necessidade de alteração dos dados usar o método CustomerSearch.

Registro do cliente

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

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

Preencher os parâmetros (TaxIdNumber, Country, StoreName, Address, AddressNumbers, ZipCode, City, State, Phone e Email), conforme descrição abaixo:

CustomerRegisterRequest

  • TaxIdNumber: Identificador da empresa (CPF/CNPJ).
  • Country: Código do país da loja. Vide tabela de países em Anexos.
  • StoreName: Nome da loja ou razão social.
  • Address: Endereço da loja.
  • AddressNumbers: Número do endereço da loja.
  • AdditionalAddress: (Campo de preenchimento opcional) Complemento do endereço da loja.
  • Neighborhood: (Campo de preenchimento opcional) Bairro do endereço da loja.
  • ZipCode: Código postal do endereço da loja (CEP).
  • City: Cidade do endereço da loja.
  • State: UF do endereço da loja.
  • Phone: Telefone da loja ou da pessoa de contato.
  • Email: Email da loja ou da pessoa de contato.
  • Contact: Nome da pessoa de contato.

A confirmação com o status é retornada, conforme exemplo abaixo:,

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

CustomerRegisterResponse

Header

Anexos

Tabela de Paises

Erros

Tabela de Erros Retornados

Fault

Abaixo segue exemplo de um retorno de erro:

 

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: