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 recebimento 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 recebimento envio de Mensagens Únicas TOTVS para integração do cadastro de Vendedor, estando o adapter de envio recebimento desta mesma mensagem fora do escopo do requisito, ou seja , o cadastro de Vendedor será realizado somente no PDV ProtheusBackOffice 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 com o do BackOffice RM com PDV Protheus, mas também viabilizará a integração com outras fontes de dados 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 envolvidode 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). 

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

Inclusão / Alteração

• O cadastro deve ser feito no Protheus e sincronizado para o RM via Integração TOTVS Mensagem Única.
• Ao receber a mensagem única deve-se verificar na tabela de De-Para se a Coligada está integrada.
• O Código do Vendedor é obrigatório no RM e deve ser igual ao código do vendedor no Protheus.
• O Nome do Vendedor no RM é obrigatório e deve ser enviado na mensagem única em seu respectivo campo. Caso não seja informado o Nome a mensagem de retorno para o Protheus deve ter o status Erro e qual o motivo do erro.
• Na inclusão caso a coluna TVEN.IDFUNCIONARIO for nula deve-se gerar um novo AutoInc passando como parâmetros os valores ("T", CODCOLIGADA, IDFUNCIONARIO).

Exclusão

• A exclusão do vendedor deve ser realizada no Protheus.
Ao receber a mensagem de exclusão no RM deve-se apagar os registros das tabelas filhas TVENCOMPL - Tab.Complementar de Vendedor/Comprador e TVENVAL - Valores por Funcionário/Filial/C.Custo.

Restrições e Ponto de Atenção

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

Fluxo do Processo

Image Added

Mapeamento dos Campos

<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

Arquivo ou Código do Script: AAA – Negociação Financeira / *Versao=CP.2014.12_03*/

• 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.

Campo

<AAA_PERESP>

Tipo

<N>

Tamanho

<6>

Valor Inicial

<Varia de acordo com o tipo informado. Por exemplo, quando o campo “tipo” for date, neste campo pode ser informado uma data>. 

Mandatório

Sim (  ) Não (  )

Descrição

<Referência Mínima para Cálculo>

Título

<Ref.Calc.>

Picture

<@E999.99>

Help de Campo