Histórico da Página
Informações | ||
---|---|---|
| ||
A venda efetuada no E-Commerce ou MarketPlace, será enviada do TOTVS OMNI e integrad 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 | Envia | Assíncrona | 2.007009 | JSON |
TOTVS Protheus | Recebe | Assíncrona | 2.007009 | JSON |
Dica | ||
---|---|---|
| ||
Antes de realizar a integração de uma reserva de produto, vamos realizar o cadastro do Adapter no modulo Configurador (SIGACFG).
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.
|
Cadastro do adapter RetailSales
- No modulo Configurador (SIFACFG), acesse Ambientes/Schedule/Adapter E.a.i
- Clique em incluir e cadastre a rotina responsável pela mensagem Item, como mostra o vídeo abaixo:
...
title | Assistir o vídeo |
---|
...
Conector de Widget width 600 url https://www.youtube.com/watch?v=T8_U1xZF7cY height 400
Informações | ||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||
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
Dicanote | ||
---|---|---|
| ||
Antes de realizar a integração de venda, é necessário que alguns DE/PARA estejam cadastrados corretamente, para isso acesse: Cadastros de De/Para 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 ; 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; | ||
Nota | ||
| ||
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
- Após ter a venda integrada e processada pelo GravaBatch, no modulo Faturamento(SIGAFAT), acesse: Atualizações/ Pedidos/ Pedidos de venda.
- 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:
...
title | Assistir o vídeo |
---|
...
Conector de Widget | ||||||
---|---|---|---|---|---|---|
|
Dica | ||
---|---|---|
| ||
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:
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
Nota | ||
---|---|---|
| ||
Caso o WOT do TOTVS OMNI esteja habilitado o não é necessário realizar a confirmação o de pedido pendente como indicado abaixo; |
- Após ter a venda integrada e processada pelo GravaBatch, no modulo Controle de Lojas(SIGALOJA), acesse: Atualizações/ Atendimento/ Venda Assistida
- Posicione no Pedido gerado na integração e em seguida realize a confirmação do pedido retira, Outras Ações/ Confirmar Pedido Pendente.
- 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:
...
title | Assistir o vídeo |
---|
...
Conector de Widget | ||||||
---|---|---|---|---|---|---|
|
Dica | ||
---|---|---|
| ||
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:
O ciclo de integração de venda do tipo entrega se encerra nesse momento. |
Próximo passo
Dica | ||
---|---|---|
| ||
Após configurar e entender funcionamento de integração de Vendas, vamos para o próximo passo, Cancelamento de vendas. |