Flutter QuickBooks集成插件another_quickbooks的使用

Flutter包用于QuickBooks。支持Payments和Accounting API以及授权流程。

QuickBooks Payments

QuickBooks Accounting

使用步骤

1. 注册开发者账号并获取clientId和clientSecret

访问QuickBooks开发者控制台注册开发者账号，并创建应用程序以获取clientId和clientSecret。

2. 初始化Quickbooks客户端

import 'package:another_quickbooks/another_quickbooks.dart';

final quickClient = QuickbooksClient(
  applicationId: 'your_application_id', // 应用程序ID
  clientId: 'your_client_id',           // clientId
  clientSecret: 'your_client_secret',   // clientSecret
);

// 初始化客户端
await quickClient.initialize();

3. 获取授权页面URL

// 获取授权页面URL
var authUrl = quickClient.getAuthorizationPageUrl(
  scopes: [Scope.Accounting, Scope.Payments], // 授权范围
  redirectUrl: '<your_redirect_url>',         // 回调URL
  state: "state123",                          // 状态参数
);

print('请访问此URL以授权您的应用: $authUrl');

4. 获取授权后的AccessToken

在用户授权后，从回调URL中获取code和realmId，然后通过以下代码获取AccessToken：

// 获取AccessToken
var autoToken = await quickClient.getAuthToken(
  code: '<code_from_redirect_url>',          // 授权码
  realmId: '<realm_id_from_redirect_url>',   // QuickBooks公司ID
  redirectUrl: '<redirect_url>',             // 回调URL
);

print('Access Token: ${autoToken.accessToken}');
print('Refresh Token: ${autoToken.refreshToken}');

5. 刷新AccessToken

当AccessToken过期时，可以使用RefreshToken刷新新的AccessToken：

// 刷新AccessToken
String newToken = (await quickClient.refreshToken(
  refreshToken: autoToken.refreshToken,      // 刷新令牌
)).accessToken;

print('New Access Token: $newToken');

示例代码完整Demo

import 'package:flutter/material.dart';
import 'package:another_quickbooks/another_quickbooks.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: QuickBooksIntegrationPage(),
    );
  }
}

class QuickBooksIntegrationPage extends StatefulWidget {
  [@override](/user/override)
  _QuickBooksIntegrationPageState createState() =>
      _QuickBooksIntegrationPageState();
}

class _QuickBooksIntegrationPageState extends State<QuickBooksIntegrationPage> {
  String _authUrl = '';
  String _accessToken = '';
  String _refreshToken = '';

  Future<void> initializeQuickBooks() async {
    final quickClient = QuickbooksClient(
      applicationId: 'your_application_id',
      clientId: 'your_client_id',
      clientSecret: 'your_client_secret',
    );

    // 初始化客户端
    await quickClient.initialize();

    // 获取授权页面URL
    setState(() {
      _authUrl = quickClient.getAuthorizationPageUrl(
        scopes: [Scope.Accounting, Scope.Payments],
        redirectUrl: '<your_redirect_url>',
        state: "state123",
      );
    });
  }

  Future<void> fetchAccessToken() async {
    final quickClient = QuickbooksClient(
      applicationId: 'your_application_id',
      clientId: 'your_client_id',
      clientSecret: 'your_client_secret',
    );

    // 获取AccessToken
    var autoToken = await quickClient.getAuthToken(
      code: '<code_from_redirect_url>',
      realmId: '<realm_id_from_redirect_url>',
      redirectUrl: '<redirect_url>',
    );

    setState(() {
      _accessToken = autoToken.accessToken;
      _refreshToken = autoToken.refreshToken;
    });
  }

  Future<void> refreshTokenExample() async {
    final quickClient = QuickbooksClient(
      applicationId: 'your_application_id',
      clientId: 'your_client_id',
      clientSecret: 'your_client_secret',
    );

    // 刷新AccessToken
    String newToken = (await quickClient.refreshToken(
      refreshToken: _refreshToken,
    )).accessToken;

    setState(() {
      _accessToken = newToken;
    });
  }

  [@override](/user/override)
  void initState() {
    super.initState();
    initializeQuickBooks();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('QuickBooks Integration'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            ElevatedButton(
              onPressed: fetchAccessToken,
              child: Text('Fetch Access Token'),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: refreshTokenExample,
              child: Text('Refresh Access Token'),
            ),
            SizedBox(height: 20),
            Text('Authorization URL: $_authUrl'),
            Text('Access Token: $_accessToken'),
            Text('Refresh Token: $_refreshToken'),
          ],
        ),
      ),
    );
  }
}