Integração Protheus x DRP Neogrid

...

Âncora
_Toc379529482 _Toc379529482

Âncora
_Toc379532242 _Toc379532242

Âncora
_Toc379549388 _Toc379549388

Âncora
_Toc380063575 _Toc380063575

Âncora
_Toc380486751 _Toc380486751

Âncora
_Toc380496056 _Toc380496056

Sumário

1. Contexto de negócio (Introdução)
2. Sistemas Envolvidos
3. Integração
4. Escopo
5. Pré-requisitos instalação/implantação/utilização
6. Instalação/Atualização
7. Controle de Versão
8. Suporte
9. Transações/Entidades/Mensagens únicas
10. Fluxo das Informações
10.1. Cadastros
10.2. Processos
Informações 
11. Fluxo das Informações Informações 

 12. Como fazer (opcional)
13. Situações comuns (opcional) 14. Checklist de suporte da aplicação 

Efetuar  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:

...

...

Escopo

...

A  NeoGrid (produto DRP – Distribution Resource Planning) disponibilizara um portal de acesso, com as seguintes opções: 

 Ao receber os arquivos, o DRP da NeoGrid analisa e processa as informações retornando sugestões de solicitações de compra ou pedidos de compra, conforme a configuração do Back Office Protheus®.
Os arquivos são gerados em pastas configuradas no Back Office Protheus®, e o upload e download é efetuado pelo Client da NeoGrid.

 Escopo

Disponibilizada as rotinas que permitem 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ção de estoque que são processadas e analisadas pelo DRP, com o objetivo de sugerir recomendações de solicitações, pedidos de compra ou transferência de estoque entre filiais.
O DRP (Sistema de Balanceamento de Estoques) tem a finalidade de aumentar a rentabilidade e participação no mercado por meio do balanceamento dos estoques da empresa, com base em informar o produto, a hora, o local e a quantidade no momento certo e permitir que os desafios da cadeia de suprimentos e demanda sejam atendidos.

Considerando o principal objetivo como aumento da rentabilidade através do balanceamento dos estoques temos:

• Redução do excesso de estoque.
• Maior velocidade de inserção de produtos novos no mercado.
• Redução dos níveis de obsolescência.
• Maior disponibilidade de produtos.
• Aumento do nível de serviço a clientes e consumidores.

Para melhor visualização da integração, observe o Fluxo de Troca das Informações e os Jobs envolvidos.
Image Added

• Cadastro Eventos (LOJA7031): O cadastro de eventos tem a finalidade de administrar situações internas ou externas que possam impactar na demanda e com isso alterar o planejamento de previsão de reposição de estoques nas lojas.       

        Filtros do Cadastro de Evento.

        Regras de aplicação do evento. Indica a quais SKUs o evento será aplicado, temos que incluir pelo menos 1 (um) filtro, dentre as três abas (Produto, Fornecedor, Armazém).

        Produto.

        Na aba Produto o evento pode ser filtrado pelo código do produto, grupo de produto, ou categoria de produto onde cada opção equivale um registro

        Fornecedor.

        Na aba Fornecedor o evento pode ser filtrado pelo código do fornecedor.

        Armazém.

        Na aba Armazém o evento pode ser filtrado pelo código do armazém. 
        Exemplos de eventos:

• Promoções
• Ações de liquidação da concorrência

• Problemas de abastecimento em função de problemas na rodovia 

• Abertura de nova loja do concorrente

• Cadastro Tipo de Eventos (LOJA7032): O cadastro de Tipo de Eventos tem como objetivo, incluir os tipos de eventos, que farão parte do cadastro de eventos para poder identificar melhor o evento em questão. 

        Exemplos de tipo de eventos:

• Promoção
• Ação Concorrência
• Perda
• Roubo

• Envio dos dados de estoque e vendas (Client Neogrid)

         O envio dos dados é feito via FTP através de um Job (Client NeoGrid), que monitora uma determinada pasta definida por parâmetro no Protheus (MV_LJNEOUT).
         As informações a serem enviadas a partir do Protheus ao DRP são:

