Fala Dev, está buscando uma integração fácil e rápida para emitir BPe em node.js?
Então pegue seu café ☕ e se prepare, pois neste post venho mostrar nossa lib de comunicação com a API de BPe da NS Tecnologia em Node.JS.
🔹 Primeiramente você pode fazer o download da nossa biblioteca através do nosso GitHub ou diretamente pelo pacote do npm através do comando “npm install ns-bpe-node”.
🔹 Após o download do pacote abriremos a pasta no Visual Studio Code onde podemos ver a composição do projeto.
Temos então nossa pasta “ns_modules” que são os módulos da NS Tecnologia, dentro da mesma temos as pastas “api_module” onde está nossa comunicação com a API através da função “PostRequest” e a pasta “bpe_module” que contém as funções de emissão, eventos e utilitários do BPe.
🔹 Na pasta raiz do nosso projeto, temos o arquivo “configParceiro.js” neste arquivo deixamos como exemplo o Token que é de uso exclusivo dos parceiros da NS para comunicação segura e o CNPJ que é no caso do emitente do BPe.
(Lembrando essa é só uma forma de exemplo para a passagem desses dados, sendo que o parceiro pode escolher de que forma vai passar)
🔹 Para fazer a emissão do nosso BPe de exemplo, irei adicionar no projeto meu arquivo JSON que já está com todos os campos necessários para emitirmos um BPe pela API.
🔹 Após isso já posso fazer a chamada da função de emissão, para isso criei um arquivo chamado “emitirBPe.js” sendo que nele irei fazer a chamada da função emitirBPeSincrono que irá fazer o envio do meu arquivo JSON para API da NS após fará a consulta de status de processamento para buscar o retorno da SEFAZ para esse BPe e por último fará o download do XML já autorizado e o PDF deste BPe.
🔹 Podemos ver na imagem abaixo toda nossa chamada onde que no inicio temos a referência a classe “emitirSincrono” para que possamos chamar a função “emitirBPeSincrono”.
🔹 Logo abaixo temos a referência ao nosso arquivo JSON com os dados do BPe.
E por final a chamada da nossa função emitirBPeSincrono passando na mesma os parâmetros necessários (Na sequência: conteudo, tpAmb, tpDown, caminhoParaSalvar).
🔹 Com isso já estamos preparados para fazer a emissão de um BPe via API da NS tecnologia utilizando a lib de NodeJS.
No terminal do VSCode irei dar o comando “node .\emitirBPe.js” fazendo com que eu chame a função sincrona e faça a emissão do BPe.
🔹 Então temos nosso retorno de autorizado do BPe, já trazendo as informações como o “cStat: 100” que vem direto da Sefaz juntamente com o “xMotivo: Autorizado o uso do BP-e”, a chave autorizada do documento e o número de protocolo de autorização(nProt) que é muito importante salvar para que possa ser feito eventos neste BPe se necessário.
Esperamos que tenha gostado do nosso post Dev!
Segue abaixo um vídeo mostrando todo o passo a passo para emissão de BPe utilizando Node 👇
Autor: Cleiton Fagundes | Analista de Integração
Gostou do Post? Caso você não conheça nossa API entre em contato conosco!