Интеграция API QuickBooks API (php)

Это будет двухчастный ответ, потому что вы не указали, используете ли вы QuickBooks ONLINE или QuickBooks для WINDOWS.

Процесс будет РАЗЛИЧНЫМ, в зависимости от того, что вы используете, поэтому обратите внимание на жирные заголовки ниже:

Для QuickBooks ONLINE:

Если вы используете QuickBooks с открытым исходным кодом PHP DevKit от GitHub, то лучшим местом для начала является QuickBooks Online с руководством по быстрому запуску PHP .

• http://www.consolibyte.com/docs/index.php/PHP_DevKit_for_QuickBooks_-_Intuit_Partner_Platform_Quick-Start

Самое первое, что вам нужно сделать, это зарегистрировать свое приложение с 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:

• QuickBooks Online – добавьте клиента с PHP
• QuickBooks Online – добавьте счет с PHP

Код заканчивается тем, что выглядит примерно так:

$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, поэтому вы хотите посмотреть на это.

Для QuickBooks для WINDOWS:

Для QuickBooks для Windows вы будете использовать веб-коннектор. Опять же, начните с открытого исходного кода QuickBooks PHP DevKit от GitHub. Вместо этого используйте QuickBooks для Windows + PHP .

Это поможет вам создать простой сервис Web Connector, который добавит тестовых клиентов в QuickBooks.

В основном вы создадите файл .QWC, который вы загрузите в веб-коннектор QuickBooks («Пуск»> «Все программы»> «QuickBooks»> «Веб-коннектор»). Этот файл .QWC укажет на скрипт PHP, который согласовывает соединение между QuickBooks и PHP . Все, что вам нужно сделать в этом примере скрипта, – это замена этой переменной:

• $ dsn (укажите его в свою собственную базу данных)

Для каждой новой функциональности, которую вы хотите добавить, вы в конечном итоге напишите новую функцию запроса и ответа, как описано в документах QuickBooks Web Connector + PHP .

Ваш код будет выглядеть примерно так:

 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>Keith@ConsoliBYTE.com</Email> <Contact>Keith Palmer</Contact> </CustomerAdd> </CustomerAddRq> </QBXMLMsgsRq> </QBXML>'; return $xml; } 

Вы можете найти дополнительную ссылку на qbXML, используя QuickBooks OSR .

Мы также предоставляем wiki с большим количеством примеров qbXML-запросов, которые вы можете использовать.

Из SDK используйте example_ipp_ids_6.php для добавления клиентов.

Вот ссылка на полный код GitHub:

• GitHub – с открытым исходным кодом QuickBooks PHP DevKit

И руководство по быстрому запуску:

• QuickBooks ONLINE быстрый запуск с PHP

• QuickBooks для быстрого запуска WINDOWS с PHP

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 = 'test@gmail.com'; // 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); }