Histórico da Página
...
Informações | ||
---|---|---|
| ||
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 | Envia | Assíncrona | 2. |
009 | JSON | ||
TOTVS Protheus | Recebe | Assíncrona | 2. |
009 | JSON |
Notatip | ||
---|---|---|
|
Pré-requisitos:
Para que o recebimento de cupons seja realizado com sucesso, é necessário que já tenha integrado os seguintes cadastros:
...
title | Como funciona a identificação de TES? |
---|
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
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:
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
Nota | ||
---|---|---|
| ||
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
- 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:
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:
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. |
Dica title Fechamento de Estoque Fique atento aos parâmetros de fechamento de estoque(MV_ULMES e MV_DBLQMOV) pois caso a data de emissão for inferior ou igual a data desses parâmetros a venda não será processada. Ou seja, as mensagens de "RetailSales" deverão ser reprocessadas.
Procedimento para Verificação dos XML:
- Após o recebimento do xml do RetailSales no Protheus, acesse e o Configurador (SIGACFG), Ambiente / Schedule / De-Para de Mensagem Única (APCFG070).
- O sistema Protheus apresenta De-Para das integrações com o Sistema Bematech.
- Localize o campo Alias com conteúdo SL1.
- Verifique através dos campos Valor Externo que é a chave da Bematech e Valor Interno que é a chave Protheus.
Importante!
Todas as integrações que utilizam mensagem única como meio de comunicação, será passível de consulta via rotina de monitoramento das mensagens trocas, bem assim como o seu resultado de integração.
1. No Configurador (SIGACFG) acesse Ambiente / Cadastros / Schedule.
2. Clique na opção EAI.
3. Localize o código da função = RETAILSALES
4. Clique na lupa e selcione a opção : Visualizar mensagem original.
Legendas:
Status das mensagens no EAI Protheus
Atualmente, existem 7 status disponíveis para uma mensagem na fila do EAI Protheus:
Aguardando execução - A mensagem está na fila do EAI e ainda não começou a execução (o seu envio ou o seu processamento pelo adapter);
Executando - A mensagem está sendo enviada para o sistema integrado ou a mensagem recebida está sendo processada;
Finalizada - A mensagem foi processada sem erros ou foi enviada sem erros;
Falhou - Houve um erro no envio da mensagem ou no seu recebimento;
Bloqueado - A mensagem foi bloqueada para execução pelo usuário;
Não entregue - A mensagem não foi enviada para o destino (ou ainda, ocorreu um erro por time-out e não foi possível definir se a mensagem foi recebida e processada);
Recusada - A mensagem foi recusada por conter divergências entre a mensagem e o seu XSD.
Processo de Vendas
1. Realizar uma venda no Live, podendo ser Cupom Fiscal / NFC-e ou SAT;
2 . Após o processo de venda é enviado o XML para o Protheus, através deste você pode identificar o número da venda que será integrada no Protheus, ressaltando que este processo é opcional pois a venda integrada mesmo sem a consulta, o processo de identificação está descrito no início deste documento;
3. No Controle de Lojas (SIGALOJA) acesse Atualizações / Atendimento / Venda Assistida.
4. Observe o cupom de venda integrado:
...