A venda efetuada no E-Commerce ou MarketPlace, será enviada do TOTVS OMNI e integrad com o TOTVS Protheus através de comunicação de Mensagem Única (RetailSales).

Caso queira verificar os campos que compõem a mensagem, acesse  https://api.totvs.com.br/legado  Clique no Link: Mensagem Padronizada, depois em  Lista de Serviços e busque a mensagem RetailSales.

Antes de realizar a integração de uma reserva de produto, vamos realizar o cadastro do Adapter no modulo Configurador (SIGACFG).

• Mas afinal o que é um Adapter?

O  Adapter é uma rotina responsável pela mensagem (RetailSales) e seu cadastro é necessário para definir algumas informações importantes, como por exemplo, o tipo da mensagem JSON ou XML, se será possível enviar e receber a mensagem ou somente uma dessas opções.

• Importante: Como pré-requisito para o cadastro do Adapter é imprescindível ter o Cadastro de Rota.

Adicionar vídeo

Importante: O campo Condição de envio pode ser preenchido com uma função ou expressão logica, para determinar se o Produto em questão será enviado ou não, no caso do adapter de cliente.

Antes de realizar a integração de venda, é necessário que alguns DE/PARA estejam cadastrados corretamente, para isso acesse: 

Como funciona a identificação de TES?

TES utilizada para gravação do Orçamento:

O Sistema respeita a seguinte ordem para encontrar a TES na RetailSales: 

1º. Efetua a busca da TES Inteligente:

2º. Busca TES Inteligente pela operação(Tag "OperationCode") enviada pela Ciashop = "V";

3º. Caso não encontre, busca a TES Inteligente com a operação = "01" padrão do Sistema ;

4º. Caso não encontre, busca a TES através dos indicadores do Produto(BZ_TS) caso habilitado o parâmetro MV_ARQPROD ;

5º. Caso não use indicadores de Produto(SBZ), busca a TES do cadastro do Produtos(B1_TS);

6º. Caso não tenha informações da TES nos produtos usá a TES conforme parâmetro abaixo:

MV_TESVEND = TES padrão para venda de Produtos

MV_TESSERV = TES padrão para venda de Serviços

B - TES utilizada para gravação do Pedido de Venda:

O Sistema respeita a seguinte ordem para encontrar a TES do Pedido de venda: 

1º. Busca TES pelo parâmetro MV_LJTESPE ;

2º. Caso não encontre,Busca TES Inteligente pela operação"V" Venda Futura;

Geração de título da venda

Como funciona a identificação da Administradora Financeira para a geração de título?

Será utilizado o conteúdo recebido na tag <FinancialManagerCode> da mensagem padronizada, onde primeiro será pesquisado conteúdo  de de/para(XXF) cadastrado para a tabela SAE campo AE_COD.  Caso exista, o valor retornado será pesquisado na tabela SAE para a gravação do campo L4_ADMINIS, caso não exista o registro de de/para, o próprio conteúdo da tag <FinancialManagerCode> será considerado na pesquisa.

Como funciona a integração de uma venda do tipo entrega?

Com a venda realizada no E-Commerce o TOTVS OMNI será encarregado de enviar a reserva dos itens da venda(ItemReserva), o cliente(CustomerVendor). Após o processamento desses registros pelo Protheus será realizado o envio da venda através da mensagem(RetailSales). Após a integração da venda, o serviço GravaBatch é responsável pelo processamento da venda no Protheus, onde será gerado o titulo financeiro e pedido de venda no modulo do Faturamento.