README

用于与市政府的电子服务发票系统集成的框架

php-nfse是一个用于生成RPS和与市政府沟通的框架。

该项目是基于已废弃的原项目nfephp-org/sped-nfse https://github.com/nfephp-org/sped-nfse。

重要提示 - 请仔细阅读

市政府会改变NFSe模型，自由地更改其布局，甚至更改访问webservice的方式，这是事实！！

这使得与类似包相比，该包极其复杂。

另一个非常重要的细节主要影响您将使用该包的应用程序，这些市政府针对采用的标准有不同的大致程序，例如

• 不同的字段（大小和结构）
• 不存在的操作，或操作不同
• 数据可接受性标准不同
• 等。

这意味着您的应用程序将必须处理每个市政府的这些特殊性，而不仅仅是模型。

在定义WebServices方面没有国家标准，市政府可以随意更改XML布局或提供商，这可能会引起严重的问题，因为我们可以没有条件适应这个框架，无论是由于技术更改还是由于时间限制。

使用此框架的用户应评估他们提供的产品的风险和责任，因为最终用户可能会在任何时候停止工作，因为如前所述

"我们无法保证在XML布局或RPS接收webservice发生更改时仍能正常工作"，我们当然会尽力适应，但我们无法保证在NFSe情况下取得成功。

建议

只有当您有足够的知识来纠正发现的错误时才使用此框架，否则请放弃并不要坚持，因为可能不会提供任何类型的支持，无论是免费还是付费。

您自行承担风险。

定义

电子服务发票 - NFS-e 是一种仅存在于数字中的财务文件，将取代传统的纸质服务发票。由市政府财政部门实施的NFSe将在计算机程序中以电子方式发出和存储，目的是通过电子记录受ISSQN（任何性质的服务税）征税的服务来实现对ISSQN的产生事实的记录。通过电子服务发票，您将获得以下好处

• 降低成本
• 减少官僚主义
• 促进承揽人和提供者之间的联系
• 更好地管理发出的和接收的发票
• 使用收据文件节省时间和提高安全性

发出NFSe需要预先登记发行人，以及具有A1（PKCS#12）类型的数字证书，该证书由巴西的认证机构发出，属于ICP-Brasil。

开发中的包，目前不可用！！

标准

存在许多不同的“标准”用于开具NFSe，此外，每个市政府都可以对其选择的“标准”进行修改，因此，每个授权市政府必须被明确识别，以便在框架调用中使用正确的代码。这大大增加了该API的复杂性，从而也增加了其维护难度。

• 算盘
• ABRASF
• 敏捷
• ArrecadaNet
• 公务员
• AWATAR
• BETHA - BETA-TESTS
• BOANF
• BSIT-BR
• Cecam
• CENTI
• Comunix
• CONAM
• Consist
• COPLAN
• DB NFSE
• DEISS
• DigiFred
• DSFNET - ALPHA-TESTS
• Dueto
• DUETO 2.0
• E-Caucaia
• e-Governe ISS
• e-公共门户
• e-Receita
• E&L
• eISS
• Elotech
• Equiplano
• ETransparencia
• FacilitaISS
• FGMAISS
• FINTELISS
• FISS-LEX
• Freire
• GENERATIVA
• GINFES
• GLC Consultoria (Sumaré e Monte Mor)
• 戈亚尼亚
• Governa
• Governa TXT
• 数字政府
• 电子政府
• INFISC
• INFISC – Santiago
• INFISC – Sapucaia
• INFISC Farroupilha
• IPM - BETA-TESTS
• ISISS
• ISS Intel
• ISS On-line Supernova
• ISS Online AEG
• ISS Simples SPCONSIG
• ISS4R
• ISSE
• ISSNET - BETA-TESTS
• 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) - BETA-TESTS
• PRODATA
• 公共 - BETA-TESTS
• RLZ
• SAATRI
• SEMFAZ
• SH3
• SIAM
• SIGCORP – TXT
• SIGCORP BAURU
• SIGCORP Ivaipora
• SIGCORP Londrina
• SIGCORP Rio Grande
• SIGCORP São Gonçalo
• SIGISS - BETA-TESTS
• SimplISS - 开发中
• SJP
• SMARAPD SIL Tecnologia
• SMARAPD SIL Tecnologia WS
• 公共解决方案
• 系统
• Tecnos
• Thema
• Tinus
• Tinus Upload
• TIPLAN
• 市级税收
• WEBISS

框架支持的市政府

ABRASF (BETA-TESTS)

• 萨尔瓦多（BA）ABRASF（修改后）
• 里约热内卢（RJ）ABRASF（修改后）
• 圣何塞 dos Campos（SP）GINFESv3
• Limeira（SP）ETransparencia
• 伊塔比拉（MG）ABRASF（修改后）
• 圣何塞 dos Pinhais（PR）ABRASF（修改后）

