Antes de começar, veja a página "
Introdução" para os pré-requisitos gerais do sistema e o passo a passo de login. Em caso de dúvidas, consulte também o
FAQ.
O NCM (Nomenclatura Comum do Mercosul) classifica bens e o NBS (Nomenclatura Brasileira de Serviços) classifica serviços. Os dois cadastros alimentam as Verticais dos convênios, que associam seus códigos aos segmentos de atuação do projeto. A tela "Cadastros NCM/NBS", na Administração, reúne os dois cadastros em duas abas — NCM e NBS — que funcionam da mesma forma. A tela só aparece no menu para os perfis com permissão para consultá-la, e cada aba depende da permissão do respectivo cadastro; as ações de inserir, editar e excluir também dependem de permissões próprias do perfil.
- Acesse Administração no menu lateral e clique em "Cadastros NCM/NBS".

- A aba NCM mostra o Código e a Descrição de cada registro, ordenados pelo Código. Os registros que já estão associados a alguma Vertical aparecem com a marca "Associado" (ao passar o mouse, a dica explica: "Associado a pelo menos uma Vertical."). Para consultar os códigos de serviço, clique na aba NBS.

- Para localizar um registro, digite parte do código ou da descrição no campo "Pesquisar...". A busca é feita no cadastro inteiro (e não só na página exibida) e não diferencia maiúsculas de minúsculas.

- A tabela mostra 5 registros por página; use a paginação, no rodapé, para navegar ou para alterar a quantidade de linhas.
- Na aba NCM, clique em "Inserir NCM".

- Preencha o Código (Campo Obrigatório, até 12 caracteres) e a Descrição (Campo Obrigatório, até 300 caracteres).

Obs: enquanto o Código ou a Descrição estiverem vazios, o botão "Salvar" fica desabilitado e o campo exibe a mensagem "Código é obrigatório" ou "Descrição é obrigatória".

- Clique em "Salvar". O sistema pede confirmação — "Tem certeza que deseja salvar as informações fornecidas?" — e, ao clicar em "Sim", exibe a mensagem "NCM inserido com sucesso." e volta para a listagem.

- Para desistir do cadastro, clique em "Cancelar". O sistema pede confirmação — "Você tem alterações não salvas, tem certeza de que deseja sair?" — e, ao clicar em "Sim", volta para a listagem sem salvar.
Obs: o Código não pode se repetir dentro do cadastro de NCM nem coincidir com um código já cadastrado como NBS. Se já existir um NCM com o mesmo código, o sistema recusa o cadastro com a mensagem "Já existe um NCM com o código 'XXXXXXXX'." (com o código informado); se o código já pertencer a um NBS, a mensagem é "Já existe um NBS com o código 'XXXXXXXX'.".

- Na aba NCM, clique no ícone de lápis da linha do registro que deseja editar.

- Altere a Descrição (e, quando permitido, o Código) e clique em "Salvar". O sistema pede confirmação e, ao clicar em "Sim", exibe a mensagem "NCM editado com sucesso." e volta para a listagem. Para sair sem alterar, clique em "Cancelar" e confirme.
Obs: em um NCM que já está associado a uma Vertical (marca "Associado"), o campo Código fica desabilitado — só a Descrição pode ser alterada.

-
Na aba NCM, clique no ícone de lixeira da linha do registro que deseja excluir. O ícone só aparece nos registros sem associação; nos registros "Associado" ele não é exibido.
-
O sistema pede confirmação: "Tem certeza que deseja excluir o NCM 'código'?". Clique em "Sim" para excluir — o sistema exibe a mensagem "NCM excluído com sucesso." — ou em "Não" para manter o registro.

