Páginas filhas
  • DI_Integracao_Protheus_x_Drp_Neogrid

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

 

Integração Protheus x DRP NeogridFevereiro/2015

 

Âncora
_Toc379529482
_Toc379529482
Âncora
_Toc379532242
_Toc379532242
Âncora
_Toc379549388
_Toc379549388
Âncora
_Toc380063575
_Toc380063575
Âncora
_Toc380486751
_Toc380486751
Âncora
_Toc380496056
_Toc380496056
Sumário

...

  • A importação dos arquivos recebidos pelo DRP é realizada através do job LOJA7033, sendo gravados em uma pasta determinada através do parâmetro MV_LJNEOIN e, a partir daí, geradas as devidas movimentações no Protheus (solicitação ou pedido) conforme configuração. Após o Protheus® ler esses arquivos, os mesmos serão movidos para uma outra pasta através da configuração do parâmetro MV_LJNERCV, que serão guardados todos os arquivos de retorno processados.
  • Caso algum item do XML não foi seja processado por motivo de falta de estoque, produto inexistente, etc., o XML é XML  será recriado somente com os itens não processados e copiará imediatamente na pasta IN. AssimDesta forma, será  será processado novamente na próxima leitura. 

Âncora
_Toc363117578
_Toc363117578
Âncora
_Toc380496061
_Toc380496061

Pré-requisitos instalação/implantação/utilização

 

  • Execução do update de base UPDLO119, conforme Procedimentos para Implementação.
  • Adquirir junto a NeoGrid o Client (StartClient) e instalar na Raiz do Back Office Protheus®.
  • Criar Schedule para gerar e importar os XMLs.

 

Instalação Client Neogrid

...

    • OUT:* Pasta que o Job LOJA7030 deverá criar os XMLs para exportação.
    • SENT:* Quando os XMLs da pasta OUT são enviados para o DRP, os arquivos são movidos para esta pasta SENT.
    • SUMMARY:* Relatório de envio dos XMLs.
    • IN:* Pasta onde irá retornar os XMLs criados pelo DRP. Estes XMLs irão para o Job LOJA7033, retornando dados ao Protheus.
    •  RECEIVED: Quando os XMLs da pasta IN são lidos pelo Job de retorno LOJA7033, os arquivos são movidos para esta pasta RECEIVED.

      Protheus

 

  1. No Configurador (SIGACFG) acesse Ambientes/Cadastro/Menu (CFGX013) e configure o(s) parâmetro(s) a seguir:

...

Nome Var.

MV_LJNEESP

Tipo

C - Caracter

Descrição

Informe a espécie específica para transferência entre filiais.


Cadastros        Cadastros de Tipos de Eventos:

  1. No Controle de Lojas (SIGALOJA) acesse Atualizações/Cadastros/Tipo de Eventos (LOJA7032).
  2. Clique na opção Incluir. Caso o cadastro esteja zerado, é aberta automaticamente a tela de Inclusão.
  3. Preencha os campos necessários para o cadastro, de acordo com as respectivas informações:
    Código: É preenchido automaticamente pelo Protheus®.
    Descrição: Informe o nome do Tipo de Evento.
  4. Confira  Confira os dados e Confirme.

       Cadastro de Eventos:

  1. No Controle de Lojas (SIGALOJA) acesse Atualizações/Cadastros/Eventos (LOJA7031).
    O Cadastro de Evento se refere a um acontecimento que afeta o mercado e pode ser filtrado por: Fornecedores, Produto, Grupo de Produto, Categoria, Armazém e Inclusão de Tipos de Eventos.
  2. Clique em Incluir. Caso o cadastro esteja zerado, é aberta automaticamente a tela de Inclusão.
  3. Preencha os campos necessários para o cadastro, de acordo com as respectivas informações:
    Codigo Event: O código é preenchido automaticamente pelo Protheus®.
    DescrEvent: Deve ser preenchido a descrição do evento.
    Tipo Evento: Código do tipo de evento, busca no cadastro de tipo de eventos e apresenta na tela a descrição do tipo de evento.
    Link: Endereço digital do link do evento, caso exista.
    Inicio Event: A data em que o evento se inicia.
    Fim Evento: A data em que o evento se encerra.
    Avisa Termin: Avisa o termino do evento.
    Dias Anteced: Quantidade de dias de antecedência do aviso de término.
    Tipo Impacto: Qual o tipo de impacto que o evento vai refletir nas vendas (Percentual / Absoluto).
    Imp Previsto: O impacto previsto em valores, de acordo com a escolha no campo Tipo de Impacto.
    Imp Real: O impacto que o evento realmente proporcionou em valores, de acordo com a escolha no campo Tipo de Impacto.
  4. Confira os dados e Confirmeconfirme.
  5. Configure os Filtros do Evento:

      Filtros do Evento: Para cadastrar os filtros, existem 3 pastas, mas para efetuar o filtro, é necessário que seja cadastrado no mínimo um (1) filtro em uma das pastas.
      Produto

  • Produto: Filtro por código de produto.
  • Grupo de Prod: Filtro por grupo de produto.
  • Categoria: Filtro por categoria.

      Observação: Você pode unir produto com grupo e/ou categoria separando em mais de um registro.
      Fornecedor

  • Cod Fornec: Filtro por Fornecedor.

       Armazém

  • Armazém: Filtro por armazém.

     Confira os dados e clique em Confirmar.

