QuickBooks API（php）の統合
私はQuickBooksを初めて使用します。 Quick Booksでトライアルアカウントを作成しました。顧客を追加したり、請求書や同様のことを自分のアカウントに作成したいと考えています。 GitHubからPHP SDKをダウンロードしました。今、私は顧客が私のウェブサイトから注文した後、どこから顧客を自分のアカウントに追加するのかを開始する方法がわかりません。誰かが私が前進できるように、いくつかの詳細なドキュメントまたはいくつかの例を手伝ってくれますか？ Webアプリコネクタに関する知識はありません。私はまったく新しいです。ありがとう。
QuickBooks ONLINEとQuickBooks for WINDOWSのどちらを使用するかを指定しなかったので、これは2部構成の回答になります。
使用するプロセスによってプロセスは異なりますので、以下の太字のヘッダーに注意してください。
QuickBooks ONLINEの場合：
GitHubの オープンソースQuickBooks PHP DevKit を使用している場合、開始するのに最適な場所は QuickBooks Online with PHPクイックスタート ガイド。
最初に行う必要があるのは、Intuitにアプリを登録することです。これを行うと、Intuitはこれらの変数を与えます。
- アプリトークン
- 消費者秘密
- 消費者キー
これらの変数を、例に含まれている config.php ファイルに置き換えます。また、アプリを指すようにこれらの値を更新します。
- oauthのURL（例：your-site.com/path/to/example/oauth.php）
- 成功URL（例：your-site.com/path/to/example/success.php）
- メニューURL（例：your-site.com/path/to/example/menu.php）
- dsn（OAuthトークンストレージ用のデータベース資格情報）
それ以上に、あなたはconfig.phpの他のすべての変数をデフォルトのままにすることができます。
次にindex.phpファイルにアクセスすると、QuickBooksに接続するように求められます。接続して、サンプルファイルにアクセスできます。次に、QuickBooks Onlineに顧客/注文を追加する例をいくつか示します。
コードは次のようになります。
$CustomerService = new QuickBooks_IPP_Service_Customer();
$Customer = new QuickBooks_IPP_Object_Customer();
$Customer->setTitle('Mr');
$Customer->setGivenName('Keith');
$Customer->setMiddleName('R');
$Customer->setFamilyName('Palmer');
$Customer->setDisplayName('Keith R Palmer Jr ' . mt_Rand(0, 1000));
// Phone #
$PrimaryPhone = new QuickBooks_IPP_Object_PrimaryPhone();
$PrimaryPhone->setFreeFormNumber('860-532-0089');
$Customer->setPrimaryPhone($PrimaryPhone);
// Bill address
$BillAddr = new QuickBooks_IPP_Object_BillAddr();
$BillAddr->setLine1('72 E Blue Grass Road');
$BillAddr->setLine2('Suite D');
$BillAddr->setCity('Mt Pleasant');
$BillAddr->setCountrySubDivisionCode('MI');
$BillAddr->setPostalCode('48858');
$Customer->setBillAddr($BillAddr);
if ($resp = $CustomerService->add($Context, $realm, $Customer))
{
print('Our new customer ID is: [' . $resp . ']');
}
追加機能を実装するために、コードに含まれている他の例を見つけることができます。
使用可能なオブジェクト/メソッドもミラーリング Intuitのドキュメント なので、これを確認する必要があります。
WINDOWS用QuickBooksの場合：
Windows用QuickBooksの場合は、Webコネクターを使用します。再度、GitHubの オープンソースQuickBooks PHP DevKit から始めます。 Windows用QuickBooks + PHP quick代わりに-start ガイド。
テストの顧客をQuickBooksに追加する簡単なWeb Connectorサービスの設定について説明します。
基本的に 。QWCファイルを作成 をQuickBooks Web Connectorにロードします（[スタート]> [すべてのプログラム]> [QuickBooks]> [Web Connector]）。その.QWCファイルは QuickBooksとPHPの間の接続をネゴシエートするPHPスクリプト をポイントします。このサンプルスクリプトで行う必要があるのは、この変数を交換することだけです。
- $ dsn（自分のデータベースを指す）
追加する機能の新しい部分ごとに、 QuickBooks Web Connector + PHP docs 。
コードは次のようになります。
function _quickbooks_customer_add_request($requestID, $user, $action, $ID, $extra, &$err, $last_action_time, $last_actionident_time, $version, $locale)
{
// You'd probably do some database access here to pull the record with
// ID = $ID from your database and build a request to add that particular
// customer to QuickBooks.
//
// So, when you implement this for your business, you'd probably do
// something like this...:
/*
// Fetch your customer record from your database
$record = mysql_fetch_array(mysql_query("SELECT * FROM your_customer_table WHERE your_customer_ID_field = " . (int) $ID));
// Create and return a qbXML request
$qbxml = '<?xml version="1.0" encoding="utf-8"?>
<?qbxml version="2.0"?>
<QBXML>
<QBXMLMsgsRq onError="stopOnError">
<CustomerAddRq requestID="' . $requestID . '">
<CustomerAdd>
<Name>' . $record['your_customer_name_field'] . '</Name>
<CompanyName>' . $record['your_customer_company_field'] . '</CompanyName>
... lots of other customer related fields ...
</CustomerAdd>
</CustomerAddRq>
</QBXMLMsgsRq>
</QBXML>';
return $qbxml;
*/
// But we're just testing, so we'll just use a static test request:
$xml = '<?xml version="1.0" encoding="utf-8"?>
<?qbxml version="2.0"?>
<QBXML>
<QBXMLMsgsRq onError="stopOnError">
<CustomerAddRq requestID="' . $requestID . '">
<CustomerAdd>
<Name>ConsoliBYTE, LLC (' . mt_Rand() . ')</Name>
<CompanyName>ConsoliBYTE, LLC</CompanyName>
<FirstName>Keith</FirstName>
<LastName>Palmer</LastName>
<BillAddress>
<Addr1>ConsoliBYTE, LLC</Addr1>
<Addr2>134 Stonemill Road</Addr2>
<City>Mansfield</City>
<State>CT</State>
<PostalCode>06268</PostalCode>
<Country>United States</Country>
</BillAddress>
<Phone>860-634-1602</Phone>
<AltPhone>860-429-0021</AltPhone>
<Fax>860-429-5183</Fax>
<Email>[email protected]</Email>
<Contact>Keith Palmer</Contact>
</CustomerAdd>
</CustomerAddRq>
</QBXMLMsgsRq>
</QBXML>';
return $xml;
}
QuickBooks OSR を使用して、追加のqbXMLリファレンスを見つけることができます。
また、使用可能な qbXMLリクエストの例 を含むwikiも提供しています。
SDKから、顧客を追加するためにexample_ipp_ids_6.phpを使用します。
GitHubの完全なコードへのリンクは次のとおりです。
そして、クイックスタートガイド：
example_ipp_ids_6.php
<?php
// Turn on some error reporting
error_reporting(E_ALL);
ini_set('display_errors', 1);
header('Content-Type: text/plain');
/**
* Require the QuickBooks library
*/
require_once dirname(__FILE__) . '/../QuickBooks.php';
/**
* Require some IPP/OAuth configuration data
*/
require_once dirname(__FILE__) . '/example_ipp_config.php';
// Set up the IPP instance
$IPP = new QuickBooks_IPP($dsn);
// Set up our IntuitAnywhere instance
$IntuitAnywhere = new QuickBooks_IPP_IntuitAnywhere($dsn, $encryption_key, $oauth_consumer_key, $oauth_consumer_secret);
// Get our OAuth credentials from the database
$creds = $IntuitAnywhere->load($the_username, $the_tenant);
// Tell the framework to load some data from the OAuth store
$IPP->authMode(
QuickBooks_IPP::AUTHMODE_OAUTH,
$the_username,
$creds);
// Print the credentials we're using
//print_r($creds);
// This is our current realm
$realm = $creds['qb_realm'];
// Load the OAuth information from the database
if ($Context = $IPP->context())
{
// Set the DBID
$IPP->dbid($Context, 'something');
// Set the IPP flavor
$IPP->flavor($creds['qb_flavor']);
// Get the base URL if it's QBO
if ($creds['qb_flavor'] == QuickBooks_IPP_IDS::FLAVOR_ONLINE)
{
$IPP->baseURL($IPP->getBaseURL($Context, $realm));
}
print('Base URL is [' . $IPP->baseURL() . ']' . "\n\n");
$CustomerService = new QuickBooks_IPP_Service_Customer();
$Customer = new QuickBooks_IPP_Object_Customer();
$Customer->setName('Willy Wonka #' . mt_Rand(0, 1000));
$Customer->setGivenName('Willy');
$Customer->setFamilyName('Wonka');
$resp = $CustomerService->add($Context, $realm, $Customer);
print_r($Customer);
print('New customer is [' . $resp . ']' . "\n\n");
print("\n\n\n\n");
print('Request [' . $IPP->lastRequest() . ']');
print("\n\n\n\n");
print('Response [' . $IPP->lastResponse() . ']');
print("\n\n\n\n");
}
else
{
die('Unable to load a context...?');
}
Example_ipp_config.phpでキーとユーザー名を設定します
<?php
/**
* Intuit Partner Platform configuration variables
*
* See the scripts that use these variables for more details.
*
* @package QuickBooks
* @subpackage Documentation
*/
// Your OAuth token (Intuit will give you this when you register an Intuit Anywhere app)
$token = 'c640731cb411db4132b8475b4198a7efae08';
// Your OAuth consumer key and secret (Intuit will give you both of these when you register an Intuit app)
//
// IMPORTANT:
// To pass your tech review with Intuit, you'll have to AES encrypt these and
// store them somewhere safe.
//
// The OAuth request/access tokens will be encrypted and stored for you by the
// PHP DevKit IntuitAnywhere classes automatically.
$oauth_consumer_key = 'qyprdzUiOLX60UK4cMwYhg1QVGfOGT';
$oauth_consumer_secret = '32mIB75pqqPreOADcxRvryC0fBduJhnRr52JfUdf';
// This is the URL of your OAuth auth handler page
$this_url = 'http://localhost/quick/docs/example_ipp_oauth.php';
// This is the URL to forward the user to after they have connected to IPP/IDS via OAuth
$that_url = 'http://localhost/quick/docs/example_ipp_ids_6.php';
// This is a database connection string that will be used to store the OAuth credentials
// $dsn = 'pgsql://username:password@hostname/database';
// $dsn = 'mysql://username:password@hostname/database';
$dsn = 'mysql://root:@localhost/quickbooks';
// You should set this to an encryption key specific to your app
$encryption_key = 'abcd1234';
// The user that's logged in
$the_username = '[email protected]';
// The tenant that user is accessing within your own app
$the_tenant = 12345;
// Initialize the database tables for storing OAuth information
if (!QuickBooks_Utilities::initialized($dsn))
{
// Initialize creates the neccessary database schema for queueing up requests and logging
QuickBooks_Utilities::initialize($dsn);
}