README

这是一个用于集成QuickBooks Online API的Laravel扩展包。

入门指南

以下是将QuickBooks Online API集成到您的Laravel项目的步骤。

安装

使用composer安装包

  composer require pns/laravel-qbo

导出配置文件

  php artisan vendor:publish --provider="Pns\LaravelQbo\Providers\LaravelQboServiceProvider" --tag="config"

导出迁移文件

  php artisan vendor:publish --provider="Pns\LaravelQbo\Providers\LaravelQboServiceProvider" --tag="migrations"

快速迁移

  php artisan migrate

环境变量

为了运行此包，您需要将以下环境变量添加到您的.env文件中

QBO_AUTH_MODE=oauth2

QBO_ATH_REQUEST_URL=https://appcenter.intuit.com/connect/oauth2

QBO_TOKEN_END_POINT_URL=https://oauth.platform.intuit.com/oauth2/v1/tokens/bearer

QBO_CLIENT_ID=

QBO_CLIENT_SECRET=

QBO_REDIRECT_URI=

QBO_SCOPE=com.intuit.quickbooks.accounting

QBO_BASE_URL=Development

QBO_COMPANY_ID=

您可以在以下位置获取环境变量的步骤： https://developer.intuit.com/app/developer/homepage

或按照以下步骤操作

生成环境变量

登录到您的QuickBooks Online账户 https://accounts.intuit.com
登录后，转到 https://developer.intuit.com/app/developer/sandbox 以创建一个新的沙盒公司。

添加沙盒公司。

创建沙盒公司后，将 公司ID 复制到 QBO_COMPANY_ID 环境变量中。

然后，转到 https://developer.intuit.com/app/developer/dashboard。

创建一个应用程序。

填写表单以创建新应用程序。

创建后，您将被重定向到应用程序的入门页面。

转到 密钥和凭证。将 客户端ID 和 客户端密钥 分别复制到 QBO_CLIENT_ID 和 QBO_CLIENT_SECRET。

向下滚动以创建或复制 重定向URI 到 QBO_REDIRECT_URI。

如何使用

下载Postman API

在此处下载Postman API集合。

身份验证

使用此功能以进行身份验证和刷新访问令牌。

控制器

  \Pns\LaravelQbo\Http\Controllers\QboAuthController

验证令牌

Postman URL

  {{url}}/qbo/authorize

响应

  {
    "authorizationCodeUrl": "https://appcenter.intuit.com/connect/oauth2?client_id=ABEP4t682b0kTjxo8G6yuJGftr506G6oZ5DsOMP0b2MbSHdWP2&scope=com.intuit.quickbooks.accounting&redirect_uri=https%3A%2F%2Fdeveloper.intuit.com%2Fv2%2FOAuth2Playground%2FRedirectUrl&response_type=code&state=DATTK"
  }

刷新令牌

Postman URL

  {{url}}/qbo/token-save

请求

  {
    "code": "AB11645453718yt4XS3Ngih24yMxDSQYXYG4Hpy2oR6lNkC87L",
    "realmId": "4620816365213659530" 
  }

响应

  {
    "message": "Token refreshed.",
    "accessToken": {
      "access_token": "eyJlbmMiOiJBMTI4Q0JDLUhTMjU2IiwiYWxnIjoiZGlyIn0..GpEotUwWZJnVEbrOGYSLcg.AdIOfTVbSs73d8-b0wgmFnbgIPbrUKWoIW6_9FJQ27lKWO5xXy5VykvAyUEd_PUpBLhpXfhnnXMkvO_75YecvducgHCHlFy9NdBGfy1WCpkZ8OZQTKIdC1Up4FrsPurK7eAqY8y1-eJNcgARK4TyLtwy14dWeIvZXe3v3uHFtsSz5BsiGj8mC1o9MoKdvFep6BgOtBeZu_nacr7qcPlTXAztWNLLExhZtzSlJqMMMcjErHJ0SOpCZfauba_KrzCT5m0GBmyHvT-maV4EbseiK_hjhdegh0T1kkznxZK92j3tPfqCeAGL3IxJQT2iJlpgyGmTTotX2Mnoz6OPPykxN-8SRh8itzOdqPquQ-P4eqXI-XtnIiHzWBhyi-jvTAfGWuTYx5ohKOQKGvOiyDV4xbqkYw-XNbwsGLtF9EUY-Z8HWk6waj5g07O_-WxOY8lOlhJ4u7lkMaCLm6KMSHLNhfwRykp81wlxac80IQF8_InBseH1jVfShP89WMgYdGzuoy-8hY9jXwBgDudVm5uoqhQiIMaLbZQ1_V1XuHs9-1pBsLtq4KjoabTCJ3lma_cv-wff0plsXDaQFih-StmyWWvBZYRzRPvWbloTsGDEt8WxIANUd2AWZhZFwfJIxkgTpfLnDEySg2QyV-LoNjFU_FAYulFGn1-V6b7JBBYTEJkZXssVGRcy62zGzw_K0Y5DlJUnesbShcAA9rwrA7L430DPi_yYLm472-OKWjhM9OaeR2f6QcrsUxuhj96XcwQd.CynAG529fBQbeDV7OY7WRw",
      "refresh_token": "AB116541797850qjxumAQNzUirNxrOs9C8Sj0U1o59iT0Ev2o2",
      "x_refresh_token_expires_in": "2022/06/02 14:23:05",
      "expires_in": "2022/02/21 15:23:05"
    }
  }

公司

使用此功能以获取和更新您的公司配置文件。

控制器

  \Pns\LaravelQbo\Http\Controllers\QboCompanyController

获取公司配置文件

Postman URL

  {{url}}/qbo/company

响应

  {
    "authorizationCodeUrl": "https://appcenter.intuit.com/connect/oauth2?client_id=ABEP4t682b0kTjxo8G6yuJGftr506G6oZ5DsOMP0b2MbSHdWP2&scope=com.intuit.quickbooks.accounting&redirect_uri=https%3A%2F%2Fdeveloper.intuit.com%2Fv2%2FOAuth2Playground%2FRedirectUrl&response_type=code&state=DATTK"
  }

功能

身份验证
公司配置文件
- 查看
发票
- 创建
- 查看
- 删除
- 列表
- 发送到电子邮件
客户
- 创建
- 查看
- 删除
- 列表

支持

对于支持，请通过电子邮件 jeddsaliba@gmail.com 或加入我们的Slack频道。

飞得更高，蝴蝶！

pns / laravel-qbo

维护者

详细信息

README

入门指南

安装

环境变量

生成环境变量

如何使用

下载Postman API

身份验证

公司

功能

支持