====== SMA pela Entrada da Nota Fiscal (PRX048117) ======

Este manual orienta a operação da geração automática de **SMA** durante a geração da AD.

===== 🔎 Visão Geral =====

  * A SMA é gerada de forma **automática** no processo de **Gerar AD**.
  * Não existe botão separado para criar SMA nessa rotina.
  * A geração depende de configuração correta e das regras do documento/item.

💡 Dica: pense neste processo como “Gerar AD + gerar SMA quando aplicável”.

===== ⚙️ Configurações Necessárias =====
Antes da operação, revise a tela de configuração do PRX048117.

^ Campo ^ Objetivo ^ Orientação de uso ^
| Gerar SMA| Liga/desliga a geração automática da SMA. | Manter ligado quando o processo exige SMA. |
| Critério Tipo Movimento SMA | Define o tipo de movimento que deve ser aplicado para cada SMA gerada. Se este campo não for preenchido o tipo de movimento padrão será Transferência| Use regra simples e validada em homologação. |
| Critério Geração SMA | Define em quais cenários a SMA deve ser criada. | Use regra simples e validada em homologação. |
| Critério Quantidade SMA | Define a quantidade da SMA. | Se não usar fórmula, o sistema considera a quantidade do item da AD. |
| Etapa Específica SMA | Campo de configuração disponível no processo. | Validar uso com responsável funcional conforme regra do ambiente. |

⚠️ Atenção: 

1. Para SMA de Transferência, se não houver local de destino de produção previamente configurado no sistema, a SMA não será gerada. A transferência via entrada da nota fiscal sempre ocorrerá em sentido único: local de estoque de origem sendo o cadastrado no item e local de estoque destino o local parametrizado da produção (cadastrado através do programa de parâmetros do estoque, PR04616).

2. Para SMA de Saída (Requisições, etc..), o local de origem será sempre o definido no cadastro do item.

3. Para SMA de Entrada (Retorno de item, devolução, etc..), o local de destino poderá variar de acordo com algumas regras de negócio:
   * Parâmetro Geral que permite definir um local de estoque fixo onde os movimentos entrarão, caso contrário;
   * Local de estoque cadastrado no item.

===== ▶️ Como Operar no Dia a Dia =====

  - Abra o PRX048117 e carregue a nota fiscal.
  - Confira itens, quantidades e locais de estoque.
  - Clique em **Gerar AD**.
  - Aguarde o processamento da AD.
  - Consulte a SMA no gerenciador para validar o resultado.

===== ✅ Como Conferir se a SMA Foi Gerada =====

Confira os sinais abaixo:

  * A AD foi gerada com sucesso.
  * Existe SMA vinculada ao processo esperado.
  * A movimentação está coerente com a necessidade de produção.

💡 Dica: na conferência inicial, valide principalmente item, quantidade e local de destino.

===== ❌ Quando a SMA Não é Gerada =====

^ Situação ^
| Quantidade de movimentação igual a zero |
| Movimento é simbólico|
| Critério de geração customizado retorna “falso” (ou valor inválido)|

Se o parâmetro adicional de Reserva Automática da OP estiver ativo (controle e vinculo de Entrada de Nota Fiscal vs Fluxo de Produção):

^ Situação ^
| Item sem vínculo com necessidade de produção (Fluxo de produção, com solicitação de compra, ordem de produção e necessidade de produção ativa)|
| Ordem de produção não está com status em produção|
| Requisição da ordem de produção está cancelada|
| Não há saldo restante na requisição da ordem de produção|

===== 🔄 Cancelamento da AD com SMA =====

Ao cancelar AD com SMA vinculada:

  * o sistema valida se as SMAs podem ser canceladas;
  * se houver SMA encerrada, o cancelamento da AD pode ser bloqueado;
  * se a SMA estiver em etapa não permitida para manutenção, o cancelamento também pode ser bloqueado;
  * quando permitido, as SMAs ativas relacionadas são canceladas automaticamente.

===== 🛠️ Mensagens Comuns e Como Agir =====

^ Mensagem (resumo) ^ Causa provável ^ Como agir ^
| Local de estoque de produção não foi definido | Configuração obrigatória ausente quando tipo de movimento for transferência. | Solicitar ajuste da configuração do local de destino da produção. |
| Critério de quantidade inválido | Fórmula retornou valor não numérico. | Corrigir fórmula para retorno numérico. |
| Documento possui SMA encerrada | Não permite cancelar AD com SMA encerrada vinculada. | Tratar a situação da SMA antes de cancelar AD. |
| SMA fora da rotina de manutenção | Etapa atual da SMA não permite cancelamento. | Ajustar etapa/permissão conforme regra do processo. |

===== 📌 Boas Praticas Operacionais =====

  * Validar configurações da SMA antes de liberar para produção.
  * Testar fórmulas de critério e quantidade em homologação.
  * Conferir local de origem/destino antes de gerar AD.
  * Em cancelamentos, avaliar primeiro a situação das SMAs vinculadas.