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
Entidades de Integração
- DataServer envolvido
- Transformação
- Id: Warehouse
- Versão: 1.000
- Fluxo da mensagem
- Tipo de Envio:
- Fórmula Visual
- 05_PDV_LocalDeEstoque.TotvsWF
- 05.Sincronização de Locais de Estoque.TotvsWF: utilizada para carga inicial