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, SIGAFAT
Rotina:
Rotina(s) envolvida(s) | Nome Técnico |
MATI030 | Integração de Cliente |
MATI010 | Integração de Produto |
FATA150 | Integração de Categoria |
OMSI010 | Integração de Tabela de Preço |
LOJI160 | Integração de Redução Z |
FINI040 | Integração de Contas a Receber |
LOJI070 | Integração de Administradoras Financeiras |
LOJI121 | Integração de Estação |
MATI461 | Integração de Nota fiscal de saída. |
MATI030 | Cadastro de Clientes |
MATA010 | Cadastro de Produtos |
LOJA210 | Integração de Codigo de barras |
FATA150 | Cadastro de Amarracao Categoria x Grupos de Produtos |
OMSA010 | Cadastro de Tabela de Preço |
LOJA160 | Redução Z |
FINA040 | Contas a receber |
LOJA070 | Cadastro de Administrador Financeira |
LOJA121 | Cadastro de Estação |
MATI461 | Notas Fiscais de Saida |
LOJA210 | Cadastro 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
Versões/Release:
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
- Cadastro de Clientes
- Cadastro de Produtos / Precificação do Produto / Código de Barras do Produto / Categoria de Produtos
- Cadastro de Estação de Trabalho (Pdv)
- Cadastro de Administradoras Financeiras
- Redução Z (PAF-ECF)
- Títulos a Receber
- 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:
- 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
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 | |
Sim | MATA010 | Item | Produto | Sim | Não | Síncrono | Todas | ALLTRIM(SB1->B1_TIPO) == "PA" | EAI | MATI030 | 4.000 |
Sim | FATA150 | ItemCategory | Categoria de produto | Sim | Não | Síncrono | Todas | EAI | MATI030 | 4.000 | |
Sim | OMSA010 | PriceListHeaderItem | Tabela de Preço | Sim | Não | Síncrono | Todas | EAI | OMSI010 | 1.000 | |
Sim | LOJA160 | Reduction | Reducao Z | Não | Sim | Síncrono | Todas | EAI | LOJI160 | 1.001 | |
Sim | FINA040 | AccountReceivableDocument | Contas a Receber | Sim | Não | Síncrono | Todas | EAI | FINI040 | 2.000 | |
Sim | MATA461 | Invoice | Nota fiscal de saida | Sim | Sim | Síncrono | Todas | EAI | MATI461 | 3.001 | |
Sim | LOJA070 | FinancialManager | Adm. Financeira | Não | Sim | Síncrono | Todas | EAI | LOJI070 | 2.002 | |
Sim | LOJA121 | ListOfStationSalePoint | Lista de Estações de Trabalho | Não | Sim | Síncrono | Todas | EAI | LOJI121 | 1.000 | |
Sim | LOJA210 | Item | Codigo de barras | Sim | Não | Síncrono | Todas | EAI | LOJA210 | 4.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 Loja | Exclusivo | Exclusivo | Compartilhado | SB0 |
Produto | Exclusivo | Exclusivo | Compartilhado | SB1 |
Produtos x Preços | Exclusivo | Exclusivo | Compartilhado | SBI |
Log de Modificações | Exclusivo | Exclusivo | Compartilhado | SLH |
Genérica | Exclusivo | Exclusivo | Compartilhado | SX5 |
Estações de Trabalho | Exclusivo | Exclusivo | Compartilhado | SLG |
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:
Alteraçã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:
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. |
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
Alteração:
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.
- 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.
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:
- 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:
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:
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:
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.