Histórico da Página
Integração BackOffice Protheus x PDV Live Bematech
Características do Requisito
Linha de Produto: | Microsiga Protheus |
Segmento: | Varejo |
Módulo: | SIGALOJA |
Cadastros Iniciais: | Adapters EAI (CFGA020): Cliente, Produto, Estação de Trabalho, Categoria, Tabela de Preço, Redução Z, Contas a Receber, Administradoras Financeiras, Nota fiscal de saída; De/Para Empresa Filial EAI (APCFG050). |
Parâmetro(s): | MV_EAIURL2 / MV_DUT |
País(es): | Brasil |
Sistema(s) Operacional(is): | Windows/Linux |
Versões/Release: | 12.1.16 |
Descrição
Implementada a funcionalidade de Integração BackOffice do sistema Protheus com o sistema PDV Live da Bematech, possibilitando a troca de informações entre algumas tabelas e processos do Microsiga Protheus® com o PDV Live da Bematech.
Os dados são enviados/recebidos por meio da funcionalidade EAI (Enterprise Application Integration), disponível no módulo Configurador.
Como premissa da integração será a utilização de Mensagem Única.
Visão geral do processo :
Importante!
Os operadores de Caixa devem ser cadastrados manualmente nos sistemas e no Protheus e conter o mesmo código.
Procedimento para Configuração
Configuração de Parâmetros
- Configuração inicial Entidades - Adapters ( clique aqui )
- Cadastro de Agendamentos - Para envio e recebimento de mensagens Assíncronas
Procedimento para Utilização
Cadastro de Cliente
O cadastro de Cliente sera realizado no sistema Bematech Live, e será integrado com a retaguarda (SigaLoja) através de comunicação de Mensagem Unica.
Inclusão:
- Após a inclusão do Cliente no sistema Bematech, no Configurador (SIGACFG), acesse 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 SA1, após localize pelos campos Valor Externo que é a chave da Bematech e Valor Interno que é a chave Protheus o item incluído.
- Acesse no SigaLoja (SIGALOJA), Atualizações / Cadastros / Clientes.
- Sistema apresenta os Clientes existentes, sistema terá incluído o novo registro.
Alteração:
- Após alteração do Cliente no sistema RM, Acesse no SigaLoja (SIGALOJA), Atualizações / Cadastros / Clientes.
- Sistema apresenta os Clientes existentes, verifique as alterações que foram efetuadas no item conforme integração.
Exclusão:
- Após a exclusão do Cliente no sistema RM, no Configurador (SIGACFG), acesse Ambiente / Schedule / De-Para de Mensagem Única (APCFG070).
- O sistema Protheus apresenta De-Para das integrações com o Sistema Bematech, cliente deve ter sido excluído da tabela De-Para.
- Acesse no SigaLoja (SIGALOJA), Atualizações / Cadastros / Clientes.
- Sistema apresenta os Clientes existentes, o cliente em questão será excluído da tabela.
Importante
Este processo por padrão também trata a integração de Fornecedores, porém, nesta integração, serão integrados apenas Clientes.
<VERIFICAR ESTA NECESSIDADE>
Importante
Protheus possui um código de Cliente Padrão automático com base nos parâmetros MV_CLIPAD e MV_LOJAPAD, RM deve enviar a integração deste cliente para alimentar a tabela De-Para.
Cadastro de Produto/Código de Barras do Produto/Amarração de Categoria x Produto
O cadastro de Produtos/Código de Barras e Amarração de Categoria x Produto serão realizado no sistema Protheus, e será integrado com o sistema Bematech Live através de comunicação de Mensagem Unica.
Importante
A integração de Produto não ocorrerá caso seja utilizada a rotina Cadastro de Produto (LOJA110) presente no módulo Controle de Lojas (SIGALOJA). Os demais cadastros de Código de barras e Amarração de Categoria x Produto não possuem ressalvas quanto ao modulo utilizado.
Inclusão:
- Acesse no Faturamento(SIGAFAT), Atualizações / Cadastros / Produtos (MATA010)
- Inclua o produto com as informações desejadas e cliquem em Confirmar para salvar e integrar o produto com o sistema Bematech.
- Após inclusão de Produto no sistema Protheus, no Configurador (SIGACFG), acesse 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 SB1, após localize pelos campos Valor Externo que é a chave Bematech e Valor Interno que é a chave Protheus o item incluído.
Alteração:
- Acesse no Faturamento(SIGAFAT), Atualizações / Cadastros / Produtos (MATA010)
- Altere o produto desejado e após alteração no sistema Protheus, ao confirmar o cadastro o produto é integrado com o sistema Bematech.
Exclusão:
- Acesse no Faturamento(SIGAFAT), Atualizações / Cadastros / Produtos (MATA010)
- Exclua o produto desejado e confirme a exclusão. O sistema Protheus irá integrar a deleção do produto no sistema Bematech, o item em questão terá sido removido da tabela.
- Cadastro de Códigos de Barras:
Os Códigos de Barras correspondentes ao Produto também serão inseridos pela integração de Produtos, os eventos de Códigos de Barras estarão relacionados com os eventos da integração do Produto da seguinte forma:
- Inclusão de Produto:
Todos os Códigos de Barras relacionados ao Produto que forem cadastrados, serão enviados para a integração.
Acesse SigaLoja (SIGALOJA), Atualizações / Cadastros / Códigos de Barras (LOJA210)
Preenchas as informações desejadas e clique em Confirmar. Neste momento será realizada a integração do produto contendo todos os seus códigos de barras, incluindo este adicionado no momento. - Alteração do Produto:
Acesse SigaLoja (SIGALOJA), Atualizações / Cadastros / Códigos de Barras (LOJA210)
Posicione no registro de código de barras desejado e clique em Alterar. Altere os campos desejados e clique em Confirmar. Neste momento será integrado o produto com todos os seus códigos de barras cadastrados. - Exclusão do Produto:
Acesse SigaLoja (SIGALOJA), Atualizações / Cadastros / Código de Barras (LOJA210).
Posicione no registro de código de barras desejado e clique em Ações Relacionadas / Excluir e em seguida clique em Confirmar.
- Inclusão de Produto:
- Cadastro de Amarração de Categoria x Produto:
A amarração das categorias com os produtos também serão integrado do sistema Produtos para o sistema Live da Bematech. Para isto basta configurar os adapters (mensagem unica) mencionados acima e realizar o cadastro das categorias e posteriormente a sua amarração com o produto. Esta integração ocorrerá através do produto a ser enviado para o sistema Bematech.
A ideia de categorizar o produto é ter vários níveis de categoria ate chegar ao nível do produto. Exemplo:
Produto: "Gato Siamês"
Categorias em níveis:"Animais" > "Animais domésticos" > "Gatos"
Arvore completa: "Animais" > "Animais domésticos" > "Gatos" > "Gato Siamês"
Ou seja, neste exemplo o produto "Gato Siamês" esta logicamente dentro da categoria "Gatos", que por sua vez esta dentro da categoria "Animais domésticos" que esta dentro da categoria "Animais".
- Inclusão das categorias:
Antes de integrar a amarração Produto x Categoria deve-se criar a categoria da seguinte maneira:
Acesse Sigaloja (SIGALOJA) , Atualizações / Cadastros / Categorias de produto (FATA140)
Preencha as informações obrigatória e o campo Cat.Superior (ACU_CODPAI) caso esta categoria seja inferior a um outra categoria já cadastrada anteriormente.
Repita este processo conforme necessidade do tamanho do nível desejado
Importante
Para esta integração será apenas tratado a amarração com o tipo de interface Por Categoria - Inclusão das amarração de Categoria x Produto:
A partir de agora é possível efetuar a integração do produto e suas categorias.
Acesse Sigaloja (SIGALOJA), Atualizações / Cadastros / Amarração Categoria x Produto (FATA150)
Informe a categoria de mais baixo nível na arvore, no exemplo citado acima seria a categoria "Gatos", pois esta categoria que irá possui os produtos atrelados a ela
No grid, é possível informar um grupo de produto ou o próprio produto. Preencha a informação desejada e clique em Salvar. A partir deste momento será integrado todos os produtos e sua arvore de categoria que pertencem ao grupo de produto (caso preenchido) ou somente os produtos informados no grid. - Alteração do Produto:
Acesse Sigaloja (SIGALOJA), Atualizações / Cadastros / Amarração Categoria x Produto (FATA150)
Posicione no registro desejado e clique em Alterar. Altere os produtos ou grupo de produtos conforme desejado e clique em Salvar. Neste momento serão integrados todos os produtos alterados ou deletados pertencente ao grupo (caso preenchido) ou somente os produtos modificados.
Importante
Somente serão integrados os grupos ou produtos que realmente foram de certa forma mexidos (alterados ou excluídos) no cadastro a fim de otimizar a integração. - Exclusão do Produto:
Acesse Sigaloja (SIGALOJA), Atualizações / Cadastros / Amarração Categoria x Produto (FATA150)
Posicione no registro desejado e clique em Ações Relacionadas / Excluir. Em seguida confirme a exclusão das categorias clicando em Confirmar. Neste momento serão integrados todos os produto pertencentes aos grupos de produtos informados (caso informado) ou todos os produtos cadastrado na amarração enviando para integração a alteração do produto para que seja retiradas as categorias amarradas ao produto. Em outras palavras o produto será integrados sem categorias.
- Inclusão das categorias:
Cadastro de Tabela de Preço
O cadastros das tabelas de preço serão realizadas no sistema Protheus, e serão integradas com o sistema Bematech Live através de comunicação de Mensagem Unica.
Inclusão:
- Acesse no Sigaloja (SIGALOJA), Atualizações / Cenário de vendas / Tabela de Preço (OMSA010)
- Inclua uma tabela de preço, informe os campos obrigatórios e os produtos com seus respectivos valores.
- Clique em Confirmar para gravar os dados informados e realizar a integração da tabela de preço do Protheus para o sistema Bematech.
Alteração:
- Acesse no Sigaloja (SIGALOJA), Atualizações / Cenário de vendas / Tabela de Preço (OMSA010)
- Selecione o registro de tabela desejado e clique em Alterar.
- Altere as informações desejadas e clique em Confirmar
- Apos a gravação somente os registros alterados serão integrados do sistema Protheus para o sistema Bematech.
Exclusão:
- Acesse no Sigaloja (SIGALOJA), Atualizações / Cenário de vendas / Tabela de Preço (OMSA010)
- Selecione o registro de tabela desejado e clique em Ações Relacionadas / Excluir
- Clique em Confirmar
- Serão integrados e excluídos todos os produtos e seus respectivos preços do sistema Protheus para o sistema Bematech.
Redução Z
As Reduções serão realizadas no Sistema Bematech Live, estas serão integradas com a retaguarda (SigaLoja) através de comunicação de Mensagem Unica.
Inclusão:
- Após a realização da Redução Z no sistema Bematech Live, será realizada a integração com o sistema Protheus
- Acesse no SigaLoja (SIGALOJA), Atualizações / Caixa / Redução Z (LOJA200)
- Sistema apresenta as Reduções existentes
Nota Fiscal de Saida
As Notas Fiscais de Saida serão realizadas tanto no sistema Bematech Live quanto no Protheus e serão integradas também tanto com a retaguarda (SigaLoja) e quanto com a Bematech live através de comunicação de Mensagem Unica.
Inclusão:
- Após a realização da Redução Z no sistema Bematech Live, será realizada a integração com o sistema Protheus
- Acesse no SigaLoja (SIGALOJA), Atualizações / Caixa / Redução Z (LOJA200)
- Sistema apresenta as Reduções existentes
Títulos a Receber
Os títulos a receber serão gerados no sistema Protheus e serão integradas com o sistema Bematech live através de comunicação de Mensagem Unica.
Inclusão:
- Acesse no SigaLoja (SIGALOJA), Atualizações / Gerencia de Financas / Contas a Receber (FINA040)
- Clique em Incluir para Incluir uma nova movimentação
- Preenchas as informações obrigatórias e clique em Salvar
- Apos a gravação será realizada a integração do titulo do sistema Protheus para o sistema Bematech live
Cadastro de Administradora Financeira
As Administradoras Financeiras serão cadastradas no sistema Bematech Live e serão integradas com o sistema Protheus através de comunicação de Mensagem Unica.
Inclusão:
- Após a realização do cadastro da administrador a financeira (bandeira de cartões) no sistema Bematech Live, será realizada a integração com o sistema Protheus
- Apos a integração, acesse no SigaLoja (SIGALOJA), Atualizações / Cadastros / Administradora Financeira (LOJA070)
- Sistema apresenta as administradoras financeiras cadastradas (integradas)
Cadastro de Estação (PDVs)
As estações dos PDVs serão cadastradas no sistema Bematech Live e serão integradas com o sistema Protheus através de comunicação de Mensagem Unica.
Inclusão:
- Após a realização o cadastro da estação do PDV no sistema Bematech Live, será realizada a integração com o sistema Protheus
- Apos a integração, acesse no SigaLoja (SIGALOJA), Atualizações / Ponto de Venda / Estações (LOJA121)
- Sistema apresenta as estações cadastradas (integradas)
Importante
Todas as integrações que utilizam mensagem unica 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.
Para isso basta acessar Miscelanea / Monitor EAI selecionar a mensagem unica que deseja detalhar e clicar na lupa e escolher entre as opções Visualizar mensagem original ou Visualizar mensagem de resposta, ambas serão exibidas os XMLs da troca de comunicação.