npm包enotasgw-nodejs使用教程-JavaScript中文网-JavaScript教程资源分享门户

简介

enotasgw-nodejs是一个简单易用的npm包，它为前端开发者提供了便捷的工具，使得其可以轻松地与e-Nota Gateway进行交互。e-Nota Gateway是一个强大的RESTful API，可用于管理电子发票以及防伪。该npm包可以帮助你通过简单的API调用实现以下功能：

创建电子发票；
取消电子发票；
查询电子发票；
查看所有可用操作类型；
生成二维码以验证发票的真实性。

安装

使用enotasgw-nodejs之前，你需要在电脑上安装Node.js环境。在Node.js环境安装成功后，你可以在命令行中使用如下命令来安装enotasgw-nodejs：

npm install enotasgw-nodejs

使用

使用enotasgw-nodejs简单方便。首先需要在使用前进行初始化，并传入所需的用户名和密码：

const ENotasGateway = require("enotasgw-nodejs");

const gateway = new ENotasGateway({
  username: "<YOUR_USERNAME>",
  password: "<YOUR_PASSWORD>",
});

完成初始化后，你就可以使用方法来执行想要的操作。所有的操作都可通过gateway对象来访问。

1、创建电子发票

使用createInvoice()方法创建电子发票。

const result = await gateway.createInvoice({
  naturezaOperacao: 'Venda de mercadorias',
  valorTotal: 400.0,
  ambienteEmissao: 2 // 1 → homologação, 2 → produção
});

console.log(result);

2、取消电子发票

使用cancelInvoice()方法取消电子发票。

const result = await gateway.cancelInvoice({
  id: "12345",
  motivoCancelamento: "Teste de cancelamento",
});

console.log(result);

3、查询电子发票

使用getInvoice()方法查询电子发票。

const result = await gateway.getInvoice({ id: "12345" });

console.log(result);

4、查看所有可用操作类型

使用getActionTypes()方法获取e-Nota Gateway中所有可用的操作类型。

const result = await gateway.getActionTypes();
console.log(result);

5、生成二维码以验证发票的真实性

为了验证发票的真实性，你可以使用generateQrCode()方法生成一个二维码。该二维码可以用于扫描，并跳转到e-Nota Gateway页面上，以便查询该发票的详情。

const result = await gateway.generateQrCode({ id: "12345" });

console.log(result);

总结

使用enotasgw-nodejs包可以大大简化前端开发者与e-Nota Gateway进行交互的过程。同时，该npm包完善的API文档和示例代码也可以帮助开发者更好地理解如何使用它。

来源：JavaScript中文网，转载请注明来源 https://www.javascriptcn.com/post/600671cc30d0927023822843