Linha Microsiga Protheus

Árvore de páginas

Importante!

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.

Produto

Fluxo

Tipo da Mensagem

Versão MSU

Formato

TOTVS OMNI EnviaAssíncrona2.009JSON
TOTVS ProtheusRecebeAssíncrona2.009

JSON

Dica!

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.


Cadastro do adapter RetailSales

  1. No modulo Configurador (SIFACFG), acesse Ambientes/Schedule/Adapter E.a.i
  2. Clique em incluir e cadastre a rotina responsável pela mensagem Item, como mostra o vídeo abaixo:


Auxilio no preenchimento dos campos

Rotina Protheus

Mensagem

Descrição

Envia

Recebe

Método Protheus

Operação

Condição de envio

Canal de Envio

VersãoAliasRotaFormato
LOJA701RetailSalesVendaNãoSimSíncronoTodas


PAD.APP2.009

SUA_ROTA

JSON


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.


Pré-requisitos e Dicas

Importante!

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


Integrando uma venda do tipo Entrega

Dica!

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.

Finalizando uma venda do tipo Entrega

  1. Após ter a venda integrada e processada pelo GravaBatch, no modulo Faturamento(SIGAFAT), acesse: Atualizações/ Pedidos/ Pedidos de venda.
  2. Posicione no Pedido de venda gerado na integração, gere e transmita o Documento de Saída (NF-e) à Sefaz, como mostra no vídeo abaixo:


Rastreio do Pedido

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.


Integrando uma venda do tipo Retira 

Dica!

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.

Finalizando uma venda do tipo Retira

Importante!

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

  1. Após ter a venda integrada e processada pelo GravaBatch, no modulo Controle de Lojas(SIGALOJA), acesse: Atualizações/ Atendimento/ Venda Assistida
  2. Posicione no Pedido gerado na integração e em seguida realize a confirmação do pedido retira, Outras Ações/ Confirmar Pedido Pendente.
  3. Com a confirmação do pedido efetuada, realize a finalização do mesmo emitindo documento fiscal(NF-e ou SAT). Como mostra o vídeo abaixo:


Rastreio do Pedido

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.

Próximo passo

Vamos lá!

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

  • Sem rótulos