• Itens do produto;
• Movimentações de Local de estoque;
• Origem da SKU;
• Cadastro de Local de Estoque;
• Eventos;
• Fornecedores;
• Movimentações de SKU;
• Movimentações de DFU;
• Pedidos de compra;

O objetivo deste envio é fornecer ao DRP Neogrid todas as informações necessárias para que sejam analisadas e assim definir as necessidades de compras buscando o balanceamento dos estoques.
As movimentações de SKU (Stock Keeping Unit, ou Unidade de Armazenamento de Estoque) e movimentações de DFU (Demand Forecast Unit, ou Unidade de Previsão de Demanda) contemplam todas as vendas emitidas tanto na Venda Assistida (SIGALOJA) na retaguarda quanto aos PDVs, originados no FrontLoja (SIGAFRT) ou no TOTVS PDV (SIGAFRT), interpretando dados da tabela de Itens de Notas Fiscais de Venda (SD2).
Devoluções nos Itens de Notas Fiscais de Entrada (SD1), gerados na rotina de Troca e Devolução do SIGALOJA (LOJA720), e Transferência de estoque entre filiais (SD3), também contemplam as movimentações de SKU.

Retorno de solicitação e pedidos de compra

O retorno dos dados é feito via FTP através de um Job (Client NeoGrid), e um Job do Protheus monitora uma determinada pasta definida por parâmetro (MV_LJNEOIN), com o objetivo de integrar com o Protheus as analises feitas do DRP através da importação de Pedido de Compra e Solicitação de Compra.

Em cada consulta de pedido de compra (MATA121) e solicitação de compra (MATA110), temos um campo chamado "DRP Neogrid

• Redução do excesso de estoque.
• Maior velocidade de inserção de produtos novos no mercado.
• Redução dos níveis de obsolescência.
• Maior disponibilidade de produtos.
• Aumento do nível de serviço a clientes e consumidores.

...

• Cadastro Eventos (LOJA7031).

             O cadastro de eventos tem a finalidade de administrar situações internas ou externas que possam impactar na demanda e com isso alterar o planejamento de previsão de reposição de estoques nas lojas.
        

         Filtros do Cadastro de Evento.

             Regras de aplicação do evento. Indica a quais SKUs o evento será aplicado, temos que incluir pelo menos 1 (um) filtro, dentre as três abas (Produto, Fornecedor, Armazém).

        Produto.

            Na aba Produto o evento pode ser filtrado pelo código do produto, grupo de produto, ou categoria de produto onde cada opção equivale um registro

        Fornecedor.

            Na aba Fornecedor o evento pode ser filtrado pelo código do fornecedor.

        Armazém.

            Na aba Armazém o evento pode ser filtrado pelo código do armazém.
            Exemplos de eventos:

• Promoções
• Ações de liquidação da concorrência

• Problemas de abastecimento em função de problemas na rodovia 

• Abertura de nova loja do concorrente

• Cadastro Tipo de Eventos (LOJA7032).

        O cadastro de Tipo de Eventos tem como objetivo, incluir os tipos de eventos, que farão parte do cadastro de eventos para poder identificar melhor o evento em questão.
        Exemplos de tipo de eventos:

• Promoção
• Ação Concorrência
• Perda
• Roubo

• Envio dos dados de estoque e vendas (Client Neogrid)

         O envio dos dados é feito via FTP através de um Job (Client NeoGrid), que monitora uma determinada pasta definida por parâmetro no Protheus (MV_LJNEOUT).
         As informações a serem enviadas a partir do Protheus ao DRP são:

• Itens do produto;
• Movimentações de Local de estoque;
• Origem da SKU;
• Cadastro de Local de Estoque;
• Eventos;
• Fornecedores;
• Movimentações de SKU;
• Movimentações de DFU;
• Pedidos de compra;

O objetivo deste envio é fornecer ao DRP Neogrid todas as informações necessárias para que sejam analisadas e assim definir as necessidades de compras buscando o balanceamento dos estoques.
As movimentações de SKU (Stock Keeping Unit, ou Unidade de Armazenamento de Estoque) e movimentações de DFU (Demand Forecast Unit, ou Unidade de Previsão de Demanda) contemplam todas as vendas emitidas tanto na Venda Assistida (SIGALOJA) na retaguarda quanto aos PDVs, originados no FrontLoja (SIGAFRT) ou no TOTVS PDV (SIGAFRT), interpretando dados da tabela de Itens de Notas Fiscais de Venda (SD2).
Devoluções nos Itens de Notas Fiscais de Entrada (SD1), gerados na rotina de Troca e Devolução do SIGALOJA (LOJA720), e Transferência de estoque entre filiais (SD3), também contemplam as movimentações de SKU.

Retorno de solicitação e pedidos de compra

O retorno dos dados é feito via FTP através de um Job (Client NeoGrid), e um Job do Protheus monitora uma determinada pasta definida por parâmetro (MV_LJNEOIN), com o objetivo de integrar com o Protheus as analises feitas do DRP através da importação de Pedido de Compra e Solicitação de Compra.

Em cada consulta de pedido de compra (MATA121) e solicitação de compra (MATA110), temos um campo chamado "DRP Neogrid?", que verifica se a solicitação ou se o pedido veio do Job de retorno da DRP.

Envio e Retorno das informações:

O envio e o retorno das informações é realizado através de 3 processos principais:

1. Gerar arquivos para envio;
2. Job (Client NeoGrid) para envio e recebimento das informações;
3. Importação para o Protheus.

Gerar arquivos para envio

Os arquivos com layout pré-definidos (ver detalhamento mais abaixo) são gerados através do Job LOJA7030, gravados em uma pasta determinada através do parâmetro MV_LJNEOUT e serão são enviados ao DRP através do Client NeoGrid (StartClient.exe).

Job Client NeoGrid (StartClient)

      Importação para o Protheus

• A importação dos arquivos recebidos pelo DRP é realizada DRP são realizados através do job LOJA7033,  gravados  e gravados em uma pasta determinada através do , conforme configuração do parâmetro MV_LJNEOIN e, a partir daí, geradas , e posteriormente  geradas as devidas movimentações no Protheus (solicitação ou pedido) conforme configuração. Após o Protheus® ler esses arquivos, os mesmos são movidos para uma outra pasta, através da configuração do parâmetro MV_LJNERCV, ( permite armazenar todos os arquivos de retorno processados).
• No Console, é apresentado se o retorno foi processado com sucesso ou não. No processamento de transferência entre filiais, caso for sucedido, aparecerá a origem e destino das filiais e a quantidade transferida.
  Image Added
• Caso algum item do XML não seja processado por motivo de falta de estoque, produto inexistente, etc., o XML  será recriado somente com os itens não processados e copia imediatamente na pasta IN. O arquivo é apresentado com NOMENCLATURA ret no final do arquivo, sendo necessário verificar o console ou o arquivo de logs. Desta forma,  será será processado novamente na próxima leitura. 

...

• Image Added

...

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

...

Importante
Verifique a gravação de Logs do Pedido de Compra, Solicitação de Compras e Transferência entre filiais na pasta autocom\logs (ambiente).

Image Added
Para ativação do arquivo de logs, basta digitar no appserver.ini as seguintes instruções: 

[LOGLOJA]

enable = 1

Importante

Para que os XML´s possam ser gravados no envio e retorno, tanto pelo Protheus como pela Neogrid, é estritamente necessário alterarmos as permissões da pasta

...

\WebEDIMercadorClient_V3.6.1

...

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

...

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

...

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 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 confirme.
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é-Requisitos – 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 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:

1.  O  produto está na categoria Linha TV, esta é uma categoria filho.
2.  Cadastre uma categoria pai como Eletrônicos.
3.  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 informe o nome da 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). 
12. Crie um código para a filial de origem, e na descrição, informe o  nome da filial.  
    Importante
13. 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. 
14. Na pasta Outros, digite a filial de origem no campo Fil. Transf.    
15. Acesse  Gerência de Vendas, Tipos de Entrada e Saída (MATA080) . 
16. 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).

     Transferência entre Armazéns:

...

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 (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.
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. 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):
7. Escolher entre as opções de envio .
8.  Empresa (Param3): Empresa do ambiente. Filial (Param4): Filial do ambiente.
9. Na opção Rotina informe LOJA7030({,0,<empresa>,<filial>}) para configurar o envio de todos os itens:
10. Todos os itens LOJA7030({,0,<empresa>,<filial>})   Também é possível configura-os separadamente, conforme instruções abaixo:
11. 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

...

para permissão de leitura e gravação.

Modo de Compartilhamento de Tabelas

Para o correto funcionamento da Integração Protheus x DRP Neogrid, é necessário atentar-se ao modo de compartilhamento das seguintes tabelas:

Quando não há gestão de grupos de empresas configurada, as tabelas Produtos (SB1) e Fornecedores (SA2) deverão estar em modo de acesso compartilhado.

Ou quando há gestão de grupos de empresas:

Transferência de estoque entre empresas:

Caso seja necessário efetuar transferência de estoque entre empresas, é necessário que o modo de compartilhamento de tabelas seja configurado conforme exemplo abaixo:

Transferência de estoque entre unidades de negócio:

Caso seja necessário efetuar transferência de estoque entre unidades de negócio, é necessário que o modo de compartilhamento de tabelas seja configurado conforme exemplo abaixo:

Transferência de estoque entre filiais:

Caso seja necessário efetuar transferência de estoque entre filiais, é necessário que o modo de compartilhamento de tabelas seja configurado conforme exemplo abaixo:

É obrigatório, no mínimo, transferência de estoque entre filiais, obrigando a configuração no item acima.

Além da tabela Produtos (SB1) estar compartilhada, as tabelas Produtos (SB1) e Dados Adicionais do Produto (SB5) devem possuir o mesmo compartilhamento, evitando inconsistências devido a compartilhamentos incorretos.

É importante que para o funcionamento completo da integração Protheus x DRP Neogrid, todos os produtos deverão estar disponíveis em todos os locais de estoque acessíveis. E para cada produto, deverá estar representado por um fornecedor, que também deverá estar acessível para todos os locais de estoque.

Local de estoque, para o DRP, representa a localização da filial mais o número do armazém daquela filial. No Protheus, cada filial poderá ter um ou mais armazéns. Este local de estoque poderá ser uma loja ou um centro de distribuição.

Importante

Caso a configuração não respeite estas regras, será exibido uma mensagem ao entrar no Job de Envio (LOJA7030) que existe incompatibilidade de acesso entre tabelas.

Â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

