rafwell / laravel-focusnfe
集成Laravel与FocusNFE进行税务发票开具。
3.0.0
2024-01-04 18:38 UTC
Requires
- php: ^8.0
README
集成Laravel与Focus NFE API进行税务发票开具。
免责声明
使用此包,您需对开具的税务发票负责。我们不负责信息的真实性或税务计算、验证等。此包仅是对https://focusnfe.com.br/doc文档的抽象,用于Laravel框架。如果您不同意,请勿使用此包。
需要的开发
我们接受包含更多抽象(如NFe、NFCe等)的PR。如果您发现问题,请创建一个issue进行讨论。
可用的端点
- NFe
- NFSe
- 经销商
- Webhook
- 市镇
安装
对于Lavavel >=5.4 && <9
执行 composer require rafwell/laravel-focusnfe "^1.0"
对于Lavavel >=9
执行 composer require rafwell/laravel-focusnfe "^2.0"
如果您正在使用Laravel 5.5,我们的包将被自动发现。否则,将我们的provider添加到您的config/app.php Rafwell\Focusnfe\FocusnfeServiceProvider::class
然后,使用以下命令发布我们的配置文件:
php artisan vendor:publish --provider='Rafwell\Focusnfe\FocusnfeServiceProvider'
使用Focusnfe提供的信息配置您的.env文件
FOCUSNFE_LOGIN='seu token de produção'
FOCUSNFE_LOGIN_SANDBOX='seu token de homologação'
FOCUSNFE_PASSWORD='sua senha'
一切准备就绪。
NFSe示例
将依赖项添加到您的controller或repository use Rafwell\Focusnfe\NFSe; 生产/测试环境由.env中的环境变量控制,因此如果env('APP_ENV')=='production',我们将使用生产服务器。否则,我们将使用测试服务器。
开具
按照focusnfe文档,构建您的数组$data。
$NFSe = new NFSe;
$res = $NFSe->enviar($ref, $data);
if($res->status == 'processando_autorizacao'){
//Nota enviada com sucesso
}
查询
$res = $NFSe->consultar($ref);
if($res->status == 'autorizado'){
//Nota autorizada pela prefeitura
}
取消
$justificativa = 'Exemplo';
$res = $NFSe->cancelar($ref, $justificativa);
if($res->status == 'cancelado'){
//Nota cancelada pela prefeitura
}
通过电子邮件发送
$emails = ['email1@teste.com', 'email2@teste.com'];
$NFSe->email($ref, $emails);