前言
随着互联网时代的到来，越来越多的企业开始将业务转到互联网上来。这就需要后台系统和前端系统协同工作，才能实现一个稳定且高效的 Web 项目。其中，前端系统不可或缺，作为用户的第一视觉感受，编写精美且高效的前端页面需要使用很多工具和技术，其中我们今天要介绍的是一个用于处理发票、收据和在线付款的 npm 包 - fatture-in-cloud-node，它提供了一组简洁易用的 API，可以轻松构建一个用于管理发票的 Web 项目。
使用教程
安装
使用 npm 安装 fatture-in-cloud-node。
--- ------- ---------------------
账户设置
fatture-in-cloud-node 提供了两个环境：测试环境和正式环境，你可以在 fatture in cloud 官网上注册一个测试账号，用于测试开发阶段，或者购买一个正式账号，用于项目上线。
接下来，以测试账号为示例，打开官网后，点击 Developer API，创建一个新的 API 密钥。
创建后，你会得到一个 Secret Key 和一个 UID，它们是用于在 Node.js 代码中验证账户的标识符。
开始使用
引入 fatture-in-cloud-node。
----- -------------- - ---------------------------------
安装并引入后，就可以开始使用API了，它提供了以下方法：
----- --- - --- ----------------------- ------------- -- -- -- ---- ---------------------------------- ---------------------------------- ------------------------------------ --------- ------------------------------------- ---------------------------------- -- -- -- ---- ------------------------------ ------------------------------------- --------------------------------------- ---------- ----------------------------------------
其中，涉及到即时请求的 API 可以通过 Promise 或者 Callback 获取返回结果。
以创建一个新发票为例：
Promise 方式：
--------------------------------- --------- -- ----------------- ---------- -- ------------------
Callback 方式：
--------------------------------- ----- ---- -- -
-- ----- -
-----------------
-------
-
-----------------
---API 参考文档
创建一个新发票
----------------------------------
参数 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 | 否 | 指示是否为电子发票。 |
获取发票
----------------------------------
参数 InvoiceID，类型是 String，必填，表示需要查询的发票ID。
更新发票
------------------------------------ ---------
参数 InvoiceID，类型是 String，必填，表示需要更新的发票ID。
参数 Invoice，类型是 Object，必填，其中包括更新后的所有发票信息。
删除发票
-------------------------------------
参数 InvoiceID，类型是 String，必填，表示需要删除的发票ID。
将发票标记为已发送
----------------------------------
参数 InvoiceID，类型是 String，必填，表示需要标记为已发送的发票ID。
总结
这篇文章介绍了使用 npm 包 fatture-in-cloud-node，并演示了如何使用它的 API，包括创建、获取、更新、删除发票。在实际开发中，我们可以使用此包构建出管理发票的 Web 项目，来处理一些业务逻辑，轻松完成一些烦琐的操作，提高程序的效率。
来源：JavaScript中文网 ，转载请联系管理员！ 本文地址：https://www.javascriptcn.com/post/600560c081e8991b448df0a9