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 | ||
|---|---|---|
| ||
Todos os processos serão realizados no sistema CiaShop e integrados com a retaguarda (SIGALOJA) através de comunicação de Mensagem Única, no Protheus entra como uma venda (SF2/SD2) gravada da mesma forma que a venda realizada diretamente pelo padrão do Protheus. | ||
| Nota | ||
|
Pré-requisitos:
Para que o recebimento de cupons seja realizado com sucesso, é necessário que já tenha integrado os seguintes cadastros:
- Tabela de Preços - PriceListHeaderItem
- Cadastro de Produto - Item
- Código de Barras do Produto - Item
- Cadastro de Estação de Trabalho (PDV) - ListOfStationSalePoint 1
- Operadores de Caixa - CashierOperator
- Cadastro de Clientes;
- Cadastro de Fornecedor (Apenas em casos de recebimento de Notas de Beneficiamento ou Devolução de Compras);
- Cadastro de Adapters / Cadastro De/Para Empresas e Cadastro De/Para dos Caixas Protheus X Live / Cadastro de De/Para CFOP/TES.
- Para processo de NF ( Beneficiamento e Devolução ) é necessário configurar a Condição de Pagamento, com o código 888 para cada filial /loja, pois esse código é utilizado pelo Live e deve estar previamente cadastrado no Protheus.
- Cadastro de TES.TES Inteligente.
Dica 1!
O Sistema respeita a seguinte regra para processo Retailsales, relacionado a TES:
1º efetua a busca da TES Inteligente, caso não exista, efetua a busca nas informações do parâmetro MV_ARQPROD ( podendo ser SB1 ou SBZ ) e por último, busca configuração no parâmetro MV_TESVEND - Venda ou MV_TESSERV - Serviço.
Dica 2!
Para buscas por TES inteligentes também é possível a pesquisa da operação de saída a partir do CFOP. Para isso é necessário relacionar as operações de saída(DHJ_TPOPSA) com a CFOP no Cadastro de MATA002( CFOP x Tp Operação no Módulo SIGACOM);
Certifique-se que realizou a inclusão dos novos campos da tabela DHJ conforme orientação no Link Configuração de Parâmetros e Campos
Dica 3!
Verifique os parâmetros 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.
Condição de Pagamento: Processo NF - Beneficiamento e Devolução:
- No Controle de Lojas, acesse Atualizações/ Cadastros/ Condições de Pagamento.
- Clique em Incluir.
- Informe o código 888 para cada filial /loja, pois esse código é utilizado pelo Live e deve estar previamente cadastrado no Protheus.
- Preencha as informações de acordo com as informações enviadas pela Bematech Live.
- Confira os dados e confirme.
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:
...
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. |
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas