a21ns1g4ts / php-nfse
NFSe 与市政府通信的生成和API。这是已弃用的 nfephp-org/sped-nfse 项目的分支。
Requires
- php: ~5.6|~8.2|~8.1
- nfephp-org/sped-common: ^5.0
- respect/validation: ^1.1
Requires (Dev)
- phpunit/phpunit: ^5.7
- scrutinizer/ocular: ^1.3
- squizlabs/php_codesniffer: ^2.8
This package is auto-updated.
Last update: 2024-09-16 04:02:34 UTC
README
用于与市政府电子税务服务系统集成的框架
php-nfse 是一个用于生成 RPS 并与市政府沟通 NFSe 的框架。
该项目是已弃用的原始项目 nfephp-org/sped-nfse https://github.com/nfephp-org/sped-nfse 的分支。
重要提示 - 请仔细阅读
市政府 随意更改 NFSe 模型、布局以及访问 webservices 的方式,这是事实!!
这使得与其他类似软件包相比,这个包极其复杂。
另一个非常重要且主要影响您应用程序的细节是,每个市政府都有自己的不同程序,这与采用的标准不同,例如
- 不同的字段(大小和结构)
- 不存在或功能不同的操作
- 与标准不同的数据可接受标准
- 等等。
这意味着您的应用程序将不得不处理每个市政府的这些特殊性,而不仅仅是模型。
在定义 WebServices 方面没有国家标准,市政府可以随意更改 XML 布局或提供商,这可能会引起严重的访问和验证问题,因为我们可能无法适应该框架,无论是由于技术变更还是由于截止日期的压力。
使用此框架的用户应评估他们所承担的风险和责任,因为最终用户的产品可能会在任何时候停止工作,因为如前所述
"我们无法保证在 XML 布局或 RPS 接收 webservices 发生变更时能够正常工作",我们显然会尽力适应,但我们无法保证在 NFSe 的情况下能够成功。
建议
只有当您有足够的知识来修复发现的错误时才使用此框架,否则放弃并不要坚持,因为很可能没有免费或付费的任何类型的技术支持。
您自行承担风险。
定义
电子服务发票(NFS-e)是仅以数字形式存在的税务文件,将取代传统的服务发票。由市政府财政部门实施的 NFS-e 将通过电子程序生成和存储,目的是通过记录受 ISSQN 税收的服务提供来体现 ISSQN(无论性质的服务税)。通过电子服务发票,您将获得以下好处
- 降低成本
- 降低官僚主义
- 鼓励收货人和供应商之间的关系
- 更好地管理发出的和接收的发票
- 使用征收文件的节省时间和安全性
NFSe 的发行需要预先注册发行商和提供 A1 类(PKCS#12)数字证书,该证书由属于 ICP-Brasil 的巴西认证机构发行。
开发中的包,目前不可用!!
标准
存在许多不同的“标准”用于开具NFSe发票,而且每个市政府都可以对其选择的“标准”进行修改,因此,每个授权市政府都需要明确标识,以确保在框架调用中使用正确的代码。这大大增加了此API的复杂性,从而也增加了其维护难度。
- 亚伯
- ABRASF
- 敏捷
- ArrecadaNet
- 公务员
- AWATAR
- BETHA - 测试版
- BOANF
- BSIT-BR
- Cecam
- CENTI
- Comunix
- CONAM
- Consist
- COPLAN
- DB NFSE
- DEISS
- DigiFred
- DSFNET - 测试版
- Dueto
- Dueto 2.0
- E-Caucaia
- e-Governe ISS
- e-Receita 公共门户
- e-Receita
- E&L
- eISS
- Elotech
- Equiplano
- ETransparencia
- FacilitaISS
- FGMAISS
- FINTELISS
- FISS-LEX
- Freire
- GENERATIVA
- GINFES
- GLC咨询(Sumaré和Monte Mor)
- 戈亚尼亚
- 政府
- 政府TXT
- 数字政府
- 电子政府
- INFISC
- INFISC – 圣地亚哥
- INFISC – Sapucaia
- INFISC Farroupilha
- IPM - 测试版
- ISISS
- ISS Intel
- ISS On-line Supernova
- ISS Online AEG
- ISS Simples SPCONSIG
- ISS4R
- ISSE
- ISSNET - 测试版
- ISSNFe On-line
- ISSWEB Camaçari
- ISSWEB Fiorilli
- JFISS Digital
- JGBAIAO
- Lençóis Paulista
- Lexsom
- Memory
- Metrópolis
- NF-Eletronica
- NF-em
- NFPSe
- NFSE-ECIDADES
- NFSeNET
- NFWEB
- Nota Blu
- Nota Carioca (ABRASF派生) - 开发中
- Nota Natalense
- Nota Salvador (ABRASF派生) - 开发中
- PMJP
- PortalFacil
- Prescon
- Primax Online
- Prodam (NF Paulistana) - 测试版
- PRODATA
- 公共 - 测试版
- RLZ
- SAATRI
- SEMFAZ
- SH3
- SIAM
- SIGCORP – TXT
- SIGCORP BAURU
- SIGCORP Ivaipora
- SIGCORP Londrina
- SIGCORP Rio Grande
- SIGCORP São Gonçalo
- SIGISS - 测试版
- SimplISS - 开发中
- SJP
- SMARAPD SIL Tecnologia
- SMARAPD SIL Tecnologia WS
- Solução Pública
- System
- Tecnos
- Thema
- Tinus
- Tinus Upload
- TIPLAN
- 市镇税收
- WEBISS
框架支持的市政府
ABRASF (测试版)
- 萨尔瓦多(BA)ABRASF(修改后)
- 里约热内卢(RJ)ABRASF(修改后)
- 圣何塞多斯坎波斯(SP)GINFESv3
- 里梅拉(SP)ETransparencia
- 伊塔比拉(MG)ABRASF(修改后)
- 圣何塞多斯皮尼亚奥斯(PR)ABRASF(修改后)
BETHA (测试版)
- 克鲁塞伊鲁(C)
- 卡马萨里(BA)
- 基里诺波利斯(GO)
- 马拉卡朱(MS)
- 科雷尼奥普里奥(PR)
- 法热达里奥格兰德(PR)
- 奥尔特吉亚(PR)
- 巴拉纳瓦伊(PR)集成
- 圣马特乌斯多苏尔(PR)
- 雷森德(RJ)
- 里约达斯弗洛雷兹(RJ)
- 格拉马杜(RS)
- 拉戈阿维梅拉(RS)
- 帕尔梅伊拉斯米森(RS)
- 特雷斯帕索斯(RS)
- 比古亚苏(SC)
- 卡诺伊阿斯(SC)
- 克里西乌马(SC)
- 库里蒂班奥斯(SC)
- 伊米布图巴(SC)
- 贾拉瓜杜苏尔(SC)
- 若阿萨巴(SC)
- 拉热斯(SC)
- 纳韦加ンテ斯(SC)
- 圣洛伦索多奥埃斯特(SC)
- 圣何塞(SC)
- 施罗伊德(SC)
- 加维亚佩绍托(SP)
- 瓜塔帕拉(SP)
- 雅姆贝伊罗(SP)
- 蒙特阿尔托(SP)
- 奥兰迪亚(SP)
DSFNET (测试版)
- 卡皮瓦里(SP)
- 圣路易斯(MA)
- 贝伦(PA)
- 大地
- 索罗卡巴(圣保罗州)
- 特雷西纳(皮奥伊州)
- 乌贝兰迪亚(米纳斯吉拉斯州)
ISSNET(Beta测试)
- 阿尔塔弗洛雷斯塔(马托格罗索州) 备注:不完整,缺少生产URL
- 阿纳波利斯(戈亚斯州) 备注:不完整,缺少生产URL
- 安德拉迪纳(圣保罗州) 备注:不完整,缺少生产URL
- 戈亚尼亚(戈亚斯州) 备注:不完整,缺少生产URL
- 阿帕雷西达(圣保罗州) 备注:不完整,缺少生产URL
- 阿拉瓜伊纳(托坎廷斯州) 备注:不完整,缺少生产URL
- 邦尼奥(马托格罗索州) 备注:不完整,缺少生产URL
- 卡斯凯韦尔(巴拉那州) 备注:不完整,缺少生产URL
- 克鲁斯阿尔塔(里斯州) 备注:不完整,缺少生产URL
- 库伊亚比(马托格罗索州)
- 杜拉多斯(马托格罗索州) 备注:不完整,缺少生产URL
- 伊塔佩廷加(圣保罗州) 备注:不完整,缺少生产URL
- 雅卡雷伊(圣保罗州) 备注:不完整,缺少生产URL
- 贾加里乌纳(圣保罗州) 备注:不完整,缺少生产URL
- 茹阿拉(马托格罗索州) 备注:不完整,缺少生产URL
- 洛雷纳(圣保罗州) 备注:不完整,缺少生产URL
- 曼蒂纳(米纳斯吉拉斯州) 备注:不完整,缺少生产URL
- 莫吉-达斯-克鲁泽斯(圣保罗州) 备注:不完整,缺少生产URL
- 纳维拉伊(马托格罗索州) 备注:不完整,缺少生产URL
- 诺布雷斯(马托格罗索州) 备注:不完整,缺少生产URL
- 诺瓦阿尔沃拉德杜苏尔(马托格罗索州) 备注:不完整,缺少生产URL
- 诺瓦奥利姆皮亚(马托格罗索州) 备注:不完整,缺少生产URL
- 诺沃哈姆布罗(里斯州) 备注:不完整,缺少生产URL
- 普拉亚格兰德(圣保罗州) 备注:不完整,缺少生产URL
- 里贝拉伊内格雷(圣保罗州) 备注:不完整,缺少生产URL
- 里奥布里朗特(马托格罗索州) 备注:不完整,缺少生产URL
- 圣玛丽亚(里斯州) 备注:不完整,缺少生产URL
- 桑托斯维森特(圣保罗州) 备注:不完整,缺少生产URL
- 塞拉纳(圣保罗州) 备注:不完整,缺少生产URL
- 西德罗兰迪亚(马托格罗索州) 备注:不完整,缺少生产URL
- 索里斯(马托格罗索州) 备注:不完整,缺少生产URL
- 特雷斯科塔斯(米纳斯吉拉斯州) 备注:不完整,缺少生产URL
- 瓦尔塞亚格兰德(马托格罗索州) 备注:不完整,缺少生产URL
IPM(Beta测试)
- 科洛莫布(巴拉那州)
PRODAM(Beta测试)
- 圣保罗(圣保罗州) 备注:没有测试环境
Publica(Beta测试)
- 蒂莫蒂奥(米纳斯吉拉斯州)
- 卡察多(圣卡塔琳娜州) 集成
- 查佩科(圣卡塔琳娜州)
- 伊塔亚伊(圣卡塔琳娜州)
SIGISS SigCorp(Beta测试)
- 隆德里纳(巴拉那州) SIGISS SigCorp v1.03
- 瓦达拉斯瓦尔达雷斯(米纳斯吉拉斯州) Sigicorp
Simpliss 在开发中
- 圣若昂达博阿维斯塔(圣保罗州)
安装
通过Composer
开发中的库
$ composer require lucas-simoes/php-nfse:dev-master
安全
如果您发现任何有关安全的问题,请直接向软件包维护者发送电子邮件,而不是打开一个ISSUE。
致谢
- 卢卡斯·席尔瓦(卢卡斯·席尔瓦) lucas_development@outlook.com