BETHA（ALPHA-TESTS）

• 克鲁泽伊罗 do Sul（C）
• Camaçari（BA）
• Quirinópolis（GO）
• Maracaju（MS）
• Cornélio Procópio（PR）
• Fazenda Rio Grande（PR）
• Ortigueira（PR）
• Paranavai（PR）集成
• São Mateus do Sul（PR）
• Resende（RJ）
• Rio das Flores（RJ）
• 格拉马杜（RS）
• Lagoa Vermelha（RS）
• Palmeira das Missões（RS）
• Três Passos（RS）
• Biguaçu（SC）
• Canoinhas（SC）
• Criciúma（SC）
• Curitibanos（SC）
• Imbituba（SC）
• Jaraguá do Sul（SC）
• Joaçaba（SC）
• Lages（SC）
• Navegantes（SC）
• São Lourenço do Oeste（SC）
• São José（SC）
• Schroeder（SC）
• Gavião Peixoto（SP）
• Guatapará（SP）
• Jambeiro（SP）
• Monte Alto（SP）
• Orlândia（SP）

DSFNET（ALPHA-TESTS）

• 卡彭蒂亚（SP）
• 圣路易斯（MA）
• 贝伦（PA）
• 坎波格兰德
• 索罗卡巴（SP）
• 特雷西纳（PI）
• 乌贝兰迪亚（MG）

ISSNET（BETA-TESTS）

• 阿尔塔弗洛雷斯塔（MT）备注：不完整，缺少生产URL
• 安帕洛斯（GO）备注：不完整，缺少生产URL
• 安德拉迪纳（SP）备注：不完整，缺少生产URL
• 阿帕雷西达·戈亚尼亚（GO）备注：不完整，缺少生产URL
• 阿帕雷西达（SP）备注：不完整，缺少生产URL
• 阿拉瓜伊纳（TO）备注：不完整，缺少生产URL
• 邦尼奥托（MS）备注：不完整，缺少生产URL
• 卡塞尔（PR）备注：不完整，缺少生产URL
• 克鲁斯阿尔塔（RS）备注：不完整，缺少生产URL
• 库里蒂巴（MT）
• 多乌鲁多斯（MT）备注：不完整，缺少生产URL
• 伊塔佩廷加（SP）备注：不完整，缺少生产URL
• 雅卡里（SP）备注：不完整，缺少生产URL
• 雅瓜里乌纳（SP）备注：不完整，缺少生产URL
• 朱阿拉（MT）备注：不完整，缺少生产URL
• 洛雷纳（SP）备注：不完整，缺少生产URL
• 马滕达（MG）备注：不完整，缺少生产URL
• 莫吉·达斯·克鲁泽斯（SP）备注：不完整，缺少生产URL
• 纳维拉伊（MS）备注：不完整，缺少生产URL
• 诺布雷斯（MT）备注：不完整，缺少生产URL
• 诺瓦·阿尔沃拉达·多·苏尔（MS）备注：不完整，缺少生产URL
• 诺瓦·奥利姆皮亚（MT）备注：不完整，缺少生产URL
• 诺沃·汉布罗（RS）备注：不完整，缺少生产URL
• 普拉亚·格兰德（SP）备注：不完整，缺少生产URL
• 里贝伊拉诺·普雷托（SP）: ABRASF（修改）
• 里奥·布里林特（MS）备注：不完整，缺少生产URL
• 圣玛丽亚（RS）备注：不完整，缺少生产URL
• 桑托·维森特（SP）备注：不完整，缺少生产URL
• 塞拉纳（SP）备注：不完整，缺少生产URL
• 希德罗兰迪亚（MS）备注：不完整，缺少生产URL
• 索里斯（MT）备注：不完整，缺少生产URL
• 特雷斯科·科雷多（MG）备注：不完整，缺少生产URL
• 瓦尔扎·格兰德（MT）备注：不完整，缺少生产URL

IPM（BETA-TESTS）

• 科洛莫（PR）

PRODAM（BETA-TESTS）

• 圣保罗（SP）备注：没有测试环境

发布（BETA-TESTS）

• 蒂莫泰奥（MG）
• 卡查多（SC）集成
• 查佩科（SC）
• 伊塔亚伊（SC）

SIGISS SigCorp（BETA-TESTS）

• 隆德里纳（PR）SIGISS SigCorp v1.03
• 瓦拉达雷斯州长（MG）Sigicorp

简化版正在开发中

• 圣若昂·达·博阿维斯塔（SP）

安装

通过Composer

库正在开发中

$ composer require lucas-simoes/php-nfse:dev-master

安全性

如果您发现任何与安全相关的问题，请直接向软件包维护者发送电子邮件，而不是打开ISSUE。

致谢

• 卢卡斯·西蒙斯 lucas_development@outlook.com