Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Integração BackOffice RM x PDV Protheus

Características do Requisito

Linha de Produto:

Microsiga Protheus

Segmento:

Varejo

Módulo:

SIGALOJA, SIGAFRT

Rotina:

Rotina

Nome Técnico

LOJA701

Venda Assistida

STIPOSMAINTOTVS PDV

Rotina(s) envolvida(s)

Nome Técnico

LOJA070

Cadastro de Administradoras Financeiras

LOJI070

Integração de Administradoras Financeiras
LOJA110Cadastro de Produtos
LOJA121Cadastro de Estação
LOJI121Integração de Estação
LOJA210Cadastro de Códigos de Barra
AGRI045Cadastro de Locais de Estoque
MATI010Integração de Produto
MATI030Integração de Cliente
MATA040Cadastro de Vendedor
MATI040Integração de Vendedor
QIEI030Integração de Unidade de Medida

Cadastros Iniciais:

Adapters EAI (CFGA020): Cliente, Fornecedor, 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, MV_EAIUSER, MV_EAIPASS, MV_LJMUDIN, MV_LJMUCH e MV_LJMUFI

País(es):

Brasil

Banco(s) de Dados:

Todos

Tabelas Utilizadas:

SAE - Administração Financeira

SX5 - Tabelas

SB0 - Dados Adicionais - Loja

SB1 - Descrição Genérica do Produto

SLK - Código de Barras por Produto

SLG - Estações

NNR - Locais de Estoque

SA1 - Clientes

SA3 - Vendedores

SAH - Unidades de Medida

Sistema(s) Operacional(is):

Windows/Linux

Chamados relacionados:TUBW06

Versões/Release:

12.1.7

Versão Corrigida:12.1.7
Versão Expedida:12.1.7

 

 

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/Fornecedores
  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
    SimAGRA045WarehouseArmazéns de EstoqueNãoSimSíncronoTodasEAIAGRI0451.001
    SimQIEA030UnitOfMeasureUnidades de MedidaNãoSimSíncronoTodasEAIQIEI0302.002
    SimLOJA121ListOfStationSalePointLista de Estações de TrabalhoNãoSimSíncronoTodasEAILOJI1211.000
    SimMATA040SellerVendedorNãoSimSíncronoTodasEAIMATI0402.001
    SimLOJA070PaymentMethodForma de Pagamento/Adm. Fin.NãoSimSincronoTodasEAILOJI0701.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

    Exclusivo

    Exclusivo

    Compartilhado

    SA1

    FornecedorExclusivoExclusivoCompartilhadoSA2

    Vendedor

    Exclusivo

    Exclusivo

    Compartilhado

    SA3

    Dados Adicionais LojaExclusivoExclusivoCompartilhadoSB0

    Produto

    Exclusivo

    Exclusivo

    Compartilhado

    SB1

    GenéricaExclusivoExclusivoCompartilhadoSX5


    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.

     


    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 adicione inicializador padrão para o campo A1_COD:

    • Acessar : Empresas / Dicionario de Dados
    • Pesquisar  por SA1
    •  Selecione a tabela e clique em Editar
    • Acesse : Clientes  / Campos
    • Pesquisar  pelo campo  código do cliente  (A1_COD)
    • Selecionar o campo  A1_COD e clicar no ícone Editar
    • Informar o valor GETSXENUM(“SA1”, “A1_COD”) ao  campo Inic.Padrão localizado na aba Opções  e Confirmar

 

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

    • Acessar : Empresas / Dicionario 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. No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Configure os parâmetros a seguir:

    Importante
    Adicionar neste parâmetro o WebService da RM.


Itens/Pastas

Descrição

Nome:

MV_EAIURL2

Tipo:

Caracter

Cont. Por.:

 

Descrição:

Informe o nome do canal configurado no EAI para envio a outro EAI.

 

 

Itens/Pastas

Descrição

Nome:

MV_EAIUSER

Tipo:

Caracter

Cont. Por.:

 

Descrição:

Informe o usuário para autenticação do EAI para   uso no envio de mensagens.


Itens/Pastas

Descrição

Nome:

MV_EAIPASS

Tipo:

Caracter

Cont. Por.:

 

Descrição:

Informe a senha para autenticação do EAI para uso no envio de mensagens.

Itens/Pastas

Descrição

Nome:

MV_LJMUCH

Tipo:

Caracter

Cont. Por.:

 

Descrição:

Forma de Pagamento externa para cheques, utilizado em integrações com outros sistemas.

Itens/Pastas

Descrição

Nome:

MV_LJMUDIN

Tipo:

Caracter

Cont. Por.:

 

Descrição:

Forma de Pagamento externa para dinheiro, utilizado em integrações com outros sistemas.

Itens/Pastas

Descrição

Nome:

MV_LJMUFI

Tipo:

Caracter

Cont. Por.:

 

Descrição:

Forma de Pagamento externa para financiado, utilizado em integrações com outros sistemas.

Procedimento para Utilização


Cadastro de Unidade de Medida


Inclusão:

       1. Após a 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 SAH, após localize pelo campo Valor Externo (Chave RM) e Valor Interno (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 esta que foi incluída ainda não existe, sistema haverá incluído, 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 conforme integração.

 

Exclusão:

  1. Após a 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 esta for uma Unidade de Medida nova, será excluída do cadastro, caso seja uma Unidade de Medida já existente, permanecerá pois pertence aos cadastros padrões do sistema Protheus.

 

 

Cadastro de Local de Estoque


Inclusão:

       1. Após a 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 NNR, após localize pelo campo Valor Externo (Chave RM) e Valor Interno (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 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 a 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 removido da tabela.

 

Cadastro de Produto


Inclusão:

       1. Após a 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 SB1, após localize pelo campo Valor Externo (Chave RM) e Valor Interno (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 conforme integração, caso tenha havida alguma alteração de preço, estes serão atualizados.
     

Exclusão:

  1. Após a 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. Inclusão de Produto:
      Todos os Códigos de Barras relacionados ao Produto que forem enviados serão incluídos.

      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 relacionados 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:
      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.