O Client (StartClient.exe) deve ser adquirido junto a NeoGrid (as informações estão disponíveis no site http://www.neogrid.com) e instalado na Raiz do Protheus®.
O parâmetro MV_LJNEOIN (pasta que receberá os arquivos para download, Pedido de Compra, Solicitação de Compra) deve conter o caminho especificado na configuração de recebimento do Client. Ex: "\Client Neogrid\WebEDIMercadorClient_V3.6.1\IN\" ou "\ClientMercador\Bin\IN\".
O parâmetro MV_LJNEOUT (pasta que receberá os arquivos para upload, informações geradas pelo Protheus®) deve conter o caminho especificado na configuração de envio do Client. Ex: "\Client Neogrid\WebEDIMercadorClient_V3.6.1\OUT\" ou "\ClientMercador\Bin\OUT\".
Ao entrar em contato com a Neogrid, peça o arquivo Client DRP. Aguarde o retorno até receber o arquivo compactado de instalação. Descompacte esse arquivo e mova para dentro do RootPath.

Exemplos da estrutura de pastas após a instalação:
Image Added

Image Added

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

       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 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 confirme.
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: É possível unir o 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é-Requisitos – Envio de arquivos para DRP:
     

       Cadastros:

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

     Importante
Se a tabela SA2 (Fornecedores) for compartilhada, obrigatoriamente devem ser preenchidos os campos: Fornecedor Padrão (B1_PROC) e Loja Padrão (B1_LOJPROC).

3. Se a tabela SA2 (Fornecedores) for exclusiva, acesse Atualizações / Gerencia Estoque / Produto x Fornecedor (MATA060).

4. Relacione cada filial, cada fornecedor e cada produto, lembrando que o cadastro não permite mais de um fornecedor para o mesmo produto e filial.

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 3 (três) tipos de categoria para o produto mencionado acima.

     Exemplo:

1.  O  produto está na categoria Linha TV, esta é uma categoria filho.
2.  Cadastre uma categoria pai como Eletrônicos.
3.  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 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. No SmartClient, vá em APSDU. 
9. Abra o SIGAMAT.EMP. Está na pasta System, listar apenas os arquivos do tipo: Todos os arquivos.   
10. Precisamos de CNPJs diferentes para filial 01 e filial 02, que vamos utilizar para os próximos passos. Favor cadastrar. 
11. No SIGALOJA, acesse Atualizações / Cadastros / Clientes (MATA030).
12. Crie um código para a filial de destino, e na descrição informe o nome da filial.
13. Na pasta Outros, digite a filial de destino no campo Fil. Transf.
14.  Crie um código para a filial de origem, e na descrição, especificar que é aquela filial.
15.  Na pasta Outros, digite a filial de origem no campo Fil. Transf. 
    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, e depois, cadastrar na filial de destino. 
16. Acesse  Cadastros / Gerência Estoque / Fornecedores (MATA020). 
17. Crie um código para a filial de origem, e na descrição, informe o  nome da filial.  
18. Na pasta Outros, digite a filial de origem no campo Fil. Transf.
    
19. Crie um código para a filial de destino, e na descrição, especificar a filial.  
20. Na pasta Outros, digite a filial de destino no campo Fil. Transf.
     Importante
    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, e depois, cadastrar na filial de origem. 
21. Acesse  Gerência de Vendas, Tipos de Entrada e Saída (MATA080) . 
22. 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  
  
  23. 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 
   

         Importante          

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

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

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

     26. Marque todas as categorias.

          Observe a tela de Transferência entre Filiais:    

          No lado esquerdo, temos a origem.

          No lado direito, temos o destino.

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

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

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

     30.   Digite a quantidade a ser transferida, e confirme.       

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

    31 Clique em confirmar.

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

       Transferência entre Armazéns:

1. No Estoque (SIGAEST) filial de  origem, acesse Atualizações / Movimentações / Transferência Múltipla (MATA261).
2. Clique em Incluir.
3. Digite o produto de origem, e o armazém de origem.
4. Na mesma linha, digite o produto de destino e o armazém de destino. 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é

...

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

...

     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: 

1. No Controle de Lojas  (SIGALOJA) acesse Gerência Estoque/Solicit. De Compras (MATA110).
2. 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 - 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         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    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.

...

        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:

...

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

...

• 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>}). Fazendo isto, automaticamente gerará a Movimentação de DFU, igual a LOJA7030({,9,<empresa>,<filial>}).
  
