Integração BackOffice RM x PDV Protheus

Características do Requisito

Descrição

Implementada no Venda Assistida e Totvs Pdv a funcionalidade de integração para o PDV do sistema Protheus (cadastros e movimentações do produto) com o BackOffice do sistema RM.

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

O desenvolvimento se dará em 2 fases distintas sendo elas:

Fase 1

1. Cadastro de Clientes
2. Cadastro de Produtos/Precificação do Produto/Código de Barras do Produto
3. Cadastro de Estação de Trabalho (Pdv)
4. Cadastro de Vendedor
5. Cadastro de Forma de Pagamento/Administradoras Financeiras
6. Cadastro de Unidade de Medida
7. Cadastro de Local de Estoque
   
   Importante
   O fluxo destas integrações serão RM para Protheus
   

Fase 2
 

1. Cupom Fiscal;
2. Cancelamento de Cupom Fiscal;
3. Mapa Resumo/Redução Z (PAF-ECF)
4. Sangria
5. Suprimento de Caixa
6. Consulta de Estoque

Importante
O fluxo destas integrações serão Protheus para RM

1. Crédito de Devolução/Troca

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
  • Recebe: SIM
  • 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	Canal de Envio	Adapter Protheus	Versão
  Sim	MATA010	Item	Produto	Não	Sim	Síncrono	Todas	EAI	MATI010	3.004
  Sim	MATA030	CustomerVendor	Cliente	Nâo	Sim	Síncrono	Todas	EAI	MATI030	2.002
  Sim	AGRA045	Warehouse	Armazéns de Estoque	Não	Sim	Síncrono	Todas	EAI	AGRI045	1.001
  Sim	QIEA030	UnitOfMeasure	Unidades de Medida	Não	Sim	Síncrono	Todas	EAI	QIEI030	2.002
  Sim	LOJA121	ListOfStationSalePoint	Lista de Estações de Trabalho	Não	Sim	Síncrono	Todas	EAI	LOJI121	1.000
  Sim	MATA040	Seller	Vendedor	Não	Sim	Síncrono	Todas	EAI	MATI040	2.001
  Sim	LOJA070	PaymentMethod	Forma de Pagamento/Adm. Fin.	Não	Sim	Sincrono	Todas	EAI	LOJI070	1.000

  
  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

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

Company : 4

Branch: 20

Emp. Protheus: 01

Fil. Protheus: 0101005

Para integrações globais do sistema RM, a configuração será conforme exemplo abaixo: 

Referência: RM

Company : 0

Branch: 

Emp. Protheus: 01

Fil. Protheus: 0101005

4. No Configurador (SIFACFG), acesse Base de Dados/Dicionário/Base de Dados e aumente tamanho do campo A1_COD para 20:

• • Acessar : Base de Dados / Dicionario / Base de Dados
  • Acessar Dicionário de Dados / Grupo de Campos
  • Editar o Grupo Codigo Cliente/Fornecedor
  • Aumentar o tamanho para 20 e salvar
  • Atualizar Base de Dados para efetivar a alteração.
    
    

5. No Configurador (SIFACFG), acesse Base de Dados/Dicionário/Base de Dados e adicione inicializador padrão para o campo A1_LOJA:

• • Acessar : Base de Dados / Dicionario / Base de Dados
  • Dicionário de Dados / Pesquisar  por SA1
  •  Selecione a tabela e clique em Editar
  • Acesse : Clientes  / Campos
  • Pesquisar  pelo campo  código do cliente  (A1_LOJA)
  • Selecionar o campo  A1_LOJA e clicar no ícone Editar
  • Informar o valor “01” (As aspas são necessárias) ao  campo Inic.Padrão localizado na aba Opções  e Confirmar.

CONFIGURAÇÃO DE PARÂMETROS

1. 1. No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Configure os parâmetros a seguir:
      
      Importante
      Adicionar neste parâmetro o endereço de WebService da RM.
      
      
      

Procedimento para Utilização

