负责管理与NF-e相关方法的包

1.2 2022-08-27 19:49 UTC

This package is not auto-updated.

Last update: 2024-09-22 05:43:10 UTC


README

本包的目标是抽象出允许开发者操作NF-e生成的XML文件的方法

🚀 开始

以下步骤将描述包的安装和使用

📋 预先条件

本包使用以下技术进行开发

  • PHP 7.4
  • Laravel框架 5.8.38
  • Postgresql 12
  • Composer版本 2.2.6

🔧 安装

  1. 访问您想要安装包的项目文件夹(请记住预先条件)
  2. 执行以下命令
composer require boostech/nfe:1.2
  1. 将在vendor/boostech/nfe目录下创建一个文件夹
  2. 编辑文件 /<nome_projeto>/config/app.php,并在providers标签内添加行 Boostech\Nfe\Providers\NfeServiceProvider::class
'providers' => [
    ...
    ...
    ...
    App\Providers\EventServiceProvider::class,
    App\Providers\RouteServiceProvider::class,
    Boostech\Nfe\Providers\NfeServiceProvider::class,

],
  1. 在项目根目录下执行以下命令
php artisan optimize
php artisan migrate

  1. 将在您的数据库中创建两个表
    • boostech_nfe_hnfex:负责管理NF-e的头部信息
    • boostech_nfe_hnfei:负责管理NF-e的项目信息

📦 开发

要使用此包,请按照以下示例操作

  1. 将授权的NF-e的一些XML文件保存在特定的目录中
  2. 在项目中创建一个名为TesteController的控制器
  3. 向此控制器添加以下方法
public function teste()
{
    $diretorio = "<diretorio_dos_xmls>";

    foreach (array_diff(scandir($diretorio), array('..', '.')) as $item) {
        $retorno = Hnfex::importarXML(1, 2, sprintf("%s/%s", $diretorio, $item));

        if (!$retorno['status']) {
            dd($retorno['excessao']);
        }
    }

    echo "XML's importados!";
}
  1. 为该方法创建一个路由:'Route::get('/teste', [App\Http\Controllers\TesteController::class, 'teste'])->name('teste.teste');'
  2. 通过浏览器访问https://:8000/teste
  3. 系统将导入XML文件,如果一切顺利,将显示以下消息:已导入XML!
  4. 访问boostech_nfe_hnfex和boostech_nfe_hnfei表并检查它们是否已填充

📌 版本

版本 1.0.1

✒️ 作者

📄 许可证

MIT