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 |
| 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 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 de 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
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
Tamanho dos Campos
Os campos listados na tabela abaixo possuem na definição da mensagem tamanho máximo menor que permitido no RM e as respectivas ações de integração.
Campo | Tamanho Mensagem Única | 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. |
Name | 40 caracteres | 80 caracteres | O RM enviará o nome com tamanho cortado em 40 caracteres. |
ShortName | 25 caracteres | 80 caracteres | O RM enviará o 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.
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, 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. | ||
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. |
---|