NBS

Valida um código NBS (Nomenclatura Brasileira de Serviços, Intangíveis e Outras Operações que Produzam Variações no Patrimônio) contra a tabela oficial da NBS 2.0, o código que a NFS-e nacional leva em cNBS.

• O código tem 9 dígitos, impressos como N.NNNN.NN.NN: o algarismo 1, o capítulo, a posição, os dois níveis de subposição, o item e o subitem.
• Aceita uma string com os 9 dígitos ou com a máscara, com qualquer sequência de separadores (espaço, ., - ou /) entre os grupos e espaços opcionais nas extremidades, ou um inteiro seguro não negativo. Qualquer outra string é rejeitada em vez de ter os dígitos pinçados.
• Só códigos completos são válidos: os títulos de capítulo (1.01), posição (1.0101) e subposição (1.0101.1) não classificam nada por si sós.
• O ANEXO B do Sistema Nacional NFS-e lista os mesmos 920 códigos menos três (1.0402.29.00, 1.0403.29.00 e 1.0904.40.00), então um código válido aqui ainda pode ser recusado pela NFS-e.

import { isValidNbs } from '@brazilian-utils/brazilian-utils';

isValidNbs('1.0101.11.00'); // true
isValidNbs('101011100'); // true
isValidNbs(101011100); // true
isValidNbs('1.0101'); // false (título de posição, não um código completo)
isValidNbs('1.9999.99.99'); // false
isValidNbs('1.0101abc11.00'); // false (não é uma forma documentada)

Formata um código NBS (Nomenclatura Brasileira de Serviços) na máscara N.NNNN.NN.NN em que a nomenclatura o imprime. Só a estrutura muda; use isValidNbs para conferir um código com a tabela.

• Opções (FormatNbsOptions): pad (padrão false) completa antes o valor com zeros à esquerda até os 9 dígitos de um código completo (todo código NBS começa com 1, então só serve para largura fixa). Um valor vazio, ou sem dígitos, devolve '' mesmo com pad.
• No resto, mesmas regras de formatCnae: a máscara é aplicada até onde o valor vai, os caracteres fora dela são descartados e um número só é lido como a string dos seus dígitos quando é um inteiro seguro não negativo; qualquer outro número retorna ''.

import { formatNbs } from '@brazilian-utils/brazilian-utils';

formatNbs('101011100'); // 1.0101.11.00
formatNbs(101011100); // 1.0101.11.00
formatNbs('10101'); // 1.0101 (mascarado até onde vai)
formatNbs('1', { pad: true }); // 0.0000.00.01 (completado até 9 dígitos antes)
formatNbs('abc101011100'); // 1.0101.11.00 (só os dígitos são lidos)
formatNbs(-101011100); // '' (não é um inteiro seguro não negativo)

Remove a formatação do NBS (Nomenclatura Brasileira de Serviços), mantém apenas os dígitos e limita o resultado aos 9 dígitos de um código completo.

• Mesmas regras de parseCbo: nada é completado com zeros à esquerda aqui.

import { parseNbs } from '@brazilian-utils/brazilian-utils';

parseNbs('1.0101.11.00'); // '101011100'

Consulta um código NBS (Nomenclatura Brasileira de Serviços) e retorna a sua descrição oficial. O resultado é um registro Nbs: { code, description }.

• Mesmas regras de isValidNbs. code são os 9 dígitos, sem a máscara. Retorna null quando o código é desconhecido ou o valor não está em uma forma documentada.

import { getNbs } from '@brazilian-utils/brazilian-utils';

getNbs('1.0101.11.00');
// { code: '101011100', description: 'Serviços de construção de edificações residenciais de um e dois pavimentos' }

getNbs(126050000); // { code: '126050000', description: 'Serviços domésticos' }
getNbs('1.0101'); // null (título de posição, não um código completo)
getNbs('1.9999.99.99'); // null

Fonte: tabela da NBS 2.0 publicada pelo MDIC, aprovada pela Portaria Conjunta RFB/SCS 1.429/2018 e alterada pela Portaria Conjunta RFB/SCS 2.000/2018.