Histórico da Página
O Mozart na integração Protheus & Gemco, faz o gerenciamento de entregas e recebimentos de mensagens padronizadas(xml) assíncronas com o TotvsEAI.
Obs. : Para mais detalhes sobre comunicação assíncrona acesse Aqui
- Fluxograma
- Funcionalidades
Na tela inicial do Mozart no canto superior direito encontrasse o menu. Imagem abaixo com o icone em destaque abre a tela inicial.
Na tela inicial do Mozart como mostra a imagem abaixo, as Operações previamente cadastradas são disponibilizadas em caixinhas que apresentam os status destas integrações como por exemplo : Quantidade de arquivos em processamento, quantidade reprocessados e status de erro caso haja.
Obs.: Operações são cadastros de funções que serão integradas como por exemplo "GEMCO PARA PROTHEUS - VENDEDOR" isso significa que o sistema Gemco enviará dados de cadastro ou alteração de um vendedor para o Mozart que por sua vez enviará esses dados para o TotvsEAI.
Na mesma tela inical, algumas caixinhas de operações mostrão o status mais em específico das integrações como por exemplo : resultado da última integração, erro ocorrido e horário da última execução da operação.
Os próximos dois icones do menu, não estão sendo utilizados potencialmente no Mozart configurado para integração via mensagem padronizada, eles apenas mostrão data atual do servidor e a data de inicialização do mozart.
O próximo icone do menu chamado de Dashboard é utilizado para apresentar todos os registros de integrações e seus status.
Reserva terá como mandatário o sistema parceiro (exemplo : Gemco), o sistema parceiro deve gerar uma mensagem padronizada de ItemReserve e enviar para o Totvs EAI do Protheus.
...
No Gemco para enviar uma reserva de produtos para o Protheus basta apenas fazer um pedido de venda de qualquer tipo (Retira, Entrega ou Retira Posterior). Abaixo segue passo a passo do fluxo de geração de reserva.
Assim que o pedido de venda é gerado no gemco, o status da integração pode ser acompanhado pelo Mozart EAI.
As imagens abaixo, mostram os passo status que a reserva pode receber em um cenário de dados ok.
...
Significado dos status dos processos(Status de integração) do Mozart :
...
Processado : Significa que o arquivo foi processado com sucesso, como por exemplo, enviou uma reserva para o Protheus e o mesmo retorno uma mensagem de sucesso.
AguardandoCallback : Significa que o Mozart EAI enviou uma mensagem de ItemReserve contendo os dados do pedido para ser reservado as mercadorias pelo Protheus e está aguardando retorno.
Erro : Significa que receberá o log de erro da integração especifica, tanto ao tentar enviar quanto AguardoCallback com retorno de erro.
Assim que a reserva é feita no Protheus, o mesmo envia uma mensagem de estoque atualizando os estoque dos produtos da reserva no Gemco
Observação: Quando o pedido de venda que não passou pelo caixa é cancelado o Adapter Reservar envia uma ItemReserve de cancelamento o Protheus processa o cancelamento e também envia uma mensagem de Estoque com as devidas atualizações para os produtos canceladas na reserva.
2. Detalhes da Integração do sistema Protheus
Os Pedidos de Venda serão incluídos no sistema Gemco, será enviada uma mensagem de ItemReserve gerando uma reserva para os produtos no sistema Protheus através de comunicação de Mensagem Única.
Para esta integração é necessário todos os atributos de chaveamento no XML a serem importados para o Protheus quanto à funcionalidade de geração de reserva, tabela "SC0".
Em outro momento, será enviado pelo sistema Gemco uma integração de venda RetailSales para o sistema Protheus através de comunicação de Mensagem Única, nesta mensagem, deverá ser informado na Lista de Produtos a informação da reserva relacionada a este, reserva que foi incluída pela integração ItemReserve, poderão ser utilizadas as tags: ItemReserveInternalId (InternalId da reserva integrada pela integração ItemReserve) ou então, ItemReserveCode (Código da reserva gerada no Protheus), será priorizada a tag ItemReserveInternalId.
Após o recebimento desta mensagem, será realizada no sistema Protheus o processo de explosão da venda para geração do BackOfficce, chamado de GravaBatch, nesse momento, a reserva será finalizada e estoque atualizado.
Procedimento para Utilização
Pré-requisitos:
- Configuração do adapter ItemReserve. Para detalhes, acesse o link: Cadastro de Adapters / Cadastro De/Para Empresas e Cadastro De/Para dos Caixas Protheus X Live / Cadastro de De/Para CFOP/TES.
- Configuração do adapter RetailSales. Para detalhes, acesse o link: Cadastro de Adapters / Cadastro De/Para Empresas e Cadastro De/Para dos Caixas Protheus X Live / Cadastro de De/Para CFOP/TES.
Importante
Procedimento para Verificação dos XML:
- Após o recebimento do xml do ItemReserve 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 Gemco.
- Localize o campo Alias com conteúdo SC0.
- Verifique através dos campos Valor Externo que é a chave da Gemco e Valor Interno que é a chave Protheus.
...
Reprocessar: Através do arquivo "Configuracao.json" é configurável por quantas vezes o Mozart deve reprocessar uma arquivo em estado de erro.
AguardandoCallback : Significa que o Mozart EAI enviou uma mensagem de por exemplo ItemReserve contendo os dados do pedido para ser reservado as mercadorias pelo Protheus e está aguardando retorno.
O Mozart também tem um Auto-Refresh configuravel localizado na barra do menu
Quando ativado, um timer de 10 segundos é executado ao termino os registros são atualizados no Mozart
Outra funcionalidade do Mozart é o Reprocessar manual: Quando o Reprocessar automático finaliza a quantidade de vezes do reprocessamento configurável, na linha do registro em Ação é disponibilizado a opção reprocessar.
Para entrar em delhates do erro na integração, clique no icone "maleta" depois em Resultado, clique no icone "Buscar" Será aberto uma telinha chamada JSON com o log.
No status AguardandoCallback como mencionado acima enquanto o Mozart não receber o retorno deste envio continuará com esse status.
Para mais detalhes do AguardandoCallback clique em AguardandoCallback > Ação > Resultado que uma telinha mostrará o endereço do ws que está aguardando retorno.
...
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 Pedido de Venda
1. Realizar um Pedido de Venda no Gemco
2 . Após o processo de Pedido de Venda é enviado o XML para reserva de produto no Protheus, através deste você pode identificar o número da reserva que será integrada no Protheus.
3. No Faturamento (SIGAFAT) acesse Atualizações / Pedidos / Controle de Reservas.
4. Observe a reserva integrada:
Processo de Vendas e baixa da reserva
1. Realizar uma venda no Gemco, 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:
Pressionar a tecla F8 para verificar a reserva relacionada ao produto:
5. No Faturamento (SIGAFAT) acesse Atualizações / Pedidos / Controle de Reservas.
6. Observe que a reserva 000025 não é exibida pois foi finalizada:
...