mazinsw/nfe-api

巴西电子发票生成和发送API

4.3.8 2024-08-28 14:35 UTC

README

用于生成、传输和处理电子发票事件的库

Latest Version on Packagist Build Status Coverage Status Quality Score Total Downloads

该库允许生成、传输和处理巴西电子发票的事件

优点

  • 代码结构良好,可重用性强,易于维护
  • 代码结构可扩展,适用于多种发票模型
  • 易于配置和使用(只需实现两个类即可进行集成)
  • 测试和代码覆盖率确保了更高的稳定性
  • 与XML结构解耦,更新几乎不影响生产环境

项目动机

目前(2016年)找到的开源代码库没有提供结构良好且易于使用/维护的结构,因此产生了创建一个能够生成多种模型发票且易于使用的库的需求

项目想法

想法是创建一个库,其中发票的实体分别实现为独立的类,每个类生成自己的XML节点,在生成完成后,所有节点统一,从而完全生成XML。这样便于维护,因为部分灵感来自分而治之的理念

安装

您需要Composer来安装此库。

在您的项目文件夹中执行以下命令

composer require mazinsw/nfe-api

维护

更新IBPT表

# linux
./utils/update_IBPT.sh
REM Windows
utils\update_IBPT.bat

文档

访问这里查看文档

项目协作

为了改进项目,请通过Pull request发送您的实现

问题解决

如果您在使用库时遇到问题,请访问Discord群组:https://discord.gg/XGU2Y77

依赖

  • PHP 7.3或更高版本
  • openssl扩展用于签名发票
  • curl扩展用于发送发票

限制

  • 仅实现了NFC-e模型并进行了测试
  • 仅支持A1模型数字证书
  • 不支持同时使用两个版本的NF-e

许可证

有关更多信息,请参阅许可证文件