Cadastro de Unidade de Medida

Inclusão:

       1. Após inclusão da Unidade de Medida 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 RM, localize o campo Alias com conteúdo SAH, após localize pelos campos Valor Externo que é a chave RM e Valor Interno que é a chave Protheus o item incluído.

2. Acesse no SigaLoja (SIGALOJA), Atualizações / Gerencia Estoques / Unidades de Medida.

Sistema apresenta as Unidades de Medida existentes, se este item que foi incluído ainda não existe, será feita a inclusão, senão, permanecerá inalterada.

Alteração:

1. Após alteração da Unidade de Medida no sistema RM, Acesse no SigaLoja (SIGALOJA), Atualizações / Gerencia Estoques / Unidades de Medida.
   Sistema apresenta as Unidades de Medida existentes, verifique as alterações que foram efetuadas no item conforme integração.
   
   

Exclusão:

1. Após exclusão da Unidade de Medida 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 RM, item deve ter sido excluído da tabela De-Para.

2. Acesse no SigaLoja (SIGALOJA), Atualizações / Gerencia Estoques / Unidades de Medida

Sistema apresenta as Unidades de Medida existentes, se for um item novo, será excluído do cadastro, caso seja um item já existente, permanecerá pois pertence aos cadastros padrões do sistema Protheusa Unidade de Medida estiver sendo utilizada em algum cadastro (ex: Produto), sistema não permitirá a exclusão.

Importante
RM deve enviar as integrações das Unidades de Medida padrões Protheus para que alimente as tabela De-Para.

Cadastro de Local de Estoque

Inclusão:

       1. Após inclusão de Local de Estoque 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 RM, localize o campo Alias com conteúdo NNR, após localize pelos campos Valor Externo que é a chave RM e Valor Interno que é a chave Protheus o item incluído.

2. Acesse no SigaLoja (SIGALOJA), Atualizações / Cadastros / Locais de Estoque.

Sistema apresenta os Locais de Estoques existentes, sistema terá incluído o novo registro.

Alteração:

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

Importante
Caso seja efetuada a alteração de inativação do Local de Estoque no sistema RM e este não tenha movimentações, será excluído no sistema Protheus.

Exclusão:

1. Após exclusão da Unidade de Medida 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 RM, item deve ter sido excluído da tabela De-Para.

2. Acesse no SigaLoja (SIGALOJA), Atualizações / Cadastros / Locais de Estoque

Sistema apresenta os Locais de Estoques existentes, o item em questão terá sido excluído da tabela.

Cadastro de Produto/Precificação/Código de Barras do Produto

Inclusão:

       1. Após inclusão de Produto 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 RM, localize o campo Alias com conteúdo SB1, após localize pelos campos Valor Externo que é a chave RM e Valor Interno que é a chave Protheus o item incluído.

2. Acesse no SigaLoja (SIGALOJA), Atualizações / Cadastros / Produtos

Sistema apresenta os Produtos existentes, sistema terá incluído o novo registro, verifique no rodapé que os preços de venda do produto também foram adicionados conforme integração.

Alteração:

1. Após alteração de Produto no sistema RM, Acesse no SigaLoja (SIGALOJA), Atualizações / Cadastros / Produtos
   Sistema apresenta os Produtos existentes, verifique as alterações que foram efetuadas no item conforme integração, caso tenha havida alguma alteração de preço, estes serão atualizados.
    

Exclusão:

1. Após exclusão de Produto 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 RM, item deve ter sido excluído da tabela De-Para.

2. Acesse no SigaLoja (SIGALOJA), Atualizações / Cadastros / Produtos

Sistema apresenta os Produtos existentes, o item em questão terá sido removido da tabela juntamente com sua precificação.

