PT | EN | ES

Início  /

Web Service Order

Atualizado em
01/04/2024

Objetivo

Esta Web Service tem o objetivo de enviar o pedido para registro na empresa do Grupo Tramontina. Juntamente com os dados do pedido são enviados os dados do cliente, sendo que todas as informações necessárias para a emissão de nota fiscal são compostas no método.

Pedido (Order): recebe os dados do pedido e do cliente e devolve um status da operação, bem como um ID para identificar a informação.

Caso o cliente já esteja cadastrado, os dados são modificados. Caso não exista cadastrado ele será efetuado. Também serão gravados os dados do pedido. O retorno será dado em um status confirmando ou em um erro. No caso de confirmado será retornado o ID Tramontina do pedido, para poder ser usado como método de acesso à informação.

Índice mostrar

WSDL

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

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

Registro do pedido/cliente

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

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

Preencher os parâmetros do cliente (TaxIdNumber, StateRegistration, Country, Name, Address, AddressNumbers, AdditionalAddress, Neighborhood, ZipCode, City, State, Phone, Email, BirthDate, Contact e DeliveryNote).

Preencher os parâmetros do pedido (EcommerceStoreCode, DistributionCenterCode, IdOrder, LocalSaleOrderID, IssueDate, PaymentCode, ShippingCompanyCode, BankCode, TotalAmount, InterestTotalAmount, SellerSaleDifferenceTotal, Delivery, Freight, CalculatedFreight, OrderType, LocalSale, HUBCode e Note).

Preencher os parâmetros dos canais de venda (MediaChannelValue).

Preencher os parâmetros das promoções de venda (PromotionValue).

Preencher os parâmetros do pagamento (PaymentType, TotalAmount, CreditCardCompany, CreditCardOperator, NumberPayments, NSU, TID, AuthID, AuthorizedDate, e OurNumber), conforme descrição abaixo.

Preencher os parâmetros dos itens (Company, ProductCode, Packing, Quantity, PackingPrice, PackingNetPrice e Subsidized), conforme descrição abaixo.

Preencher os parâmetros da customização (RowValue, Size e Fonte), conforme descrição abaixo.

OrderRequest

TaxIdNumber: Identificador da empresa (CPF/CNPJ). CNPJ para pessoa jurídica ou CPF para pessoa física (18 caracteres)
StateRegistration: Inscrição estadual da empresa. Caso seja pessoa física ou jurídica isenta, não deve ser preenchido (14 caracteres)
Country: Código do país do cliente. Vide tabela de países em Anexos. (4 caracteres)
Name: Nome do cliente ou razão social da loja. (45 caracteres)
Address: Endereço entrega e faturamento. (45 caracteres)
AddressNumbers: Número do endereço. (5 caracteres)
AdditionalAddress: (Campo de preenchimento opcional) Complemento do endereço. (15 caracteres)
Neighborhood: (Campo de preenchimento opcional) Bairro do endereço. (20 caracteres)
ZipCode: Código postal do endereço (CEP). (9 caracteres)
City: Cidade do endereço. (20 caracteres)
State: UF do endereço. (2 caracteres)
Phone: Telefone da loja ou da pessoa de contato. (20 caracteres)
Email: Email da loja ou da pessoa de contato. (60 caracteres)
BirthDate: Data de nascimento do cliente.
Contact: Nome da pessoa de contato. (30 caracteres)
DeliveryNote: Observações de entrega do cliente. (75 caracteres)
EcommerceStoreCode: Código da Loja de Ecommerce do Grupo Tramontina onde o pedido foi emitido, com 3 dígitos, conforme tabela de Lojas Ecommerce em Anexos.
DistributionCenterCode: Código da empresa do Grupo Tramontina onde o pedido será gravado e que será responsável pelo faturamento, com 3 dígitos, conforme tabela de unidades de distribuição em Anexos.
IdOrder: Código identificador único do pedido. (50 caracteres)
LocalSaleOrderID: Código identificador único do pedido do local de venda. Usado para o Market-place. Quando o local é na Tramontina este campo não é preenchido. (50 caracteres)
IssueDate: Data de emissão do pedido.
PaymentCode: Código do prazo de pagamento, conforme tabela de prazos em Anexos.
ShippingCompanyCode: Código da transportadora que efetuará a entrega, conforme tabela de transportadoras em Anexos.
BankCode: Código do banco, conforme tabela de bancos em Anexos.
TotalAmount: Valor total líquido do pedido. Somatório de todos os item, considerando o valor unitário do produto multiplicado pela quantidade de peças.
InterestTotalAmount: Valor total líquido do pedido com juros. Somatório de todos os item, considerando o valor unitário do produto multiplicado pela quantidade de peças acrescido do juros cobrado.
SellerSaleDifferenceTotal: Valor total da diferença entre o valor que deveria ser cobrado e o valor efetivo da venda no Seller. No caso de desconto o valor será negativo e no caso de acréscimo o valor será positivo. Quando o valor for igual será zero.
Delivery: Quantidade de dias para a entrega.
Freight: Valor do frete pago.
CalculatedFreight: Valor do frete calculado.
OrderType: Tipo do pedido, conforme tabela de tipos em Anexos.
LocalSale: Local da venda, conforme tabela de locais em Anexos.
HUBCode: Código da empresa que faz a intermediação dos Pedidos, dos Sellers com o ERP, conforme tabela de HUB em Anexos.
Note – Observações do pedido. (75 caracteres)
MediaChannel: Registro dos Canais de mídia de publicidade usado, conforme atributos abaixo em MediaChannel.
Promotion: Registro das promoções na plataforma de venda, conforme atributos abaixo em Promotion.
Payment: Registro dos pagamentos, conforme atributos abaixo em Payment.
AccountsReceivableSeller: Registro do contas a receber do Seller, conforme atributos abaixo em AccountsReceivableSeller.
Product: Registro dos produtos, conforme atributos abaixo em Product.,

