Integração BackOffice Protheus x PDV Live Bematech

Características do Requisito

Descrição

Implementada a funcionalidade de integração para o BackOffice do sistema Protheus com o sistema de PDV Live da Bematech.

Como premissa da integração será a utilização de Mensagem Única.

Visão geral do processo :

Entidades integradas

1. Cadastro de Clientes
2. Cadastro de Produtos / Precificação do Produto / Código de Barras do Produto / Categoria de Produtos
3. Cadastro de Estação de Trabalho (Pdv)
4. Cadastro de Administradoras Financeiras
5. Redução Z (PAF-ECF)
6. Títulos a Receber
7. Notas Fiscais de Saída.
   

Importante

Os Operadores de Caixa deverão ser cadastrados manualmente nos sistemas RM e Protheus e deverão ter o mesmo código.

Procedimento para Configuração

Pré-Requisitos

Adapters:

1. No Configurador (SIFACFG), acesse Ambientes/Schedule/Adapter E.a.i
   • Incluir uma nova Rotina  para os Adapters do  sistema Protheus

   • Configurar a Rotina do Adapter  de acordo com  os dados abaixo fornecidos  e que já foram pré estabelecidos  para a integração:

   • Mensagem única: Sim
   • Rotina: Nome do adapter com a ultima letra  referenciando o programa 
   • Mensagem: Nome da mensagem única  que o Adapter EAI  espera receber.
   • Descrição: Identificação da mensagem
   • Envia: SIM (se envia a informação para o outro sistema) ou NÃO ( Se não envia nenhuma informação deste adapter para o outro sistema)
   • Recebe: SIM (se recebe a informação do outro sistema) ou NÃO ( Se não recebe nenhuma informação deste adapter do outro sistema)
   • Método: Síncrono/Assincrono
   • Operação: TODAS
   • Canal de Envio: EAI

Lista de Adapters a serem incluídos:

Importante
Estes adapters devem ser adicionados somente na Retaguarda.

<<VERIFICAR ESTA NECESSIDADE:>>
2. Ainda no módulo Configurador, alterar a configuração  de compartilhamento de registros  nas tabelas do Protheus, acesse Base de Dados/Dicionário/Base de Dados,  pesquise pela tabela   e a configure  conforme especificado na tabela abaixo:

Clique em atualizar Base de Dados para salvar as alterações.

Importante
Será necessário excluir a tabela SX5 via APSDU, após novo acesso ao Protheus, a tabela será recriada com as informações distribuídas por filial.
Efetuar Backup da tabela antes deste procedimento.

Importante 

Será necessário efetuar os procedimentos de Compartilhamento de tabelas na Retaguarda e nos PDVs.

3. No Configurador (SIFACFG), acesse Ambientes/Schedule/Emp.Fil.Msg.Unica e cadastrar De-Para de Empresas e Filiais, preencher conforme os valores a seguir:

• • Referência: BEMATECH
  • Company :  Código da Coligada RM  a integrar.
  • Branch: Código da Filial RM a integrar
  • Emp. Protheus: Código da Empresa no Protheus a integrar com o sistema RM
  • Fil. Protheus: Código da Filial no Protheus  a integrar com o sistema  RM 

Exemplo:

Referência: BEMATECH

Company : 220000205   

Branch: 17011700    

Emp. Protheus: T1

Fil. Protheus: D MG 01 

4. No Configurador (SIFACFG), acesse Base de Dados/Dicionário/Base de Dados/Grupo de Campos e aumente o tamanho do Código Cliente/Fornecedor.

• • Acessar : Base de Dados / Dicionario / Base de Dados.
  • Dicionário de Dados / Grupo de Campos.
  • Selecione o Código do Cliente e clique em Editar.
  • Aumente o tamanho para o valor desejado, neste exemplo.
  • Atualizar Base de Dados para efetivar a alteração.

• 5. No Configurador (SIFACFG), acesse Base de Dados/Dicionário/Base de Dados altere a obrigatoriedade do campo B1_POSIPI:

• • Acessar : Base de Dados / Dicionario / Base de Dados.
  • Dicionário de Dados / Pesquisar por SB1.
  • Selecione a tabela e clique em Editar.
  • Acesse : Descrição Genérica do Produto / Campos.
  • Pesquisar  pelo campo  Pos. IPI/NCM (B1_POSIPI). 
  • Selecionar o campo  B1_POSIPI e clique no ícone Editar. Na aba Uso selecione a opção Obrigatório e confirme a alteração clicando no botão Salvar.Atualizar Base de Dados para efetivar a alteração.

