npm 包 fatture-in-cloud-node 使用教程-JavaScript中文网-JavaScript教程资源分享门户

前言

随着互联网时代的到来，越来越多的企业开始将业务转到互联网上来。这就需要后台系统和前端系统协同工作，才能实现一个稳定且高效的 Web 项目。其中，前端系统不可或缺，作为用户的第一视觉感受，编写精美且高效的前端页面需要使用很多工具和技术，其中我们今天要介绍的是一个用于处理发票、收据和在线付款的 npm 包 - fatture-in-cloud-node，它提供了一组简洁易用的 API，可以轻松构建一个用于管理发票的 Web 项目。

使用教程

安装

使用 npm 安装 fatture-in-cloud-node。

npm install fatture-in-cloud-node

账户设置

fatture-in-cloud-node 提供了两个环境：测试环境和正式环境，你可以在 fatture in cloud 官网上注册一个测试账号，用于测试开发阶段，或者购买一个正式账号，用于项目上线。

接下来，以测试账号为示例，打开官网后，点击 Developer API，创建一个新的 API 密钥。

创建后，你会得到一个 Secret Key 和一个 UID，它们是用于在 Node.js 代码中验证账户的标识符。

开始使用

引入 fatture-in-cloud-node。

const fattureInCloud = require("fatture-in-cloud-node");

安装并引入后，就可以开始使用API了，它提供了以下方法：

-- -------------------- ---- -------
----- --- - --- ----------------------- -------------

-- -- -- ----
----------------------------------
----------------------------------
------------------------------------ ---------
-------------------------------------
----------------------------------

-- -- -- ----
------------------------------
-------------------------------------
--------------------------------------- ----------
----------------------------------------

其中，涉及到即时请求的 API 可以通过 Promise 或者 Callback 获取返回结果。

以创建一个新发票为例：

Promise 方式：

API.CreateInvoice.create(Invoice)
  .then(res => console.log(res))
  .catch(err => console.log(err));

Callback 方式：

API.CreateInvoice.create(Invoice, (err, res) => {
  if (err) {
    console.log(err);
    return;
  }
  console.log(res);
});

API 参考文档

创建一个新发票

API.CreateInvoice.create(Invoice);

参数 Invoice，类型是 Object，必填，其中包括：

名称	类型	必填	描述
TipoDocumento	String	是	发票类型（D，NC，TD，F，PF）。
Data	String	是	发票日期（格式：YYYY-MM-DD）。
Numero	String	是	发票编号（不能为空；由唯一编号组成）
Anno	Number	是	发票年份。
Importo	Number	是	发票费用。
Cliente	Object	是	客户信息。
RiferimentoNumero	String	否	发票参考编号
Note	String	否	发票备注
Saldo	Number	否	发票余款
ScadenzaPagamento	String	否	发票到期日（格式：YYYY-MM-DD）
EsempioSplitPayment	Object	否	包含代表客户的Payee作为payload的对象
PaymentMethod	String	否	费用支付方法（已定义的有效值：Cash，BankTransfer，CreditCard，PayPal）
Iban	String	否	客户IBAN
PaymentTypeId	Number	否	付款类型的ID（定义在您帐户的付款类型中）
ShareWith	Array	否	PayPal款项共享的受益人之一。共享的金额或百分比作为’百分比’或’数额’键包含在有效负载的基础上。
SplitPayment	Boolean	否	指示是否应拆分付款。
VAT_Excluded	Boolean	否	指示发票中的价格是否排除了增值税。
Ritenuta	Boolean	否	指示是否对发票进行了提取。
Trasmissione	Boolean	否	指示是否为电子发票。

获取发票

API.Invoice.getInvoice(InvoiceID);

参数 InvoiceID，类型是 String，必填，表示需要查询的发票ID。

更新发票

API.Invoice.updateInvoice(InvoiceID, Invoice);

参数 InvoiceID，类型是 String，必填，表示需要更新的发票ID。

参数 Invoice，类型是 Object，必填，其中包括更新后的所有发票信息。

删除发票

API.Invoice.deleteInvoice(InvoiceID);

参数 InvoiceID，类型是 String，必填，表示需要删除的发票ID。

将发票标记为已发送

API.Invoice.markAsSent(InvoiceID);

参数 InvoiceID，类型是 String，必填，表示需要标记为已发送的发票ID。

总结

这篇文章介绍了使用 npm 包 fatture-in-cloud-node，并演示了如何使用它的 API，包括创建、获取、更新、删除发票。在实际开发中，我们可以使用此包构建出管理发票的 Web 项目，来处理一些业务逻辑，轻松完成一些烦琐的操作，提高程序的效率。

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