Histórico da Página
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 |
- 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
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:
- 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.
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
Guia de configuração para a utilização do Protheus x Gemco
...
Produto:
...
Microsiga Protheus
...
Versões Releases:
...
12.1.17
...
Produto:
...
Gemco
...
Versões Releases:
...
120 SP13
...
Produto:
...
Mozart EAI
...
Versões Releases:
...
5.1.0.7
...
Funcionalidades Disponíveis
Requisitos Necessários
...
Produto:
...
Microsiga Protheus
...
DbAcess
...
Versão XYZ
...
AppServer
...
LoboGuará
...
Build
...
XYXW
...
Sistema Operacional
...
Windows 10
...
Banco de Dados
...
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 |
...
Implementação passo a passo ( clique aqui )
...
Detalhes da Integração ( clique aqui )
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 (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 :
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
4. Vídeo How-to
Em desenvolvimento...
5. Mapeamento de Mensagens
6. FAQs
Em desenvolvimento....
...
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas