Gerador de EIN

Continuar na ferramenta

Mais páginas desta ferramenta

EIN para fixtures de teste

EIN sintético para fixtures de teste

Testes automatizados que tocam campo de EIN não podem usar o número real de uma empresa, então esta página mostra como gerar um EIN sintético com prefixo IRS válido, formato XX-XXXXXXX e semente reproduzível, pronto para fixture, massa de dados de homologação ou teste de contrato de formulário mascarado.

Como o formato XX-XXXXXXX se comporta em teste automatizado

O EIN sempre tem 9 dígitos divididos em prefixo de 2 dígitos e serial de 7 dígitos, exibido como XX-XXXXXXX; a função de normalização do gerador remove qualquer caractere que não seja dígito antes de validar, então um campo com máscara que insere o hífen automaticamente, ou um campo que só aceita dígitos, recebe o mesmo valor de 9 dígitos por baixo. Um teste de contrato deve comparar o valor normalizado (`raw`, sem hífen) contra o formatado (`formatted`, com hífen na posição 2), nunca assumir que a interface sempre mostra um dos dois formatos.
Para reproduzir o mesmo EIN em execuções diferentes de CI, passe uma `DigitSource` fixa para `generateEin`: a mesma semente sempre sorteia o mesmo prefixo dentro do pool de 83 prefixos válidos e o mesmo serial de 7 dígitos, o que evita snapshot de teste quebrando a cada rodada. Também dá para restringir o sorteio a um único campus do IRS passando `campusId`, por exemplo 'internet', que sozinho cobre 17 dos 83 prefixos (20, 26, 27, 45, 46, 47, 81 a 88, 92, 93 e 99), útil quando o teste precisa validar especificamente o caminho de EIN emitido pelo formulário online do IRS.
Para popular uma massa de homologação com vários registros de uma vez, `generateEinBatch(count, source, campusId)` devolve um array já formatado, cada item revalidado internamente contra as mesmas 3 regras do validador antes de entrar na lista; um lote de 50 linhas fica pronto para importar numa tabela de fornecedores fictícios sem precisar rodar o gerador 50 vezes na mão. Se o formulário sob teste rejeitar duplicata de EIN dentro do mesmo lote, vale checar o pool do campus escolhido: o SBA tem só 1 prefixo (31), então um lote grande restrito a esse campus vai repetir prefixo com frequência, mesmo com serial diferente em cada linha.

Três sementes, três formatos de fixture

Prefixo do campus Internet

Entrada: createEin('20', '1234567')
Saída esperada: 20-1234567, campus Internet, válido

20 está entre os 17 prefixos do campus 'Internet', o grupo mais usado em fixture porque representa EIN emitido pelo formulário online do IRS, o caminho padrão de onboarding.

Prefixo do campus Brookhaven

Entrada: createEin('01', '9990001')
Saída esperada: 01-9990001, campus Brookhaven, válido

01 pertence a Brookhaven, o campus com mais prefixos da tabela (24 dos 83), útil para testar o caminho menos comum de geração quando o teste precisa evitar o prefixo 20 de propósito.

Campus SBA, pool de um único prefixo

Entrada: createEin('31', '0005000')
Saída esperada: 31-0005000, campus Small Business Administration (SBA), válido

SBA é o campus mais estreito da tabela: só o prefixo 31 pertence a ele, então qualquer EIN de teste com esse prefixo aponta sempre para o mesmo campus, sem variação possível.

FAQ da ferramenta completa

EIN tem dígito verificador?

Não como CPF/CNPJ. A validação básica usa comprimento e prefixos válidos do IRS.

O prefixo identifica campus do IRS?

O EIN gerado identifica empresa real?

Posso usar em testes B2B?

Quando preciso de EIN real?

O número é enviado ao servidor?

Por que não gerar qualquer 9 dígitos?

O que devo registrar em logs de teste?

Perguntas frequentes

Como manter o mesmo EIN de fixture entre execuções de CI?

Passe a mesma função `DigitSource` como semente para `generateEin`; como o sorteio de prefixo e serial depende só dela, a mesma semente sempre reproduz o mesmo XX-XXXXXXX, sem precisar hardcodar o valor final no teste.

O valor de fixture passa num campo com máscara automática de hífen?

Passa: o gerador expõe `raw` (9 dígitos sem separador) e `formatted` (com hífen após os 2 primeiros); um campo mascarado recebe `raw` e formata sozinho, e um teste de contrato deve comparar os dois contra o mesmo valor normalizado.

Dá para gerar um lote de EINs para uma tabela de homologação?

