Histórico da Página

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 Vendedor viabilizando assim o CRUD completo do cadastro por envio de mensagem de integração no padrão de Mensageria Única TOTVS.

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 Vendedor, estando o adapter de recebimento desta mesma mensagem fora do escopo do requisito, ou seja , o cadastro de Vendedor será realizado somente no BackOffice RM e devendo todo o tratamento de comissionamento ser também gerido neste.

A análise e o desenvolvimento do adapter será efetuado considerando a integração do BackOffice RM com PDV Protheus, mas também viabilizará a integração com outros destinatários desde que respeitado o layout da mensagem e os campos especificado para envio. 

Visto que o PDV Protheus somente necessita de informações para lookup e o BackOffice RM quem deve efetuar todo o controle de comissionamento, somente serão enviados os dados básicos do vendedor.

Tabelas Utilizadas

• TVEN – Vendedores
• TVENCOMPL – Tab.Complementar de Vendedor/Comprador
• TVENVAL – Valores por Funcionário/Filial/C.Custo

Entidades de Integração 

• DataServer de Gatilho
  • MovVenData
• Transformação
  • Id: Seller
  • Versão: 2.001
• SourceCode (Evento)
  • GUID: d772e85a-0f3f-4fbc-a387-54bf763d925d
  • Nome: Seller_2_001

Regras de Integridade

Controle de comissionamento

Visto que todo o controle de comissionamento deverá ser efetuado no BackOffice RM não haverá integração de dados referentes a este controle na Mensagem Única enviada.

 

Tipo de Vendedor

O campo Tipo será desconsiderado para a integração, enviando assim registros referentes a todos os tipos de Vendedores do BackOffice RM (Vendedor, Comprador, Gerente e demais). Este   

Vendedor Padrão

O PROTHEUS possui um parâmetro onde é informado o Código do Vendedor Padrão que será assumido na tela de atendimento no momento da Venda. Com isso é necessário que este Vendedor seja cadastrado no RM e o parâmetro MV_VENDPAD seja atualizado no Configurador do PROTHEUS (SIGACFG).

Tamanho dos Campos

Os campos listados na tabela abaixo possuem no Protheus tamanho máximo menor que permitido no RM e as respectivas ações de integração.

Campo	Tamanho Protheus	Tamanho no BackOffice RM	Ação de Integração
Code	6 caracteres	16 caracteres	Caso seja enviado maior que o permitido o Protheus retornará Erro com mensagem explicativa.
ShortName	25 caracteres	80 caracteres	O RM enviará o campo NOME com tamanho cortado em 25 caracteres.

 

Compartilhamento de registros por Coligada e Filial

Visto que o registo no BackOffice RM não 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 compartilhado por Filial.

Em resumo, o sistema de destino não deve considerar a informação de Filial enviada, pois caso no BackOffice RM este campo esteja nulo será enviada a Filial do contexto de integração, que e a primeira filial da empresa disponível na tabela De-Para.

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

• • Empresa:  Exclusivo
  • Unidade:   Deve ser equivalente à entidade relacionada no De-Para de integração (Empresa ou filial)
  • Filial:        Compartilhado

Restrições e Ponto de Atenção

• Deve-se retirar a permissão do cadastro de Vendedor no Protheus, pois estas informações serão cadastradas no BackOffice RM.

Fluxo do Processo

Image Modified

<Nesta etapa incluir representações gráficas que descrevam o problema a ser resolvido e o sistema a ser desenvolvido. Exemplo: Diagrama - Caso de Uso, Diagrama de Atividades, Diagrama de Classes, Diagrama de Entidade e Relacionamento e Diagrama de Sequência>.

Mapeamento dos Campos

• Mensagem Seller 2.000 

• Somente os campos marcados em negrito são tratados no Adapter, sendo os demais não enviados por não haver necessidade de uso no PDV Protheus.