OData SDK for PHP を使ってTaxJar のデータを取得

CData Connect Server を使えば、OData を使ってTaxJar のデータにアクセスできます。CData Connect Server とOData PHP SDK を利用することで、TaxJar のエンティティをPHP で取得して、オブジェクトとしてモデル化できます。

加藤龍彦
デジタルマーケティング
最終更新日：2022-11-25

こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

CData Connect Server はTaxJar のデータをWeb サービスとして公開します。この記事の手順を実行することで、TaxJar のデータをPHP オブジェクトとして扱うことができるようになります。

CData Connect Server はTaxJar のデータへのクラウドベースのOData インターフェースを提供し、ODataPHP SDK からTaxJar のデータへのリアルタイム連携を実現します。

TaxJar の仮想OData API エンドポイントを作成

まずCData Connect Server でデータソースへの接続およびOData API エンドポイント作成を行います。

CData Connect Server にログインして、「DATA MODEL」をクリックします。
利用できるデータソースアイコンから"TaxJar" を選択します。
TaxJar に接続するために必要なプロパティを入力します。
TaxJar API への認証には、まず初めにTaxJar UI からAPI キーを取得する必要があります。

NOTE：API の利用は、Professional およびPremium TaxJar プランでのみ可能です。

すでにProfessional またはPremium プランをお持ちの方は、TaxJar UI にログインして、「アカウント」->「TaxJar API」に移動するとAPI キーを確認することができます。 API キーを取得したら、APIKey 接続プロパティに設定できます。
その他の注意事項
- デフォルトでは、エンティティが日付範囲フィルタをサポートしている場合、CData コネクタは過去3か月のデータを取得します。StartDate を設定して、取得するデータの最小作成日を指定することができます。
- API キーがサンドボックスAPI アカウント用に作成されている場合は、UseSandbox をtrue に設定してください。ただし、すべてのエンドポイントが期待どおりに機能するとは限りません。詳しくは、TaxJar 開発者用ドキュメントを参照してください。
「Test Connection」をクリックします。
「USERS」 -> Add をクリックして、新しいユーザーを追加し、適切な権限を指定します。
API タブをクリックして OData API エンドポイントが生成されていることを確認します。

コネクションとOData エンドポイントを設定したら、PHP からTaxJar のデータに接続できます。

まずは、ODataPHP SDK を使用してCData Connect Server が公開したWeb サービスに接続するプロキシクラスを作成します。

URI 部分を書き換えて、次のようなコマンドを実行してください。
php C:\PHPLib\ODataphp\PHPDataSvcUtil.php /uri=https://your-server:8032/api.rsc/@your-authtoken/ /out=C:\PHPLib\ODataphp\TaxJarEntities.php
このコマンドは、OData エンドポイントが返すメタデータからクラスを定義して、指定したフォルダにクラスの定義を出力します。

CData Connect Server およびOData SDK for PHP は、どちらもフォームとWindows 認証をサポートします。CData Connect Server はOData エンドポイントへのアクセスが認可されたユーザーの認証に、認証トークンを使用します。認証トークンはHTTP Basic 認証の際に渡したり、OData URL に付加することで使用できます。

認証済みのユーザーは、CData Connect Server の管理コンソールのUsers セクションで設定できます。
これで、PHP のオブジェクト指向インターフェースを使ってTaxJar のデータにアクセスできます。以下のコードはOrders テーブルのレコードを作成してリアルタイムデータを取得し、新しく作成したレコードを表示します。
require_once 'TaxJarEntities.php'; try{ $svc = new CDataAPI(); $orders = new Orders(); $orders->TransactionID = '123'; $svc->AddToOrders($orders); $svc->SetSaveChangesOptions(SaveChangesOptions::None); $svc->SaveChanges(); $response = $svc->orders()->Execute(); foreach($response->Result as $orders) echo $orders->TransactionID." "; } catch (Exception $e) { //CData Connect Server からのエラーをキャッチ echo $e->getError(), "\n"; }

トライアル・お問い合わせ

30日間無償トライアルで、CData のリアルタイムデータ連携をフルにお試しいただけます。記事や製品についてのご質問があればお気軽にお問い合わせください。

無償トライアルへ

お問い合わせ

ソリューション

サポート

ブログへ →

ナレッジベース

製品をチェック

お困りの点はございませんか？

OData SDK for PHP を使ってTaxJar のデータを取得

CData Connect Server を使えば、OData を使ってTaxJar のデータにアクセスできます。CData Connect Server とOData PHP SDK を利用することで、TaxJar のエンティティをPHP で取得して、オブジェクトとしてモデル化できます。

TaxJar の仮想OData API エンドポイントを作成

その他の注意事項

トライアル・お問い合わせ