Web Service Order

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