• Cadastro de Eventos. LOJA7030({,610,<empresa>,<filial>}).Cadastro de Local
• de Estoque (Tabela NNRLinha de Pedidos Colocados (Pedidos de Compra). LOJA7030({,712,<empresa>,<filial>})
• Movimentação de SKUFornecedor. LOJA7030({,813,<empresa>,<filial>})
• Movimentação de DFU. LOJA7030({,9,<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 esqueça alguma movimentação em uma data anterior, se preferir, é 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",0Cadastro de Eventos. LOJA7030({,10,<empresa>,<filial>})
• Linha de Pedidos Colocados (Pedidos de Compra). LOJA7030({,12,<empresa>,<filial>})
• Fornecedor. LOJA7030({,13,<empresa>,<filial>})
• Importante

...

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

     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:

• 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 foi processado por motivo de falta de estoque, produto inexistente, etc., o XML é recriado somente com os itens não processados e copiará imediatamente para a 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. Virá um XML de retorno, e 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.

...

• .

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

        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.
  Importante
  Para gerar um pedido de compra automático via DRP Neogrid, é necessário ter o campo último preço de compra (B1_UPRC) preenchido no Cadastro de Produtos (LOJA110). Este campo é utilizado para calcular o valor total do preço de compra. Caso esteja de acordo com o preço cadastrado no pedido de compra, é possível altera-lo  em :SIGALOJA / Gerência de Estoques / Pedido de Compra (MATA121).

       Para consultar a importação de Solicitações de Compra: 

1. No Controle de Lojas  (SIGALOJA) acesse Gerência

...

1. Estoque/Solicit. De Compras (MATA110).
2. Ao consultar

...

1. a tabela, é possível identificar que solicitação foi gerada pelo DRP

...

1. , através do campo "DRP Neogrid?"

...

1. = "Sim".
   

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

...

1. No momento da importação, é apresentado no console o número da Solicitação de compra.
   Image Added

      Para consultar a importação de Pedidos de Compra:  .

...

1. No Controle de Lojas (SIGALOJA) acesse 

1. Gerencia Estoque/Pedidos de Compra (MATA121).

...

2.  Ao consultar a tabela,

...

1.  é possível identificar que  o pedido foi gerado pelo DRP

...

1. , através do  campo DRPNeogrid?"Sim".
2. No momento da importação, é apresentado no console o número do Pedido de Compra. 
   Image Added

       Importante

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

• 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. Está localizado em SIGAEST/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).

...

       Para consultar  a importação de Transferências entre Filiais:

1. No processamento de transferência entre filiais, é apresentado no console, a origem e destino das filiais e a quantidade transferida.
    Image Added
   Importante
   Verifique a gravação de Log do Pedido de Compra, Solicitação de Compras e Transferência entre filiais na pasta autocom ( Ambiente).

...

Instalação/Atualização

O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch UPDLO119). Para que o envio dos XMLs funcione, é necessário que o Client da NeoGrid seja instalado e configurado para o envio e retorno dos arquivos.
Importante
Antes de executar o compatibilizador UPDLO119 é imprescindível:

1. Realizar o backup da base de dados do produto que será executado o compatibilizador (Diretório: \PROTHEUS11_DATA\DATA) e dos dicionários de dados SXs (\PROTHEUS11_DATA\SYSTEM).
2. Os diretórios mencionados acima correspondem à instalação padrão do Protheus®, portanto, devem ser alterados conforme o produto instalado na empresa.
3. Essa rotina deve ser executada em Modo Exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.
4. Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador, certifique-se de que estão identificados pelo Nickname. Caso o compatibilizador necessite criar índices, adicione-os à partir da ordem original instalada pelo Protheus®, o que poderá sobrescrever índices personalizados, caso não estejam identificados pelo Nickname.
5. O compatibilizador deve ser executado com a Integridade Referencial desativada{*}.
6. Os parâmetros devem ser configurados de acordo com as respectivas informações:

...

Âncora
_Toc380496071 _Toc380496071

Controle de Versão

O grupo TOTVS representado por suas marcas irá administrar as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.
Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância das marcas e alinhamento com as diretivas definidas pelo Comitê de Integração TOTVS.

Âncora
_Toc380496072 _Toc380496072

Suporte

O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos DRP Neogrid e Backoffice Protheus® estarão aptas a fazer a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso. Observação: Este modelo de suporte está sendo revisado pela TOTVS.

Transações/Entidades/Mensagens únicas

• Observe o Diagrama das Integrações efetuadas entre o Back Office Protheus® e o DRP NeoGrid:

...

• XMLs utilizados para cada transação:

...

Âncora
_Toc351371779 _Toc351371779

Âncora
_Toc363117591 _Toc363117591

Âncora
_Toc380496074 _Toc380496074

Fluxo das Informações

...

Âncora
_Toc380496077 _Toc380496077

Fluxo das Informações

...

Exemplo:

• ERP envia PRODUTO cadastrado para o DRP, com o fornecedor padrão (B1_PROC) e loja padrão (B1_LOJPROC) preenchidos.
  ERP somente envia o Produto se a tabela Complemento de Produto (SB5) estiver preenchida e não marcado o se o campo SB5_DRPEXP não estiver gravado. Também é necessário que o Produto esteja amarrado a tabela ACV como Categoria. No mínimo dois três níveis de categoria devem ser preenchidos na tabela ACU, sendo a categoria principal como filho, a categoria superior como pai, etc.
  
  
• .ERP envia o MOV LOCAL DE ESTOQUE cadastrado para o DRP.
  ERP somente envia o MOV LOCAL DE ESTOQUE se o campo B2_DRSALDO tiver conteúdo estiver  com  conteúdo diferente de B2_QATU.
  
  
• ERP envia a ORIGEM SKU cadastrado para o DRP:
  ERP somente envia a ORIGEM SKU se foi enviado o MOV LOCAL DE ESTOQUE cadastrado para o DRP.
  
  
• ERP envia o CAD LOCAL DE ESTOQUE cadastrado para o DRP:
   ERP somente enviar envia a CAD LOCAL DE ESTOQUE se o campo NNR_DRPEXP não estiver marcadogravado. Cada registro que enviar, o campo NNR_DRPEXP será marcadogravado.

• ERP envia o MOV SKU cadastrado para o DRP
  ERP somente envia o MOV SKU se a tabela ITENS DE VENDA estiverem na faixa de DATA INICIAL e DATA FINAL estiver com a data especificada, cujo TIPO DE SAÍDA configurado como VENDA, e cujo TIPO DE N.F. for VENDA NORMAL, Unindo com Se . Se a tabela ITENS DE COMPRA estiverem na faixa de DATA INICIAL e DATA FINAL estiver na data especificada, cujo TIPO DE N.F. for uma DEVOLUÇÃO,  indo com . Se a tabela MOVIMENTAÇÕES INTERNAS estiverem na faixa de DATA INICIAL e DATA FINAL estiver com a data especificada, cujo TIPO DE SAÍDA configurado como VENDA, desde que o campo D3_DRPEXP não estiver marcadoesteja gravado. Cada registro que enviar, o campo D3_DRPEXP será marcadogravado.
  
  
• ERP envia o MOV DFU cadastrado para o DRP 
  ERP somente envia o MOV DFU se a tabela ITENS DE VENDA estiverem na faixa de DATA INICIAL e DATA FINAL, cujo data especificadas cujo TIPO DE SAÍDA configurado como VENDA, e se houve emissão de DUPLICATA, e se o TIPO DE N.F. for uma VENDA NORMAL, desde que o campo D2_DRPEXP não estiver marcado. Cada registro que enviar, o campo D2_DRPEXP será marcado.

• ERP envia o EVENTO cadastrado para o DRP
  ERP somente envia o EVENTO se o CÓDIGO DO EVENTO estiver ligado na tabela FILTROS DE EVENTOS, se o GRUPO DE FILTRO DE EVENTOS estiver ligado no campo GRUPO na tabela PRODUTOS e se a CATEGORIA DE FILTRO DE EVENTOS estiver ligado na tabela CATEGORIA DE PRODUTO, desde que o campo MFP_DRPEXP não estiver marcadoesteja gravado. Cada registro que enviar, o campo MFP_DRPEXP será marcadogravado.
  
  
• ERP envia o PED COMPRA cadastrado para o DRP desde que o mesmo esteja em aberto.

• ERP envia o FORNECEDOR cadastrado para o DRP.
  ERP somente envia o FORNECEDOR se o campo A2_DRPEXP não estiver marcadogravado. Cada registro que enviar, o campo A2_DRPEXP será marcadogravado.
  
  
• DRP retorna os dados para o ERP, caso o item de retorno for sugestão de saída:
  Se MV_LJNEOPV = 1, gravará grava na tabela SC7 (Pedidos de Compra).
  Se MV_LJNEOPV = 2, gravará grava na tabela SC1 (Solicitações de Compra).
  
  
• DRP retorna os dados para o ERP, caso o item de retorno for sugestão de transferências:
  Se for sugestão Caso seja uma sugestão de transferências entre armazéns, na mesma filial, gravará será gravada na tabela SD3 (Movimentações de Estoque).
  Se for sugestão de Caso seja uma transferências entre filiais, será  gerada uma nota fiscal de saída (SF2/SD2) e uma nota fiscal de entrada (SF1/SD1).

Âncora
_Toc351371783 _Toc351371783

Âncora
_Toc363117595 _Toc363117595

Âncora
_Toc380496078 _Toc380496078

Como fazer

         Você receberá, na instalação, o        Instalação do Client Neogrid.:

1. O Client Neogrid , virá compactado.
    Para descompactar, utilize um programa compatível com .ZIP.

...

2.  Em seguida, copie a pasta "ClientMercador" para o Rootpath. Exemplo: C:\Amb\Ret12\Protheus_Data.
3. Na pasta <rootpath>\ClientMercador\Bin, configure o arquivo mercadorconnector.conf.
4. Acesse os grupos Proxy HTTP e Proxy HTTPS:

         Proxy HTTP

• conn.proxy.use=yes
• conn.proxy.server=seu_servidor_proxy
• conn.proxy.port=porta_do_servidor_proxy
• conn.proxy.username=seu_usuario_na_rede
• conn.proxy.password=sua_senha
• Faça o mesmo com o Proxy HTTPS que está na linha abaixo.

          Proxy HTTPS

• conn.proxy.secure.use=yes
• conn.proxy.secure.server=seu_servidor_proxy
• conn.proxy.secure.port=porta_do_servidor_proxy
• conn.proxy.secure.username=seu_usuario_na_rede
• conn.proxy.secure.password=sua_senha
• Certifique com o parceiro Neogrid qual o credencial para autorização do cliente a rodar os serviços no servidor:
• conn.username=seu_username_cadastrado_na_Neogrid
• conn.password=sua_senha
• conn.senderCNPJ=NG
  Todos os status de comunicação ficarão registrados em um log, identificado como mercador.log.

1. Execute, na pasta \Bin, o arquivo StartClient.bat para ativar o serviço DRP.
   O Protheus grava os arquivos gerados a partir da rotina LOJA7030() para a pasta \ClientMercador\Bin\Out\, identificado no parâmetro MV_LJNEOUT.
   Em seguida, o DRP converte os arquivos que estão com \Out\ e grava na linguagem Neogrid na pasta \Rec_Out\.
   Os arquivos que estão na pasta \Rec_Out\ são enviados para o DRP.
    Ao finalizar, os arquivos são movidos para a pasta \SENT\.
     Observe o envio dos arquivos,  consultando o log dos envios, que está na pasta \SUMMARY\.
   O DRP está sendo processado.
   Em seguida, são enviados os arquivos de retorno na pasta \IN\, identificado no Protheus como parâmetro MV_LJNEOIN.
   O Protheus identifica os arquivos através da rotina LOJA7033() e cada arquivo processado, será movido para a pasta configurada como parâmetro MV_LJNERCV. 
   Conforme a configuração do parâmetro MV_LJNEOPV,  são gravados os dados nos arquivos de Solicitação de Compra (SC1), Pedidos de Compra (SC7) ou Movimentações de Estoque entre Armazéns (SD3).

...

1. 
   

   Âncora
   _Toc328136233 _Toc328136233

   Âncora
   _Toc351371784 _Toc351371784

   Âncora
   _Toc363117596 _Toc363117596

   Âncora
   _Toc380496079 _Toc380496079

   Situações comuns

Caso              Caso não consiga efetuar  a transmissão, verifique:

...

Figura caso conn.proxy.use=yes


Figura caso conn.proxy.use=no

  Caso afirmativo, consulte a tabela abaixo:
  Tratamento de erros de integração (DRP Neogrid)

Âncora
_Toc363117597 _Toc363117597

Âncora
_Toc380496080 _Toc380496080

Checklist

...

  Suporte da aplicação

...

• Verificar versão superior.
• 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 Schedules para gerar e importar os XMLs.
• Cadastrar algum complemento para cada produto.
• Cadastrar as Categoria de Produtos.
• Cadastrar para cada produto três níveis de categoria (Amarração Cat x prd) no Back Office Protheus®.
• Cadastrar os Fornecedores.
• Cadastrar os Armazéns (NNR).

 

Âncora
_Toc380496081 _Toc380496081

...

Não se aplica.