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.

...

1. Contexto de negócio (Introdução)
2. Sistemas Envolvidos
3. Integração
4. Escopo
5. Pré-requisitos instalação/implantação/utilização
5.1. Datasul
5.2. Logix
5.3. Protheus
5.4. RM
6. Instalação/Atualização
6.1. Datasul
6.2. Logix
6.3. Protheus
6.4. RM
7. Controle de Versão
8. Suporte
9. Transações/Entidades/Mensagens únicas
10. Fluxo das Informações
10.1. Cadastros
10.2. Processos
11. Fluxo das Informações
12. Como fazer (opcional)
13. Situações comuns (opcional)


14. Checklist de suporte da aplicação
15. Anexos aplicação 

Âncora
_Toc363117574
_Toc363117574
Âncora
_Toc380496057
_Toc380496057
Contexto de negócio (Introdução)


Efetuar a integração do Back Office Protheus® com a NeoGrid (produto DRP – Distribution Resource Planning) através do envio de informações de vendas e de posições de estoque, que são processadas e analisadas pelo DRP com o objetivo de sugerir recomendações de solicitações ou pedidos de compra.
A principal vantagem da integração, é permitir o balanceamento de estoques dos produtos varejistas da cadeia de processos, considerando o histórico de consumo de indústrias e varejos com foco no aumento do giro, redução de rupturas e consumo real. Como consequência, possibilita outras vantagens na gestão de estoques, como aumento da rentabilidade, Market Share, foco na distribuição interna, gerenciamentos dos estoques, reposição adequada dos produtos em seus Centros de Distribuição (CDs) e otimização da produção e logística.
Suas principais premissas são, evitar:

...

  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

     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:

...

         Observe que a transferência foi gerada na SD2 (saída) e na SD1 (entrada).

Transferência entre Armazéns:   No

  1. No Estoque (SIGAEST) filial de  origem, acesse Atualizações / Movimentações / Transferência Múltipla (MATA261).

...

  1. Clique em Incluir.

...

  1.  Digite o produto de origem, e o armazém de origem.
  2. Na mesma linha, digite o produto de destino e o armazém de destino.

...

  1.  Na mesma linha, digite a quantidade, e confirme.

...

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


  1. 9. No SmartClient, vá em SIGACFG/Base de Dados/Dicionário/Base de Dados (CFGX031):

     

    9.1. Na aba Parâmetros, cadastre:

     

    MV_LJNETES := <código criado no item 6.1>

     

    MV_LJNETEE := <código criado no item 6.2>

     

    MV_LJNECPT := <condição de pagamento padrão>

     

    MV_LJNESER := <série específica para transferência entre filiais ou à sua escolha>

     

    MV_LJNEESP := <NF ou NFE ou NFF, dependendo da espécie utilizada no dia a dia>

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

...

  • 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

Importante

Ter duas filiais: uma origem (exemplo: D MG 01) e uma destino (exemplo: D MG 02)

MV_FILTRF := .T.

 

1. No SmartClient, vá em SIGALOJA, Atualizações, Produtos (LOJA110)

Cadastre os campos:

- Grupo

- Fornecedor Padrão

- Loja Padrão

Aba Mrp/Suprimentos:

- Ponto Pedido

- Segurança

- Lote Econômico

- Lote Mínimo (deverá ser menor que Lote Econômico)

- Estoque Máximo (deverá ser maior que Ponto Pedido)

2. No SmartClient, vá em SIGALOJA, Atualizações, Locais de Estoque (AGRA045):

2.1. Favor criar um segundo armazém para a filial de origem.

3. No SmartClient, vá em SIGAEST, Atualizações, Saldos, Atual (MATA225)

3.1. Cadastre os produtos com seus novos armazéns. Clique em Confirmar.

4. No SmartClient, vá em SIGALOJA, Atualizações, Clientes (MATA030)

4.1. Favor criar um código para a filial de destino, e na descrição, especificar que é aquela filial.

OBS: Se for 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.

4.2. Na aba Outros, digite a filial de destino no campo Fil. Transf. Importante para o parâmetro MV_FILTRF := .T.

5. No SmartClient, vá em SIGALOJA, Cadastros, Gerência Estoque, Fornecedores (MATA020)

5.1. Favor criar um código para a filial de origem, e na descrição, especificar que é aquela filial.

