README

查看contributing.md以获取待办事项列表。

安装

通过Composer

$ composer require jarvus/laravel-quickbooks

发布包并运行迁移

$ php artisan vendor:publish
$ php artisan migrate

使用方法

配置

您需要在.env文件中设置以下变量。

# Client ID from the app's keys tab.
QB_CLIENT_ID=

# Client Secret from the app's keys tab.
QB_CLIENT_SECRET=

# The redirect URI provided on the Redirect URIs part under keys tab.
QB_REDIRECT_URI=

# Quickbooks scope com.intuit.quickbooks.accounting or com.intuit.quickbooks.payment
QB_SCOPE=

# Development/Production
QB_BASE_URL=

令牌处理

由于每个应用程序的设置不同，您需要创建一个扩展QuickBooksTokenHandler的类来在数据库中持久化令牌。默认情况下，令牌使用Laravel Cache API存储，有效期为7天。

例如，如果您使用Laravel Options包，您可以在项目的某个位置创建以下类

namespace App\QuickBooks;

use Jarvus\LaravelQuickBooks\QuickBooksTokenHandler;

class TokenHandler extends QuickBooksTokenHandler
{
    public function set($key, $value)
    {
        option([$key => $value]);
    }

    public function get($key)
    {
        return option($key);
    }
}

然后在AppServiceProvider.php中绑定它

public function boot()
{
    $this->app->bind(
        \Jarvus\LaravelQuickBooks\QuickBooksTokenHandlerInterface::class,
        \App\QuickBooks\TokenHandler::class
    );
}

连接QuickBooks账户

要连接您的应用程序与QuickBooks公司，您可以使用QuickBooksAuthenticator助手。它有两个方法

getAuthorizationUrl() - 返回重定向URL并将quickbooks_authcookie放入Laravel cookie队列。Cookie有效期为30分钟。
processHook() - 验证quickbooks_authcookie并设置域ID、访问令牌和刷新令牌。

使用示例

namespace App\Http\Controllers;

use Jarvus\LaravelQuickBooks\QuickBooksAuthenticator;
use Cookie;

class QuickBooksController extends Controller
{
    public function connect()
    {
        return redirect(QuickBooksAuthenticator::getAuthorizationUrl())
            ->withCookies(Cookie::getQueuedCookies());
    }

    public function refreshTokens()
    {
        if (QuickBooksAuthenticator::processHook()) {
            return 'Tokens successfully refreshed.';
        }

        return 'There were some problems refreshing tokens.';
    }
}

同步Eloquent模型到QuickBooks

您可以选择扩展已经扩展Eloquent模型的Jarvus\LaravelQuickBooks\QuickBooksEntity类，或者使用Jarvus\LaravelQuickBooks\SyncsToQuickBooks特质。

然后您必须定义

quickBooksResource - QuickBooks资源类之一（例如\Jarvus\LaravelQuickBooks\Resources\Company::class）。
getQuickBooksArray() - 此方法必须返回要同步到QuickBooks的关联数组。
quickBooksIdColumn（可选）- 用于存储QuickBooks ID的列（默认为quickbooks_id）

使用示例

namespace App\Models\Company;

use Jarvus\LaravelQuickBooks\QuickBooksEntity;
use Jarvus\LaravelQuickBooks\Resources\Customer;

class Company extends QuickBooksEntity
{
    /**
     * Database column name
     * This is optional default value is 'quickbooks_id'
     * @var string
     */
    protected $quickBooksIdColumn = 'quickbooks_id';

    /**
     * Use one of Jarvus\LaravelQuickBooks\Resources classes
     * @var array
     */
    protected $quickBooksResource = Customer::class;

    /**
     * @return array
     */
    protected function getQuickBooksArray(): array
    {
        return [
            'CompanyName'  => 'Example name',
            'DisplayName'  => 'Example display name',
            //...
        ];
    }
}

当您想要同步资源时，必须调用syncToQuickBooks()。方法返回成功时为true。您可以使用方法getLastQuickBooksError()获取最后一个QuickBooks错误。

同步示例

/**
 * @return string
 * @throws \Exception
 */
public function syncExample()
{
    $company = Company::find(1);
    if ($company->syncToQuickBooks()){
        return 'Success';
    }
    return $company->getLastQuickBooksError();
}

使用QuickBooks资源类

您可以使用包含在Jarvus\LaravelQuickBooks\Resources中的资源类来创建、更新和查询来自QuickBooks的资源。

示例

$customer = new Jarvus\LaravelQuickBooks\Resources\Customer;

// create
$customer->create([
    'GivenName'  => 'John',
    'FamilyName' => 'Smith',
]);

// update item with ID "123"
$customer->update(123, [
    'GivenName'  => 'John',
    'FamilyName' => 'Smith',
]);

// find by ID:
$customer->find(123);

// find by a specific field:
$customer->findBy('FamilyName', 'Smith');

// find multiple items:
$customer->query();

请参阅QuickBooksResource.php以获取更多文档信息。

变更日志

请参阅changelog以获取有关最近更改的更多信息。

贡献

请参阅contributing.md以获取详细信息以及待办事项列表。

安全性

如果您发现任何与安全相关的问题，请通过电子邮件联系作者而不是使用问题跟踪器。

致谢

许可

MIT许可。请参阅许可文件以获取更多信息。

jarvus / laravel-quickbooks

维护者

详细信息