• • 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 enviados serão incluídos.
      No Configurador (SIGACFG), acesse Ambiente / Schedule / De-Para de Mensagem Única (APCFG070).
      O sistema Protheus apresenta De-Para das integrações com o Sistema RM, localize o campo Alias com conteúdo SLK, após localize pelos campos Valor Externo que é a chave RM e Valor Interno que é a chave Protheus o item incluído.
      
      Acesse SigaLoja (SIGALOJA), Atualizações / Cadastros / Códigos de Barras
      Sistema apresenta os Códigos de Barras existentes, verifique as alterações que foram efetuadas conforme integração.
      
      
      
   2. Alteração do Produto:
      Acesse SigaLoja (SIGALOJA), Atualizações / Cadastros / Códigos de Barras
      Todos os Códigos de Barras relacionadas ao Produto que forem enviados serão alterados se necessário, aqueles que não forem enviados serão excluídos.
      
      
      
   3. Exclusão do Produto:
      No Configurador (SIGACFG), acesse Ambiente / Schedule / De-Para de Mensagem Única (APCFG070).    
      O sistema Protheus apresenta De-Para das integrações com o Sistema RM, item deve ter sido excluído da tabela De-Para.
      
      
      Acesse SigaLoja (SIGALOJA), Atualizações / Cadastros / Códigos de Barras
      Todos os Códigos de Barras relacionados ao Produto serão excluídos.
      
      

Importante

O Protheus possui um tratamento onde um Código de Barras pode representar uma Caixa de Mercadorias, neste caso, deverá ser informado pela RM a quantidade de produtos para o Código de Barras que está sendo gerado, caso não seja informado, será considerado o valor default = 0, definindo assim que o Código de Barras representa apenas 1 produto.

Importante

As integrações de Unidade de Medida e Local de Estoque são pré-requisitos para a integração de Produtos e estão detalhadas neste documento.

Cadastro de Cliente

Inclusão:

       1. Após a inclusã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 RM, localize o campo Alias com conteúdo SA1, após localize pelos campos Valor Externo que é a chave RM e Valor Interno que é a chave Protheus o item incluído.

2. Acesse no SigaLoja (SIGALOJA), Atualizações / Cadastros / Clientes.

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

O sistema Protheus apresenta De-Para das integrações com o Sistema RM, item deve ter sido excluído da tabela De-Para.

2. Acesse no SigaLoja (SIGALOJA), Atualizações / Cadastros / Clientes.

Sistema apresenta os Clientes existentes, o item 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.

Importante
Protheus possui um código de Cliente Padrão automático, RM deve enviar a integração deste cliente para alimentar a tabela De-Para.

Cadastro de Vendedor

Inclusão:

       1. Após a inclusão do Vendedor 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 RM, localize o campo Alias com conteúdo SA3, após localize pelos campos Valor Externo que é a chave RM e Valor Interno que é a chave Protheus o item incluído.

2. Acesse no SigaLoja (SIGALOJA), Atualizações / Cadastros / Vendedores.

Sistema apresenta os Vendedores existentes, sistema terá incluído o novo registro.

Alteração:

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

Exclusão:

1. Após a exclusão do Vendedor 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 RM, item deve ter sido excluído da tabela De-Para.

2. Acesse no SigaLoja (SIGALOJA), Atualizações / Cadastros / Vendedores.

Sistema apresenta os Vendedores existentes, o item em questão terá sido excluído da tabela.

Importante
Protheus possui um código de Vendedor Padrão automático, RM deve enviar a integração deste cliente para alimentar a tabela De-Para.

Cadastro de Estação de Trabalho (Pdv)

Inclusão:

       1. Após a inclusão da Estação de Trabalho 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 RM, localize o campo Alias com conteúdo SLG, após localize pelos campos Valor Externo que é a chave RM e Valor Interno que é a chave Protheus o item incluído.

2. Acesse no SigaLoja (SIGALOJA), Atualizações / Ponto de Venda / Estações.

Sistema apresenta as Estações de Trabalho existentes, sistema terá incluído o novo registro.

Alteração:

