TFA007 — Vendedores (enriquecimento)

Menu: Cadastros > Tabelas de Faturamento > Vendedores

Objetivo

Cadastro de vendedores (comissionados) do faturamento: define os dados gerais do vendedor (vendedor geral, histórico de baixa, tabela de preço, representante, preposto), as regras de comissão por combinação de grupo/subgrupo/marca/tabela/pessoa/item/seção/condição de pagamento/tipo de vendedor/perfil, as metas de venda e de despesa por período, e os centros de resultado (empresa/centro de custo) vinculados ao vendedor. Também permite duplicar todo o conjunto de regras e metas de um vendedor para outro vendedor novo ou existente.

Fluxo principal

1. Abrir a tela pelo menu Cadastros > Tabelas de Faturamento > Vendedores; a grade de vendedores é carregada. (Grade de Vendedores) — source/TFA007/UTFA007.pas:228-275 (iniciar)
2. Clicar em Novo e informar/buscar (F9) o código do vendedor; o sistema valida que a pessoa está cadastrada, tem endereço e ainda não é vendedor. (Aba Vendedor) — source/TFA007/UdmTFA007.pas:287-320 (TdmTFA007.tabVENDEDORCD_VENDEDORValidate)
3. Na aba Comissão, cadastrar as regras de percentual/valor de comissão por combinação de grupo, subgrupo, tabela, marca, pessoa, item, seção, condição de pagamento, tipo de vendedor e/ou perfil. (Aba Comissão) — source/TFA007/UdmTFA007.pas:371-483 (TdmTFA007.tabCOMISSAOBeforePost)
4. Na aba Metas, cadastrar metas mensais (valor e/ou quantidade); opcionalmente usar Replicar 12/6 Meses ou Copiar por Período. (Aba Metas) — source/TFA007/UdmTFA007.pas:769-864 (TdmTFA007.tabMETABeforePost)
5. Na aba Centro de Resultado, vincular empresas e centros de custo ao vendedor (exige parâmetro Vários Vendedores ativo). (Aba Centro de Resultado) — source/TFA007/UdmTFA007.pas:1138-1182 (TdmTFA007.tabCENTROCUSTOBeforePost)
6. Clicar em Salvar; o sistema grava vendedor, comissões, metas, metas de despesa e centros de resultado numa mesma transação e reabre o registro. (Barra de ferramentas) — source/TFA007/UTFA007.pas:473-500 (TfrmTFA007.salvar)

Campos obrigatórios

Campo	Condição	Mensagem	Fonte
Código do Vendedor	sempre, ao salvar o cadastro do vendedor	W-1627	source/TFA007/UdmTFA007.pas:322-330 (TdmTFA007.tabVENDEDORBeforePost)
% Venda acima Tabela (PC_EXCEDENTETABELA)	sempre, ao salvar o cadastro do vendedor	E-1628	source/TFA007/UdmTFA007.pas:332-336 (TdmTFA007.tabVENDEDORBeforePost)
% Comissão à Vista e % Comissão à Prazo (ou Valor de Comissão)	ao salvar uma linha da grade de regras de comissão	W-1629 / W-1630 / W-1631	source/TFA007/UdmTFA007.pas:371-397 (TdmTFA007.tabCOMISSAOBeforePost)
Data da Meta	ao salvar uma linha de meta de vendas	E-1617	source/TFA007/UdmTFA007.pas:786-787 (TdmTFA007.tabMETABeforePost)
Valor ou Quantidade da Meta	ao salvar meta; ao menos um dos dois deve estar preenchido	É Obrigatório Informar (Valor ou Quantidade) da Meta	source/TFA007/UdmTFA007.pas:789-799 (TdmTFA007.tabMETABeforePost)
Período Inicial e Período Final da Meta	quando o Tipo de Comissão do vendedor é 'G' (Faturamento x Meta por Período)	É Obrigatório Informar a Período Inicial/Final para a Meta	source/TFA007/UdmTFA007.pas:775-784 (TdmTFA007.tabMETABeforePost)
Empresa (Centro de Resultado)	ao salvar uma linha de Centro de Resultado do vendedor	A Empresa Do Centro de Resultado deve ser Informada. Verifique!	source/TFA007/UdmTFA007.pas:1141-1146 (TdmTFA007.tabCENTROCUSTOBeforePost)
Centro de Custo (Centro de Resultado)	ao salvar uma linha de Centro de Resultado do vendedor	O Centro de Resultado deve ser Informada. Verifique!	source/TFA007/UdmTFA007.pas:1148-1153 (TdmTFA007.tabCENTROCUSTOBeforePost)
Data da Meta de Despesa	ao salvar meta de despesa do vendedor	E-2109	source/TFA007/UdmTFA007.pas:1076-1079 (TdmTFA007.tabMETASDESPESABeforePost)
Valor da Meta de Despesa (maior que zero)	ao salvar meta de despesa do vendedor	E-2108	source/TFA007/UdmTFA007.pas:1081-1084 (TdmTFA007.tabMETASDESPESABeforePost)

