Pular para o conteúdo principal

CD_SERVCANALETA — Serviço de Canaleta

Tela de configuração: REC001 — Parâmetros da Recapadora Localização: Opção 3 Tabela: PARAMRECAP.CD_SERVCANALETA Tipo: INTEGER (FK → ITEM.CD_ITEM) Valor padrão: NULL (não configurado)


Descrição​

Define o item de serviço (tipo Serviço, TP_ITEM = 'S', ativo) que representa o serviço de canaleta executado durante os processos de raspagem (MRC007) e escareação (MRC009) na recapadora.

Quando o operador marca que a canaleta foi feita (STFEITOCANALETA = 1) na raspagem/escareação, o sistema utiliza este parâmetro para inserir automaticamente a linha de serviço no pedido de faturamento — buscando a tabela de preço, a movimentação padrão do cliente e o preço do item.


Campos envolvidos​

CampoTabelaTipoDescrição
CD_SERVCANALETAPARAMRECAPINTEGERCódigo do item de serviço de canaleta
DS_ITEMITEMVARCHARDescrição do item (exibida no campo auxiliar)

Constraint de integridade:

FK_PARAMRECAP_ITEMSERVCANALETA → ITEM (CD_ITEM)

Telas impactadas​

TelaUso
REC001Cadastro/edição do parâmetro
MRC020Faturamento — verifica se o parâmetro está preenchido para incluir serviços de canaleta no pedido de nota fiscal
JunsoftNFSe2 (PersistenciaDao)Emissão de NFS-e — identifica se o item do pedido corresponde ao serviço de canaleta parametrizado
RETORNA_DADOSORDEMCARREGRECAPOrdem de carregamento — filtra item de canaleta no pedido

Opções disponíveis​

O campo aceita o código de qualquer item de serviço ativo cadastrado em ITEM. Não existem opções de lista fixa — a digitação é livre, com validação no momento do preenchimento.


Preenchido — Item de Serviço Válido​

O que fazDetalhe
Tipo de controleCampo editável (edtCodCanaleta)
Tipo de dadoINTEGER — código do item
ValidaçãoO item deve existir, ter TP_ITEM = 'S' e ST_ATIVO = 'S'
Busca (F9)Abre consulta de itens com filtros TP_ITEM = 'S' e ST_ATIVO = 'S'
IntegridadeFK para ITEM.CD_ITEM

Simulação passo a passo​

  1. Acesse REC001 (Parâmetros da Recapadora).
  2. Navegue até a aba Opção 3.
  3. No campo Serviço Canaleta, digite o código de um item de serviço existente (ex: 5001) ou pressione <F9> para buscar.
  4. Se o código for válido (item ativo e do tipo serviço), a descrição do item será exibida no campo auxiliar.
  5. Salve o registro.

Resultado esperado: O código do item fica gravado em PARAMRECAP.CD_SERVCANALETA. A partir desse momento, ao faturar ordens de recapagem onde a canaleta foi realizada, o sistema insere automaticamente a linha de serviço canaleta no pedido de faturamento — com preço, tabela e movimentação calculados pelo fluxo INSERE_ITEMPEDIDO_SERVCANALETA.

Excecao / Importante: O item precisa estar vinculado a uma tabela de preço válida e o cliente deve ter uma movimentação de saída cadastrada para o item. Caso contrário, a procedure INSERE_ITEMPEDIDO_SERVCANALETA retornará mensagens de erro como "Não Existe Tabela de Preço Para o Item..." ou "Não Existe Movimentação de Saída Para o Cliente..." e o serviço não será inserido no pedido.


Vazio (NULL) — Sem Serviço de Canaleta Parametrizado​

O que fazDetalhe
ComportamentoNenhum serviço de canaleta é adicionado automaticamente ao pedido
Campo auxiliarDescrição do item fica em branco

Simulação passo a passo​

  1. Acesse REC001, aba Opção 3.
  2. Deixe o campo Serviço Canaleta vazio.
  3. Salve o registro.

Resultado esperado: Ao faturar ordens de recapagem onde a canaleta foi feita, o sistema não insere automaticamente a linha de serviço de canaleta no pedido. O operador precisará adicionar o item manualmente, se necessário.


Código Inválido — Item Inexistente, Inativo ou Não-Serviço​

O que fazDetalhe
ValidaçãoDisparada pelo evento qryCadastroCD_SERVCANALETAValidate
Condições de erroItem não existe, TP_ITEM <> 'S' ou ST_ATIVO <> 'S'

Simulação passo a passo​

  1. Acesse REC001, aba Opção 3.
  2. No campo Serviço Canaleta, digite um código que não exista na tabela ITEM (ex: 99999), ou um código de produto (tipo diferente de Serviço), ou um item inativo.
  3. Saia do campo ou tente salvar.

Resultado esperado: O sistema exibe a mensagem "O Produto não está cadastrado, Verifique! [TPO001]" e impede a gravação.


Fluxo Automático — Inserção do Serviço no Pedido​

Quando o parâmetro está preenchido, o fluxo ocorre automaticamente durante o faturamento de ordens de recapagem:

  1. O sistema verifica se a raspagem/escareação marcou STFEITOCANALETA = 1.
  2. Lê CD_SERVCANALETA de PARAMRECAP para a empresa.
  3. Busca a movimentação de saída do cliente para o serviço (RETORNA_MOVIMENTACAOPADRAO).
  4. Busca a tabela de preço que contenha o serviço de canaleta (PARMTABPRECO + ITEMTABPRECO).
  5. Calcula o preço do serviço (RETORNA_PRECOITEM).
  6. Verifica o tipo de peso/quantidade (HABILITA_PESOQTDE).
  7. Insere a linha em ITEMPEDIDO com TP_PEDIDO = 'S', status 'N' (Normal), entrega 'A' (Aberta).

Importante: Se a movimentação de saída ou a tabela de preço não forem encontradas, o sistema gera uma mensagem de erro e não insere o item. Verifique os cadastros em MFA001 e MFA005/MFA006.


Regra Geral​

  • O parâmetro é opcional. Se não preenchido, nenhuma linha de canaleta é inserida automaticamente.
  • Deve apontar para um item de serviço ativo (TP_ITEM = 'S', ST_ATIVO = 'S').
  • O item deve possuir tabela de preço válida e movimentação de saída para o cliente.
  • Utilizado tanto no fluxo de faturamento (MRC020) quanto na emissão de NFS-e (JunsoftNFSe2) para identificar o serviço de canaleta.