CD_SERVCANALETA — Serviço de Canaleta
Tela de configuração: REC001 — Parâmetros da Recapadora Localização: Opção 3 Tabela:
PARAMRECAP.CD_SERVCANALETATipo: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
| Campo | Tabela | Tipo | Descrição |
|---|---|---|---|
CD_SERVCANALETA | PARAMRECAP | INTEGER | Código do item de serviço de canaleta |
DS_ITEM | ITEM | VARCHAR | Descrição do item (exibida no campo auxiliar) |
Constraint de integridade:
FK_PARAMRECAP_ITEMSERVCANALETA → ITEM (CD_ITEM)
Telas impactadas
| Tela | Uso |
|---|---|
| REC001 | Cadastro/edição do parâmetro |
| MRC020 | Faturamento — 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_DADOSORDEMCARREGRECAP | Ordem 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 faz | Detalhe |
|---|---|
| Tipo de controle | Campo editável (edtCodCanaleta) |
| Tipo de dado | INTEGER — código do item |
| Validação | O 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' |
| Integridade | FK para ITEM.CD_ITEM |
Simulação passo a passo
- Acesse REC001 (Parâmetros da Recapadora).
- Navegue até a aba Opção 3.
- No campo Serviço Canaleta, digite o código de um item de serviço existente (ex:
5001) ou pressione<F9>para buscar. - Se o código for válido (item ativo e do tipo serviço), a descrição do item será exibida no campo auxiliar.
- 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_SERVCANALETAretornará 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 faz | Detalhe |
|---|---|
| Comportamento | Nenhum serviço de canaleta é adicionado automaticamente ao pedido |
| Campo auxiliar | Descrição do item fica em branco |
Simulação passo a passo
- Acesse REC001, aba Opção 3.
- Deixe o campo Serviço Canaleta vazio.
- 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 faz | Detalhe |
|---|---|
| Validação | Disparada pelo evento qryCadastroCD_SERVCANALETAValidate |
| Condições de erro | Item não existe, TP_ITEM <> 'S' ou ST_ATIVO <> 'S' |
Simulação passo a passo
- Acesse REC001, aba Opção 3.
- 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. - 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:
- O sistema verifica se a raspagem/escareação marcou
STFEITOCANALETA = 1. - Lê
CD_SERVCANALETAdePARAMRECAPpara a empresa. - Busca a movimentação de saída do cliente para o serviço (
RETORNA_MOVIMENTACAOPADRAO). - Busca a tabela de preço que contenha o serviço de canaleta (
PARMTABPRECO+ITEMTABPRECO). - Calcula o preço do serviço (
RETORNA_PRECOITEM). - Verifica o tipo de peso/quantidade (
HABILITA_PESOQTDE). - Insere a linha em
ITEMPEDIDOcomTP_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
MFA001eMFA005/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.