Histórico da Página

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
Projeto¹	Integração BackOffice RM x PDV Protheus	IRM¹	PCREQ-7769
Requisito¹	PCREQ-7800	Subtarefa¹	PDR_CP_MOV008-33
Chamado²
Release de Entrega Planejada		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 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.

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.000
SourceCode (Evento)
- GUID: d772e85a-0f3f-4fbc-a387-54bf763d925d
- Nome: Seller_1_000

Regras de Integridade

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).
O campo TVEN.VENDECOMPRA deve receber como valor default o valor 2 - Vendedor e Comprador.

Exclusão

A exclusão do vendedor deve ser realizada no Protheus.

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

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

<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

Mensagem Padrão	Descrição	RM
Mensagem Padrão	Descrição	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	Na mensagem tem 6 caracteres.
InternalId	InternalId de Integração	TVEN	CODCOLIGADA\|CODVEN
Name	Nome do Vendedor	TVEN	NOME	Na mensagem tem 40 caracteres, mas o RM pode enviar até 80 caracteres.
ShortName	Login do Vendedor			Campo não utilizado na Integração.
SellerPassword	Senha do Vendedor			Campo não utilizado na Integração.
SellerPhoneDDD	DDD 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.
Address	Dados da localização física do vendedor			Campo não utilizado na Integração.
SalesChargeInformation	Informações de comissões			Campo não utilizado na Integração.	SalesChargeInformationType	Campo não utilizado na Integração.
CustomerVendorInternalId	InternalId do Fornecedor			Campo não utilizado na Integração.
SalesChargeInterface	Interface 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.

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

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 4

Nova versão 5

Chave