使用 Xero API - Private App 获取发票数据

Question

我正在尝试建立一个在线表格，用户可以输入他们的发票号码，然后网络服务器将与 Xero API 交互以获取发票详细信息并填充一些额外的付款字段。

我已经构建并准备好表单逻辑，但是我不知道如何开始使用 Xero API。

我已经创建了一个私人应用程序并拥有所需的密钥，但我找不到任何关于如何在 PHP 中实际设置 API 调用的文档。

如有任何帮助，我们将不胜感激。

**** 更新 ****

我能够使用以下方法让 API 工作：

function GetInvData ($InvNumber) {

    try {
        $config = [
            'oauth' => [
                'consumer_key' => 'REDACTED',
                'rsa_private_key' => 'REDACTED',
            ],
        ];

        $xero = new PrivateApplication($config);
        //$invoice =  $xero->load(\XeroPHP\Models\Accounting\Invoice::class)->where('InvoiceNumber',$InvNumber)->execute();
        $invoice =  $xero->load('Accounting\Invoice')
                    ->where('InvoiceNumber',$InvNumber)
                    ->execute();

    }
    catch(\Exception $ex) {
        var_dump($ex);
    }

    return ($invoice);
}

然而，返回的是我见过的最复杂的 JSON ......可能不会说太多。

我只需要能够提取发票金额、客户姓名和他们的电子邮件地址，有人可以帮忙吗？

Answer 1

你几乎是在问如何做人们不喜欢这里的整个事情。很好地完成了 API 调用，您可能需要一段时间才能完全理解每一行的内容，但这不是必需的。

既然你已经完成了那部分，你只需要处理 Xero 返回给你的数据，而不是 xero-php（你正在使用的库）给你的数据背部。您发布的内容不是 JSON，它只是数据的转储（文本表示），因为它作为对象存在于您的代码中。

该对象是发票集合，但在您的情况下它只是一张单数发票。它总是 return 一个集合，即使您有非常具体的搜索查询，但您可以随时检查一下以确保集合只有一张发票，如果您只期望一张发票。

所以，对于您真正想要的（发票金额、客户姓名和他们的电子邮件地址），下面是代码行。

发票金额：

$invoice->Invoices[0]->Total;

客户姓名：

$invoice->Invoices[0]->Contact->Name;

电子邮件地址：

$invoice->Invoices[0]->Contact->EmailAddress;

Invoices[0] 用于获取集合中的第一个 Invoice，因此假定只有一个。希望这能为您指明正确的方向。

Answer 2

最终让它与以下内容一起工作：

function GetInvData ($InvNumber) {
global $xero;
$return = array('AmountDue' => null, 'Customer' => null, 'EmailAddress' => null);

try {
    //throw new Exception("Test");
    $invoices =  $xero->load(Accounting\Invoice::class)
                     ->where('InvoiceNumber',$InvNumber)
                     ->where('Status', 'AUTHORISED')
                     ->execute();

    $invoice = $invoices->first();

    if(empty($invoice)){
        $return = '';
    }
    else {                      
        $invoiceCount = count($invoice);
        if($invoiceCount > 1) {
            throw new \Exception("Managed to find [" . $invoiceCount . "] with Invoice ID [" . $InvNumber . "]. Expected this to be unique.");
        }
        $contact = $invoice->getContact();
        $return['AmountDue'] = $invoice->getAmountDue();
        $return['Customer'] = $contact->getName();
        $return['EmailAddress'] = $contact->getEmailAddress();  
    }   
}

catch(\Exception $ex) {
    $return = LogException($ex);
}

return $return;
}

感谢大家的帮助。

使用 Xero API - Private App 获取发票数据

Get invoice data with Xero API - Private App

php

xero-api