CFOP

Valida um código CFOP (Código Fiscal de Operações e Prestações) contra a tabela oficial, o Anexo II consolidado do Convênio SINIEF s/nº 1970 em vigor.

• Só os códigos operáveis contam: os títulos de grupo e subgrupo, os códigos terminados em 00 e 50, são rejeitados.
• Aceita uma string com os 4 dígitos ou com a forma N.NNN, com qualquer sequência de separadores (espaço, ., - ou /) entre os grupos, ou um número. Qualquer outra string é rejeitada.
• Nenhum código CFOP começa com zero, então nada é completado.

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

isValidCfop('5102'); // true
isValidCfop('1.101'); // true
isValidCfop('7504'); // true (incluído na reescrita de 2022 do anexo)
isValidCfop('0000'); // false
isValidCfop('1150'); // false (título de subgrupo, não é um código operável)
isValidCfop('abc5102'); // false (não é uma forma documentada)
isValidCfop(-5102); // false (não é um inteiro seguro não negativo)

Fonte: Anexo II consolidado do Convênio SINIEF s/nº 1970, última alteração pelo Ajuste SINIEF 39/25.

Formata um código CFOP (Código Fiscal de Operações e Prestações) na forma N.NNN que o anexo imprime. Só a estrutura muda; use isValidCfop para conferir um código com a tabela.

• Opções (FormatCfopOptions): pad (padrão false) completa antes o valor com zeros à esquerda até os 4 dígitos de um código completo (nenhum CFOP começa com zero, então só serve para largura fixa). Sem ele a máscara é aplicada até onde o valor vai. Um valor vazio, ou sem dígitos, devolve '' mesmo com pad.
• Caracteres fora da máscara são descartados, e um número só é lido como a string dos seus dígitos quando é um inteiro seguro não negativo: um número negativo, fracionário ou inseguro retorna ''. Retorna '' quando não há dígito algum.

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

formatCfop('5102'); // 5.102
formatCfop('51'); // 5.1 (máscara aplicada até onde o valor vai)
formatCfop('102', { pad: true }); // 0.102 (completado até 4 dígitos antes)
formatCfop('abc5102'); // 5.102 (só os dígitos são lidos)
formatCfop(-5102); // '' (não é um inteiro seguro não negativo)

Fonte: Convênio SINIEF s/nº 1970, Anexo II, que imprime os códigos como N.NNN.

Remove a formatação do CFOP (Código Fiscal de Operações e Prestações), mantém apenas os dígitos e limita o resultado a 4 dígitos.

• Nenhum código CFOP começa com zero, então nada é completado aqui.

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

parseCfop('5.102'); // '5102'

Consulta um código CFOP (Código Fiscal de Operações e Prestações) e retorna seu código e a descrição oficial. O resultado é um registro Cfop: { code, description }.

• Mesmas regras de isValidCfop. Retorna null para um título, um código desconhecido ou um valor fora das formas documentadas.

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

getCfop('1101'); // { code: '1101', description: 'Compra para industrialização ou produção rural' }
getCfop('7504'); // { code: '7504', description: 'Exportação de mercadoria que foi objeto de formação de lote de exportação' }
getCfop('0000'); // null
getCfop('5350'); // null (título de subgrupo, não é um código operável)
getCfop('abc5102'); // null (não é uma forma documentada)

Fonte: Anexo II consolidado do Convênio SINIEF s/nº 1970, última alteração pelo Ajuste SINIEF 39/25.