Pré       Pré-Requisitos cadastro – Para envio de arquivos para DRP:
        Cadastros:

  1. No SIGALOJA (SIGALOJA) acesse Atualizações/Cadastros /Produtos (LOJA110).
  2. Efetue o cadastro de produtos.

       Importante
Obrigatoriamente        Obrigatoriamente devem ser preenchidos os campos Fornecedor Padrão (B1_PROC) e Loja Padrão (B1_LOJPROC).

  1. Acesse Atualizações /Cadastros /Complemento do Produto (MATA180).
  2. Cadastre no mínimo 1 (um) complemento de produto.
  3. Acesse Atualizações /Cadastros /Categorias (FATA140).
  4. O produto deve estar associado a uma Categoria. Deve ser cadastrado no mínimo 2 (dois) tipos de categoria para o produto mencionado acima.

        Exemplo: O produto

  1.  O  produto está na categoria Linha TV

...

  1. , esta é uma categoria filho.
  2.  Cadastre uma categoria pai como Eletrônicos.

...

  1.  Em seguida, altere a categoria filho: no campo Categoria Superior, digite o código da categoria pai e confirme.    
      Lembrando que é a categoria principal como filho, a categoria superior como pai, etc, respeitando sua hierarquia.
  1. Acesse Atualizações/Cadastros /Amarração Categoria x Produto (FATA150).
  2. Efetue a amarração do produto x categoria.
  3. Acesse Atualizações /Cadastros/Grupo de Produtos (MATA035).
  4. Cadastre no mínimo 1 (um) grupo de produtos.
  5. Acesse Atualizações/Gerência Estoques/Fornecedores (MATA020).
  6. Efetue o cadastro de fornecedores.
  7. Acesse Atualizações /Cadastros / Locais de Estoque (AGRA045).
  8. Efetue o Cadastro Locais de Estoque.

       Pré-requisitos - Cadastro de Transferência entre Filiais para o DRP 

       Importante

       É necessário ter duas filiais, uma origem (exemplo: D MG 01) e uma destino (exemplo: D MG 02).

         Configure o parâmetro: MV_FILTRF := .T.
 

  1. No Controle de Lojas (SIGALOJA) acesse  Atualizações/ Cadastros/ Produtos (LOJA110)  
  2. Configure os campos:  Grupo;  Fornecedor Padrão; Loja Padrão;
  3. Preencha os campos da pasta Mrp/Suprimentos:
    Ponto Pedido;
    Segurança;   
    Lote Econômico;    
    Lote Mínimo (deve ser menor que Lote Econômico);
    Estoque Máximo (deve ser maior que Ponto Pedido).

  4. Acesse Atualizações / Cadastros / Locais de Estoque (AGRA045):
  5. Crie um segundo armazém para a filial de origem.
  6. Acesse Atualizações / Cadastros/ Saldos, Atual (MATA225).
  7. Cadastre os produtos com seus novos armazéns e confirme.
  8. Acesse Atualizações / Cadastros / Clientes (MATA030)
  9. Crie um código para a filial de destino, e na descrição, especificar que é aquela filial.    
    Importante  
    Caso o cadastro COMPARTILHADO, não é necessário sair de uma filial e entrar na filial de origem. Se for cadastro EXCLUSIVO, verifique se está na filial de origem.
  10. Na pasta Outros, digite a filial de destino no campo Fil. Transf. 
  11. Acesse  Cadastros / Gerência Estoque / Fornecedores (MATA020). 11  Crie um código para a filial de origem, e na descrição, especificar à filial.  
    Importante
  12. Caso o cadastro seja COMPARTILHADO, não é necessário sair de uma filial e entrar na filial de destino. Se for cadastro EXCLUSIVO, verifique se está na filial de destino. 
  13. Na pasta Outros, digite a filial de origem no campo Fil. Transf.    
  14. Acesse  Gerência de Vendas, Tipos de Entrada e Saída (MATA080) . 
  15. Cadastre primeiro o tipo para Saída:
  • Tipo do Tes: Saída
  • Cred. Icms: Não
  • Credita IPI: Não
  • Gera Dupl: Não
  • Atu. Estoque: Sim
  • Poder Terc: Não Controla
  • Tes Devolução: <o código tes de entrada, volte a cadastrar após fazer o TES como entrada>
  • Mov. Projet: Despesa
  • Transf. Filial: Sim

       16. Cadastre o tipo para Entrada.

  • Tipo do Tes: Entrada
  • Cred. Icms: Não
  • Credita IPI: Não
  • Gera Dupl: Não
  • Atu. Estoque: Sim
  • Poder Terc: Não Controla
  • Tes Devolução: <o código tes de saída>
  • Mov. Projet: Receita
  • Transf. Filial: Sim 

          Caso o  cadastro seja  COMPARTILHADO, será necessário efetuar apenas um cadastro de entrada e outro de saída. Se for cadastro EXCLUSIVO, tem que fazer um cadastro de entrada e outro de saída para cada filial.

     17   No Estoque (SIGAEST) filial de origem, acesse Atualizações /Movimentações /Fiscais, Transferência entre Filiais (MATA310).  

     18   Preencha os parâmetros abaixo:

  • De produto: <brancos>
  • Até produto: ZZZZ.
  • De filial: <filial de origem>
  • Até filial: <filial de destino>
  • De armazém: <brancos>
  • Até armazém: 99
  • De tipo: <brancos>
  • Até tipo: ZZ
  • De grupo? <brancos>
  • Até grupo? 9999
  • Filtra produtos por categoria? Sim
  • Quebra informações? Por produto
  • TES para a nota de saída? <a nota de saída específica para Transf. Filiais conforme cadastrado acima>
  • Gera documento de entrada? Classificado
  • TES para a nota de entrada? <a nota de entrada específica para Transf. Filiais conforme cadastrado acima>
  • Condição de Pagamento? <padrão>
  •  Considera como preço no PV?  Tabela de Preço
  •  Dados da Origem: Todas as filiais
  •  Utilizar saldo de terceiros? Não
  •  Espécie documento de entrada? NF
  •  Descrição de Produtos? Não
  •  TP. Oper Saída? <brancos>
  •  Tp. Oper Entrada? <brancos>

     19 Marque todas as categorias.

          Observe a tela de Transferência entre Filiais:    

          No lado esquerdo, temos a origem.

          No lado direito, temos o destino.

     20. No lado esquerdo, selecione a filial de origem e o produto que deseja transferir.

     21  No lado direito, selecione a filial de destino e o produto que deve receber a transferência.

     22. Clique em  Ações Relacionadas, e clique em Relação.

     23   Digite a quantidade a ser transferida, e confirme.       

           Observe que a quantidade disponível foi alterada na origem e no destino. 

    24.  Clique em confirmar.

    25.  Selecione a série desejada e confirme.     

           Aguarde a transferência.    

         Observe que a transferência foi gerada na SD2 (saída) e na SD1 (entrada).
   No Estoque (SIGAEST) filial de  origem, acesse Atualizações / Movimentações / Transferência Múltipla (MATA261). 27.    Clique em Incluir. 28.    Digite o produto de origem, e o armazém de origem. Na mesma linha, digite o produto de destino e o armazém de destino. 29.    Na mesma linha, digite a quantidade, e confirme.          Observe que a transferência entre Armazéns foi gerada na tabela SD3, criando dois registros: um de saída de armazém e outro de entrada de armazém, identificados como D3_LOCAL.

        Pré - requisitos - Envio de movimentações para DRP: Venda

  1. No Controle de Lojas(SIGALOJA) acesse SIGALOJA/Atualizações /Atendimento/Venda Assistida (LOJA701).
  2. Efetue uma venda A integração envia informações de devolução se houver. 

        Pedido de Compra:

  1. No Controle de Lojas (SIGALOJA) acesse Atualizações/Gerência Estoques/Pedidos de Compra (MATA121).
  2. Efetue um pedido compra. Para que seja realizada a exportação, é necessário que o pedido esteja em aberto.

            Importante

 As movimentações de vendas e devolução (SD2 e SD1), assim como os pedidos de compra (SC7), devem ser feitas no mesmo dia da exportação para o DRP, pois são enviadas as movimentações SKU e DFU com o  resumo                         de quantidade vendida/devolvida diária por produto.

       Configuração do Envio - Agendamento:

  1. No Configurador (SIGACFG) acesse Ambiente/Schedule/Schedule (CFGA010). Configure o Schedule para o Envio das Informações.
  2. Efetue o cadastro de um Agent em Visões/Schedule/Agent/Cadastro.
  3. Preencha os campos necessários para o cadastro de acordo com as respectivas informações:
  • Código: O código é preenchido automaticamente pelo Protheus.
  • Nome: Deve ser preenchido a descrição do Agent.
  • Ip: IP onde o Agent será instalado.
  • Porta: Porta do IP onde o Agent será instalado.
  • Ambiente: Ambiente do Agent cadastrado.
  • Empresa: Código da empresa das tarefas que o Agent cadastrado irá executar.
  • Nº de Threads: Número de threads disponíveis para execução das tarefas.
  • Habilitado: Indica se o Agent está habilitado ou desabilitado.
  1. Efetue o cadastro de um Agendamento em Visões/Schedule/Agendamentos/Cadastro.
  2. Preencha os campos necessários para o cadastro de acordo com as respectivas informações:
  • Rotina: Rotina agendada LOJA7030({,0,<empresa>,<filial>}). Exemplo: LOJA7030({,0,"05","D MG 01"}).
  • Empresa/Filial: Empresa e filial que são utilizadas para execução do agendamento.
  • Módulo: Ambiente do Protheus®.
  • Habilitado: Indica se o Agent está habilitado ou desabilitado.
  1. Configure os parâmetros de acordo com as respectivas informações para o envio da rotina Agendada LOJA7030({Param1,Param2,Param3,Param4}) Data (Param1): Data corrente dos dados a serem pesquisados. Data em branco entende que irá pesquisar a data de hoje. Para utilizar uma data à sua escolha, utilize o parâmetro STOD("AAAAMMDD"), onde AAAA é o ano, MM é o mês e DD é o dia. Exemplo: STOD("20151201"). Opção de Envio (Param2): Escolher entre as opções de envio (conforme o item 7 abaixo). Empresa (Param3): Empresa do ambiente. Filial (Param4): Filial do ambiente.
  2. Na opção Rotina informe LOJA7030({,0,<empresa>,<filial>}) para configurar o envio de todos os itens:
  3. Todos os itens LOJA7030({,0,<empresa>,<filial>})   Também é possível configura-os separadamente, conforme instruções abaixo:
    • Itens do Produto: LOJA7030({,4,<empresa>,<filial>})
    • Movimentações de Local de Estoque: LOJA7030({,5,<empresa>,<filial>}). Fazendo isto, automaticamente será gerada a Origem da SKU, igual a LOJA7030({,6,<empresa>,<filial>}).
    • Cadastro de Local de Estoque (Tabela NNR): LOJA7030({,7,<empresa>,<filial>})
    • Movimentação de SKU: LOJA7030({,8,<empresa>,<filial>})
    • Movimentação de DFU: LOJA7030({,9,<empresa>,<filial>})
    • Cadastro de Eventos: LOJA7030({,10,<empresa>,<filial>})
    • Linha de Pedidos Colocados (Pedidos de Compra): LOJA7030({,12,<empresa>,<filial>})
    • Fornecedor: LOJA7030({,13,<empresa>,<filial>})

                     Importante

                     A configuração do Job deve ter recorrência diária (executando uma por dia, dê preferência  após o expediente).

                     Todos os lançamentos devem ser lidos e exportados para o DRP, sem exceções.

                     Caso esqueça de alguma movimentação em uma data anterior, é possível passar a data retroativa dos movimentos não transferidos ao primeiro parâmetro, no formato:

                     AAAAMMDD, em um novo Job, que deve ser executado somente uma vez.

                     Exemplo: LOJA7030({"20151201",0,<empresa>,<filial>}). 

       Configuração do Recebimento - Agendamento:

  1. No Configurador (SIGACFG) acesse Ambiente/Schedule/Schedule (CFGA010).  Configure o Schedule para o Recebimento das Informações.
  2. Inclua um agendamento com as configurações de recorrência, código, usuário, data, hora, ambiente, configurar empresa/filial e módulo.
  3. Efetue o cadastro de um Agendamento em Visões/Schedule/Agendamentos/Cadastro (CFGA010).
  4. Preencha os campos necessários para o cadastro, de acordo com as respectivas informações:
  • Rotina: Rotina Agendada LOJA7033 ({0,<empresa>,<filial>}). Exemplo: LOJA7033({0,"05","D MG 01"}).
  • Empresa/Filial: Empresa e filial que serão utilizadas para execução do agendamento.
  • Módulo: Módulo do Protheus®.
  • Habilitado: Indica se o Agent está habilitado ou desabilitado.
  • Configure os parâmetros de acordo com as respectivas informações para o envio da rotina Agendada LOJA7033({Param1,Param2,Param3})
  • Opção de Envio (Param1): Use 0, para ler todos os itens.
  • Empresa (Param2): Empresa do ambiente. 
  • Filial (Param3): Filial do ambiente.
    Após a configuração do passo anterior, o Protheus® envia as informações necessárias ao DRP e inclui os devidos documentos para que seja feita a continuidade do processo no ERP.

             Após a exportação para o DRP, é necessário aguardar o processamento no DRP para depois receber o retorno. 
           

           Envio de informações para DRP :

           Observe o envio das informações no client da Neogrid, nas seguintes pastas:

  • OUT: Pasta que o Job LOJA7030 cria os XMLs para exportação.
  • SENT: Quando os XMLs da pasta OUT são enviados para o DRP, os arquivos são movidos para esta pasta SENT.
  • SUMMARY: Relatório de envio dos XMLs.

          Importante

          Cancelamento da Nota Fiscal:

          Após o envio dos itens para DRP, não será possível cancelar uma nota fiscal, em SIGAFAT/Atualizações/Faturamento/Exclusão Doc. Saída (MATA521).

          Para isso, basta emitir uma nota de entrada, do tipo Devolução. Desta forma, os itens de devolução são enviados para DRP.

          Retorno de informações para DRP:

          Verifique no Client da Neogrid, as seguintes informações:

  • Pasta IN (Client Neogrid): Pasta onde retorna os XMLs criados pelo DRP. Estes XMLs são enviados para o Job LOJA7033, retornando dados ao Protheus.
  • Pasta RECEIVED: Quando os XMLs da pasta IN são lidos pelo Job de retorno LOJA7033, os arquivos são movidos para esta pasta RECEIVED.
  • Caso algum item do XML não seja  processado por motivo de falta de estoque, produto inexistente, etc., o XML é recriado somente com os itens não processados e copia imediatamente na pasta IN. Assim, será processado novamente na próxima leitura.
  • A configuração do parâmetro MV_LJNEOPV determina o tipo de documento incluído no retorno das análises do DRP. Este parâmetro define como este retorno será gravado no Protheus. Os valores configuráveis de retorno são: 1 – Solicitação de Compra, 2 – Pedido de Compra, descritos abaixo:
  •  Solicitação de Compra: quando for efetuada uma análise prévia sobre as sugestões de compras no próprio DRP, são geradas solicitações para que sejam avaliadas e efetivadas se realmente necessárias.
  • Pedido de Compra: quando é efetuada uma análise sobre as sugestões de compras no próprio DRP, que permite gerar os pedidos de compras, para serem convertidos em NF de entrada posteriormente

             Para consultar as solicitações de Compras: 

             No Controle de Lojas  (SIGALOJA) acesse Gerência Estoque/Solicit. De Compras (MATA110).

  1. Ao consultar a tabela, é possível identificar que solicitação foi gerada pelo DRP, através do campo "DRP Neogrid?" = "Sim".

           Para consular as solicitações de Pedido de Compra:  .

  1. No Controle de Lojas (SIGALOJA) acesse Gerencia Estoque/Pedidos de Compra (MATA121).
  2.  Ao consultar a tabela, é possível identificar que  o pedido foi gerado pelo DRP, através do  campo DRPNeogrid?"Sim".

Importante

Independente da seleção para solicitação ou pedido de compra, poderá apresentar  no mesmo arquivo XML informações sobre transferências, tanto entre filiais como entre armazéns.

Para consultar Transferências entre filiais:

Transferência de Estoque entre Filiais: quando for efetuada uma análise sobre sugestões de compras no próprio DRP, são geradas transferências entre movimentações de estoque de uma filial para outra.

  1.  No Estoque (SIGAEST) acesse Atualizações/Movimentações/Fiscais/Transf. Filiais (MATA310).
  • Transferência de Estoque entre Armazéns: quando for efetuada uma análise sobre sugestões de compras no próprio DRP, são geradas transferências entre movimentações de estoque de um armazém para outro, na mesma filial. Está localizado em SIGAEST/Atualizações/Movimentações/Internas/Transf. Múltipla (MATA261).

Pré-requisitos - Cadastro de Transferência entre Filiais para o DRP

...