Child pages
  • ER_PCREQ-7807_Local de Estoque - Warehouse
Skip to end of metadata
Go to start of metadata

 Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.                                                             

  

Informações Gerais

 

Especificação

Produto

TOTVS Gestão de Estoque, Compras e Faturamento

Módulo

 Estoque

Segmento Executor

TOTVS Construção e Projetos

Projeto1

Integração BackOffice RM x PDV Protheus

IRM1

 PCREQ-7769

Requisito1

 PCREQ-7807

Subtarefa1

 PDR_CP_MOV008-40

Chamado2

 

Release de Entrega Planejada

 12.1.10

Réplica

 Não

País

( X ) Brasil  (  ) Argentina  (  ) Mexico  (  ) Chile  (  ) Paraguai  (  ) Equador

(  ) USA  (  ) Colombia   (  ) Outro _____________.

Outros

<Caso necessário informe outras referências que sejam pertinentes a esta especificação. Exemplo: links de outros documentos ou subtarefas relacionadas>.

   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.

 

Rotina

Tipo de Operação

Opção de Menu

Regras de Negócio

Locais de Estoque

Inclusão/Alteração/Exclusão

RM \ BackOffice \ Gestão de Estoque, Compras e Faturamento \ Cadastros \ Estoque, Compras e Faturamento \ Locais de Estoque

-

 

As inclusões, alterações e exclusões de Locais de Estoque são feitos através da Linha RM, que identifica o evento em sua entidade e envia uma mensagem ao PDV Protheus. Os dados de locais de estoque que serão sincronizados pela mensagem única são :
  • Pasta Identificação: Filial, Estoque, Inativo, Descrição

A integração deste cadastro é necessário, pois será utilizado como filtro na consulta de saldo de estoque.

Regras de Integridade

  • 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

Mensagem Padrão

 

Descrição

 

RM

Tabela

Campo

Observação
CompanyIdCódigo da empresa. TLOC CODCOLIGADA 
 BranchId

Código da filial

 TLOC CODFILIAL 
CompanyInternalIdInternalId da chave completa de empresa TLOC CODCOLIGADA|CODFILIAL 
CodeCódigo Local de EstoqueTLOCCODLOC 
InternalIdInternalId da EntidadeTLOCCODCOLIGADA| CODFILIAL| CODLOC 
DescriptionDescrição Local EstoqueTLOCNOME 
ActiveLocal Estoque Ativo?TLOCINATIVO

Inativo=0: Ativo

Inativo=1: Inativo
TypeTipo do Local de Estoque  Não utilizada na linha RM
IsFinalItemLocal de Estoque é de produto acabado?  Não utilizada na linha RM

IsQualityControl

Local de Estoque é de controle de qualidade?

  Não utilizada na linha RM

IsProcess

Local de Estoque é de processo?

  Não utilizada na linha RM

IsWaste

Local de Estoque é de rejeito?

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

 

 Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.