Mensagens: causa e ação

E-1617

Causa: Usuário tentou salvar uma linha de meta de vendas sem preencher a Data da Meta.

Ação: Informar a data (mês/ano) da meta na grade de Metas antes de salvar.

Fonte: source/TFA007/UdmTFA007.pas:786-787 (TdmTFA007.tabMETABeforePost)

E-1618

Causa: O campo % Desconto no Fechamento foi preenchido com valor negativo ou maior que 100.

Ação: Informar um percentual entre 0 e 100.

Fonte: source/TFA007/UdmTFA007.pas:1027-1033 (TdmTFA007.tabVENDEDORPC_DESCONTO_FECHAMENTOValidate)

E-1619

Causa: O % Desconto/Acréscimo (da meta ou do vendedor) foi informado com valor negativo ou acima do limite aceito pelo sistema (999,99).

Ação: Informar um valor dentro do limite; se a mensagem citar 100%, confirmar com o suporte o limite real esperado para o caso.

Fonte: source/TFA007/UdmTFA007.pas:1035-1042 (TdmTFA007.tabMETAPC_DESCACRESValidate), source/TFA007/UdmTFA007.pas:1105-1112 (TdmTFA007.tabVENDEDORPC_DESCACRESValidate)

E-1620

Causa: O Valor de Meta de Preço Médio (do vendedor ou da meta) foi informado com valor negativo.

Ação: Informar um valor igual ou maior que zero.

Fonte: source/TFA007/UdmTFA007.pas:1114-1121 (TdmTFA007.tabVENDEDORVL_METAPRECOMEDIOValidate), source/TFA007/UdmTFA007.pas:1123-1130 (TdmTFA007.tabMETAVL_PRECOMEDIOValidate)

E-1621

Causa: Usuário tentou buscar (F9) o Centro de Custo na aba Centro de Resultado sem antes informar a Empresa.

Ação: Informar a Empresa na linha antes de selecionar o Centro de Custo.

Fonte: source/TFA007/UTFA007.pas:1596-1601 (TfrmTFA007.gridCENTROCUSTOKeyDown)

E-1622

Causa: Usuário clicou em Replicar 12/6 Meses sem ter uma meta com Data da Meta preenchida.

Ação: Preencher e salvar a meta do mês de referência antes de replicar.

Fonte: source/TFA007/UTFA007.pas:1269-1273 (ReplicarMeta)

E-1623

Causa: Usuário clicou em Duplicar sem ter um vendedor de origem aberto na tela.

Ação: Abrir/selecionar um vendedor na grade antes de usar Duplicar.

Fonte: source/TFA007/UTFA007.pas:1246-1261 (TfrmTFA007.btnDuplicarClick)

E-1624

Causa: O código informado como vendedor não existe na tabela de Pessoas.

Ação: Cadastrar a pessoa no módulo TFA001 antes de criar o vendedor.

Fonte: source/TFA007/UdmTFA007.pas:292-299 (TdmTFA007.tabVENDEDORCD_VENDEDORValidate)

E-1625

Causa: A pessoa existe, mas não possui endereço cadastrado.

Ação: Cadastrar um endereço para a pessoa em TFA001.

Fonte: source/TFA007/UdmTFA007.pas:301-308 (TdmTFA007.tabVENDEDORCD_VENDEDORValidate)

E-1626

Causa: O código informado já está cadastrado como vendedor.

Ação: Buscar e abrir o vendedor existente em vez de criar um novo com o mesmo código.

Fonte: source/TFA007/UdmTFA007.pas:310-314 (TdmTFA007.tabVENDEDORCD_VENDEDORValidate)

E-1628

Causa: O campo % Venda acima Tabela ficou vazio ao salvar o vendedor.

Ação: Preencher o percentual (o sistema sugere 40% como padrão ao criar um novo vendedor).

Fonte: source/TFA007/UdmTFA007.pas:332-336 (TdmTFA007.tabVENDEDORBeforePost), source/TFA007/UdmTFA007.pas:513-519 (TdmTFA007.tabVENDEDORAfterInsert)

