Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Migration of unmigrated content due to installation of a new plugin

 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

Faturamento

Segmento Executor

TOTVS Construção e Projetos

Projeto1

Integração BackOffice RM x PDV Protheus

IRM1

PCREQ-7769

Requisito1

PCREQ-7800

Subtarefa1

PDR_CP_MOV008-33

Chamado2

 

Release de Entrega Planejada 

12.1.10

Réplica

 

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

 

Rotina

Tipo de Operação

Opção de Menu

Regras de Negócio

Funcionários

Inclusão \ Alteração \ Exclusão 

RM \ BackOffice \ Gestão de Estoque, Compras e Faturamento \ Cadastros \ 
Estoque, Compras e Faturamento \ Funcionários

 

 

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.

CampoTamanho ProtheusTamanho no BackOffice RMAção de Integração
Code6 caracteres16 caracteresCaso seja enviado maior que o permitido o Protheus retornará Erro com mensagem explicativa.
ShortName25 caracteres80 caracteresO 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.

 

Opcional

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*/

  

Índice

Chave

01

<FI9_FILIAL+FI9_IDDARF+FI9_STATUS>

02

<FI9_FILIAL+FI9_FORNEC+ FI9_LOJA+FI9_EMISS+FI9_IDDARF>

03

<FI9_FILIAL+FI9_FORNEC+ FI9_LOJA+FI9_PREFIX+FI9_NUM+FI9_PARCEL+FI9_TIPO>

  • Mensagem Seller 2.000 

Mensagem Padrão

Descrição

RM

Tabela

Campo

Observação

CompanyId

Código da empresa.

TVEN

CODCOLIGADA

Código da Coligada é obtido a partir do De-Para de Filial.

BranchId

Código da filial

TVEN

CODFILIAL

CompanyInternalId

InternalId da chave completa de empresa do produto

TVEN

CODCOLIGADA|CODFILIAL

Code

Código do Vendedor

TVEN

CODVEN

 

InternalId

InternalId de Integração

TVEN

CODCOLIGADA|CODVEN

 

Name

Nome do Vendedor

TVEN

NOME

 

ShortName

Login do Vendedor

TVEN

NOME

 

Conforme solicitado pela equipe Protheus, será enviado o mesmo campo NOME com a informação cortada em 25 caracteres.

ActiveRegistro Ativo/InativoTVENINATIVO

TVEN.INATIVO = 0: Ativo

TVEN.INATIVO = 1: Inativo

SellerPasswordSenha do Vendedor  Campo não utilizado na Integração.
SellerPhoneDDDDDD do Vendedor  Campo não utilizado na Integração.

SellerPhone

Telefone do Vendedor

 

 

Campo não utilizado na Integração.

SellerEmail

E-mail do Vendedor

 

 

Campo não utilizado na Integração.

AddressDados da localização física do vendedor  Campo não utilizado na Integração.
SalesChargeInformationInformações de comissões  Campo não utilizado na Integração.
CustomerVendorInternalIdInternalId do Fornecedor  Campo não utilizado na Integração.
SalesChargeInterfaceInterface a ser utilizada no fechamento da comissão  

Campo não utilizado na Integração.

 

  • 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

<Informar o % que o aluno pagará em dinheiro. Esse % poderá ser alterado durante a negociação>

 

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