01. DADOS GERAIS
| Produto: | TOTVS DMS |
|---|---|
| Linha de Produto: | Linha Protheus |
| Segmento: | Varejo |
| Módulo: | TOTVS DMS (Linha Protheus) - Oficina (SIGAOFI) TOTVS DMS (Linha Protheus) - Autopeças (SIGAPEC) TOTVS DMS (Linha Protheus) - Veículos (SIGAVEI) |
| Função: | Sugestão de Compras DMS (Mata297M) |
| País: | Todos os países |
| Ticket: | Não se aplica |
| Requisito/Story/Issue (informe o requisito relacionado) : | DVARMIL-12501 |
02. SITUAÇÃO/REQUISITO
Se faz necessário centralizar e controlar a manutenção de itens já vinculados à Sugestão de Compras, evitando divergências entre o que está na sugestão (SDF/VB5) e o que permanece pendente no Orçamento ou na OS.
Hoje, alterações feitas diretamente na rotina MATA297M (troca de produto, mudança de quantidade ou exclusão) podem gerar inconsistências e falta de rastreabilidade.
Cenário atual que motivou a mudança:
Usuários alteram código ou quantidade de itens vinculados à sugestão na tela principal, afetando o vínculo com o Orçamento/OS.
Não havia um local único para reduzir/remover quantidades de forma segura.
Quando todos os itens de um orçamento saem da sugestão, o status não retorna automaticamente para “0 – Digitado”.
O vendedor não é avisado quando itens são atualizados ou removidos da sugestão.
Requisito:
Bloquear na MATA297M as ações indevidas (troca de produto, reduzir quantidade abaixo do sugerido, exclusão).
Criar a opção Composição & Manutenção para ajustar quantidades somente por ali.
Propagar os ajustes para Orçamento e OS, reverter o orçamento para “0 – Digitado” quando não houver itens pendentes e enviar e-mail automático ao vendedor com o resumo das alterações.
03. SOLUÇÃO
Foi criada a opção Composição & Manutenção no MATA297M para ajustar as quantidades vinculadas à Sugestão de Compras , recalculando o total e refletindo no orçamento/OS. Na tela padrão, foram bloqueadas: troca de produto, deleção e aumento de quantidade — o usuário é direcionado à nova opção. Ao confirmar, o sistema envia e-mail ao vendedor por Orçamento/OS (azul para alteração; vermelho quando todos os itens forem zerados) e, se não houver pendências, o orçamento em “A” retorna para “0 – Digitado”. Para o envio automático, configurar o VEIA010 no grupo 003 – Sugestão de Compras (eventos 003001/003002).
📧 Para correto funcionamento do processo de envio de e-mail automático por eventos,
é necessária a configuração dos parâmetros padrões da TOTVS, conforme exemplo fictício abaixo
| Parâmetro | Descrição | Valor Exemplo (Gmail) |
|---|---|---|
| MV_RELSERV | Nome do servidor SMTP e porta usada para envio de e-mail. | smtp.gmail.com:587 |
| MV_RELAUTH | Define se o servidor SMTP exige autenticação. Pode ser .T. (sim) ou .F. (não). | .T. |
| MV_RELAUSR | Usuário (e-mail) utilizado para autenticação no servidor SMTP. | [email protected] |
| MV_RELAPSW | Senha para autenticação no servidor SMTP. No Gmail, deve ser a senha de aplicativo gerada. | abcd efgh ijkl mnop |
| MV_EMCONTA | Conta de e-mail que será usada como remetente para o envio automático. | [email protected] |
| MV_EMSENHA | Senha da conta remetente para envio. Normalmente igual à senha de autenticação. | abcd efgh ijkl mnop |
Feito a parametrização correta:
- Acessa a rotina VEIA010 (Cadastro de Envio automático de E-mails)
Abrir o grupo “003 – Sugestão de Compras”
Selecione o grupo 003.
Cadastrar os eventos do grupo
003001 – Alterar (quando a quantidade for atualizada)
003002 – Excluir (quando o item for removido da sugestão)
Preencher os destinatários
Informe os e-mails dos vendedores (ou utilize regra/consulta conforme seu cadastro).
É possível adicionar e-mails fixos (ex.: coordenação) como cópia.
Validar o código do evento
Campo VEU_EVENTO deve ter 6 caracteres conforme a documentação DT DMS Melhoria para envio de e-mails automáticos nos eventos do DMS (VEIA010).
Campo
VEU_EVENTO
Tamanho 6 Val. Sistema Visual V Combobox Browse Não Inic.Padrão Help Informe o evento que dispara o e-mail.
A rotina Composição & Manutenção permite ajustar, de forma controlada, as quantidades sugeridas na Sugestão de Compras. Ela exibe o cabeçalho do orçamento/OS, os itens sugeridos (SDF) e o detalhamento de composição (VB5). Toda alteração é feita exclusivamente no campo VB5_QTDAGU: o sistema soma as linhas de VB5 do mesmo item e recalcula o DF_QTDSUG, atualizando o pendente no orçamento (VS3) ou na OS (VSJ) conforme o caso. É possível reduzir quantidades ou zerar; aumentar acima do pendente é bloqueado. Ao confirmar, se todos os itens de um orçamento ficarem zerados, o status retorna para 0 – Digitado. A rotina também envia e-mail automático por orçamento/OS (um por agrupamento), indicando os itens ajustados (azul) ou totalmente removidos (vermelho), desde que configurado no VEIA010 (grupo 003 – Sugestão de Compras).
04. DEMAIS INFORMAÇÕES
| Pacotes Gerados: | 12.1.2210: https://r.totvs.io/p/1231290 12.1.2310: https://r.totvs.io/p/1231291 12.1.2410: https://r.totvs.io/p/1231292 12.1.2510: https://r.totvs.io/p/1231293 |
|---|
05. ASSUNTOS RELACIONADOS
DT DMS Melhoria para envio de e-mails automáticos nos eventos do DMS (VEIA010)