E-1632

Causa: Já existe uma regra de comissão, meta de vendas ou meta de despesa com a mesma combinação de chaves (vendedor + grupo/subgrupo/tabela/pessoa/item/marca/seção/condpagto/tipovendedor/perfil, ou vendedor + mês) cadastrada.

Ação: Ajustar a combinação de campos para diferenciar da regra/meta existente, ou editar o registro já cadastrado em vez de criar um novo.

Fonte: source/TFA007/UdmTFA007.pas:400-462 (TdmTFA007.tabCOMISSAOBeforePost), source/TFA007/UdmTFA007.pas:1057-1073 (TdmTFA007.tabMETASDESPESABeforePost)

E-2108

Causa: O valor da meta de despesa está vazio ou é menor/igual a zero.

Ação: Informar um valor de meta de despesa maior que zero.

Fonte: source/TFA007/UdmTFA007.pas:1081-1084 (TdmTFA007.tabMETASDESPESABeforePost)

E-2109

Causa: A data da meta de despesa não foi informada.

Ação: Informar a data (mês/ano) da meta de despesa.

Fonte: source/TFA007/UdmTFA007.pas:1076-1079 (TdmTFA007.tabMETASDESPESABeforePost)

W-0127

Causa: Usuário tentou informar o Tipo de Vendedor na linha de Centro de Resultado sem ter selecionado/informado o vendedor daquela linha.

Ação: Selecionar o vendedor antes de informar o tipo de vendedor do Centro de Resultado.

Fonte: source/TFA007/UdmTFA007.pas:1254-1257 (TdmTFA007.tabCENTROCUSTOCD_TIPOVENDEDORValidate)

W-0132

Causa: O código de Tipo de Vendedor informado não existe no cadastro TFA064.

Ação: Cadastrar o tipo em TFA064 ou usar F9 para escolher um tipo já cadastrado.

Fonte: source/TFA007/UdmTFA007.pas:1260-1267 (TdmTFA007.tabCENTROCUSTOCD_TIPOVENDEDORValidate)

W-0231

Causa: No bloco de cópia de metas por período, a Data Início informada é posterior à Data Fim.

Ação: Corrigir as datas de início e fim da cópia de período.

Fonte: source/TFA007/UTFA007.pas:1439-1444 (TfrmTFA007.copiaMetaSelecionada)

W-1627

Causa: Usuário tentou salvar o cadastro de vendedor sem informar o código na primeira coluna da grade.

Ação: Informar o código do vendedor (ou buscar com F9) antes de salvar.

Fonte: source/TFA007/UdmTFA007.pas:325-330 (TdmTFA007.tabVENDEDORBeforePost)

W-1629

Causa: Nenhum dos campos de comissão (% à vista, % à prazo, valor de comissão) foi preenchido na linha de regra de comissão.

Ação: Preencher pelo menos o % de comissão (à vista/à prazo) ou o valor de comissão, conforme o tipo de comissão do vendedor.

Fonte: source/TFA007/UdmTFA007.pas:377-384 (TdmTFA007.tabCOMISSAOBeforePost)

W-1630

Causa: O % de Comissão à Vista ficou vazio ao salvar a regra de comissão.

Ação: Informar o percentual de comissão à vista (ou preencher o % à prazo, que é copiado automaticamente).

Fonte: source/TFA007/UdmTFA007.pas:386-391 (TdmTFA007.tabCOMISSAOBeforePost)

W-1631

Causa: O % de Comissão à Prazo ficou vazio ao salvar a regra de comissão.

Ação: Informar o percentual de comissão à prazo (ou preencher o % à vista, que é copiado automaticamente).

Fonte: source/TFA007/UdmTFA007.pas:392-397 (TdmTFA007.tabCOMISSAOBeforePost)

W-1634

Causa: O código de Grupo informado na regra de comissão ou na meta não existe no cadastro TPO006.

Ação: Cadastrar o grupo em TPO006 ou selecionar um grupo válido.

Fonte: source/TFA007/UdmTFA007.pas:500-508 (TdmTFA007.tabCOMISSAOCD_GRUPOValidate)

I-1076

Causa: A duplicação de vendedor foi concluída com sucesso (regras de comissão e metas copiadas para o vendedor destino).

Ação: Nenhuma ação necessária; conferir o vendedor destino se desejar.

Fonte: source/TFA007/UTFA007DUPLICA.pas:180-188 (TfrmTFA007DUPLICA.btnOKClick)

