Árvore de páginas

Versões comparadas

Chave

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

1. Integração de Reserva (ItemReserve) Protheus x Gemco

       Nesta integração de reserva, o sistema Protheus recebe uma mensagem padronizada de ItemReserve enviada pelo sistema Gemco.

2. Fluxo das Mensagens

Produto

Fluxo

Tipo da Mensagem

Versão MSU

Formato

GEMCO

Envia

Assíncrona

1.000 (link da api.totvs.com)

Json/XML

Protheus

Recebe

Assíncrona

1.000 (link da api.totvs.com)

XML


2.1 Protheus

         a. Pré-Condição   


Produto:

Microsiga Protheus

DbAcess

Versão XYZ

AppServer

LoboGuará

Build

XYXW

Sistema Operacional

Windows 10

Banco de Dados

SqlServer/Oracle


         b. Descrição do Processo

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


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 = ITEMRESERVE  
 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 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:


2.2 Gemco

              a. Pré-Condição


Produto:

Mozart

Versão

5.1.0.1

Browser

Firefox/Google Crome/IE

Sistema Operacional

Windows Server

Banco de Dados

SqlServer

Observação: Para mais detalhes da configuração do Mozart acesse o link Mozart EAI

Produto:

Gemco

Build

120 SP13

Sistema Operacional

Windows XP, 7, 10

Banco de Dados

SqlServer/Oracle


                b. Descrição do Processo

No Gemco para enviar uma reserva de produtos para o Protheus basta apenas fazer um pedido de venda de qualquer tipo (RetiraEntrega 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 :

AguardandoProcessamento : Mozart mostra a quantidade de processos especificos por exemplo (Reserva) estão aguardando na fila para serem executados.

Processando : Significa que após aguardar na fila o arquivo é envidado para ser processado.

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.

3. Processos Relacionados

        Mozart EAI

4. Vídeo How-to

            Em desenvolvimento...

5. Mapeamento de Mensagens

6. FAQs

Em desenvolvimento....