README

Craft Commerce 很棒！他们的PDF系统也非常出色。然而，PDF并不等同于发票，发票应该是：不可变且顺序编号的。

Commerce Invoices 是 Craft Commerce 的扩展，允许您

为订单创建PDF发票（自动或手动创建）
部分或全额信用发票，创建信用通知单
当您部分或全额信用订单时，自动重新补充库存
保持稳定的发票历史记录，不可变且不可逆，这样您的会计会非常高兴（或女性，或其他任何代词）

要求

此插件需要 Craft CMS 3.0.0-beta.23 或更高版本。

安装

要安装此插件，请按照以下说明操作。

打开您的终端并转到您的 Craft 项目
```
 cd /path/to/project
```

然后让 Composer 加载插件

 composer require lenvanessen/commerce-invoices

在控制面板中，转到设置 → 插件，并单击 Commerce Invoices 的“安装”按钮。

配置 Commerce Invoices

设置电子邮件和PDF

此扩展与 Craft 内置的 Commerce 电子邮件和PDF系统很好地集成。然而，略有差异。通常，您会通过将其分配给特定的订单状态来触发电子邮件。如果您想将发票的PDF附加到电子邮件中，这将不起作用。这是由于一个订单可以包含多个发票和多个信用发票。因此，即使订单达到状态，插件也不知道您想发送给客户的PDF是什么。

相同的原理也适用于 Craft 的原生PDF。您可以从 Craft 的内部系统创建PDF，但它们只能获取order变量，并链接到特定的订单，而不是发票或信用发票。因此，我们不将原生PDF分配给我们要创建的电子邮件，它将自动添加。

正确的设置如下

转到 Craft Commerce，创建一个新的电子邮件。您可以分配PDF，只要它不是发票的PDF（您根本不应该创建它；)
转到发票 > 设置，并选择新创建的电子邮件。在这里，您还可以选择发票的PDF模板。
完成；)

构建发票PDF

您可以通过导航到：https://yourlocaltest.dev/commerce-invoices/style-pdf 来轻松检查发票的预览

通过传递特定的发票ID，您可以测试特定的发票，使用查询参数 ?invoiceId={ID}。如果您想测试特定的场景或遇到特定发票的问题，这很有用。这不是必需的，您也可以将其留空，它将获取最后一个发票。

唯一的要求是您的网站不在生产模式。您还可以在该扩展的源代码中的 templates 目录下找到示例PDF。

Commerce Invoices 路线图

要完成的事情以及潜在功能的想法

自动退款创建
发布

由 Len van Essen 提供

图标由Pixel perfect设计，来源自www.flaticon.com

lenvanessen / commerce-invoices

维护者

详细信息

README

要求

安装

配置 Commerce Invoices

设置电子邮件和PDF

构建发票PDF

Commerce Invoices 路线图