Regras de negócio

• TFA007.R001 (ver regras/TFA007/TFA007.R001.md)
• TFA007.R002 (ver regras/TFA007/TFA007.R002.md)
• TFA007.R003 (ver regras/TFA007/TFA007.R003.md)
• TFA007.R004 (ver regras/TFA007/TFA007.R004.md)
• TFA007.R005 (ver regras/TFA007/TFA007.R005.md)
• TFA007.R006 (ver regras/TFA007/TFA007.R006.md)
• TFA007.R007 (ver regras/TFA007/TFA007.R007.md)
• TFA007.R008 (ver regras/TFA007/TFA007.R008.md)
• TFA007.R009 (ver regras/TFA007/TFA007.R009.md)
• TFA007.R010 (ver regras/TFA007/TFA007.R010.md)
• TFA007.R011 (ver regras/TFA007/TFA007.R011.md)
• TFA007.R012 (ver regras/TFA007/TFA007.R012.md)
• TFA007.R013 (ver regras/TFA007/TFA007.R013.md)
• TFA007.R014 (ver regras/TFA007/TFA007.R014.md)
• TFA007.R015 (ver regras/TFA007/TFA007.R015.md)
• TFA007.R016 (ver regras/TFA007/TFA007.R016.md)
• TFA007.R017 (ver regras/TFA007/TFA007.R017.md)
• TFA007.R018 (ver regras/TFA007/TFA007.R018.md)
• TFA007.R019 (ver regras/TFA007/TFA007.R019.md)
• TFA007.R020 (ver regras/TFA007/TFA007.R020.md)

Perguntas frequentes

P: Por que aparece 'O Vendedor não está Cadastrado no Cadastro de Pessoa Física/Jurídica [TFA001]!' ao tentar informar o código do vendedor? R: O código informado não existe na tabela de Pessoas. Cadastre a pessoa em TFA001 antes de criar o vendedor. Fonte: source/TFA007/UdmTFA007.pas:292-299 (TdmTFA007.tabVENDEDORCD_VENDEDORValidate)

P: A pessoa já existe em TFA001, mas mesmo assim não consigo cadastrar o vendedor. Por quê? R: A pessoa não tem endereço cadastrado (E-1625). Vá até TFA001 e cadastre um endereço para essa pessoa. Fonte: source/TFA007/UdmTFA007.pas:301-308 (TdmTFA007.tabVENDEDORCD_VENDEDORValidate)

P: Deu a mensagem 'Este Código de Vendedor já está Cadastrado!'. O que fazer? R: Já existe um vendedor com esse código na base. Pesquise (F3) e abra o vendedor existente em vez de tentar criar um novo com o mesmo código. Fonte: source/TFA007/UdmTFA007.pas:310-314 (TdmTFA007.tabVENDEDORCD_VENDEDORValidate)

P: Ao salvar uma regra de comissão aparece 'Este Registro já está Cadastrado. Verifique!'. Por que? R: Já existe uma regra de comissão para esse vendedor com a mesma combinação de Grupo, Subgrupo, Tabela de Preço, Tipo de Pessoa, Fator, Pessoa, Item, Marca, Seção, Condição de Pagamento, Tipo de Vendedor e Perfil. Altere um desses campos ou edite a regra já cadastrada. Fonte: source/TFA007/UdmTFA007.pas:400-462 (TdmTFA007.tabCOMISSAOBeforePost)

P: A meta não salva e pede 'Valor ou Quantidade' — o que preencher? R: É preciso informar pelo menos um dos dois campos: o Valor da Meta ou a Quantidade da Meta (a data da meta também é obrigatória). Fonte: source/TFA007/UdmTFA007.pas:786-799 (TdmTFA007.tabMETABeforePost)

P: Não consigo escolher (F9) o Centro de Resultado na aba de vendedores. Por quê? R: É preciso informar a Empresa primeiro (E-1621); além disso, a empresa selecionada precisa ter o parâmetro 'Vários Vendedores' ativo em MFA001, senão o sistema bloqueia com a mensagem 'Para Centro de Resultado por vendedor, o parâmetro de Vários Vendedores deve estar ativo'. Fonte: source/TFA007/UTFA007.pas:1596-1611 (TfrmTFA007.gridCENTROCUSTOKeyDown), source/TFA007/UdmTFA007.pas:1158-1182 (TdmTFA007.tabCENTROCUSTOCD_EMPRESAValidate)

