ER_PCREQ-7798_Integração_Código de Barras

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 Código de Barras com o PDV, 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 Código de Barras, 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.

• No cadastro de Transformação da mensagem ITEM o Xslt Saída deve considerar as informações de Códigos de barra. Este Xslt de saída será detalhado no tópico Mapeamento de Campos abaixo.
• As informações do envio da tag ItemQuantity será realizada através do Extension. Ao informar a Unidade no cadastro de Código de Barras será enviado para a tag o valor do Fator de Conversão utilizado por esta unidade de medida, com base na unidade de medida do produto.
• A mensagem de Códigos de Barra deve estar mapeada para a integração 1016 - BackOffice RM x PDV Protheus.

Através do módulo Integração \ Ferramentas \ Configurar o usuário poderá executar o Configurador da Integração que irá criar toda a estrutura necessária para a integração deste cadastro com o PDV.

Para receber a mensagem o Protheus deve considerar:

• A configuração de compartilhamento de cadastros entre Empresas e Filiais para a entidade Códigos de Barras deve ser: Exclusivo por Empresa e Compartilhado por Filial.
• O tamanho padrão do Código de barras no Protheus é de 15 caracteres. Caso seja enviado um código de barras com mais de 15 caracteres, o adapter do Protheus irá apresentar mensagem de consistência na integração do cadastro. Para que isso não ocorra deve-se aumentar o tamanho deste campo no cadastro de Código de Barras do Protheus. 

Fórmula Visual

Para sincronizar o cadastro será necessário importar a fórmula visual que encontra-se disponível na pasta “Sugeridos”, interna à pasta “_ImpExp” no ambiente instalado do sistema (“../CorporeRM/_ImpExp/Sugeridos”). 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.

Carga Inicial

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.

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.

Por padrão a consulta seleciona para envio registros Ativos que ainda não foram enviados para o Protheus ou que estejam desatualizados no mesmo (data de último envio anterior a data da última modificação do registro).

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

Listagem de Fórmula Visual:

Código de Barras

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

03_PDV_Código de Barras.TotvsWF

Código de Barras

Carga inicial

Tabelas Utilizadas

• TPRDCODIGO – Cadastro de Código Genérico de Produtos.

• TPRODUTO – Produtos Globais.

• TUND – Unidades.

Entidades de Integração 

• DataServer envolvido
  • EstPrdDataBR
• Transformação
  • Id: Item
  • Versão: 3.004
• Fluxo da mensagem
  • Saída
• Tipo de Envio:
  • Síncrono.
• Extension: 
  • 27490bfc-3d18-4e49-9eeb-b94e483baf01

Fluxo do Processo

Diagrama de Sequência

Mapeamento dos Campos

Os dados de Código de barras serão sincronizados na mensagem única Item (Produto) através da tag ListOfBarCode os demais campos da mensagem Item podem ser visualizados na especificação de requisitos da mensagem Item. Estão listados abaixo somente os mapeamentos referentes à tag de Código de Barras

• Mensagem Código de barras