SDK JavaScript/TypeScript

O SDK oficial está no npm: nferapido. Zero dependências (Node 18+), TypeScript incluso, 6,5 kB.

npm install nferapido

Emitir a primeira nota (homologação)

import NFeRapido from 'nferapido';

const nfe = new NFeRapido('nfr_test_...'); // token de teste: nunca emite de verdade

const nota = await nfe.emitirNFe(payload, { idempotencyKey: 'pedido-8842' });
console.log(nota.chave, nota.status);

O que ele resolve por você

• Idempotência de fábrica — passe idempotencyKey e um retry devolve a mesma nota em vez de emitir duas (como funciona).
• Retry só quando é seguro — GET, ou escrita com chave de idempotência. Escrita sem chave nunca é re-tentada às cegas.
• Webhook em uma função — verificarAssinaturaWebhook(corpoBruto, header, secret) valida o HMAC em tempo constante (contrato).
• Erros tratáveis — NFeRapidoError com status e body da API.

Métodos disponíveis

emitirNFe · emitirNFCe · emitirNFSe · emitirNFSeNacional · emitirCTe · emitirMDFe · emitirBPe · emitirNFCom · cancelarNFe/NFCe/NFSe/CTe/MDFe · cartaCorrecaoNFe · devolucaoNFe · encerrarMDFe · consultarNFe · consultarCNPJ · consultarIE · consultarCEP — e request() genérico para qualquer um dos 300+ endpoints (Swagger).

Python e PHP

Em preparação. Enquanto isso, a coleção Postman cobre a API inteira em qualquer linguagem.