P: O botão 'Duplicar' não faz nada / dá erro ao clicar. Por quê? R: É preciso ter um vendedor de origem já aberto/carregado na tela antes de clicar em Duplicar; caso contrário o sistema mostra 'Selecione o vendedor de origem para duplicar as regras de comissão'. Fonte: source/TFA007/UTFA007.pas:1246-1261 (TfrmTFA007.btnDuplicarClick)

P: Como copio a meta de um mês para os próximos 12 ou 6 meses? R: Preencha e salve a meta do mês de referência e use as opções 'Replicar 12 Meses' / 'Replicar 6 Meses' do botão de metas; se a meta ainda não tiver data preenchida, o sistema pede para informar o mês de referência antes. Fonte: source/TFA007/UTFA007.pas:1263-1307 (ReplicarMeta)

P: Deu a mensagem 'A data inicial não pode ser maior que a data final' ao copiar metas por período. O que fazer? R: Confira os campos Data Início e Data Fim da cópia de período de metas: a data de início está depois da data de fim; corrija a ordem das datas. Fonte: source/TFA007/UTFA007.pas:1439-1444 (TfrmTFA007.copiaMetaSelecionada)

P: Ao excluir um vendedor, os pedidos/notas dele também são apagados? R: Não. O sistema apaga as regras de comissão e os acertos de comissão do vendedor, e apenas desvincula (deixa em branco) o vendedor nos cadastros de endereço, item de restaurante, nota, orçamento, parâmetro de restaurante e pedido — os documentos permanecem. Fonte: source/TFA007/UTFA007.pas:438-448 (TfrmTFA007.btnExcluirClick)

P: Por que a comissão de alguns vendedores não aparece calculada na venda, só depois? R: Para os tipos de comissão 'Unidades Vendidas no Mês x Meta Mensal' (U) e 'Meta por Quantidade e Bônus por Preço Médio' (H), o próprio sistema avisa na tela que a comissão não é calculada no registro do Pedido/Venda, apenas quando a tela MNF011 recalcula o período. Fonte: source/TFA007/UTFA007.pas:887-890 (TfrmTFA007.cmbST_COMISSAOChange), source/TFA007/UTFA007.pas:1009-1013 (TfrmTFA007.cmbST_COMISSAOChange)

P: Por que preciso informar Empresa e Centro de Custo juntos na aba Centro de Resultado? R: Os dois campos são obrigatórios para salvar a linha; além disso o sistema impede cadastrar duas vezes o mesmo Centro de Custo para o mesmo vendedor na mesma empresa. Fonte: source/TFA007/UdmTFA007.pas:1141-1153 (TdmTFA007.tabCENTROCUSTOBeforePost), source/TFA007/UdmTFA007.pas:1193-1201 (TdmTFA007.tabCENTROCUSTOCD_CENTROCUSTOValidate)

Dúvidas em aberto (o código não responde)

• O texto da mensagem E-1619 no catálogo fala em limite de 100, mas o código libera até 999,99. A mensagem do catálogo está desatualizada ou há outra validação (trigger/procedure) não lida nesta sessão que aplica o limite de 100? — TdmTFA007.tabMETAPC_DESCACRESValidate e TdmTFA007.tabVENDEDORPC_DESCACRESValidate (UdmTFA007.pas:1035-1042 e 1105-1112) só rejeitam valores < 0 ou > 999.99, mas disparam a mensagem E-1619 cujo texto no catálogo diz 'maior que 0 e menor que 100'.
• A checagem de meta com 'Período já informado' em tabMETADT_METAValidate monta a exceção mas não usa Raise — é proposital (pois já existe checagem redundante em tabMETABeforePost) ou é um bug que deixou essa validação sem efeito? — UdmTFA007.pas:1298-1327, TdmTFA007.tabMETADT_METAValidate. Comentário na linha 1305 credita a alteração a 'Lucas Felix, chamado 480948', sugerindo que a intenção era bloquear duplicidade neste ponto específico.
• Quais campos exatamente definem 'endereço cadastrado' para a validação E-1625 (o que o usuário precisa preencher em TFA001)? — UdmTFA007.pas:301-308 depende do retorno da procedure Firebird RETORNA_DADOSCADASTRAIS, que não foi lida nesta sessão.
• As licenças erpFatBasico e erpGourmetRet mudam algum comportamento visível da tela (campos, abas, bloqueios)? — Não foi encontrada no código lido (.pas) nenhuma checagem condicional a essas licenças; pode estar apenas no cadastro de módulos, fora do escopo dos arquivos analisados.