rafwell/laravel-focusnfe

集成Laravel与FocusNFE进行税务发票开具。

3.0.0 2024-01-04 18:38 UTC

This package is auto-updated.

Last update: 2024-09-04 20:06:06 UTC


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);