Backend · Dados

Importação de CSV

Lê planilha CSV do Excel ou ERP (aspas, ; ou ,, BOM, CRLF) e valida cada linha com schema simples: número BR, data, e-mail, CPF e CNPJ. Mostra ao usuário a linha e a coluna exata de cada erro.

CSV · Importação · Validação · 8 testes automatizados · Licença MIT · Criado por FlowCore Soluções LTDA

Este módulo vem da camada de back-end dos sistemas sob medida da FlowCore: TypeScript sem dependências externas e com testes automatizados. Serve para validar dados, integrar pagamentos e serviços, e proteger rotas em qualquer API Node.js.

Como instalar

  1. Funciona onde você já roda Node 18+, Cloudflare Workers, Deno, Bun, Vercel e Netlify Functions. Zero dependência: só fetch e Web Crypto, que já vêm no runtime.
  2. Crie src/lib/csv-importacao.ts Cole o código da aba Código.
  3. Use
    const { validas, erros } = importarCsv(textoDoArquivo, {
  nome: { tipo: "texto", obrigatorio: true },
  email: { tipo: "email", coluna: "E-mail", obrigatorio: true },
  valor: { tipo: "numero", min: 0 },
});
if (erros.length) return Response.json({ erros }, { status: 422 });
  4. Rode o teste junto O arquivo de teste (aba Teste) cobre 8 cenários. Copie para src/lib/ ao lado e rode:
    npm install -D vitest
npx vitest run src/lib

Código no GitHub · Biblioteca de códigos

A FlowCore Soluções desenvolve sistemas sob medida para empresas. Se você precisa desta funcionalidade dentro do sistema da sua empresa, integrada ao que já funciona, o diagnóstico é gratuito e o escopo sai em até 24 horas. Desenvolvimento de sistemas sob medida

Perguntas rápidas

Posso usar em projeto comercial?

Sim. A licença MIT permite usar, modificar e distribuir, inclusive em projeto comercial, mantendo o aviso de licença no código.

Precisa de cadastro?

Não. O código está na página e no repositório público do GitHub, sem cadastro e sem cartão.

Mais em Dados