README

（将此下载的内容放入 yii3-i 的发票文件夹或作为独立的仓库运行）

yii3-i 的发票文件夹

Yii3 发票

特性

• 使用 Invoiceplane 类型数据库模式的循环 ORM 接口。
• 使用 Mpdf 生成增值税发票。
• 代码生成器 - 控制器到视图。
• PCI 合规的支付网关接口 - Braintree 沙箱、Stripe 沙箱和亚马逊支付集成已测试。
• 生成 openPeppol Ubl 2.1 发票 3.0.15 XML 发票 - 使用 Ecosio 验证。
• StoreCove API 连接器，带有 JSON 发票。
• 发票周期 - 报价到销售订单（包括客户的采购订单详情）到发票。
• 多语言兼容 - 包含生成新语言文件的步骤。
• 独立的客户控制台和公司控制台。
• 使用 Composer 安装。

在 Windows 中使用 Composer 安装 composer update

安装 npm_modules 文件夹，其中包含 package.json 中提到的 bootstrap

• 步骤 1：在 https://node.org.cn/en/download 下载 node.js
• 步骤 2：确保 C:\ProgramFiles\nodejs 包含在环境变量路径中。搜索 ... 编辑系统环境变量
• 步骤 3：在 c:\wamp64\invoice 文件夹中运行 npm i。这将安装 @popperjs 和 bootstrap 5。
• 步骤 4：通过运行例如 npm install -g npm@10.8.1 来保持 npm 的最新状态

推荐的 php.ini 设置

• 步骤 1：Wampserver ... Php {version} ... Php Settings ... xdebug.mode = off
• 步骤 2：... 最大执行时间 = 240

** 注意：截至 2024 年 6 月 15 日：如果您已调整任何实体文件，您将必须始终进行以下两项调整，以确保数据库使用新的更改和相关字段更新： **

• 1. 将此处下面的 false 立即更改为 true，即 'mode' => true ? ...
• 1. 将根目录下的 .env 文件中的 BUILD_DATABASE = false 更改为 BUILD_DATABASE = true
• 1. 更改已反映，并且您已通过例如 phpMyAdmin 检查它们后，请恢复到原始设置

调整 c:\wamp64\yii3-i\config\common\params.php 文件中约 193 行到 'mode' => true 以进行安装。这将自动在数据库 yii3-i 下构建表。

'mode' => false ? PhpFileSchemaProvider::MODE_WRITE_ONLY : PhpFileSchemaProvider::MODE_READ_AND_WRITE,

安装后，确保模式为 'mode' => false 以获得更好的性能和 BUILD_DATABASE = false

使用 创建用户帐户 注册您的第一个用户

注册您的第二个用户作为您的客户/客户。

要启用您的已注册客户进行支付

• 步骤 1：确保您已创建一个客户即。客户 ... 查看 ... 新建
• 步骤 2：创建一个设置 ... 用户帐户
• 步骤 3：使用分配的客户 ... 汉堡按钮 ... 并将新用户帐户分配给现有客户。
• 步骤 4：确保他们是活跃的。
• 步骤 5：确保相关发票状态为 '已发送'，可以通过以下方式手动编辑发票状态：在 '发票 ... 查看 ... 选项' 中编辑发票状态，或者在实际通过 '发票 ... 查看 ... 选项' 将发票通过电子邮件发送给客户。

要安装至少一个服务和产品，并且外国和非外国客户自动遵循以下步骤，请参阅

• 步骤 1：设置 ... 查看 ... 通用 ... 安装测试数据 ... 是 AND 使用测试日期 ... 是
• 步骤 2：在主网址中输入：invoice 并按回车键。发票控制器将自动创建 2 个客户和产品。

默认情况下，该套餐不会使用增值税，并将使用传统的 Invoiceplane 类型安装，提供行项目税和发票税

如果您需要基于增值税的发票，请确保通过转到设置 ... 查看 ... 增值税进行增值税设置，并为该目的使用单独的数据库。只有行项目税将可用。

翻译成其他语言的步骤

GeneratorController 包含一个函数 google_translate_lang ...
此函数接受位于 src/Invoice/Language/English 的英语 ip_lang 数组或 gateway_lang

src/Invoice/Language/English

并将其翻译成所选的区域设置（设置...查看...谷歌翻译）

输出到 resources/views/generator/output_overwrite.

• 步骤 1：将 https://curl.haxx.se/ca/cacert.pem 下载到活动文件夹 c:\wamp64\bin\php\php8.1.12。
• 步骤 2：选择您在 https://console.cloud.google.com/projectselector2/iam-admin/serviceaccounts?pportedpurview=project 下创建的项目。
• 步骤 3：单击操作图标并选择管理密钥。
• 步骤 4：添加密钥。
• 步骤 5：选择 JSON 文件选项，并将文件下载到 src/Invoice/Google_translate_unique_folder。
• 步骤 6：您需要启用云翻译 API 并提供您的计费详情。您将收取 0 货币。
• 步骤 7：将文件从 views/generator/output_overwrite 移动到例如 src/Invoice/Language/{您的语言}

XML 电子发票 - 如果遵循以下顺序，则可以输出

• a：登录客户通过客户端...查看...选项...编辑 Peppol 详情以设置他们的 Peppol 详情。

• b：管理员创建并发送报价给客户。

• c：登录客户从报价创建销售订单，包括他们的采购订单号、采购订单行号以及他们的联系人。

• d：登录客户在每个销售订单行项中输入他们的行项目采购订单参考号和他们的采购订单行号。（强制性，否则将引发异常）。

• e：登录管理员请求接受条款和条件。

• f：登录客户接受条款和条件。

• g：登录管理员将销售订单的状态从组装、批准、确认更新为生成。

• h：登录管理员如果销售订单状态为 '生成'，则可以生成发票

• i：登录管理员现在可以使用在设置...查看...Peppol 电子发票...中的一个货币和另一个货币上设置的本日汇率生成 Peppol Xml 发票

• j：将引发 Peppol 异常。