Item
Item — Cadastro Geral (ERPAtak)
A rotina Item, do grupo Órgão Público do módulo Cadastro Geral (menu Cadastro Geral > Órgão Público > Item, recurso 1193), é o cadastro que relaciona, para cada cadastro geral, o código e o nome com que o órgão público (ou outro participante) chama um produto ao item do ERP.
Visão Geral
A rotina Item, do grupo Órgão Público do módulo Cadastro Geral (menu Cadastro Geral > Órgão Público > Item, recurso 1193), é o cadastro que relaciona, para cada cadastro geral, o código e o nome com que o órgão público (ou outro participante) chama um produto ao item do ERP. Cada linha liga um cadastro geral a um item e referência do estoque e guarda o “Cod. Item do Órgão” e o “Nome Item do Órgão”. Esta tela não cadastra itens do estoque: ela só guarda o código que o participante usa para um item já cadastrado. A importação de notas por XML de entrada usa o código do participante para achar o item do ERP (ver Integrações).
A tela tem duas partes. A listagem “Lista de Item por Cadastro Geral:” mostra uma linha por vínculo cadastrado. A edição (“Novo Item” ou “Cadastro geral – Item: {código}”) mostra o cadastro geral escolhido no alto e, abaixo, a grade com todos os vínculos dele. A rotina Órgão Público (recurso 1192), do mesmo grupo, tem manual próprio.
Pré-requisitos
- Cadastro geral: o participante precisa existir no Cadastro geral; a edição começa pela escolha dele.
- Itens cadastrados e ativos: a pesquisa de item só traz itens ativos.
Permissões e Acesso
Recursos de menu e de ação do Item
A rotina aparece no menu Cadastro Geral, no grupo “Órgão Público” (recurso 1191, ordem 50 do menu), como o item de ordem 2, recurso 1193. O usuário só vê a opção se o grupo dele tiver acesso ao recurso.
| Recurso | Ação protegida |
|---|---|
| 1193 | Abrir a listagem |
| 1206 | Gravar um cadastro novo (Novo) |
| 1207 | Gravar a edição (Editar) |
| 1208 | Excluir o vínculo da linha selecionada na listagem |
| 1209 | Exportar a listagem |
Quando o grupo do usuário não tem acesso a uma ação protegida, o sistema responde “Você não tem permissão para acessar este recurso”.
Ações do Item sem verificação de recurso
Obter um vínculo, listar os vínculos e listar os vínculos de um cadastro geral (a listagem e a grade da edição) estão marcados como de acesso livre: o sistema não confere grupo nem recurso do usuário nessas ações.
Fluxo Operacional
Fluxo de cadastro de itens de um participante
- O usuário abre Cadastro Geral > Órgão Público > Item; a tela abre “Lista de Item por Cadastro Geral:”.
- Aciona “Novo”; a tela abre “Novo Item”.
- Escolhe o “Cadastro Geral”.
- Aciona “Novo” da barra da janela, escolhe o “Item” (código e referência), informa o “Cod. Item do Órgão” e o “Nome Item do Órgão” e confirma a linha.
- Repete para cada item e aciona “Salvar” ou “Salvar e Fechar”.
Fluxo de manutenção dos vínculos de um participante
- O usuário localiza o vínculo na listagem e dá duplo clique, ou seleciona a linha e aciona “Edição”.
- A tela abre “Cadastro geral – Item: {código do cadastro}” com todos os vínculos daquele cadastro geral na grade.
- Edita a linha, inclui uma linha nova com “Novo” ou remove uma linha com “Excluir” da barra da janela.
- Aciona “Salvar” ou “Salvar e Fechar”.
Fluxo de exclusão de um vínculo pela listagem
- O usuário seleciona a linha na listagem e aciona “Excluir”.
- Confirma “Confirma exclusão do(s) registro(s)?”.
Interface e Comportamentos da Tela
Listagem de itens por cadastro geral
A tela “Lista de Item por Cadastro Geral:” tem a barra de ferramentas “Ferramentas -> Orgão Público”, a pesquisa livre e a grade com paginação de 30 linhas. A barra tem “Novo”, “Edição”, “Excluir”, a exportação para Excel, Word, PDF e HTML, “Vídeo” e “Fechar Aba”, e há a barra “Personalizar Listagens”. O duplo clique numa linha abre a edição.
| Coluna | Conteúdo |
|---|---|
| ID | Número do vínculo |
| Cadastro | Código e nome do cadastro geral, no formato “código – nome” |
| Cod. Item | Código do item do ERP |
| Cod. Referência | Código da referência do item |
| Nome Do Item | Nome do item do ERP |
| Cod. Item do Órgão | Código do item no participante |
| Nome Item do Órgão | Nome do item no participante |
Janela de cadastro e edição
A janela tem o grupo “Item”, com o campo “Cadastro Geral” (pesquisa de cadastro geral, obrigatória), e abaixo a grade de vínculos. Ao escolher o cadastro geral (ou ao abrir a edição), a grade carrega a primeira página dos vínculos daquele cadastro. A barra de ferramentas da janela, tanto no cadastro novo quanto na edição, tem “Salvar” (Ctrl + S), “Salvar e Fechar” (Ctrl + Alt + S), “Salvar e Novo” (Ctrl + Shift + S), “Cancelar” (Ctrl + D, “Desfazer alterações”), “Novo” (Ctrl + Insert, “Novo item”), “Edição” (Ctrl + E, “Editar item”), “Excluir” (Ctrl + Delete) e “Fechar Aba”. O botão “Excluir” da barra da janela remove a linha da grade; não há botão para excluir o cadastro inteiro.
Grade de vínculos
A grade é editável por linha, com paginação de 30 linhas. Depois de confirmar uma linha nova, a grade abre outra linha em branco para continuar a digitação.
| Coluna | Obrigatório | Observação |
|---|---|---|
| Item | Sim | Pesquisa de itens ativos; a grade mostra “código.referência – nome” |
| Cod. Item do Órgão | Sim | Texto de até 30 caracteres |
| Nome Item do Órgão | Sim | Texto de até 50 caracteres |
Pesquisa de item da grade
A pesquisa do campo “Item” lista os itens ativos, em páginas de 30, e devolve o código e a referência do item escolhido. O código do item tem até 12 caracteres e a referência até 4.
Pesquisa livre da listagem
Na listagem, um texto numérico filtra os vínculos cujo cadastro geral ou número do vínculo seja igual ao número, ou cujo código do item ou Cod. Item do Órgão seja igual ao texto. Qualquer outro texto filtra pelos vínculos cujo nome do cadastro geral, nome do item ou Nome Item do Órgão contenha o texto.
Pesquisa livre da grade da janela
Na grade da janela, um texto numérico filtra os vínculos cujo código do item ou Cod. Item do Órgão seja igual ao texto. Outro texto filtra pelos vínculos cujo nome do item ou Nome Item do Órgão contenha o texto. Sem texto, a grade mostra todos os vínculos do cadastro geral.
Ordenação
A listagem vem pelo número do vínculo, do menor para o maior; o clique no título de uma coluna ordena por ela. Os títulos “Cadastro” e “Nome Do Item” ordenam, os dois, pelo nome do cadastro geral.
Exclusão de linha na grade
O botão “Excluir” da barra da janela marca a linha selecionada para exclusão e a tira da grade; a exclusão só vale depois de “Salvar” ou “Salvar e Fechar”. Se a grade tem apenas uma linha, a tela recusa a remoção, mesmo sem linha selecionada.
Feedbacks ao Usuário
Feedbacks da janela de cadastro e edição
| Situação | Tipo e título | Texto exato |
|---|---|---|
| Remover a última linha da grade | Informação “AVISO” | “Não é permitido remover todos os itens!!!” |
| Desfazer alterações | Confirmação “Confirmação” | “Deseja cancelar as alterações?” |
| Campo obrigatório vazio | Destaque do campo | O campo fica marcado como obrigatório |
Feedbacks da listagem
| Situação | Tipo e título | Texto exato |
|---|---|---|
| Excluir o vínculo selecionado | Confirmação “Confirmação” | “Confirma exclusão do(s) registro(s)?” |
Mensagens devolvidas pela gravação
| Situação | Título | Texto exato |
|---|---|---|
| Cadastro novo gravado | “ItemReferenciaPorCadastroGeral” | “ItemReferenciaPorCadastroGeral inserida(o) com sucesso.” |
| Edição gravada | “Editar ItemReferenciaPorCadastroGeral” | “ItemReferenciaPorCadastroGeral editada(o) com sucesso.” |
| Vínculo excluído pela listagem | “Excluir ItemReferenciaPorCadastroGeral” | “ItemReferenciaPorCadastroGeral excluída(o) com sucesso” |
As validações da gravação aparecem como mensagem padronizada com três partes, Erro, Motivo e Solução. O texto está em Troubleshooting.
Regras de Negócio
Vínculo de item com cadastro geral
Cada vínculo guarda o cadastro geral, o item com a referência, o Cod. Item do Órgão (até 30 caracteres) e o Nome Item do Órgão (até 50 caracteres). O sistema não impede dois vínculos do mesmo cadastro geral com o mesmo item ou com o mesmo Cod. Item do Órgão.
Item e referência
O campo “Item” devolve o código e a referência juntos, no formato “código.referência”. O sistema separa os dois no ponto. Quando a referência vem vazia depois do ponto, o sistema grava a referência “0”.
Gravação do cadastro novo
- Linha gravada: só vale a linha com Item e Cod. Item do Órgão preenchidos. O sistema não confere o Nome Item do Órgão, que a tela exige.
- Sem linha válida: a gravação é recusada com a mensagem de T-01.
- Marca de exclusão: o sistema não considera a marca de exclusão das linhas no cadastro novo; toda linha válida enviada pela grade é gravada.
Gravação da edição
- Linha nova: o sistema cria o vínculo com o cadastro geral do cabeçalho.
- Linha existente: o sistema atualiza o vínculo com os valores da grade.
- Linha removida: o sistema exclui o vínculo da linha marcada para exclusão; a linha incluída e removida antes de gravar é descartada.
- Linha incompleta: a linha sem Item, Cod. Item do Órgão ou Nome Item do Órgão é ignorada sem aviso, inclusive a marcada para exclusão.
- Só vale a página carregada: a gravação considera as linhas da página que está na grade; as demais páginas do cadastro geral não são alteradas.
Remoção de linhas da grade
A tela recusa remover quando a grade tem uma linha só (“Não é permitido remover todos os itens!!!”): o cadastro novo ou editado mantém ao menos um vínculo na grade carregada.
Pesquisa livre e ordenação
As regras de pesquisa e de ordenação estão na seção Interface e Comportamentos da Tela.
Relatórios e Exportações
Exportação da listagem
Os botões de exportação geram Excel, Word, PDF e HTML da listagem de itens por cadastro geral, com no máximo 1000 registros, sem a pesquisa livre da tela, sob o recurso 1209.
Integrações
Importação de notas por XML de entrada
Na importação de notas por XML de entrada e na validação dos valores do XML, o sistema procura nesta tela o vínculo do participante da nota (o emitente) cujo Cod. Item do Órgão seja igual ao código de produto que veio no XML. Achando, troca o código do produto da nota pelo código do item do ERP do vínculo (só o código do item, sem a referência). A validação do XML tenta primeiro o código já separado da referência e, se não acha, tenta o código inteiro. Quando há mais de um vínculo para o mesmo código, vale o primeiro encontrado. Sem vínculo, o código do XML é mantido.
Troubleshooting
Gravação recusada: nenhuma linha válida
Mensagem exibida: Erro “Não foi possível inserir Novo item referência.”, Motivo “Não foi identificado itens com valores válidos”, Solução “Verifique os dados do registro e salve o item na grid”
O que fazer: escolher o Item e informar o Cod. Item do Órgão de ao menos uma linha, confirmar a linha na grade e gravar de novo.
Gravação recusada: lista de vínculos ausente
Mensagem exibida: Erro “Não foi possível inserir Novo item referência.”, Motivo “Não foi informado nenhum valor para o registro, está vazio ou nulo”, Solução “Ao inserir novo item referência por cadastro geral, incluir ao menos um registro”
O que fazer: incluir ao menos um vínculo na grade e gravar de novo.
Linha removida na grade ainda foi gravada no cadastro novo
Sintoma: no cadastro novo, uma linha removida com “Excluir” foi gravada junto com as demais.
O que fazer: o sistema não considera a marca de exclusão no cadastro novo. Antes de gravar, cancele e refaça a grade só com as linhas desejadas, ou grave e remova o vínculo depois, pela edição ou pela listagem.
A tela recusa remover a linha
Mensagem exibida: Informação “AVISO” com “Não é permitido remover todos os itens!!!”
O que fazer: a grade precisa manter ao menos uma linha. Para apagar o último vínculo de um cadastro geral, selecione a linha na listagem e use “Excluir”.
Linha da edição não foi gravada
Sintoma: depois de gravar a edição, uma linha digitada não aparece.
O que fazer: a linha sem Item, Cod. Item do Órgão ou Nome Item do Órgão é ignorada sem aviso. Preencher os três campos e gravar de novo.
Item não aparece na pesquisa
Sintoma: o item esperado não aparece ao incluir a linha.
O que fazer: a pesquisa só traz itens ativos; reativar o item no estoque ou pesquisar pelo código.
Nota de entrada importada com o código do fornecedor
Sintoma: na importação do XML de entrada, o item da nota continua com o código do emitente.
O que fazer: conferir se existe vínculo do cadastro geral do emitente com o Cod. Item do Órgão igual ao código do produto no XML; sem vínculo, o sistema mantém o código do XML.
Ação recusada por falta de permissão
Mensagem exibida: “Você não tem permissão para acessar este recurso”
O que fazer: pedir ao administrador que libere ao grupo o recurso da ação (1206 Novo, 1207 Editar, 1208 Excluir, 1209 Exportar).
Casos de Uso
Caso 1 — Cadastro dos itens de um órgão novo
A analista Renata cadastra os itens que a Prefeitura de Exemplo usa. Aciona “Novo”, escolhe o cadastro geral 2040, inclui uma linha com o item “Parafuso 10mm”, Cod. Item do Órgão “PRF-10” e Nome Item do Órgão “PARAFUSO 10 MM”, e aciona “Salvar e Fechar”. O vínculo aparece na listagem.
Caso 2 — Correção do código do órgão
O órgão mudou o código do parafuso para “PRF-11”. Renata abre o cadastro 2040 com duplo clique, edita a linha, troca o Cod. Item do Órgão e grava. A listagem passa a mostrar o código novo.
Caso 3 — Importação de nota de entrada
Uma nota de entrada do emitente 2040 traz o produto “PRF-11”. Na importação, o sistema acha o vínculo e troca o código pelo do item “Parafuso 10mm” do ERP.
Caso 4 — Exclusão de um vínculo
Renata localiza na listagem o vínculo pelo texto “PRF-11”, seleciona a linha, aciona “Excluir” e confirma. Só esse vínculo é apagado; os demais itens do cadastro 2040 continuam.