1. Após alteração da Estação de Trabalho no sistema RM, Acesse no SigaLoja (SIGALOJA), Atualizações / Ponto de Venda / Estações.
   Sistema apresenta as Estações de trabalho existentes, verifique as alterações no item que foram efetuadas conforme integração.
   
   

Exclusão:

1. Após a exclusão da Estação de Trabalho 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 RM, item deve ter sido excluído da tabela De-Para.

2. Acesse no SigaLoja (SIGALOJA), Atualizações / Ponto de Venda / Estações.

Sistema apresenta as Estações de Trabalho existentes, o item em questão terá sido removido da tabela.

Importante

A integração de Local de Estoque é pré-requisito para a integração de Estação de Trabalho e está detalhada neste documento.

Importante
Protheus possui um código de Estação de Trabalho Padrão automático, RM deve enviar a integração deste cliente para alimentar a tabela De-Para.

Cadastro de Forma de Pagamento/Administradoras Financeiras

Visto que a base Protheus possui carga com formas de pagamento padrão (obrigatoriamente constam na base de dados), deve-se efetuar o cadastro destas Formas de Pagamento no RM respeitando o mesmo código do Protheus para viabilizar a integração de registros que utilizem estas como parâmetro. A lista de forma de pagamentos padrão no Protheus e que devem ser cadastradas no RM com o mesmo código estão armazenadas na tabela SX5, Chave 24:

Importante

Se forem incluídas novas Formas de Pagamentos no Sistema RM diferentes das Formas de Pagamento pré-existente no Protheus, essas serão incluídas automaticamente.

Deverá ser informado pelo sistema RM o mesmo código da Forma de Pagamento Protheus conforme tabela SX5, Chave 24, desta forma, será alimentada a tabela de integração para utilização, se o usuário optar em trabalhar com código diferente do cadastro Protheus, os códigos devem ser inseridos manualmente nos parâmetros abaixo:

- MV_LJMUDIN: parâmetro de forma de pagamento para Dinheiro.

- MV_LJMUCH: parâmetro de forma de pagamento para Cheque.

- MV_LJMUFI: parâmetro de forma de pagamento para Financiado.

Importante

Os códigos deverão ser inseridos manualmente nos parâmetros, se a Forma de Pagamento alternativa for excluída, o código deverá ser apagado manualmente do parâmetro correspondente.

Importante

As Administradoras Financeiras serão inseridas manualmente no sistema Protheus e não terão integração com o sistema RM, deve-se preencher no campo Form Pg Ext (AE_CODEXT) a Forma de Pagamento Cartão de Crédito/Débito enviado pelo sistema RM, desta forma, será possível estabelecer a relação entre as entidades.

Inclusão:

       1. Após a inclusão da Forma de Pagamento 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 RM, localize o campo Alias com conteúdo SX5, após localize pelos campos Valor Externo que é a chave RM e Valor Interno que é a chave Protheus o item incluído.

2. Acesse no Configurador (SIGACFG), Ambiente / Cadastro / Tabelas, posicionar na chave 24 (Formas de Pagamento).

Sistema apresenta as Formas de Pagamento existentes, se este item ainda não existe, sistema fará a inclusão, senão, permanecerá inalterada.

Alteração:

1. Após alteração da Forma de Pagamento no sistema RM, Acesse Configurador (SIGACFG), Ambiente / Cadastro / Tabelas, posicionar na chave 24 (Formas de Pagamento).

 Sistema apresenta as Formas de Pagamento existentes, verifique as alterações que foram efetuadas no item conforme integração.

Exclusão:

1. Após a exclusão da Forma de Pagamento 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 RM, item deve ter sido excluído da tabela De-Para.

2. Acesse no Configurador (SIGACFG), Ambiente / Cadastro / Tabelas, posicionar na chave 24 (Formas de Pagamento).

Sistema apresenta as Formas de Pagamentos existentes, se esta for uma Forma de Pagamento nova, será excluída do cadastro, caso seja uma Forma de Pagamento já existente, permanecerá pois pertence aos cadastros padrões do sistema Protheus.