PIS/PASEP

Valida um PIS. Aceita o valor com ou sem máscara.

• Um valor com todos os dígitos iguais é rejeitado.
• O dígito verificador usa os pesos 3, 2, 9, 8, 7, 6, 5, 4, 3 e 2 e módulo 11. Nenhum documento oficial encontrado publica esses pesos: os manuais do eSocial e do SIRC dizem só que o número tem 11 dígitos e dígito verificador módulo 11, e os leiautes da Caixa pedem um "Número de PIS/PASEP válido" sem dizer como ele é calculado. Os pesos seguem o brutils.

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

isValidPis('12056412847'); // true
isValidPis('12056412547'); // false

Formata um PIS.

• Opções (FormatPisOptions): pad completa o valor com zeros à esquerda até 11 dígitos antes de aplicar a máscara (padrão false); obfuscate esconde os 3 primeiros dígitos e o dígito verificador. Um valor vazio, ou sem dígitos, devolve '' mesmo com pad.
• O obfuscate é aplicado depois do pad.
• Nenhuma autoridade publica uma regra de mascaramento para o PIS, então o obfuscate usa a que as Leis de Diretrizes Orçamentárias definem para a divulgação do CPF ("ocultar os três primeiros dígitos e os dois dígitos verificadores", Lei nº 14.194/2021, art. 149, regra criada pela Lei nº 12.309/2010, art. 87, § 5º), um número com a mesma estrutura.

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

formatPis('12345678901'); // 123.45678.90-1
formatPis('123456789', { pad: true }); // 001.23456.78-9
formatPis('12345678901', { obfuscate: true }); // ***.45678.90-*

Remove a formatação do PIS, mantém apenas os dígitos e limita o resultado a 11 dígitos.

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

parsePis('123.45678.90-1'); // 12345678901

Gera um PIS válido aleatório.

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

generatePis(); // '91077906857'

Fonte: Lei nº 14.194/2021, art. 149, a regra de mascaramento do CPF que o obfuscate toma emprestada, criada pela Lei nº 12.309/2010, art. 87, § 5º e repetida pelas LDOs seguintes (a de 2026, Lei nº 15.321/2025, art. 163, a repete).