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 | ||
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 \ |
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.000001
- 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).
- 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. 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 | |||
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. | |
ShortName | Login do Vendedor | TVEN | NOME
| Na mensagem tem 25 caracteres. | Conforme solicitado pela equipe Protheus, será enviado o mesmo campo NOME com a informação cortada em 25 caracteres. |
Active | Registro Ativo/Inativo | TVEN | INATIVO | TVEN.INATIVO = 0: Ativo TVEN.INATIVO = 1: Inativo | |
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 | ver AddresType | Campo não utilizado na Integração. | ||
SalesChargeInformation | Informações de comissões | Ver SalesChargeInformationType | |||
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 | Possíveis valores: S - Contas a Pagar F - Folha de Pagamento N - Sem Interface | |||
AddressType | |||||
Address | Rua, Avenida, Rodovia, etc | ||||
Number | Número do Endereço | ||||
Complement | Informações complementares do endereço | ||||
City | Ver CityType | ||||
District | Bairro | ||||
State | Ver StateType | ||||
Country | Ver CountryType | ||||
ZIPCode | CEP | ||||
Region | Região | ||||
POBox | Caixa Postal | ||||
CityType | |||||
CityCode | Código do município | ||||
CityInternalId | InternalId do CityCode | ||||
CityDescription | Descrição do município | ||||
StateType | |||||
StateCode | Código da Unidade Federativa | ||||
StateInternalId | InternalId do StateCode | ||||
StateDescription | Descrição da Unidade Federativa | ||||
CountryType | |||||
CountryCode | Código do país | ||||
CountryInternalId | InternalId do CountryCode | ||||
CountryDescription | Descrição do país |
Campo não utilizado na Integração. |
- Somente os campos marcados em negrito são tratados no Adapter, sendo os demais não tratados no recebimento da mensagemnã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. |
---|