Importante 

 Ao alterar a obrigatoriedade deste campo, ele sempre deverá ser preenchido no cadastro do produto.

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:

1. Após a inclusão do Cliente no sistema Bematech, no Configurador (SIGACFG), acesse Ambiente / Schedule / De-Para de Mensagem Única (APCFG070).
2. 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.
3. Acesse no SigaLoja (SIGALOJA), Atualizações / Cadastros / Clientes.
4. Sistema apresenta os Clientes existentes, sistema terá incluído o novo registro.
   
   

Alteração:

1. Após alteração do Cliente no sistema RM, Acesse no SigaLoja (SIGALOJA), Atualizações / Cadastros / Clientes.
2. Sistema apresenta os Clientes existentes, verifique as alterações que foram efetuadas no item conforme integração.
   
   

Exclusão:

1. Após a exclusão do Cliente no sistema RM, no Configurador (SIGACFG), acesse Ambiente / Schedule / De-Para de Mensagem Única (APCFG070).
2. O sistema Protheus apresenta De-Para das integrações com o Sistema Bematech, cliente deve ter sido excluído da tabela De-Para.
3. Acesse no SigaLoja (SIGALOJA), Atualizações / Cadastros / Clientes.
4. 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:

1. Acesse no Faturamento(SIGAFAT), Atualizações / Cadastros / Produtos (MATA010)
2. Inclua o produto com as informações desejadas e cliquem em Confirmar para salvar e integrar o produto com o sistema Bematech.
3. Após inclusão de Produto no sistema Protheus, no Configurador (SIGACFG), acesse Ambiente / Schedule / De-Para de Mensagem Única (APCFG070).
4. 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:

1. Acesse no Faturamento(SIGAFAT), Atualizações / Cadastros / Produtos (MATA010)
2. 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:

1. Acesse no Faturamento(SIGAFAT), Atualizações / Cadastros / Produtos (MATA010)
2. 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:

1. 1. 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.
      
      
      
   2. 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.
      
      
      
   3. 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.
      
      
      

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

1. 1. 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
      
      
   2. 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.
      
      
      
   3. 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.
      
      
   4. 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.

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:

1. Acesse no Sigaloja (SIGALOJA), Atualizações / Cenário de vendas / Tabela de Preço (OMSA010)
2. Inclua uma tabela de preço, informe os campos obrigatórios e os produtos com seus respectivos valores.
3. 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:

1. Acesse no Sigaloja (SIGALOJA), Atualizações / Cenário de vendas / Tabela de Preço (OMSA010)
2. Selecione o registro de tabela desejado e clique em Alterar.
3. Altere as informações desejadas e clique em Confirmar
4. Apos a gravação somente os registros alterados serão integrados do sistema Protheus para o sistema Bematech.

Exclusão:

1. Acesse no Sigaloja (SIGALOJA), Atualizações / Cenário de vendas / Tabela de Preço (OMSA010)
2. Selecione o registro de tabela desejado e clique em Ações Relacionadas / Excluir
3. Clique em Confirmar
4. 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:

1. Após a realização da Redução Z no sistema Bematech Live, será realizada a integração com o sistema Protheus
2. Acesse no SigaLoja (SIGALOJA), Atualizações / Caixa / Redução Z (LOJA200)
3. 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:

1. Após a realização da Redução Z no sistema Bematech Live, será realizada a integração com o sistema Protheus
2. Acesse no SigaLoja (SIGALOJA), Atualizações / Caixa / Redução Z (LOJA200)
3. 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:

1. Acesse no SigaLoja (SIGALOJA), Atualizações / Gerencia de Financas / Contas a Receber (FINA040)
2. Clique em Incluir para Incluir uma nova movimentação
3. Preenchas as informações obrigatórias e clique em Salvar
4. 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:

1. 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
2. Apos a integração, acesse no SigaLoja (SIGALOJA), Atualizações / Cadastros / Administradora Financeira (LOJA070)
3. 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:

1. 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
2. Apos a integração, acesse no SigaLoja (SIGALOJA), Atualizações / Ponto de Venda / Estações (LOJA121)
3. 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.