ST_IMPORTAOBSITEMPED — Importar Observação da OS no Item do Pedido

Tela de configuração: OFI001 — Parâmetros da Oficina Localização: Aba Ordem 1 → campo "Ordem 1" Tabela: PARMOFICINA.ST_IMPORTAOBSITEMPED Tipo: CHAR(1) Valor padrão: N

Resumo

Controla se a observação (ocorrência) registrada na Ordem de Serviço será automaticamente importada como descrição complementar do primeiro serviço quando o usuário gera um Pedido de Venda a partir da OS (botão "Pedido" no MOF001).

Telas impactadas

Tela	Arquivo	Efeito
MOF001 (Ordem de Serviço)	source/MOF001/UMOF001.pas	Ao clicar em "Pedido" (btnPedidoClick), verifica o valor e decide se importa a ocorrência

Campos envolvidos

Campo	Tabela / Origem	Papel
ST_IMPORTAOBSITEMPED	PARMOFICINA	Parâmetro que define o comportamento
DS_OBSERVACAO	ORDEMSERVICO	Texto da ocorrência da OS (fonte dos dados)
DS_OBSITEM / iDS_OBSITEM	PEDIDOITEM	Destino — descrição complementar do item no pedido

Opções disponíveis

O que faz	Detalhe
N — Não Importar	A ocorrência da OS não é copiada para o item do pedido. O campo vObsServico é limpo. Valor padrão do sistema.
O — Ocorrência	A ocorrência da OS é anexada à descrição do primeiro serviço do pedido gerado, no formato Ocorrência: [texto].

---

N — Não Importar

Simulação passo a passo

1. Acesse OFI001 (Parâmetros da Oficina).
2. Na aba Ordem 1, localize o campo ao lado do label "Ordem 1".
3. Selecione Não Importar (N).
4. Salve o parâmetro.
5. Abra uma Ordem de Serviço em MOF001 que possua texto no campo "Ocorrência" (DS_OBSERVACAO), por exemplo: "Barulho no motor ao frear".
6. Clique no botão Pedido para gerar o Pedido de Venda.
7. Abra o pedido gerado e verifique a descrição do primeiro serviço.

Resultado esperado: A descrição do primeiro serviço no pedido contém apenas a descrição padrão do item (sem texto adicional de ocorrência).

Importante: Quando este parâmetro está como N, a variável interna vObsServico é zerada, garantindo que nenhum texto de ocorrência seja transportado para o pedido.

---

O — Ocorrência

Simulação passo a passo

1. Acesse OFI001 (Parâmetros da Oficina).
2. Na aba Ordem 1, localize o campo ao lado do label "Ordem 1".
3. Selecione Ocorrência (O).
4. Salve o parâmetro.
5. Abra uma Ordem de Serviço em MOF001 e preencha o campo "Ocorrência" com, por exemplo: "Barulho no motor ao frear".
6. Adicione ao menos um serviço na OS (ex: código de serviço 1001).
7. Clique no botão Pedido para gerar o Pedido de Venda.
8. Abra o pedido gerado e verifique a descrição do primeiro serviço inserido.

Resultado esperado: A descrição do primeiro serviço no pedido aparece como:

• Se o item já tinha descrição customizada: Descrição do Serviço/Ocorrência: Barulho no motor ao frear
• Se o item usa a descrição padrão: Ocorrência: Barulho no motor ao frear

Excecao / Importante:

• A importação ocorre apenas no primeiro serviço do pedido (controle via variável primeiroItem). Os demais serviços não recebem o texto da ocorrência.
• Se o campo "Ocorrência" da OS estiver vazio (DS_OBSERVACAO em branco), nenhum texto é importado mesmo com o parâmetro ativo.
• O texto da observação do pedido (DS_OBSERVACAO do PEDIDO) é preenchido independentemente, com dados como KM, Chassi e Veículo — este parâmetro controla somente a observação do item do pedido.

Tabela Comparativa Resumida

Valor	Descrição	Ocorrência → Item do Pedido	Observação do Pedido
N	Não Importar	❌ Não importa	Preenchida normalmente (KM, Chassi, Veículo)
O	Ocorrência	✅ Importa no 1º serviço	Preenchida normalmente (KM, Chassi, Veículo)

Procedures impactadas

Rotinas Delphi com referência direta ao parâmetro

Rotina	Arquivo	Linha	Evidência
TfrmMOF001.btnPedidoClick	source/MOF001/UMOF001.pas	4268	if (ParmOficina.Values['ST_IMPORTAOBSITEMPED'] = 'O') then
TfrmMOF001.btnPedidoClick	source/MOF001/UMOF001.pas	4352	if (ParmOficina.Values['ST_IMPORTAOBSITEMPED'] = 'O') and (primeiroItem) and (vObsServico <> '')
TdmOFI001.tabPARMOFICINAAfterInsert	source/OFI001/UdmOFI001.pas	383	tabPARMOFICINAST_IMPORTAOBSITEMPED.AsString := 'N'

Referências SQL diretas ao campo

Não foi encontrada referência direta ao campo ST_IMPORTAOBSITEMPED em procedures/views SQL do diretório Scripts/. O campo é lido exclusivamente via ParmOficina.Values[...] no código Delphi.

Candidatas por uso da tabela PARMOFICINA

As procedures/views abaixo fazem JOIN ou SELECT na tabela PARMOFICINA, mas não citam o campo ST_IMPORTAOBSITEMPED. Não há impacto funcional direto identificado no código para este parâmetro:

• PARCELA_FINANC_MNF017 (Scripts/PARCELA_FINANC_MNF017.sql)
• PARCELA_FINANCIAMENTO (Scripts/PARCELA_FINANCIAMENTO.sql)
• REABRE_OS (Scripts/REABRE_OS.sql)
• RETORNA_MOTIVOBLOQUEIO (Scripts/RETORNA_MOTIVOBLOQUEIO.sql)
• RETORNA_PRECOITEM (Scripts/RETORNA_PRECOITEM.sql)
• VERIFICA_BLOQUEIO (Scripts/VERIFICA_BLOQUEIO.sql)
• VIEW_DOCUMENTOSBLOQUEADOS (Scripts/VIEW_DOCUMENTOSBLOQUEADOS.sql)
• VIEW_ROF004 (Scripts/VIEW_ROF004.sql)
• VIEW_ROF004B / VIEW_ROF004B_V2 (Scripts/VIEW_ROF004B.sql / Scripts/VIEW_ROF004B_V2.sql)
• VIEW_ROF008 (Scripts/VIEW_ROF008.sql)