OBS: Se for cadastro 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.

5.2. Na aba Outros, digite a filial de origem no campo Fil. Transf. Importante para o parâmetro MV_FILTRF := .T.

6. No SmartClient, vá em SIGALOJA, Gerência de Vendas, Tipos de Entrada e Saída (MATA080)

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

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

OBS: Se for cadastro COMPARTILHADO, um cadastro de entrada e outro de saída já satisfaz. Se for cadastro EXCLUSIVO, tem que fazer um

cadastro de entrada e outro de saída para cada filial.

7. No SmartClient, na filial de origem, vá em SIGAEST, Atualizações, Movimentações, Fiscais, Transferência entre Filiais (MATA310)

7.1. Preencha os campos na janela 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>

7.2. Marque todas as categorias.

7.3. Observe a tela de Transferência entre Filiais:

No lado esquerdo, temos a origem.

No lado direito, temos o destino.

No lado esquerdo, escolha a filial de origem e o produto que queira transferir.

No lado direito, escolha a filial de destino e o produto que deverá receber a transferência.

Vá em Ações Relacionadas, e clique em Relação.

 

7.4. Digite a quantidade a ser transferida. Clique em Confirmar.

 

7.5. Veja que a quantidade disponível foi alterada na origem e no destino. Clique em Confirmar.

 

7.6. Escolha a série desejada e clique no tique verde.

 

7.7. Aparecerá uma janela inicial e clique direto em Confirmar. Aguarde a transferência.

 

7.8. Veja que a transferência foi gerada tanto na SD2 (saída) quanto na SD1 (entrada).

 

 

8. No Smartclient, na filial de origem, vá em SIGAEST, Atualizações, Movimentações, Transferência Múltipla (MATA261).

 

8.1. Clique em Incluir.

 

 

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

 

8.3. Na mesma linha, digite a quantidade. Clique no botão Confirmar.

 

8.4. Repare que foi feito a Transferência entre Armazéns na tabela SD3, criando dois registros: um de saída de armazém e outro de entrada de

 

armazém, identificados como D3_LOCAL.

 

9. No SmartClient, vá em SIGACFG/Base de Dados/Dicionário/Base de Dados (CFGX031):

 

9.1. Na aba Parâmetros, cadastre:

 

MV_LJNETES := <código criado no item 6.1>

 

MV_LJNETEE := <código criado no item 6.2>

 

MV_LJNECPT := <condição de pagamento padrão>

 

MV_LJNESER := <série específica para transferência entre filiais ou à sua escolha>

 

MV_LJNEESP := <NF ou NFE ou NFF, dependendo da espécie utilizada no dia a dia>

  • 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é Pré - requisitos - Envio de movimentações para DRP:
Venda     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.

...

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

        4. Efetue o cadastro de um Agendamento em Visões/Schedule/Agendamentos/Cadastro.

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

6         6. 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 entenderá que irá pesquisar a data de hoje. Para utilizar uma data à sua escolha, utilize o parâmetro "AAAAMMDD", onde AAAA é o ano, MM é o mês e DD é o dia. Exemplo: "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.

7         7. Na opção Rotina informe LOJA7030({,0,<empresa>,<filial>}) para configurar o envio de todos os itens:

  • Todos os itens: LOJA7030({,0,<empresa>,<filial>})

Ou testar          Também podem ser configurados separadamente, um por um:

        • Itens do Produto. LOJA7030({,4,<empresa>,<filial>})
        • Movimentações de Local de Estoque. LOJA7030({,5,<empresa>,<filial>}). Fazendo isto, automaticamente gerará 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 vez por dia, de preferência após o expediente). Todos os lançamentos devem ser lidos e exportados para o DRP, sem exceções. Caso haja esquecimento de alguma movimentação em uma data anterior, se preferir, é possível passar a data retroativa dos movimentos não transferidos ao primeiro 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.
  5. 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.
  6. Confira os dados e confirme.

...

Após o envio, não será possível cancelar uma nota fiscal cujos itens já foram enviados pelo DRP em SIGAFAT/Atualizações/Faturamento/Exclusão Doc. Saída (MATA521). Para isso, basta emitir uma nota de entrada, do tipo Devolução. Os dados da devolução também irão para o DRP.

      Retorno de informações para DRP:

...