Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Migration of unmigrated content due to installation of a new plugin

Integração BackOffice Protheus x PDV Live Bematech

Características do Requisito

Linha de Produto:

Microsiga Protheus

Segmento:

Varejo

Módulo:

SIGALOJA, SIGAFAT

Rotina:

Rotina(s) envolvida(s)

Nome Técnico

MATI030

Integração de Cliente

MATI010Integração de Produto
FATA150Integração de Categoria
OMSI010Integração de Tabela de Preço

LOJI160

Integração de Redução Z
FINI040Integração de Contas a Receber
LOJI070Integração de Administradoras Financeiras
LOJI121Integração de Estação
MATI461Integração de Nota fiscal de saída.
MATI030Cadastro de Clientes
MATA010Cadastro de Produtos
LOJA210Integração de Codigo de barras
FATA150Cadastro de Amarracao Categoria x Grupos de Produtos
OMSA010Cadastro de Tabela de Preço
LOJA160Redução Z
FINA040Contas a receber
LOJA070Cadastro de Administrador Financeira
LOJA121Cadastro de Estação
MATI461Notas Fiscais de Saida
LOJA210Cadastro de Códigos de Barra

Cadastros Iniciais:

Adapters EAI (CFGA020): Cliente, Produto, Estação de Trabalho, Vendedor, Forma de Pagamento, Unidade de Medida e Local de Estoque;

De/Para Empresa Filial EAI (APCFG050).

Parâmetro(s):

MV_EAIURL2

País(es):

Brasil

Banco(s) de Dados:

Todos

Tabelas Utilizadas:

ACV - Categoria de produto

DA0 - Tabela de Preços

DA1 - Itens da Tabela de Preços

SA1 - Clientes

SAE - Administração Financeira

SB0 - Dados Adicionais - Loja

SB1 - Descrição Genérica do Produto

SFI - Resumo Redução Z

SLG - Estações

SLK - Código de Barras por Produto

Sistema(s) Operacional(is):

Windows/Linux

Chamados relacionados: 

Versões/Release:

12.1.14

Versão Corrigida:12.1.14Versão Expedida:12.1.14

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.

 

Fase 1

  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

As Administradoras Financeiras (SAE) deverão ser cadastradas manualmente nos sistemas RM e Protheus e deverão ter o mesmo código.

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:

Mensagem Única

Rotina Protheus

Mensagem

Descrição

Envia

Recebe

Método Protheus

Operação

Condição de envio

Canal de Envio

Adapter Protheus

Versão

Sim

MATA030

CustomerVendor

Cliente

Não

Sim

Síncrono

Todas

 

EAI

MATI010

2.003
SimMATA010ItemProdutoSimNãoSíncronoTodasALLTRIM(SB1->B1_TIPO) == "PA"EAIMATI0304.000
SimFATA150ItemCategoryCategoria de produtoSimNãoSíncronoTodas EAIMATI0304.000
SimOMSA010PriceListHeaderItemTabela de PreçoSimNãoSíncronoTodas EAIOMSI0101.000

Sim

LOJA160

Reduction

Reducao Z

Não

Sim

Síncrono

Todas

 

EAI

LOJI160

1.001
SimFINA040AccountReceivableDocumentContas a ReceberSimNãoSíncronoTodas EAIFINI0402.000

Sim

MATA461InvoiceNota fiscal de saidaSimSimSíncronoTodas EAIMATI4613.001
SimLOJA070FinancialManagerAdm. FinanceiraNãoSimSíncronoTodas EAILOJI0702.002
SimLOJA121ListOfStationSalePointLista de Estações de TrabalhoNãoSimSíncronoTodas EAILOJI1211.000
SimLOJA210ItemCodigo de barrasSimNãoSíncronoTodas EAILOJA2104.000
            

 

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:

 

Entidade

Empresa

Unidade

Filial

Tabela Protheus

Cliente

Compartilhado

Compartilhado

Compartilhado

SA1

Vendedor

Exclusivo

Exclusivo

Compartilhado

SA3

Dados Adicionais LojaExclusivoExclusivoCompartilhadoSB0

Produto

Exclusivo

Exclusivo

Compartilhado

SB1

Produtos x PreçosExclusivoExclusivoCompartilhadoSBI
Log de ModificaçõesExclusivoExclusivoCompartilhadoSLH
GenéricaExclusivoExclusivoCompartilhadoSX5
Estações de TrabalhoExclusivoExclusivoCompartilhadoSLG

 

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 

 

Image Removed

 

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.

Image Removed

 

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

Image Removed

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:

  • 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:

    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:

  • 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).
  • Situação/Requisito:

    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.

    Solução/Implementação:

    Importante! 

    Para detalhes da implementação da integração, acesse o link: Guia da Integração BackOffice Protheus PDV X Live Bematech
    Requisito:DVARLOJ1-254

    Procedimento para Utilização   

    Para detalhes da implementação da integração, acesse o link: Guia da Integração BackOffice Protheus PDV X Live Bematech
    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:

    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:

     

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

    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:

  • 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:

    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:

  • 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:

    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.

    Image Removed

    Image Removed