Integração Protheus x DRP NeogridFevereiro/2015

...

Âncora
_Toc363117575 _Toc363117575

Âncora
_Toc380496058 _Toc380496058

Sistemas Envolvidos

• Protheus®/SIGALOJA.
• DRP NeoGrid - O objetivo é aumentar a rentabilidade e participação no segmento através do balanceamento dos estoques de sua empresa, considerando a cadeia de suprimentos, indústria e varejo. O DRP tem foco na distribuição tanto da indústria quanto do varejo.

Âncora
_Toc380496059 _Toc380496059

Integração

A principal vantagem da integração é permitir o balanceamento de estoques dos produtos do varejista na cadeia como um todo considerando o histórico de consumo. Como consequência disso, possibilita outras vantagens na gestão de estoques (descritas no fluxo abaixo) e resulta no aumento da rentabilidade e do market share.





As informações são originadas do Back Office Protheus® e envidas em formato XML ao DRP da NeoGrid para serem analisadas e processadas. Os dados enviados são:

Ao receber os arquivos, o DRP da NeoGrid analisa e processa as infomações retornando sugestões de solicitações de compra ou pedidos de compra dependendo da 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.

...

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.

• Cadastro Eventos (LOJA7031).

...

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

...

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

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

...

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

...

Â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: "\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: "\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:

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

    Protheus

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

...

1. Confira os dados e Confirme.

Cadastro de Eventos:

1. No Controle de Lojas (SIGALOJA) acesse Atualizações/Cadastros/Eventos (LOJA7031).

...

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.

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.
• 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, 3 – Transferência de Estoque entre Filiais, 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.

...

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

Âncora
_Toc363117583 _Toc363117583

Âncora
_Toc380496066 _Toc380496066

Instalação/Atualizaçã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

...

Âncora
_Toc363117590 _Toc363117590

Âncora
_Toc380496073 _Toc380496073

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

...

ERP somente enviará o PRODUTO se a tabela COMPLEMENTO DO PRODUTO (SB5) estiver preenchida e não marcado o campo SB5_DRPEXP, e se o PRODUTO estiver ligado na tabela ACV como CATEGORIA. Ao menos dois 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 enviará o MOV LOCAL DE ESTOQUE se o campo B2_DRSALDO tiver conteúdo diferente de B2_QATU.

• ERP envia a ORIGEM SKU cadastrado para o DRP

ERP somente enviará 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á a CAD LOCAL DE ESTOQUE se o campo NNR_DRPEXP não estiver marcado. Cada registro que enviar, o campo NNR_DRPEXP será marcado.

• ERP envia o MOV SKU cadastrado para o DRP

ERP somente enviará o MOV SKU se a tabela ITENS DE VENDA estiverem na faixa de DATA INICIAL e DATA FINAL,
cujo TIPO DE SAÍDA configurado como VENDA, e cujo TIPO DE N.F. for VENDA NORMAL,
Unindo com
Se a tabela ITENS DE COMPRA estiverem na faixa de DATA INICIAL e DATA FINAL cujo TIPO DE N.F. for uma DEVOLUÇÃO,
Unindo com
Se a tabela MOVIMENTAÇÕES INTERNAS estiverem na faixa de DATA INICIAL e DATA FINAL, cujo TIPO DE SAÍDA configurado como VENDA, desde que o campo D3_DRPEXP não estiver marcado. Cada registro que enviar, o campo D3_DRPEXP será marcado.

• ERP envia o MOV DFU cadastrado para o DRP

ERP somente enviará o MOV DFU se a tabela ITENS DE VENDA estiverem na faixa de DATA INICIAL e DATA FINAL,
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 enviará 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 marcado. Cada registro que enviar, o campo MFP_DRPEXP será marcado.

• 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 enviará o FORNECEDOR se o campo A2_DRPEXP não estiver marcado. Cada registro que enviar, o campo A2_DRPEXP será marcado.

• DRP retorna os dados para o ERP, caso:

...

• Virá compactado. Para descompactar, utilize um programa compatível com .ZIP. Em seguida, copie a pasta "ClientMercador" para o Rootpath. Exemplo: C:\Amb\Ret12\Protheus_Data.
• Na pasta <rootpath>\ClientMercador\Bin, configure o arquivo mercadorconnector.conf.
• Vá nos grupos Proxy HTTP e Proxy HTTPS:

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

1. 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.
• Execute, na pasta \Bin, o arquivo StartClient.bat para ativar o serviço DRP.
• O Protheus gravará os arquivos gerados a partir da rotina LOJA7030() para a pasta \ClientMercador\Bin\Out\, identificado no parâmetro MV_LJNEOUT.
• Em seguida, o DRP converterá os arquivos que estão com \Out\ e gravará já na linguagem Neogrid na pasta \Rec_Out\.
• Os arquivos que estão na pasta \Rec_Out\ serão enviados para o DRP. Ao finalizar, os arquivos são movidos para a pasta \SENT\.
• Você pode verificar se o envio dos arquivos deu certo consultando o log dos envios, que está na pasta \SUMMARY\.
• O DRP está sendo processado. Em seguida, receberá os arquivos de retorno na pasta \IN\, identificado no Protheus como parâmetro MV_LJNEOIN.
• O Protheus lerá os arquivos a partir da rotina LOJA7033() e cada arquivo lido, moverá para a pasta configurada como parâmetro MV_LJNERCV. Dependendo da configuração do parâmetro MV_LJNEOPV, gravará os dados nos arquivos de Solicitação de Compra (SC1), Pedidos de Compra (SC7) ou Movimentações de Estoque entre Armazéns (SD3).

...

...

Âncora
_Toc363117597 _Toc363117597

Âncora
_Toc380496080 _Toc380496080

Checklist de 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

Anexos

...