契約および請求書の実績搬送日の使用
実績搬送日を契約開始日または顧客の請求書として使用します。
顧客が購入した品目を受け取るまで顧客に請求できないという契約があるとします。 「実績搬送日(出荷)」属性を使用して、出荷の搬送日を取得し、それを使用して販売オーダーを請求に移動できます。
販売オーダーには次の属性があります:
- 実際の配送日(出荷)。 この日付はOracle Shippingから取得されます。
- 「実際の配送日(Oracle Transportation Management)」。 この日付はOracle Transportation Managementから取得されます。
出荷および出荷と搬送が同時に発生することを確認する場合、または搬送のリード・タイムがあることを確認した後、この日付を出荷で取得できます。
AS54888 Desktop Computerとコンピュータの保証を、Computer Service and Rentalsの顧客の販売オーダーに追加する必要があるとします。 お客様がコンピュータを受け取るまで、保証を開始する必要はありません。 オーケストレーションは、コンピュータの実績搬送日が使用可能になるまで一時停止し、その搬送日を使用して保証の補償範囲日を調整してから、Order Management作業領域に補償範囲日を表示します。
試す:
- 「カバレッジ開始日」オーダー管理パラメータを「搬送日」に設定します。
- オーケストレーション・プロセスに一時停止ステップを追加します。
- 「オーダー管理」作業領域に移動し、販売オーダーを作成し、次のオーダー明細を追加して、オーダーを発行します:
明細 品目 1 AS54888デスクトップ・コンピュータ 2 延長保証 - 履行ビューに移動し、履行明細を表示します。
履行明細 品目 ステータス 契約開始日 契約終了日 実際の配送日(出荷) 実際の配送日(Oracle Transportation Management) 1-1 AS54888デスクトップ・コンピュータ ePODを待機中 - - - - 1-1-1 延長保証 ePODを待機中 10/24/24 10/23/26 - - 「Shipping」属性が空であることを確認します。
- 「Inventory Management」作業領域に移動し、「タスク」>「タスクの表示」>「出荷」>「出荷の管理」をクリックします。
- 販売オーダーの出荷を検索して開きます。 検索時に、「顧客」属性を「Computer Service and Rentals」に設定します。
- 「出荷の編集」ページで、明細の出荷を確認します。 確認時にこの値を設定します:
属性 値 実績搬送日 10/26/24 - 「オーダー管理」作業領域の履行ビューに戻り、履行明細を表示します:
履行明細 品目 ステータス 契約開始日 契約終了日 実際の配送日(出荷) 実際の配送日(Oracle Transportation Management) 1-1 AS54888デスクトップ・コンピュータ 請求待機中 - - 10/26/24 - 1-1-1 延長保証 請求待機中 10/26/24 10/25/26 - -
ノート
- 実際の配送日(出荷)属性に、「出荷の編集」ページの値が含まれるようになりました。
- Order Managementでは、10/26/24実績搬送日に従って、契約開始日と契約終了日が更新されました。 出荷から日付を取得するようにオーケストレーション・プロセスを設定したため、実績搬送日(Oracle Transportation Management)属性に値がありません。
- PODは「配達証明」を意味します。
契約の開始日を搬送日に設定
契約の開始日を実際の配送日に設定する必要がある場合は、「カバレッジ開始日」オーダー管理パラメータを「配送日」に設定します。 バックグラウンドについては、「販売オーダーの補償範囲の設定」を参照してください。
顧客が出荷を受領した後に補償範囲を開始
一時停止ルールを設定して、オーケストレーション・プロセスが出荷から実際の搬送日を受け取るまで待機するようにできます。 これは、顧客が出荷を受け取った後にのみカバレッジを開始する場合、または請求書に実際の搬送日が必要な場合などに、オーケストレーション・プロセスを請求書ステップに移動する前に搬送日が必要な場合に行います。
- オーケストレーション・プロセスを編集のために開いてから、「出荷通知の待機」ステップの直後に一時停止ステップを追加します。 たとえば:
ステップ ステップ名 タスク サービス 10 出荷リクエストの作成 出荷 出荷の作成 20 出荷通知の待機 出荷 出荷の待機 30 PODの待機 PODに対して一時停止 一時停止プロセス - 「PODの待機」ステップで「ルールのクリック」をクリックし、次のルールを追加します:
IF Hdr is a DooSeededOrchestrationRules.DOOHeader and fline is a DooSeededOrchestrationRules.DOOFLine and hdr.childFLines RL.contains fline and fline.actualDeliveryDate is null THEN assign new DooSeededOrchestrationRules.SacResult sac = new DooSeededOrchestrationRules.SacResult() assign hdr.sacResult = sac assign hdr.sacResult.sacType = DooSeededOrchestrationRules.SacResult.SAC_TYPE_EVENT assign hdr.sacResult.eventName = DooSeededOrchestrationRules.SacResult.SAC_SYSTEM_EVENT_POD_PAUSE
日付の取得元:
- 出荷
fline.actualDeliveryDate is null
を使用します。 - Transportation Management。
fline.transportationPlannedFlag isn't D
を使用します。詳細は、「Order ManagementとTransportation Managementの統合のガイドライン」の配信確認の取得サブトピックを参照してください。
fline.actualDeliveryDate
がnull
の場合、出荷タスク・タイプが出荷から実績搬送日を受信していないことを意味し、Order Managementはオーケストレーションを一時停止します。 一時停止は、タスク・タイプが日付を受け取るまで続行され、fline.actualDeliveryDateはNULLではなくなり、フローはオーケストレーション・プロセスの次のステップに移動します。
リリース
eventTypeをSAC_TYPE_EVENTに設定し、eventNameをSAC_SYSTEM_EVENT_POD_PAUSEに設定した場合、Order Managementは、出荷またはTransportation Managementから実際の配送日を受け取ると、一時停止を自動的にリリースします。 PODは「配達証明」を意味します。
fline.actualDeliveryDate is null
を使用するが、実際の配送日がTransportation Managementから取得された場合、Order Managementは一時停止をリリースします。
fline.transportationPlannedFlag isn't D
を使用するが、実際の配送日は「出荷」から取得し、「実際の配送日(出荷)」属性で配送を取得する場合:
- 「出荷確認時」。 Order Managementでは、一時停止は解除されません。 Transportation Managementが搬送日を送信すると、Order Managementはそれを「実績搬送日」(Oracle Transportation Management)属性に格納し、一時停止を解除します。
- 「出荷確認後」。 Order Managementにより一時停止が解除されます。
バックグラウンドについては、「オーケストレーション・プロセスの一時停止の概要」を参照してください。
REST APIを使用したインポート
curl: https://xxxx.fusionapps.ocs.oc-test.com/fscmRestApi/resources/11.13.18.05/salesOrdersForOrderHub/action/updateActualDeliveryDate
{
"processRequestOfflineAfter": 1,
"integrationContextCode": "ORA_UPDATE_ACTUAL_DEL_DATE",
"updateActualDeliveryDateRequest": [
{
"FulfillLineIdentifier": "300100649702721",
"ActualDeliveryDate": "2024-11-24T18:00:00+00:00",
"DeliveryName": "2729631"
},
{
"FulfillLineIdentifier": "300100649702986",
"ActualDeliveryDate": "2024-11-18T18:00:00+00:00",
"DeliveryName": "2729633"
}
]
}
integrationContextCode属性をORA_UPDATE_ACTUAL_DEL_DATEに設定する必要があります。
この例では、Oracle Transportation Managementから日付を取得します:
curl: https://xxxx.fusionapps.ocs.oc-test.com/fscmRestApi/resources/11.13.18.05/salesOrdersForOrderHub/action/updateActualDeliveryDate
{
"processRequestOfflineAfter": 1,
"integrationContextCode": "ORA_OTM_UPD_ACTUAL_DEL_DATE",
"updateActualDeliveryDateRequest": [
{
"FulfillLineIdentifier": "300100649702721",
"ActualDeliveryDate": "2024-11-24T18:00:00+00:00",
"DeliveryName": "2729634"
},
{
"FulfillLineIdentifier": "300100649702987",
"ActualDeliveryDate": "2024-11-18T18:00:00+00:00",
"DeliveryName": "2729635"
}
]
}
ノート
- 実績搬送日の更新(FOM_SALES_ORDER_REST_UPDATE_ACTUAL_DELIVERY_DATE_PRIV)権限が必要です。
- integrationContextCode属性をORA_OTM_UPD_ACTUAL_DEL_DATEに設定する必要があります。
- 出荷には日付の搬送番号が必要です。
Webサービスを介したインポート
REST APIを使用してOracle Transportation Managementから日付を取得することをお薦めしますが、オーダー履行レスポンス・サービスwebサービスを使用することもできます:
- オーケストレーション・プロセスの出荷ステップの後に一時停止ステップを追加します。 一時停止すると、オーダー明細が一時停止され、Order Managementでクローズできなくなります。
- DOO_TransportationPlanningタスク・タイプおよびこのペイロードを使用して、オーダー履行レスポンス・サービスをコールします:
<soapenv:Envelope xmlns:com="http://xmlns.oracle.com/apps/scm/doo/taskLayer/commonService/" xmlns:mod="http://xmlns.oracle.com/apps/scm/doo/processOrder/model/" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:typ="http://xmlns.oracle.com/apps/scm/doo/taskLayer/commonService/types/"> <soapenv:Header></soapenv:Header> <soapenv:Body> <typ:processFulfillmentResponse> <typ:responseMessageHeader> <com:IntegrationContextCode>Pause</com:IntegrationContextCode> <com:FulfillmentSystemResponseIdentifier></com:FulfillmentSystemResponseIdentifier> <com:FulfillmentSystem>OPS</com:FulfillmentSystem> </typ:responseMessageHeader> <typ:fulfillLineList> <com:FulfillLineIdentifier></com:FulfillLineIdentifier> <com:TaskInstanceStatusCode>WAITING</com:TaskInstanceStatusCode> <com:FulfillmentDetail> <com:TaskTypeCode>DOO_TransportationPlanning</com:TaskTypeCode> <com:ActualDeliveryDate></com:ActualDeliveryDate> </com:FulfillmentDetail> </typ:fulfillLineList> </typ:processFulfillmentResponse> </soapenv:Body> </soapenv:Envelope>
ガイドライン
オーケストレーション・プロセスの場合:
- 「計画タスクがあります」。 Oracle Transportation Managementを使用することをお薦めします。
- 「プランニング・タスクがありません」。 海運を利用することをおすすめします。
実際の配送日の取得
オーケストレーション・プロセスで次が指定されている場合:
- 出荷 「出荷の編集」ページまたはREST APIから日付を取得する必要があります。
- Transportation Management。 REST APIまたはオーダー履行レスポンス・サービスから日付を取得する必要があります。
出荷の確認中または確認後に、オーケストレーション・プロセスが一時停止中、請求待ちまたはクローズ済ステップ中に、出荷から日付を取得できます。 ただし、日付をOracle Receivablesに送信する必要がある場合、または日付を使用して契約開始日または契約終了日を更新する必要がある場合は、オーケストレーション・プロセスが「PODの一時停止」タスクにある間に実行します。
この日付は、出荷可能な構成品目にのみ使用できます。 Order Managementでは、オプション区分などの出荷不可の親の日付が表示されますが、その日付は格納されません。 品目に複数の構成部品があり、それぞれに異なる実績搬送日がある場合、Order Managementでは親の最終日が表示されます。 たとえば、コンポーネントxの日付が4月1日で、コンポーネントyの日付が5月1日の場合、Order Managementでは親の5月1日が表示されます。
タスク・タイプの参照
Order Managementでは、出荷を使用するかTransportation Managementを使用するかに応じて、搬送日が格納されるときに異なるタスク・タイプが使用されます。 たとえば:
オーダー番号 | タスク・タイプ | 実績搬送日 | 搬送名 | 履行明細ID |
54678 | 出荷 | 01-01-25 | 296728 | 300100668997887 |
76849 | DOO_TransportationPlanning | 03-11-25 | (null) | 300100668998551 |
ビジネス・イベントのトリガー
「実績搬送日」属性を使用して、Order Managementでその日付が更新されたときにビジネス・イベントをトリガーできます。 たとえば、Order Managementによって日付が変更されたという通知をダウンストリーム履行システムの1つに送信する必要があります。 この属性を「オーダー属性更新」ビジネス・イベントに追加します:
オーダー・エンティティ | 属性名 |
履行明細詳細 | 実績搬送日 |
バックグラウンドについては、「Order Managementから他のシステムへの通知の送信の概要」を参照してください。
スケジュール済プロセスの実行
Order Managementでは、「オーダー履行からのレスポンスの処理」スケジュール済プロセスを使用して、実際の搬送日が自動的に更新されます。 まれに、日付を処理するために手動で実行する必要がある場合があります。 実行する場合は、実行時に「履行レスポンス・タイプ」パラメータを次のいずれかの値に設定します:
- 出荷の実績搬送日の処理
- Transportation Managementの実際の配送日の処理
バックグラウンドについては、「オーダー履行からのレスポンスの処理」を参照してください。
その他
「出荷の実績搬送日の取得」を参照してください。