Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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

  1.  Fluxograma 

     Image Added
  2. Funcionalidades

Na tela inicial do Mozart no canto superior direito encontrasse o menu. Imagem abaixo com o icone em destaque abre a tela inicial.  

Image Added
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.  


Image Added

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.

   Image Added   

     Image Added        Image Added

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.

Image Added Image Added

O próximo icone do menu chamado de Dashboard é utilizado para apresentar todos os registros de integrações e seus status.

Image Added

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.

Image Removed

...

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.

Image Removed

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.

...

Image AddedImage Added

Image Modified Image Modified

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

Image Removed

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

    
     Image Removed

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:

 Procedimento para Verificação dos XML:

  1. Após o recebimento do xml do ItemReserve no Protheus, acesse e o Configurador (SIGACFG), Ambiente / Schedule / De-Para de Mensagem Única (APCFG070).
  2. O sistema Protheus apresenta De-Para das integrações com o Sistema Gemco. 
  3. Localize o campo Alias com conteúdo SC0.
  4. Verifique através dos campos Valor Externo que é a chave da Gemco e Valor Interno que é a chave Protheus.

Image Removed

...

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

Image Added Image Added

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.

Image Added 


Para entrar em delhates do erro na integração, clique no icone "maleta"Image Added depois em Resultado, clique no icone "Buscar"Image Added Será aberto uma telinha chamada JSON com o log.

Image Added


No status AguardandoCallback como mencionado acima enquanto o Mozart não receber o retorno deste envio continuará com esse status.

Image Added

Para mais detalhes do AguardandoCallback clique em AguardandoCallback > Ação > Resultado   que uma telinha mostrará o endereço do ws que está aguardando retorno.

Image Added


        

...

Legendas:

           Status das mensagens no EAI Protheus

           Atualmente, existem 7 status disponíveis para uma mensagem na fila do EAI Protheus:

Image RemovedAguardando 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);

Image RemovedExecutando - A mensagem está sendo enviada para o sistema integrado ou a mensagem recebida está sendo processada;

Image RemovedFinalizada - A mensagem foi processada sem erros ou foi enviada sem erros;

Image RemovedFalhou - Houve um erro no envio da mensagem ou no seu recebimento;

Image RemovedBloqueado - A mensagem foi bloqueada para execução pelo usuário;

Image RemovedNã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);

Image RemovedRecusada - A mensagem foi recusada por conter divergências entre a mensagem e o seu XSD.

Image Removed

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:

Image Removed

Image Removed

 

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:

Image Removed

Image Removed

Pressionar a tecla F8 para verificar a reserva relacionada ao produto:

Image Removed

5. No Faturamento (SIGAFAT) acesse  Atualizações / Pedidos /  Controle de Reservas.

6. Observe que a reserva 000025 não é exibida pois foi finalizada:

Image Removed

...