Informações Gerais

   Legenda: 1 – Inovação 2 – Manutenção (Os demais campos devem ser preenchidos para ambos os processos). 

Objetivo

Implementação do adapter de integração via Mensagem Única TOTVS do cadastro de Local de Estoque com o PDV Protheus, viabilizando assim o CRUD completo do cadastro por envio de mensagem de integração.

Definição da Regra de Negócio

Considera-se como escopo deste requisito a implementação do adapter de envio de Mensagens Únicas TOTVS para integração do cadastro de Local de Estoque (Warehouse), estando o adapter de recebimento desta mesma mensagem fora do escopo do requisito.

A análise e o desenvolvimento do adapter será efetuado considerando a integração com o PDV Protheus, mas também viabilizará a integração com outras fontes de dados desde que respeitado o layout da mensagem.

• O cadastro deve ser feito no BackOffice RM e sincronizado para o PROTHEUS via Integração TOTVS Mensagem Única.
• Serão enviados para o PROTHEUS somente os Locais de Estoque da Filial que está integrada.
• O campo Código do Local de Estoque no RM possui tamanho de 15 caracteres e no PROTHEUS o campo Código possui tamanho padrão de 2 caracteres extensível até 6 caracteres (até a presente data). Sendo assim será realizado o seguinte tratamento para o tamanho do campo Código:
  • Se o campo Código no PROTHEUS for configurado como auto-incremento, ele irá ignorar o código enviado pelo RM, gerando na inclusão do local de estoque o código com auto-incremento.
  • Se o campo Código no PROTHEUS não for configurado como auto-incremento, caso seja cadastrado um Local de Estoque com código maior do que o permitido no PROTHEUS será exibida mensagem de consistência similar a: "Tamanho do campo Código maior que o permitido: Enviado X Permitido Y."

Compartilhamento de registros por Coligada e Filial

Visto que o registo no BackOffice RM considera a Filial como parte da Chave e existe a restrição na Mensagem Única TOTVS para envio do 'CompanyInternalId' completo (Coligada + Filial), é necessário que o sistema destinatário possua este cadastro exclusivo por Coligada e exclusivo por Filial.

Em relação ao Protheus deve seguir o seguinte compartilhamento:

• • Empresa:  Exclusivo
  • Unidade:   Exclusivo.
  • Filial:        Exclusivo.

Fórmula Visual

Para sincronizar o cadastro será necessário importar a fórmula visual que encontra-se disponível na pasta “Fórmulas Visuais”, interna à pasta “ObjetosGerencias” no ambiente instalado do sistema (“../CorporeRM/ObjetosGerencias/Fórmulas Visuais”). Ao importar a fórmula visual deverá ser marcado para cada fórmula o parâmetro “Importar Gatilho” na rotina de Importação de Fórmula Visual.

Visando facilitar a sincronização das bases de dados RM e PDV foi desenvolvida uma atividade de fórmula visual que se responsabiliza por, a partir de alguns parâmetros, obter os dados necessários e solicitar o envio da Mensagem Única TOTVS Warehouse_1.000.

Basicamente é necessário informar a esta atividade somente a lista de chaves dos registros que se deseja integrar, qual a Mensagem Única a enviar e qual o objeto de negócio (DataServer) responsável por retornar as informações do registro. A partir destas informações a atividade se responsabiliza pela leitura, transformação e envio dos dados ao sistema de destino, oferecendo como retorno o Log de integração.

Todas as mensagens trafegadas também constarão no monitor da fila de integração, para posterior conferência.

Tabelas Utilizadas

• TLOC- Locais de Estoque

Entidades de Integração

• DataServer envolvido
  • EstLOCData
• Transformação
  • Id: Warehouse
  • Versão: 1.000
• Fluxo da mensagem
  • Saída
• Tipo de Envio:
  • Síncrono.
• Fórmula Visual
  • 05_PDV_LocalDeEstoque.TotvsWF
  • 05.Sincronização de Locais de Estoque.TotvsWF: utilizada para carga inicial

Fluxo do Processo

Mapeamento dos campos 

• Mensagem Warehouse 1.000

• Somente os campos marcados em negrito são tratados no Adapter, sendo os demais não enviados na mensagem.