Obs: a exclusão é definitiva — o registro não pode ser recuperado depois. Um NCM associado a Verticais não pode ser excluído: caso a tentativa chegue ao sistema, ele a recusa com a mensagem "Não é possível excluir o NCM 'código - descrição' pois ele está associado a N Vertical(is)."
-
Clique na aba NBS. O cadastro de NBS funciona exatamente como o de NCM: o botão "Inserir NBS" abre o formulário, o ícone de lápis edita e o ícone de lixeira exclui (só nos registros sem associação).
-
No formulário do NBS, preencha o Código (Campo Obrigatório, até 12 caracteres) e a Descrição (Campo Obrigatório, até 500 caracteres). O botão "Salvar" só é habilitado com os dois campos preenchidos.


- As confirmações e mensagens seguem o mesmo padrão do NCM, trocando o nome do cadastro: "NBS inserido com sucesso.", "NBS editado com sucesso.", "NBS excluído com sucesso." e "Já existe um NBS com o código 'XXXX'." — e, quando o código informado já pertence a um NCM, "Já existe um NCM com o código 'XXXX'.". Um NBS associado a Verticais também tem o código bloqueado para alteração e não pode ser excluído.
| Regra | Descrição |
| RN72.1 | Os cadastros de NCM e de NBS têm, cada um, cinco permissões independentes: listar, inserir, detalhar, atualizar e excluir. O item de menu aparece com a permissão de listar de qualquer um dos dois; cada aba e cada botão só aparecem para quem tem a respectiva permissão. |
| RN72.2 | Código e Descrição são obrigatórios. O Código tem no máximo 12 caracteres; a Descrição tem no máximo 300 caracteres no NCM e 500 no NBS. |
| RN72.3 | O Código é único dentro de cada cadastro e também entre os dois: um código de NCM não pode ser igual a um código de NBS, e vice-versa. A regra vale no cadastro e na edição. |
| RN72.4 | Um NCM ou NBS associado a pelo menos uma Vertical (marca "Associado") não pode ter o Código alterado nem ser excluído; a Descrição continua editável. Na tela, o campo Código fica desabilitado e o ícone de excluir não é exibido; o sistema também recusa a operação, informando a quantidade de Verticais associadas. |
| RN72.5 | A exclusão de um NCM ou NBS é definitiva e só é possível para registros sem associação a Verticais. A exclusão pede confirmação. |
| RN72.6 | A pesquisa considera parte do código ou da descrição (sem diferenciar maiúsculas de minúsculas) e é feita sobre todo o cadastro. A listagem é paginada pelo sistema (5 registros por página, ajustável) e ordenada pelo Código. |
| Campo | Descrição |
| Sistema | Harpia (Gestão 360) |
| Versão | 1.4 |
| Data de Atualização | 2026-10-20 |
| Responsável | Amanda Galvão |
| Público-alvo | usuários administradores responsáveis pela manutenção dos códigos NCM e NBS |
| Objetivo | consultar, cadastrar, editar e excluir os códigos NCM e NBS |
| Tipo | Documento de referência / treinamento |
| Versão | Data | Descrição da Alteração | Responsável pela Aprovação |
| 1.4 | 2026-10-20 | Screenshots de listagem (abas NCM e NBS) e inserção (NCM e NBS) recapturados no hml, refletindo o novo breadcrumb do hml (sem "CONVÊNIOS" no caminho, apex-fsw-2026-0475). | Amanda Galvão |
| 1.3 | 2026-10-15 | Adicionado o bloco "Veja Também" com links para os guias relacionados e o card correspondente no Sumário | Amanda Galvão |
| 1.2 | 2026-10-15 | Código de NCM e de NBS não podem coincidir entre si: atualizadas a observação do cadastro de NCM, as mensagens do NBS e a RN72.3, conforme o ambiente de homologação | Amanda Galvão |
| 1.1 | 2026-10-09 | Ajustada a ordenação da listagem de NCM e NBS (pelo Código), conforme o ambiente de homologação; atualizada a RN72.6. | Amanda Galvão |
| 1.0 | 2026-10-07 | Versão inicial da documentação | Amanda Galvão |