Envio Email Ordem Compra

Introdução

Este artigo descreve o funcionamento do envio de e-mails a partir da 273 Ordem de Compra, contemplando o uso do Modelo E-mail (recurso 132) com ou sem 1571 Observacao Dinamica e as validações/configurações necessárias nos recursos relacionados. O comportamento de corpo do e-mail foi estendido para permitir o uso da Observação Dinâmica vinculada ao Modelo E-mail quando aplicável.

Pré-requisitos e Configurações Necessárias

• Servidor de E-mail (recurso 496 Servidor Email) devidamente configurado.
• Modelo E-mail (recurso 132 Modelo Email) definido para Ordem Compra nas Opções de Relacionamento (recurso 134 ▸ aba Logística Faturamento ▸ Ordem Compra).
• E-mail em cópia (se aplicável) informado e opção Enviar Cópia marcada nas Opções de Relacionamento.
• BI da Ordem de Compra informado nas Opções de Compra 804 Opcoes Compra.
• (Opcional) Modelo E-mail preferencial do usuário; caso não informado, usa-se o configurado nas Opções de Relacionamento. Se informado, se busca preferencialmente do recurso 54 - Usuarios, aba "Outras Opções": Servidor E-mail e Modelo E-mail.

Onde acionar o envio

O envio é acionado pelos hot-links no recurso 273 – Ordem Compra:

• Enviar E-Mail OC
• Enviar E-Mail OC Solicitante

Ambos passam por validações e utilizam o Modelo/Servidor de E-mail conforme regras abaixo.

Validações ao enviar

Ao acionar um dos hot-links, ocorrem as seguintes verificações:

1. É necessário haver uma Ordem de Compra selecionada.
2. Para OC fechada, é exigida confirmação do envio.
3. Deve haver Servidor de E-mail informado em 134 ▸ Logística Faturamento ▸ Ordem Compra (caso não use o servidor preferencial do usuário, ou este não esteja informado).
4. Deve haver Modelo E-mail informado em 134 ▸ Logística Faturamento ▸ Ordem Compra (caso não use o modelo preferencial do usuário, ou este não esteja informado).
5. Se a opção de enviar cópia estiver ativa, o e-mail de cópia precisa estar preenchido.
6. É necessário informar o BI da Ordem de Compra nas Opções de Compra (804 Opcoes Compra).

Destinatários do envio

Dependendo do hot-link acionado, os destinatários variam:

• Enviar E-Mail OC Solicitante: envia apenas aos usuários solicitantes das OCs (identificados pelas necessidades de compra vinculadas), desde que o usuário possua um e-mail habilitado para envio de ordem de compra; envia também para o e-mail em cópia informado nas Opções de Relacionamento.
• Enviar E-Mail OC: além do acima, envia para o Fornecedor da OC (se houver e-mail habilitado) e para o Transportador (se o checkbox de enviar cópia ao transportador estiver ativo). Também envia para os e-mails informados na própria OC, quando aplicável.

Corpo do e-mail: Modelo Padrão vs Observação Dinâmica

Uso do Modelo Padrão

Se o Modelo E-mail não possui Observação Dinâmica vinculada, é utilizado o modelo padrão.

Uso de Observação Dinâmica

Quando o Modelo E-mail possuir uma 1571 Observacao Dinamica vinculada, ela substitui o corpo padrão do modelo, desde que:

• Se houver origem definida na Observação Dinâmica, deve ser “Ordem Compra” (classe com.touchcomp.basementor.model.vo.OrdemCompra).
• Caso não haja origem definida, também é permitido o uso.
• Os tokens da Observação Dinâmica são preenchidos com dados da Ordem de Compra que acionou o hot-link.

Como configurar a Observação Dinâmica

1. Cadastre a Observação Dinâmica no recurso 1571 – Observação Dinâmica e, se for utilizar origem, informe Ordem Compra.
2. Edite o Modelo E-mail (132) e vincule esta Observação Dinâmica em Configuração Nova – OBS Dinâmica.
3. Utilize os campos disponíveis da OC na Observação (tokens) para compor o texto. Ex.: Olá, a OC @field:identificador@ foi enviada….

Fluxo de envio (resumo)

1. Usuário aciona Enviar E-Mail OC ou Enviar E-Mail OC Solicitante na OC.
2. Sistema executa validações (OC selecionada, status, servidor, modelo, cópia, BI da OC).
3. Sistema identifica destinatários conforme hot-link.
4. Sistema determina o Modelo E-mail efetivo (preferencial do usuário ou de Opções de Relacionamento).
5. Se houver Observação Dinâmica válida, usa-a como corpo (com substituição de tokens); caso contrário, usa o modelo padrão.
6. E-mail é enviado via Servidor de E-mail configurado.

Exemplos de Observação Dinâmica para OC

Olá,
A Ordem de Compra @field:identificador@ foi registrada com os seguintes detalhes:
- Fornecedor: @field:unidadeFatFornecedor.pessoa.nome@
- Data Prevista de Chegada: @field:dataPrevChegada@

Favor acompanhar o recebimento conforme cronograma.