README

此包基于 Laravel Daily 的 Laravel Invoices。

我们对它进行了一些调整，用于几个内部项目，并强烈推荐使用 Laravel Daily 的包，该包可在 https://packagist.org.cn/packages/laraveldaily/laravel-invoices 获取

可用方法

几乎每个配置值都可以通过方法动态覆盖。

发票

通用

• addItem(InvoiceItem $item)
• addItems(Iterable)
• name(string)
• status(string) - 如果需要，发票状态 [已支付/到期]
• seller(PartyContract)
• buyer(PartyContract)
• setCustomData(mixed) - 允许用户将附加数据附加到发票
• getCustomData() - 获取用于模板的附加数据
• template(string)
• logo(string) - 标志路径
• getLogo() - 返回 base64 编码的图像，用于模板以避免路径问题
• filename(string) - 覆盖自动文件名
• taxRate(float)
• shipping(float) - 运费
• totalDiscount(float) - 如果未提供，将自动计算
• totalTaxes(float) - 如果未提供，将自动计算
• totalAmount(float) - 如果未提供，将自动计算
• taxableAmount(float) - 如果未提供，将自动计算

序列号

• series(string)
• sequence(int)
• delimiter(string)
• sequencePadding(int)
• serialNumberFormat(string)
• getSerialNumber() - 返回格式化的序列号

日期

• date(Carbon)
• dateFormat(string) - 日期的 Carbon 格式
• payUntilDays(int) - 从开出发票起支付的日期
• getDate() - 返回格式化的日期
• getPayUntilDate() - 返回格式化的到期日期

货币

• currencyCode(string) - EUR, USD 等。
• currencyFraction(string) - 分、分币、便士等。
• currencySymbol(string)
• currencyDecimals(int)
• currencyDecimalPoint(string)
• currencyThousandsSeparator(string)
• currencyFormat(string)
• getAmountInWords(float, ?string $locale) - 将浮点数拼写成文字，第二个参数是区域设置
• getTotalAmountInWords() - 拼写成 total_amount
• formatCurrency(float) - 返回带有货币设置的格式化值 '$ 1,99'

文件

• stream() - 在浏览器中打开发票
• download() - 提供下载发票
• save($disk) - 将发票保存到存储，使用 ->filename() 指定文件名
• url() - 返回已保存发票的 URL
• toHtml() - 渲染 HTML 视图而不是 PDF

InvoiceItem

• title(string) - 产品或服务名称
• description(string) - 服务条目额外的信息
• units(string) - 项目的度量单位（如果设置，则添加单位列）
• quantity(float) - 项目的单位数量
• pricePerUnit(float)
• discount(float) - 货币折扣
• discountByPercent(float) - 百分比折扣 discountByPercent(15) 表示 15%
• tax(float)
• taxByPercent(float)
• subTotalPrice(float) - 如果未提供，将自动计算

测试

$ composer test

安全

如果您发现任何与安全相关的问题，请通过电子邮件 support@manifestghana.com 而不是使用问题跟踪器。

作者

• Johnson Sebire

许可证

GPL-3.0-only。有关更多信息，请参阅许可证文件。