Histórico da Página
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. O cadastro de Vendedor será realizado somente no BackOffice RM e devendo todo o tratamento de comissionamento ser também gerido neste.
Caminho do cadastro de funcionários no BackOffice: 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
Observações:
- 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.
- Deve-se retirar a permissão do cadastro de Vendedor no Protheus, pois estas informações serão cadastradas no BackOffice RM.
- 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.
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. | Código da Coligada é obtido a partir do De-Para de Filial. |
BranchId | Código da filial | TVEN | CODFILIAL | Código da Coligada é obtido a partir do De-Para de Filial. | Código da Coligada é obtido a partir do De-Para de Filial. |
CompanyInternalId | InternalId da chave completa de empresa do produto | TVEN | CODCOLIGADA | CODFILIAL | Código da Coligada é obtido a partir do De-Para de Filial. |
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. | 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 = 0: Ativo TVEN.INATIVO = 1: Inativo |
Atenção! Somente os campos acima são tratados no Adapter, sendo os demais no cadastro de funcionário(RM) não enviados por não haver necessidade de uso no PDV Protheus.