README

LibreDTE 是一个旨在为 Chile 提供免费电子发票的项目。

这里您可以找到用于与 SII (Chile 国家税务局) 电子税务文件 (DTE) 集成的 PHP 语言库。

该库最初是为了与 LibreDTE 社区版本 Web 应用程序 一起使用而构建的。在这个库中，只包含基本功能，没有用户界面，以便开发人员可以构建自己的应用程序。

如果您需要一个“到达即使用”的应用程序，无需担心安装或服务器，请查看 LibreDTE 官方版本 Web 应用程序。您可以在平台上注册并使用发票编制平台，以及其他模块。

重要：LibreDTE 的作者和所有者 SASCO SpA 公司不提供直接使用此库的官方支持。SASCO SpA 仅通过 LibreDTE 网络平台提供 Web 服务集成支持，通常在 www.libredte.cl 上提供。

实现的功能

• 连接到 Maullin 或 Palena。
• 获取用于自动认证的令牌。
• 通过卷号、日期和金额获取 DTE 状态。
• 测试集解析器。
• 生成 XML、盖章和签署 DTE。
• 生成并发送签署的 XML EnvioDTE。
• 通过 Track ID 查询 DTE 发送状态。
• 通过 Track ID 查询发送的账簿状态。
• 官方支持文档 (证书集)
  • 电子发票 (33)。
  • 免税电子发票 (34)。
  • 电子发票 (39)。
  • 免税电子发票 (41)。
  • 电子采购发票 (46)。
  • 电子装运指南 (52)。
  • 电子借记单 (56)。
  • 电子信用单 (61)。
  • 电子出口发票 (110)。
  • 电子出口借记单 (111)。
  • 电子出口信用单 (112)。
• 采购和销售电子信息 (IECV)。
• 电子装运指南账簿。
• 发票和连续纸使用报告 (RCOF)。
• 与其他纳税人的交换阶段
  • 收据确认。
  • 收货和提供服务收据。
  • 验证结果。
• 从 XML 生成 PDF DTE，包括信头和连续纸。
• 从 XML 生成 PDF IECV。
• 额外税收 (除燃料外)。
• 电子转让 (保理)。
• 购销登记 (RCV) 操作。
  • 提交接受或索赔。
  • 列出 DTE 事件。
  • 查询 DTE 转让可能性。
  • 查询 SII 收到 DTE 的日期。

独立功能

• PHP 数组到 XML 的转换。
• 对 XML 进行电子签名。
• 国际化。
• 日志系统。

支持的 DTE 数据输入格式

• SII 结构的官方格式
  • JSON
  • XML
  • YAML

安装

直接从终端使用

$ composer require sasco/libredte

或编辑 composer.json 文件并添加

{
	"require": {
		 "sasco/libredte": "21.10.*"
	}
}

示例文件可在examples目录中找到。需要XML文件的示例包括SII提供的XML文件或由同一库生成的XML文件。

使用条款和条件

使用本项目（全部或部分），即表示自动接受遵守LibreDTE的使用条款和条件。仅对遵守使用条款和条件的用户，GNU Affero通用公共许可证（AGPL）才适用。LibreDTE没有商业许可证，因此如果不同意遵守这些条款和条件，则不能使用本项目。

允许使用本项目并遵守LibreDTE使用条款和条件的简要版本如下：

• 您可以自由地：使用、学习、分发和修改LibreDTE。
• 如果您的软件使用了LibreDTE，那么该软件的源代码必须以AGPL许可证公开发布。
• 如果您对LibreDTE进行了修改，那么您必须公开修改后的源代码，并使用AGPL许可证。
• 无论是否修改了LibreDTE，您都必须在您的软件中公开引用该项目及其原作者。

希望使用本项目的用户有责任阅读并完全接受使用条款和条件。

为项目做贡献

如果您想为项目做贡献，特别是解决issue（问题）或创建有关使用库的示例，您需要：

1. 在GitHub上为项目创建分支
2. 为修改创建一个分支：git checkout -b nombre-branch
3. 修改代码：git commit -am '添加...'
4. 发布更改：git push origin nombre-branch
5. 创建一个pull request将新分支合并到LibreDTE。

重要：在创建pull request之前，请确保代码符合PSR-1、PSR-2和PSR-4标准。

联系方式和社交媒体

• 网站：https://libredte.cl
• YouTube：https://www.youtube.com/libredtecl
• Facebook：https://#/libredte
• Instagram：https://www.instagram.com/libredte
• Twitter：https://twitter.com/libredte