使用 php 更新 quickbooks 发票

Question

我们需要使用 PHP (CakePHP 1.3) 在线更新快速手册中的单个发票。我环顾四周，唯一能找到的是“keith palmer php api”，对于我们想要完成的简单性质来说，这似乎有点过头了。

有人做到了吗？我不认为只需要对快速手册执行简单的 curl 即可更新发票吗？请指教。

Answer 1

有人做到了吗？

是的！很多人！

我不认为只需要对快速手册执行简单的 curl 即可更新发票吗？

不幸的是，它确实需要更多的东西。

出于 3 个主要原因，它需要更多：

1. Intuit 要求您通过 OAuth 对 QuickBooks Online 进行身份验证（只需一次）。 Curl 没有内置的 OAuth 支持，因此您需要使用某种库或代码来签署您的 OAuth 请求。 OAuth 不是一种微不足道的协议/签名机制。

2. 要更新 QuickBooks Online 中的对象，您必须向 Intuit 发送最新的 SyncToken 值。最新的SyncToken 值只能通过 API 首先查询 QuickBooks 中的发票获取。即要进行更新，您也必须首先能够查询。

3. Intuit 要求您注册一个“应用程序”以连接到 QuickBooks Online。这提供了设置步骤并需要 OAuth 流的信息。

话虽如此，使用这个库：

• https://github.com/consolibyte/quickbooks-php

真的不是很困难。

只需按照快速入门指南进行操作：

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

并查看进行发票更新的示例：

• https://github.com/consolibyte/quickbooks-php/blob/master/docs/partner_platform/example_app_ipp_v3/example_invoice_update.php

看起来像这样：

    $InvoiceService = new QuickBooks_IPP_Service_Invoice();

    // Get the existing invoice first (you need the latest SyncToken value)
    $invoices = $InvoiceService->query($Context, $realm, "SELECT * FROM Invoice WHERE Id = '34' ");
    $Invoice = $invoices[0];

    print_r($Invoice);

    $Invoice->setTxnDate(date('Y-m-d'));  // Update the invoice date to today's date 

    if ($resp = $InvoiceService->update($Context, $realm, $Invoice->getId(), $Invoice))
    {
        print('&nbsp; Updated!<br>');
    }

Answer 2

您可以参考以下步骤使用 IPP 的官方 PHP sdk 与 QBO V3 REST API 进行通信。

要开始使用 QB API 进行开发，您需要在 Intuit 的 appcenter 中创建一个 IA 应用程序。

• https://developer.intuit.com/docs/0025_quickbooksapi/0010_getting_started/0010_signup

从上面的链接你会得到 - apptoken、consumer key 和 consumer Secret。您可以在 IPPOAuthPlayground（PFB 链接）中使用上述 3 个密钥来获取与您的 QB Online 帐户对应的访问令牌和访问密钥。

• https://appcenter.intuit.com/Playground/OAuth

使用上述令牌，您可以针对您的 QB Online 帐户调用任何 REST 端点。

PHP 开发工具包在这里可用。

• https://developer.intuit.com/docs/0025_quickbooksapi/0055_devkits

PHP 开发包用户指南

• https://developer.intuit.com/docs/0025_quickbooksapi/0055_devkits/0210_ipp_php_sdk_for_quickbooks_v3/0002_synchronous_calls/0001_data_service_apis

Answer 3

完成！在 CakePHP 1.3 中，我们将 Keith Palmers API 放在了 webroot 目录中。一旦获得授权，我们就会在支付控制器中添加以下功能。

    function updateQBInvoice($invoiceNumber = null, $depositAmount = null) {            
        include(APP."webroot".DS."quickbooks-php".DS."docs".DS."example_app_ipp_v3".DS."config.php");
        $IPP = new QuickBooks_IPP($dsn);
        $creds = $IntuitAnywhere->load($the_username, $the_tenant);
        $IPP->authMode(QuickBooks_IPP::AUTHMODE_OAUTH, $the_username, $creds);  
        $realm = $creds['qb_realm'];

        if ($Context = $IPP->context()) {
            $IPP->version(QuickBooks_IPP_IDS::VERSION_3);
            $InvoiceService = new QuickBooks_IPP_Service_Invoice();
            $invoices = $InvoiceService->query($Context, $realm, "SELECT * FROM Invoice");

            foreach ($invoices as $Invoice) {
                $docNumber = $Invoice->getDocNumber();
                if ($docNumber == $invoiceNumber) {

                    /* Set the invoice as paid. */
                    $Invoice->setDeposit($depositAmount);

                    if ($resp = $InvoiceService->update($Context, $realm, $Invoice->getId(), $Invoice)) {
                        echo '&nbsp; Updated!<br>';
                    } else {
                        echo '&nbsp; ' . $InvoiceService->lastError() . '<br>';
                    }
                }
            }               
        } else {
            echo 'Unable to load a context...?';
        }
    }

我想有更好的方法来获取发票，但我还没有发现。我尝试将查询调整为“SELECT * FROM Invoices WHERE DocNumber=XXX”，但这不起作用。

感谢大家的帮助，谢谢！

Answer 4

@基思

请求：

   [GET https://quickbooks.api.intuit.com/v3/company/210896252/query?query=SELECT+%2A+FROM+Invoice+WHERE+DocNumber%3D2060 HTTP/1.1
    Content-Type: text/plain
    Authorization: OAuth realm="", oauth_signature_method="HMAC-SHA1", oauth_signature="xxx",  oauth_nonce="gZxqN", oauth_timestamp="1400779429", oauth_token="xxx", oauth_consumer_key="xxx", oauth_version="1.0"

    ]

回复：

[HTTP/1.1 200 OK
Date: Thu, 22 May 2014 17:23:49 GMT
intuit_tid: 6f7b9023-3c8e-401c-9028-711300475720
Content-Length: 327
Via: 1.1 ipp-gateway-.net
Content-Type: application/xml;charset=UTF-8
Content-Encoding: gzip
QBO-Version: 73.223
Cache-Control: max-age=0, no-cache, no-store, must-revalidate, private
Expires: 0

<?xml version="1.0" encoding="UTF-8" standalone="yes"?><IntuitResponse xmlns="http://schema.intuit.com/finance/v3" time="2014-05-22T10:23:50.031-07:00"><Fault type="ValidationFault"><Error code="4000"><Message>Error parsing query</Message><Detail>QueryParserError: Encountered &quot; &lt;INTEGER&gt; &quot;2060 &quot;&quot; at line 1, column 39.
Was expecting one of:
    &quot;false&quot; ...
    &quot;true&quot; ...
    </Detail></Error></Fault></IntuitResponse>]