【ITニュース解説】Managing Custom Invoice Hold for Partial PO Invoicing in Oracle Fusion Payables Using REST APIs
2026年10月19日に「Dev.to」が公開したITニュース「Managing Custom Invoice Hold for Partial PO Invoicing in Oracle Fusion Payables Using REST APIs」について初心者にもわかりやすく解説しています。
ITニュース概要
Oracle Fusion Payablesで、受入未満の請求は標準で保留されない。REST APIで請求書と受入数量を比較し、カスタム保留を自動適用することで、企業独自の支払い制御を実現する。
ITニュース解説
多くの企業では、仕入先からの請求書が正しいかどうかを確認する作業が非常に重要である。この確認作業の一つが「発注書(PO)マッチング」と呼ばれるもので、事前に発行した発注書の内容と、実際に受け取った物品やサービスの記録、そして仕入先からの請求書の内容を照合することだ。Oracle Fusion Cloud Payablesというシステムは、このような請求書処理を効率的に行うための機能を提供している。
しかし、システムが標準で提供する機能だけでは、すべての企業の特定の業務要件に対応できるわけではない。例えば、システムでは通常、請求書に記載された数量が、発注した数量や受領した数量を超えていないかを確認する。もし請求数量が受領数量より少ない場合、多くの場合システムはそれを問題ない取引として認識し、自動的に支払いの手続きを進める。
今回のケースで考えてみるのは、次のような状況である。ある発注書で10個の品物を注文し、実際にその10個すべてを受け取ったとする。ところが、仕入先から届いた請求書には、なぜかそのうちの4個分しか記載されていなかった。Oracleの標準的なマッチングルールからすると、請求数量が受領数量を超えていないので、この請求書は特に問題なく処理されるはずだ。しかし、とある企業では「発注書に記載された全量がすでに受領されている場合、それよりも少ない数量で請求された請求書は、支払う前に必ず内容を詳しく確認するべきだ」という独自のルールを持っているかもしれない。このような場合、システムが自動的にこの請求書を「保留(Hold)」の状態にし、担当者が確認するまで支払いを停止する仕組みが必要となる。今回の解説では、このような特別な要件を、Oracle Fusion Payablesの標準機能を変更することなく、どのように実現できるかを説明していく。
このビジネス要件を具体的に見てみよう。発注数量が10個、受領数量も10個、そして請求数量が4個という状況である。受領は全量完了しているにもかかわらず、請求書は一部の数量で作成されている。企業はこの数量の差をシステムが検知し、自動的に「カスタムホールド」を適用することを望む。このホールドが適用されている間は、請求書は支払いの対象から外され、担当者がその差異をレビューし、問題がないと判断してホールドを解除するまで支払いが行われない。なぜこのような追加の制御が必要なのかというと、標準機能では部分的な請求書の発行は認められているため、今回のように受領数量より少ない数量で請求されても、通常は例外として扱われないからである。つまり、標準の請求書マッチング機能を置き換えるのではなく、企業の特定の請求ポリシーに基づいて追加の検証を導入することが目的となる。
Oracle Fusion Payablesには「ツーウェイマッチング」「スリーウェイマッチング」「フォーウェイマッチング」といった複数のマッチングオプションがある。例えばスリーウェイマッチングでは、請求書の内容が発注書と受領情報に対して検証される。標準的な数量マッチングは、主に請求された数量が発注または受領された許可数量を超える場合に適用される。しかし、今回の例では、受領数量が10、請求数量が4であり、請求数量は受領数量よりも少ない。そのため、この差異だけでは標準的な数量マッチングによる保留は通常適用されない。しかし、カスタム要件では「請求数量が適用可能な受領数量より少ない場合、その取引を特定し、請求書をレビューのために保留する」必要がある。この条件は、システム間連携技術である「REST API」を活用したカスタムな方法で評価される。REST APIとは、インターネットを介して異なるソフトウェアやシステムが情報をやり取りするためのルールや手順のことで、これにより外部のプログラムからOracleのシステム内のデータにアクセスしたり、操作したりすることが可能となる。
この課題を解決するための全体的なアプローチは、Oracle Fusion Procurement(発注管理)、Receiving(受領管理)、Payables(買掛金管理)、そしてREST APIを連携させることである。REST APIを活用したシステム間連携の仕組みが、必要な情報を取得し、比較を行い、最終的に設定された請求書保留を適用する役割を担う。
それでは、具体的な手順を追って説明していく。まず最初に、Oracle Fusion Procurementで発注書を作成する。ここでは、数量10個の品物に対する発注書を作成する。この発注書は承認されると、受領処理が可能になる。次に、この発注書に対して受領処理を実行する。シナリオ通り、注文した10個すべてを受領したと記録する。この受領処理が完了していることが、後で請求数量と比較する上で非常に重要となる。
受領処理が完了したら、Oracle Fusion Payablesに移動し、仕入先からの請求書を作成する。ここで重要なのは、発注書では10個受領済みとなっているにもかかわらず、請求書には4個分の数量しか入力しないことである。請求書の作成とマッチングが完了した時点で、請求書は受領数量よりも少ない数量でマッチされた状態となる。この段階では、標準のマッチングルールによって数量の保留がかかることはない。ここで、私たちが導入するカスタムな検証が機能する出番となる。
次に、このカスタムなビジネス要件のために、Oracle Fusion Payables内に独自の請求書保留を設定する必要がある。これは「設定とメンテナンス」メニューから「請求書保留と解除の管理」で行う。例えば「部分PO請求数量保留」といった名前で保留を定義する。この保留は、請求書に記載されたマッチング数量が受領数量よりも少ない場合に、追加のレビューが必要な請求書を識別するために使われる。ただし、この保留名を定義しただけでは、システムが自動的に数量の差異を評価し、保留を適用するわけではない。その作業は、これから説明するカスタムのシステム間連携(REST API)が行う。
請求書が作成されたら、私たちのシステム間連携は、その請求書に関する関連情報を取得する必要がある。Oracle Fusion Cloud Financialsは、Payablesの請求書データにアクセスするためのREST APIを提供している。今回の連携では、指定された請求書から「請求書識別子」「請求書番号」「発注書参照」「発注書明細参照」「マッチした請求数量」といった情報を取り出す。特に、マッチした請求数量が4単位であることを取得する。
同時に、この連携は、発注書に関連する受領情報を取得する必要がある。具体的には、発注書参照と、それに対応する受領済み数量(今回の例では10単位)である。請求書数量と受領数量が、同じ発注書の同じ明細に属していることを確認することが重要だ。これにより、正しい比較が行われる。
請求書数量(4)と受領数量(10)の両方が取得できたら、連携システムはこれらの数量を比較するカスタムな検証を実行する。検証条件は非常にシンプルで、「もし請求数量が受領数量より少ないならば、その請求書をカスタムホールドの対象とする。そうでなければ、カスタムホールドは不要」というものである。今回の例では、4は10よりも少ないため、この条件が満たされ、請求書はカスタムホールドの対象として識別される。この検証は、Oracle標準のマッチング動作ではなく、ビジネスの特定の要件に基づいている。実際の運用では、現在の請求書だけでなく、関連するすべての請求書の累積数量で比較するかどうかも検討する必要があるだろう。
検証の結果、保留が必要と判断された場合、Oracle Fusion Cloud Financialsが提供するInvoice Holds RESTリソースを使って、請求書に保留を適用する。これは、REST APIを通じて「INVOICE_101」という請求書に対して、事前に定義した「部分PO請求数量保留」という名前のホールドを適用する操作である。この処理を行う前に、同じホールドがすでに請求書に適用されていないかを確認することで、重複してホールドが作成されるのを防ぐ。REST APIによるリクエストが成功すれば、請求書にホールドが適用されたことを確認できる。
REST APIでホールドを適用した後、Oracle Fusion Payablesの画面に戻り、請求書を確認すると、その請求書にカスタムホールドが適用されていることが確認できる。このホールドがアクティブな間は、請求書は支払いの処理から制限される。ただし、手動で適用される請求書保留は、それ自体ではユーザーが請求書を編集したり、同じ発注書に対して別の請求書を作成したりすることを妨げるものではない。もしそのような制限も必要であれば、別途対応を検討する必要がある。
最後に、適用された請求書保留をどのように解除するかを設計することも重要だ。保留は、数量の差異が担当者によってレビューされ、必要なビジネス上の対応(例えば、仕入先が残りの数量を請求したり、既存の請求書が修正されたり)が完了するまでアクティブなままにするべきだ。受領や請求を追加したからといって、手動で適用されたホールドが自動的に解除されるわけではないため、解除プロセスは明確に設計し、テストする必要がある。保留は、権限のあるユーザーが手動で解除することもできるし、サポートされているREST APIの機能を通じて解除することも可能だ。
この解決策を本番環境で実際に導入する際には、いくつかの追加の考慮事項がある。例えば、発注書に複数の明細がある場合、比較は発注書ヘッダー全体の合計ではなく、適切な発注書明細レベルで行うべきだ。また、一つの発注書明細が複数の受領処理を経て受領されることもあるため、返品や修正を考慮した実質の受領数量を計算する必要がある。仕入先が同じ発注書に対して複数の請求書を提出する可能性もあるため、保留の適用を現在の請求書数量に基づいて行うのか、それとも累積的な請求数量に基づいて行うのかを決定する必要がある。既に説明したように、重複してホールドが適用されることを防ぐためのチェックも不可欠だ。さらに、REST APIによる検証を実行するタイミングも重要であり、検証とホールドの適用が完了する前に請求書が支払われてしまうことがないようにする必要がある。そして、ホールドの解除プロセスは文書化され、適切なユーザーや連携プロセスに限定されるべきである。
今回のシナリオから得られる主な学びは、Oracle Fusion Payablesが一般的に部分的な請求書発行をサポートしており、標準のマッチング機能だけでは請求数量が受領数量より少ない場合に保留を適用しないということである。しかし、カスタムの請求書保留を設定し、REST APIを利用することで、請求書情報を取得し、数量を比較し、定義されたホールドを適用するという追加のビジネスレビュー要件をサポートできる。カスタム検証は、適切な発注書マッチング参照を使用し、ホールドの作成、重複防止、および解除は、全体的なシステム間連携設計の一部として考慮する必要がある。また、手動で適用される請求書保留は支払いを制限するが、追加の請求書入力や編集を自動的に防ぐものではない。
このように、Oracleの標準的な発注書と請求書のマッチングプロセスを変更することなく、企業の特定の財務管理要件を満たすために、カスタムホールドとREST APIを組み合わせたアプローチは非常に有効である。これにより、標準機能の限界を超える柔軟な制御が可能となる。