Sim, `generateEinBatch(count, source, campusId)` devolve o array já validado; restringir por `campusId` ajuda quando o teste precisa isolar um caminho específico, mas campus com poucos prefixos, como SBA com só 1, repete prefixo em lotes grandes.

O que o formulário recebe se eu colar só os 9 dígitos, sem hífen?

O mesmo dado: o campo `raw` do documento gerado já vem sem hífen, pronto pra colar direto num input que só aceita dígitos ou pra montar o payload de uma chamada de API de teste.

Próximos passos

Continuar na ferramenta

Abrir ferramenta completa

EIN para fixtures de teste

EIN sintético para fixtures de teste

Como o formato XX-XXXXXXX se comporta em teste automatizado

O EIN sempre tem 9 dígitos divididos em prefixo de 2 dígitos e serial de 7 dígitos, exibido como XX-XXXXXXX; a função de normalização do gerador remove qualquer caractere que não seja dígito antes de validar, então um campo com máscara que insere o hífen automaticamente, ou um campo que só aceita dígitos, recebe o mesmo valor de 9 dígitos por baixo. Um teste de contrato deve comparar o valor normalizado (`raw`, sem hífen) contra o formatado (`formatted`, com hífen na posição 2), nunca assumir que a interface sempre mostra um dos dois formatos.

Para reproduzir o mesmo EIN em execuções diferentes de CI, passe uma `DigitSource` fixa para `generateEin`: a mesma semente sempre sorteia o mesmo prefixo dentro do pool de 83 prefixos válidos e o mesmo serial de 7 dígitos, o que evita snapshot de teste quebrando a cada rodada. Também dá para restringir o sorteio a um único campus do IRS passando `campusId`, por exemplo 'internet', que sozinho cobre 17 dos 83 prefixos (20, 26, 27, 45, 46, 47, 81 a 88, 92, 93 e 99), útil quando o teste precisa validar especificamente o caminho de EIN emitido pelo formulário online do IRS.

Para popular uma massa de homologação com vários registros de uma vez, `generateEinBatch(count, source, campusId)` devolve um array já formatado, cada item revalidado internamente contra as mesmas 3 regras do validador antes de entrar na lista; um lote de 50 linhas fica pronto para importar numa tabela de fornecedores fictícios sem precisar rodar o gerador 50 vezes na mão. Se o formulário sob teste rejeitar duplicata de EIN dentro do mesmo lote, vale checar o pool do campus escolhido: o SBA tem só 1 prefixo (31), então um lote grande restrito a esse campus vai repetir prefixo com frequência, mesmo com serial diferente em cada linha.

Três sementes, três formatos de fixture

Prefixo do campus Internet

Entrada: createEin('20', '1234567')
Saída esperada: 20-1234567, campus Internet, válido

20 está entre os 17 prefixos do campus 'Internet', o grupo mais usado em fixture porque representa EIN emitido pelo formulário online do IRS, o caminho padrão de onboarding.

Prefixo do campus Brookhaven

Entrada: createEin('01', '9990001')
Saída esperada: 01-9990001, campus Brookhaven, válido

01 pertence a Brookhaven, o campus com mais prefixos da tabela (24 dos 83), útil para testar o caminho menos comum de geração quando o teste precisa evitar o prefixo 20 de propósito.

Campus SBA, pool de um único prefixo

Entrada: createEin('31', '0005000')
Saída esperada: 31-0005000, campus Small Business Administration (SBA), válido

SBA é o campus mais estreito da tabela: só o prefixo 31 pertence a ele, então qualquer EIN de teste com esse prefixo aponta sempre para o mesmo campus, sem variação possível.

FAQ da ferramenta completa

EIN tem dígito verificador?

Não como CPF/CNPJ. A validação básica usa comprimento e prefixos válidos do IRS.

O prefixo identifica campus do IRS?

O EIN gerado identifica empresa real?

Posso usar em testes B2B?

Quando preciso de EIN real?

O número é enviado ao servidor?

Por que não gerar qualquer 9 dígitos?

O que devo registrar em logs de teste?

Perguntas frequentes

Como manter o mesmo EIN de fixture entre execuções de CI?

O valor de fixture passa num campo com máscara automática de hífen?

Dá para gerar um lote de EINs para uma tabela de homologação?

O que o formulário recebe se eu colar só os 9 dígitos, sem hífen?

O mesmo dado: o campo `raw` do documento gerado já vem sem hífen, pronto pra colar direto num input que só aceita dígitos ou pra montar o payload de uma chamada de API de teste.