README

Paraşüt前会计和发票程序与市场自动集成的PHP(Laravel)代码。此包允许您通过必要的设置将N11、Gittigidiyor和Hepsiburada的销售处理为在您指定的间隔内自动处理到Paraşüt中。如果您是电子发票或电子档案的客户，Paraşüt将根据必要的详细信息将它们发送为电子档案或电子发票。Paraşüt使用http://api.parasut.com/docs部分中的销售发票-新发票和电子档案/电子发票记录。

框架：Laravel

如何安装？

步骤：1

由于这是一个Laravel包，因此首先需要安装Laravel。有关如何安装Laravel的详细信息，请参阅Laravel如何安装。

步骤：2

要在Laravel已安装的根目录中安装此包，需要运行以下命令：

$ composer require salyangoz/pazaryeri-parasut

步骤：3

为了使插件在当前的Laravel中可用，需要向Laravel目录中的Config/app.php添加以下更改：

    'providers' => [
        salyangoz\pazaryeriparasut\PazaryeriParasutServiceProvider::class
    ],

步骤：4

为了防止已处理的订单再次传输，需要创建一个名为parasut-data.json的本地存储文件来保存已处理的发票的记录编号，并将其放置在storage/app目录中，并确保文件可写。

Linux示例命令（在Laravel根目录中）

$ touch storage/app/parasut-data.json
$ chmod 777 storage/app/parasut-data.json

步骤 5：环境设置

该包从Laravel项目中的.env文件中获取用于N11、Gittigidiyor、Hepsiburada和Paraşüt的项目信息。您可以从此存储库中的.env.example文件中查看将定义哪些变量。

可选

如果需要更改项目中的包中的常量（或者想要开发包），则需要发布配置值以进行包设置。为此，可以使用以下命令：

php artisan vendor:publish --provider="salyangoz\pazaryeriparasut\PazaryeriParasutServiceProvider"

运行此命令后，包的config.php文件将作为pazaryeri-parasut.php复制到Laravel项目的config目录中，并在此处进行的更改将与包中的配置文件合并或覆盖。

步骤 6：Laravel任务

该包通过定时向市场API服务发送请求来发送订单。为了实现这一点，我们需要向Laravel添加任务并进行时间安排。以下是一个示例。

App\Console\Kernel.php

namespace App\Console;

use Illuminate\Console\Scheduling\Schedule;
use Illuminate\Foundation\Console\Kernel as ConsoleKernel;

class Kernel extends ConsoleKernel
{

    protected $commands = [
        \salyangoz\pazaryeriparasut\Commands\Transfer::class
    ];

    /**
     * Define the application's command schedule.
     *
     * @param  \Illuminate\Console\Scheduling\Schedule  $schedule
     * @return void
     */
    protected function schedule(Schedule $schedule)
    {
		      $schedule->command('pazaryeriparasut:transfer')->everyFiveMinutes();
    }

    /**
     * Register the Closure based commands for the application.
     *
     * @return void
     */
    protected function commands()
    {
        require base_path('routes/console.php');
    }
}

重要提示：Laravel任务计时器需要Web服务器上的cron才能运行。

Laravel任务如何设置时间

确认Laravel任务时间安排正在运行后，我们就准备好了！

在完成以下配置后，可以通过在命令行中直接运行来测试任务是否正确执行：

$ php artisan pazaryeriparasut:transfer

如何使用？

ParaşütAPI配置流程

destek@parasut.com地址发送电子邮件，说明您希望使用API，并请求与您分享相关信息。
从收到的信息中，将Application Id、Secret以及您登录Paraşüt时在顶部链接中找到的以6个数字开头的编号部分和您将为发票打开的类别ID输入到项目的.env文件中。

PARASUT_CLIENT_ID=
PARASUT_CLIENT_SECRET=
PARASUT_USERNAME=
PARASUT_COMPANY_ID=
PARASUT_PASSWORD=
PARASUT_CATEGORY_ID=
PARASUT_ACCOUNT_ID=

Pazaryeri与Paraşüt的集成用于在指定的时间间隔内自动处理市场中的销售发票。使用此系统的电子发票纳税人，在市场中的订单被确认或准备好发货时，将自动生成发票。

Gittigidiyor API配置流程

使用您店铺的信息从http://dev.gittigidiyor.com地址登录。
从菜单进入API密钥部分。
点击以获取新的API密钥。
将密钥信息输入到Config/Parasut-Pazaryeri.php文件中的相关信息。
之后，为了在gittigidiyor上获取AUTH_USERNAME和AUTH_PASSWORD，向api.destek@gittigidiyor.com邮箱地址发送消息。以下是一个示例消息。
您可以将收到的信息处理到laravel项目的.env文件中的相关信息。

GITTIGIDIYOR_API_KEY=
GITTIGIDIYOR_SECRET_KEY=
GITTIGIDIYOR_USERNAME=
GITTIGIDIYOR_PASSWORD=
GITTIGIDIYOR_AUTH_USER=
GITTIGIDIYOR_AUTH_PASSWORD=
GITTIGIDIYOR_LANG=tr

为了让Paraşüt gittigidiyor集成工作，您需要在服务器或托管设置中将8080和8443端口打开。


API girişinizi yapabilmek için API kullanıcı rolü tanımlaması rica ediyoruz. Aşağıda kullanıcı bilgilerimiz mevcuttur. Mağaza adımız “mağaza-adınız”.

如果您愿意，gittigidiyor在之后可能会向您询问一些信息。为了方便您准备这些信息，以下是这些信息可能包含的内容。

Hesap sahibinin;

Ad:
Soyad:
Mail adresi:
Telefonu:
Firma Ad:
Firma Telefonu:
Firma Web sitesi:
GittiGidiyor Kullanıcı Adı:
Kullanım amacınız ve uygulamanız hakkında detaylı bilgi:

Entegrasyon Firması Adı:
Firma Email Adresi:
Firma Telefonu:

### N11 API配置过程

使用您的店铺信息从http://so.n11.com地址登录。
进入上面显示的“我的账户”-“API账户”菜单后，点击“+创建新账户”按钮。信息将发送到您店铺注册的电子邮件地址。
将这些信息输入到laravel项目的.env文件中。

N11_APP_KEY=
N11_APP_SECRET=

Hepsiburada配置过程

使用您在Hepsiburada店铺注册的电子邮件，向mpentegrasyon@hepsiburada.com地址请求测试和实时集成信息。
将发送的门户用户名、密码和商户ID部分输入到laravel项目的.env文件中。

HEPSIBURADA_USERNAME=
HEPSIBURADA_MERCHANT_ID=
HEPSIBURADA_PASSWORD=

安全

如果您发现任何安全漏洞，请通过info@salyangoz.com.tr地址发送通知，而不是直接创建问题。

开发平台

Laravel - PHP框架，为Web工匠而生

版本控制

我们使用SemVer版本控制。要查看版本，请访问标签部分。

参与者

许可证

MIT许可证。有关更多信息，请参阅许可证文件。

附加信息

Salyangoz网站地址

salyangoz / pazaryeri-parasut

维护者

详细信息