MediaChannel

MediaChannelValue: Descrição dos canais de venda do pedido. (100 caracteres)

Promotion

PromotionValue: Descrição das promoções do pedido. (100 caracteres)

Payment

PaymentType: Código do tipo de pagamento efetuado, conforme tabela de tipos de pagamento em Anexos.
TotalAmount: Valor total líquido do pagamento.
CreditCardCompany: Código da empresa do cartão de crédito/débito/boleto, conforme tabela de códigos da empresa do cartão crédito/débito/boleto em Anexos.
CreditCardOperator: Código da operadora do cartão de crédito/débito/boleto, conforme tabela de códigos da operadora do cartão crédito/débito/boleto em Anexos.
NumberPayments: Número de parcelas do pagamento. Boleto deve ser informado como uma parcela.
NSU: Número sequencial único (NSU).
TID: Código da transação (TID).
AuthID: Código da autorização.
AuthorizedDate: Data/hora da autorização.
OurNumber: Número do boleto bancário.

AccountsReceivableSeller

PaymentType: Código do tipo de pagamento efetuado, conforme tabela de tipos de pagamento em Anexos.
TotalAmount: Valor total líquido do pagamento.
TotalReceivable: Valor previsto de repasse.
TotalComission: Valor previsto de comissão.
NumberPayments: Número de parcelas do pagamento.
Installment: Registro das parcelas dos repasses, conforme atributos abaixo em Installment.

Installment

Parcel: Sequência da parcela de repasse.
ParcelReceivableValue: Valor de repasse da parcela.
ParcelComissionValue: Valor da comissão da parcela.
PrimaryDate: Data prevista do repasse da parcela.
ForecastDate: Data prevista do repasse da parcela recalculada.

Product

Company: Código da empresa 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.
Packing: Quantidade de peças da caixa (Embalagem).
Quantity: Quantidade de caixas.
PackingPrice: Preço de cada embalagem do produto. Não deve ser multiplicado pela quantidade, pois deve ser o preço da embalagem.
PackingNetPrice: Preço líquido de cada embalagem do produto. Não deve ser multiplicado pela quantidade, pois deve ser o preço da embalagem com os descontos.
Subsidized: Indica se o produto é Bonificado. Valores possíveis: Y = yes/sim ou N = no/não.
Customization: Registro da customização, conforme atributos abaixo em Customization.

Customization

ProductSequence: Sequência do produto. Indica a sequência de customizações diferentes para um mesmo produto. Quando um mesmo produto possui customizações diferentes. Quando for apenas um ou igual sempre será 1.
Quantity: Quantidade de peças a serem produzidas com esta customização.
Font – Código da fonte da letra, conforme tabela de fontes em Anexos.
FileContents: Imagem em base64 da personalização do produto.
CustomizationDetails: Registo dos detalhes da customização, conforme atributos abaixo em CustomizationDetails.

CustomizationDetails

RowSequence: Sequência da linha. Para identificar cada linha da customização. Pode ter uma linha ou duas linhas.
RowValue: Texto da linha a ser personalizado.
Size: Código do tamanho da letra, conforme tabela de tamanhos em Anexos.

A conformação com o status e o ID é retornada, conforme exemplo abaixo:

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

OrderResponse

Header

Tabela de Paises

Tabela de Lojas de Ecommerce Tramontina

Tabela de Unidades de Distribuição

 

Tabela de Empresas do Grupo Tramontina

Tabela de Tipos de Pagamento

Tabela das empresas de cartão de crédito/débito/boleto

Tabela de Prazos E-commerce Móveis

Tabela de Prazos E-commerce Brasil

Tabela de Prazos E-commerce Menu

Tabela de Prazos E-commerce Chile

Tabela de Prazos E-commerce Colômbia

Tabela de Prazos E-commerce Peru

Tabela de Prazos E-commerce México

Tabela de Prazos E-commerce Dubai

Tabela de Bancos E-commerce Móveis

Tabela de Bancos E-commerce Brasil

Tabela de Bancos E-commerce Menu

Tabela de Bancos E-commerce Chile

Tabela de Bancos E-commerce Colômbia

Tabela de Bancos E-commerce Peru

Tabela de Bancos E-commerce México

Tabela de Bancos E-commerce Dubai

Tabela de Transportes E-commerce Móveis

Tabela de Transportes E-commerce Brasil

Tabela de Transportes E-commerce Chile

Tabela de Transportes E-commerce Colômbia

Tabela de Transportes E-commerce Menu

Tabela de Transportes E-commerce Peru

Tabela de Transportes E-commerce México

Tabela de Transportes E-commerce Dubai

Tabela de Representantes

Tabela de Tipos

Tabela de Locais (Marketplace)

Tabela de Tamanhos

Tabela de Fontes

Tabela de HUB

Tabela de Códigos da Operadora

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: