この記事では、REST ベースのテーブルを使用して Exact Online 上で明細を含む受注(Sales Order)を作成する方法を説明します。
受注の作成には、スループットが約3倍高く、1日あたりのクォータも桁違いに大きいという理由から、一般的に Exact Online の XML API を使用することが推奨されています。XML API には、UploadXMLTopics または、Excel シートを入力として使用する https://go.invantive.eu/get-my-report を使ってアクセスできます。詳細については、以下の「パフォーマンス」セクションを参照してください。
受注および受注明細を作成する手順
Exact Online には、受注・売上請求書・総勘定元帳の取引など、各トランザクションに少なくとも1つの明細が必要であるという特有の仕様があります。しかし、標準の insert ステートメントではヘッダーのみが作成されます。そのため、ヘッダーと明細を1つのトランザクションとして Exact Online に送信する必要があります。
Invantive SQL には、これを実現するためのトランザクションロジックが用意されています。同じトランザクションロジックは、EDIFACT ファイルを作成する場合など、他のコネクタでも使用されています。
以下の Invantive SQL ステートメントを実行すると、次のような受注が作成されます。
このような受注を作成するには、次の手順を実行します。
- Exact Online の会社(company)を選択します。
use COMPANYNUMBER
- Exact Online との実際の通信内容を確認したい場合は、ネイティブ呼び出しのログ記録を次のように有効にします。
set trace-native-calls true
set log-native-calls-to-disk
- ネイティブ呼び出しは、デフォルトでは
%USERPROFILE%\\invantive\\nativelogフォルダーに記録されます。 - 受注を作成するためのトランザクションを開始します。
begin transaction
- 受注の内容を定義します。
insert into exactonlinerest..salesorders
( orderedby
, description
)
--
-- ランダムな顧客を選択し、受注1件につき1つの
-- トランザクション 'TRANSACTION1' を定義します。
-- 複数の Exact Online 受注を定義・アップロードし、
-- それらを1つの Invantive SQL トランザクションで送信することができます。
--
select act.id
, 'buy some items' description
from exactonlinerest..accounts act
where act.status = 'C'
limit 1
identified by 'TRANSACTION1'
- 受注に10件の受注明細を追加します。それぞれ異なるランダムに選ばれた品目を使用します。
insert into ExactOnlineREST..salesorderlines
( item
, linenumber
)
select itm.id
, row_number()
linenumber
from exactonlinerest..items itm
where itm.IsSalesItem = true
limit 10
attach to 'TRANSACTION1'
- 受注とそれに関連する受注明細を、1回の REST API 呼び出しで Exact Online に渡します。
commit transaction
- コミット後、検証エラーがあれば Exact Online から返されます。
- ログフォルダー内に記録される送信ネイティブ呼び出しは、次のようになります(読みやすさのため改行を追加しています)。
Outbound https://start.exactonline.nl/api/v1/102673/salesorder/SalesOrders Request using POST started at 2020-06-02 16:43:01 (UTC).
Object: ExactOnlineREST.SalesOrder.SalesOrders
Partition: 102673
Data container ID: https://start.exactonline.nl/8045575
User: john.doe@acme.com
{"Description":"buy some items","OrderedBy":"6d0bfbeb-730f-4290-b886-007392d22a0f"
,"SalesOrderLines":
[ {"Item":"1db1fa03-4b2d-4a54-bee2-005edae3934c","LineNumber":21}
,{"Item":"127fba93-64ce-4cb8-bd9c-00653edf0a13","LineNumber":22}
,{"Item":"46dd7805-15ab-4360-a383-008ce7f46811","LineNumber":23}
,{"Item":"0ed58c10-be4d-4cb9-9ffd-0100d261dc3b","LineNumber":24}
,{"Item":"8194860a-4624-4517-a54f-01194fe2f97d","LineNumber":25}
,{"Item":"cd09577e-e541-4e99-a495-020ab56faa78","LineNumber":26}
,{"Item":"65484fc2-c60c-4b3d-8538-021ad2036ee5","LineNumber":27}
,{"Item":"6e65e4cd-130c-4b3c-8f20-0255283e6368","LineNumber":28}
,{"Item":"0d998f82-fc15-48a8-bc6e-0261a89f0645","LineNumber":29}
,{"Item":"8fa70684-cce7-4916-b4fd-028a7c5af6d4","LineNumber":30}
]
}
- Invantive SQL によって解釈された Exact Online からのネイティブ応答は、次のようになります。
Inbound https://start.exactonline.nl/api/v1/102673/salesorder/SalesOrders POST started at 2020-06-02 16:43:01 (UTC).
Object: ExactOnlineREST.SalesOrder.SalesOrders
Partition: 102673
Data container ID: https://start.exactonline.nl/8045575
User: john.doe@acme.com
{
"d" : {
"__metadata": {
"uri": "https://start.exactonline.nl/api/v1/102673/salesorder/SalesOrders(guid'94feaad3-69cc-46ad-9925-d02d2b7f994a')"
, "type": "Exact.Web.Api.Models.SalesOrder"
}
...
, "Created": "\/Date(1591123382670)\/"
, "Creator": "bd0e191e-6fb4-4537-bf91-9f68d4e62744"
, "CreatorFullName": "John Doe"
, "Currency": "EUR"
, "DeliverTo": "6d0bfbeb-730f-4290-b886-007392d22a0f"
, "DeliverToContactPerson": null
, "DeliverToContactPersonFullName": null
, "DeliverToName": " 61602"
, "DeliveryDate": "\/Date(1591056000000)\/"
, "DeliveryStatus": 12
, "DeliveryStatusDescription": "Open"
, "DeliveryAddress": "bb8da22d-fd4f-4f8e-bd96-b0b1de61bd6a"
, "Description": "buy some items"
, "Division": 102673
...
, "InvoiceStatus": 12
, "InvoiceStatusDescription": "Open"
, "InvoiceTo": "6d0bfbeb-730f-4290-b886-007392d22a0f"
...
, "OrderedBy": "6d0bfbeb-730f-4290-b886-007392d22a0f"
...
, "OrderNumber": 42
...
, "Status": 12
, "StatusDescription": "Open"
...
, "SalesOrderLines":
{
"__deferred": {
"uri": "https://start.exactonline.nl/api/v1/102673/salesorder/SalesOrders(guid'94feaad3-69cc-46ad-9925-d02d2b7f994a')/SalesOrderLines"
}
}
}
}
サポートされているテーブル
以下の Exact Online テーブルでは、明細とヘッダーを1つのトランザクションにまとめてトランザクション処理を行うことができます。
ExactOnlineREST.CRM.QuotationsExactOnlineREST.FinancialTransaction.BankEntriesExactOnlineREST.FinancialTransaction.CashEntriesExactOnlineREST.FinancialTransaction.TransactionsExactOnlineREST.GeneralJournalEntry.GeneralJournalEntriesExactOnlineREST.Inventory.StockCountsExactOnlineREST.Inventory.WarehouseTransfers(リリース 20.2.112 以降)ExactOnlineREST.PurchaseEntry.PurchaseEntriesExactOnlineREST.Purchase.PurchaseInvoicesExactOnlineREST.PurchaseOrder.GoodsReceiptsExactOnlineREST.PurchaseOrder.PurchaseOrdersExactOnlineREST.SalesEntry.SalesEntriesExactOnlineREST.SalesInvoice.SalesInvoicesExactOnlineREST.SalesOrder.GoodsDeliveriesExactOnlineREST.SalesOrder.SalesOrdersExactOnlineREST.Subscription.Subscriptions
Exact Online にトランザクションロジックを備えた新しいテーブルが追加されたものの、お使いのリリースがまだそれに対応していない場合は、NativeScalarRequests を使用してこれらの新しいテーブルにアップロードしてください(例については Triggering the new error rate limit active of 10 per app, endpoint, Exact Online division, user and hour を参照)。
Exact Online へのアップロードのパフォーマンス
Exact Online REST API のパフォーマンスには制限があります。過去の計測結果は Does Invantive UniversalSQL match the speed of Infinite Probability Drive? に記載されています。大量データのアップロードには、代わりに Exact Online XML API を使用することが望ましい場合が多くあります。Exact Online XML API を使用した標準的なアップロードは、以下で利用できます。
関連する記事は以下の通りです。
- Mass copy pictures across Exact Online articles
- Upload Journal Entries to Exact Online
- https://forums.invantive.com/t/inlezen-extra-velden-van-exact-online-artikelen/1201(オランダ語)
Invantive SQL の UploadXMLTopics テーブルは、Exact Online API の制限内でアップロードを自動的に扱いやすい単位に分割しますが、Exact Online REST API を使用する場合と比べて大幅に高いスループットを実現します。
