Histórico da Página

A venda efetuada no E-Commerce ou MarketPlace, será enviada do TOTVS OMNI e integrado 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.

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: Cadastros de De/Para

Para maiores detalhes técnicos referente à mensagem RetailSales e integração de venda acesse: Guia de uso - RetailSales

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 TOTVS OMNI faz 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.

Conforme a realização dos procedimentos acima ocorre a geração e envio da mensagem de rastreio de pedido(DocumentTraceAblityOrder) ao TOTVS OMNI, com os seguintes status:

• Faturado - Ao gerar o Documento de Saída(NF-e)
• Empacotado - Ao transmitir a NF-e e a mesma ser autorizada pela Sefaz.

O ciclo de integração de venda do tipo entrega se encerra nesse momento.

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

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 TOTVS OMNI faz 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 o pedido filho no modulo Controle de Lojas.

Caso o WOT do TOTVS OMNI esteja habilitado o não é necessário realizar a confirmação o de pedido pendente como indicado abaixo;

Conforme a realização dos procedimentos acima ocorre a geração e envio da mensagem de rastreio do varejo(DocumentTraceAblityOrderRetail) ao TOTVS OMNI, com os seguintes status:

• Empacotado - Ao confirmar pedido pendente. OBS caso o WOT do TOTVS OMNI esteja habilitado o não é necessário realizar a confirmação o de pedido pendente e o status Empacotado é gerado e enviado automaticamente ao TOTVS OMNI.
• Entregue - Ao transmitir o documento fiscal e o mesmo ser autorizado pela Sefaz.

O ciclo de integração de venda do tipo entrega se encerra nesse momento.

Após configurar e entender funcionamento de integração de Vendas, vamos para o próximo passo, Cancelamento de vendas.