プロジェクト詳細のインポート
webサービス、ファイルまたはREST APIを使用して、プロジェクト詳細をオーダー管理にインポートします。
たとえば:
-
各プロジェクトのプロジェクト番号、タスク番号、支出組織およびその他の属性をインポートします。
-
インポートを実行するときに、支出タイプ、ユーザー定義属性、契約番号および資金ソースのデフォルト値を設定します。
-
インポートするソース・オーダーに価格設定を含めるか、ソース・オーダーで価格設定を空のままにして、オーダー管理で価格設定を実行します。
Webサービスからのインポート
webサービスorderImportServiceを使用して、プロジェクト詳細を含む販売オーダーをインポートします。
プロジェクト詳細を含めるペイロードの一部を次に示します。 すべての属性が必要です。
<ns2:Project xmlns:pjc="http://xmlns.oracle.com/apps/flex/scm/doo/processOrder/pjcDff/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ns2:PJCDFFVA xsi:type="pjc:OmSalesOrder">
<pjc:projectId_Display>PDSC-CT-PDSCM1X-004</pjc:projectId_Display>
<pjc:taskId_Display>1.1.1</pjc:taskId_Display>
<pjc:expenditureItemDate>2019-03-20</pjc:expenditureItemDate>
<pjc:expenditureTypeId_Display>Material</pjc:expenditureTypeId_Display>
<pjc:organizationId_Display>Vision Operations</pjc:organizationId_Display>
</ns2:PJCDFFVA>
</ns2:Project>
説明
属性またはコード |
値 |
---|---|
pjcDff |
付加フレックスフィールドを使用してプロジェクト詳細を格納していることを示します。 この値を使用する必要があります。 |
xsi:タイプ |
ソース・タイプをOmSalesOrder (オーダー管理販売オーダー)として識別します。 この値を使用する必要があります。 |
projectId_Display |
プロジェクトを一意に識別する値。 この例では、値として1.1.1を使用します。 |
expenditureItemDate |
品目を経費計上する日付です。 年-月-日書式を使用する必要があります。 たとえば、2019-03-20は2019年3月20日を示します。 |
expenditureTypeId_Display |
資材など、支出のタイプを識別します。 |
organizationId_Display |
Vision Operationsなどのビジネス・ユニットを識別します。 |
予約ID |
サンプルのペイロードにはこの属性が含まれていません。 webサービスは、この属性を以前の更新にのみ使用します。 現在の更新の場合、値は空であり、webサービスではこの値は使用されません。 |
_Display
は、Oracleアプリケーションに属性を表示するときに値を使用することを示します。
同じプロジェクト詳細を含むペイロードの例を次に示します。
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns1:createOrders xmlns:ns1="http://xmlns.oracle.com/apps/scm/fom/importOrders/orderImportService/types/">
<ns1:request xmlns:ns2="http://xmlns.oracle.com/apps/scm/fom/importOrders/orderImportService/">
<ns2:Order>
<ns2:SourceTransactionIdentifier>RRFPDSC_TEST_112</ns2:SourceTransactionIdentifier>
<ns2:SourceTransactionSystem>LEG</ns2:SourceTransactionSystem>
<ns2:SourceTransactionNumber>RRFPDSC_TEST_112</ns2:SourceTransactionNumber>
<ns2:BuyingPartyName>FOM-Customer-001</ns2:BuyingPartyName>
<ns2:BuyingPartyContactName>James Pattison</ns2:BuyingPartyContactName>
<ns2:CustomerPONumber>PDSCSPBU</ns2:CustomerPONumber>
<ns2:TransactionalCurrencyCode>USD</ns2:TransactionalCurrencyCode>
<ns2:TransactionOn>2019-08-22T00:00:00.000</ns2:TransactionOn>
<ns2:RequestingBusinessUnitName>Vision Operations</ns2:RequestingBusinessUnitName>
<ns2:OrigSystemDocumentReference/>
<ns2:TransactionTypeCode>STD</ns2:TransactionTypeCode>
<ns2:FreezePriceFlag>false</ns2:FreezePriceFlag>
<ns2:FreezeShippingChargeFlag>false</ns2:FreezeShippingChargeFlag>
<ns2:FreezeTaxFlag>false</ns2:FreezeTaxFlag>
<ns2:ShipToPartyName>FOM-Customer-001</ns2:ShipToPartyName>
<ns2:ShipToAddress1>1045, 5th Avenue</ns2:ShipToAddress1>
<ns2:ShipToCity>San Diego Country Estate</ns2:ShipToCity>
<ns2:ShipToPostalCode>92065</ns2:ShipToPostalCode>
<ns2:ShipToState>CA</ns2:ShipToState>
<ns2:ShipToCountry>US</ns2:ShipToCountry>
<ns2:ShipToPartyContactName>James Pattison</ns2:ShipToPartyContactName>
<ns2:BillToPartyType>ORGANIZATION</ns2:BillToPartyType>
<ns2:BillToCustomerName>FOM-Customer-001</ns2:BillToCustomerName>
<ns2:BillToCustomerIdentifier>300100046859202</ns2:BillToCustomerIdentifier>
<ns2:BillToAddress1>1045, 5th Avenue</ns2:BillToAddress1>
<ns2:BillToCity>San Diego Country Estate</ns2:BillToCity>
<ns2:BillToPostalCode>92065</ns2:BillToPostalCode>
<ns2:BillToState>CA</ns2:BillToState>
<ns2:BillToCountry>US</ns2:BillToCountry>
<ns2:BillToAccountContactName>James Pattison</ns2:BillToAccountContactName>
<ns2:SalesChannel>Direct</ns2:SalesChannel>
<ns2:Salesperson>Paul Robert Scholes</ns2:Salesperson>
<ns2:SalesCredit>
<ns2:SourceTransactionSalesCreditIdentifier>OSC-001</ns2:SourceTransactionSalesCreditIdentifier>
<ns2:SalesPerson>Paul Robert Scholes</ns2:SalesPerson>
<ns2:Percent>100</ns2:Percent>
<ns2:SalesCreditTypeCode>1</ns2:SalesCreditTypeCode>
<ns2:SalesCreditTypeReference>Quota Sales Credit</ns2:SalesCreditTypeReference>
</ns2:SalesCredit>
<ns2:Line>
<ns2:SourceTransactionLineIdentifier>101</ns2:SourceTransactionLineIdentifier>
<ns2:SourceTransactionScheduleIdentifier>101</ns2:SourceTransactionScheduleIdentifier>
<ns2:SourceTransactionLineNumber>1</ns2:SourceTransactionLineNumber>
<ns2:SourceTransactionScheduleNumber>1</ns2:SourceTransactionScheduleNumber>
<ns2:ParentLineReference/>
<ns2:RootParentLineReference/>
<ns2:TransactionCategoryCode>ORDER</ns2:TransactionCategoryCode>
<ns2:ProductNumber>OM-PDSC-STD-03-C</ns2:ProductNumber>
<ns2:OrderedQuantity>100</ns2:OrderedQuantity>
<ns2:OrderedUOM>Each</ns2:OrderedUOM>
<ns2:RequestedFulfillmentOrganizationCode>PDSCM1</ns2:RequestedFulfillmentOrganizationCode>
<ns2:CustomerPONumber>NKPO2017/10/005/01</ns2:CustomerPONumber>
<ns2:CustomerPOLineNumber>1</ns2:CustomerPOLineNumber>
<ns2:RequestedShipDate>2019-06-30T23:08:52Z</ns2:RequestedShipDate>
<ns2:PaymentTerms>30 Net</ns2:PaymentTerms>
<ns2:PartialShipAllowedFlag>false</ns2:PartialShipAllowedFlag>
<ns2:Comments/>
<ns2:TaxExempt>S</ns2:TaxExempt>
<ns2:ShipToPartyName>FOM-Customer-001</ns2:ShipToPartyName>
<ns2:ShipToAddress1>1045, 5th Avenue</ns2:ShipToAddress1>
<ns2:ShipToCity>San Diego Country Estate</ns2:ShipToCity>
<ns2:ShipToPostalCode>92065</ns2:ShipToPostalCode>
<ns2:ShipToState>CA</ns2:ShipToState>
<ns2:ShipToCountry>US</ns2:ShipToCountry>
<ns2:ShipToPartyContactName>James Pattison</ns2:ShipToPartyContactName>
<ns2:BillToPartyType>ORGANIZATION</ns2:BillToPartyType>
<ns2:BillToCustomerName>FOM-Customer-001</ns2:BillToCustomerName>
<ns2:BillToCustomerIdentifier>300100046859202</ns2:BillToCustomerIdentifier>
<ns2:BillToAddress1>1045, 5th Avenue</ns2:BillToAddress1>
<ns2:BillToCity>San Diego Country Estate</ns2:BillToCity>
<ns2:BillToPostalCode>92065</ns2:BillToPostalCode>
<ns2:BillToState>CA</ns2:BillToState>
<ns2:BillToCountry>US</ns2:BillToCountry>
<ns2:BillToAccountContactName>James Pattison</ns2:BillToAccountContactName>
<ns2:Project xmlns:pjc="http://xmlns.oracle.com/apps/flex/scm/doo/processOrder/pjcDff/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ns2:PJCDFFVA xsi:type="pjc:OmSalesOrder">
<pjc:projectId_Display>PDSC-CT-PDSCM1X-004</pjc:projectId_Display>
<pjc:taskId_Display>1.1.1</pjc:taskId_Display>
<pjc:expenditureItemDate>2019-03-20</pjc:expenditureItemDate>
<pjc:expenditureTypeId_Display>Material</pjc:expenditureTypeId_Display>
<pjc:organizationId_Display>Vision Operations</pjc:organizationId_Display>
</ns2:PJCDFFVA>
</ns2:Project>
<ns2:AdditionalFulfillmentLineInformationCategories xsi:type="ns12:j_FulfillLineEffDooFulfillLinesAddInfoprivate" xmlns:ns12="http://xmlns.oracle.com/apps/scm/doo/processOrder/flex/fulfillLineCategories/" xmlns:ns22="http://xmlns.oracle.com/apps/scm/doo/processOrder/flex/fulfillLineContextsB/" xmlns:ns8="http://xmlns.oracle.com/apps/scm/doo/processOrder/model/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ns8:Category>DOO_FULFILL_LINES_ADD_INFO</ns8:Category>
<ns12:FulfillLineEffBShipment__InstructionsprivateVO>
<ns8:ContextCode>Shipment Instructions</ns8:ContextCode>
<ns22:packInstructions>OM-PI-Test</ns22:packInstructions>
<ns22:shipInstructions>OM-SI-Test</ns22:shipInstructions>
<ns22:handlingCost>12.5</ns22:handlingCost>
<ns22:needByDate>2018-10-15</ns22:needByDate>
<ns22:expectedPickDate>2018-10-15T12:12:12</ns22:expectedPickDate>
</ns12:FulfillLineEffBShipment__InstructionsprivateVO>
</ns2:AdditionalFulfillmentLineInformationCategories>
</ns2:Line>
<ns2:Line>
</ns2:Order>
</ns1:request>
</ns1:createOrders>
</soap:Body>
</soap:Envelope>
簡潔にするために、このペイロードにはオーダー明細が1つのみ含まれます。 より完全なペイロードを表示するには、「Order Managementの技術リファレンス(ドキュメントID 2051639.1)」に移動し、ペイロードおよびファイルの添付をダウンロードします。
履行明細のプロジェクト詳細の検証
webサービスorderImportServiceを使用して、履行明細のプロジェクト属性の組合せを検証します。 新規オーダーを発行するか、既存のオーダーを改訂するか、または出荷タスク中に直接実行します。
webサービスは、発行時イベント中に販売利益センターおよび倉庫のビジネス・ユニットを検証します。
たとえば、webサービスは確実です。
-
ユーザーは、「プロジェクト詳細の編集」ダイアログで各必須属性の値を指定します。
-
プロジェクト番号
-
タスク番号
-
支出組織
-
支出項目日
-
支出タイプ
-
-
フローはプロジェクトに契約を割り当てました。
-
設定した支出項目日は、プロジェクト開始日と終了日の範囲内で発生します。
-
販売オーダーの請求先住所が契約の請求先住所と一致します。
-
販売オーダーの出荷先住所が契約の出荷先住所と一致します。
検証に失敗すると、オーダー管理に警告またはエラーが表示され、修正方法が示されます。
Order Managementは、これらの検証を実行して、出荷時または契約への請求時に問題が発生しないようにします。 たとえば、販売オーダーの出荷先事業所が少なくとも1つの契約明細の出荷先事業所と一致しない場合、オーダー管理がプロジェクトの契約を請求するときに、販売オーダーで誤った税金が使用される可能性があります。 出荷では、品目を誤ったロケーションに出荷することもできます。 ユーザーは、オーダー管理で訂正済明細を出荷に送信できるように、履行明細を変更してオーダーを手動でリカバリする必要があります。
次に、支出品目日がプロジェクト日付の範囲外になったときにwebサービスが送信するレスポンスの例を示します。
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns1:createOrders
<ns0: createOrdersResponse xmlns:ns0="http://xmlns.oracle.com/apps/scm/fom/importOrders/orderImportService/types/">
<ns1:result xsi:type="ns0:OrderImportResponse xmlns:ns1=
"http://xmlns.oracle.com/apps/scm/fom/importOrders/orderImportService/">
<ns0:Order>
<ns0:SourceTransactionNumber>RRFPDSC_TEST_112</ns0:SourceTransactionNumber>
<ns0:SourceTransactionIdentifier>RRFPDSC_TEST_112</ns0:SourceTransactionIdentifier>
<ns0:SourceTransactionSystem>LEG</ns0:SourceTransactionSystem>
<ns0:OrderNumber>514626</ns0:OrderNumber>
<ns0:HeaderId>xsi:nil="true"</ns0:HeaderId>
<ns0:OrderStatus>DOO_DRAFT</ns0:OrderStatus>
<ns0:ReturnStatus>ERROR</ns0:ReturnStatus>
<ns0:MessageName>env:Server</ns0:MessageName>
<ns0:MessageText>The submit failed for sales order RRFPDSC_TEST_112 on order line1, in schedule 1. The expenditure item date happens outside the project dates. Change the project start and finish dates, or change the expenditure item date.</ns0:MessageText>
<ns0:flowType>xsi_nil="true"</ns0:flowType>
ファイルからのインポート
オーダー・インポート・テンプレートのDOO_PROJECTS_INTワークシートを使用して、プロジェクト詳細をインポートします。
-
バッチをインポートします。 同じバッチにないプロジェクト詳細および明細を含む販売オーダー明細をインポートします。
-
出荷可能品目のプロジェクト詳細をインポートします。
-
構成品目をインポートします。
-
オーダー発行プロセスの一部としてプロジェクト属性の組合せを検証します。
-
テンプレートのDOO_PROJECTS_INTワークシートを使用して、販売オーダー明細のプロジェクト属性を取得します。
必要な属性は次のとおりです。
属性 |
値 |
---|---|
ソース・トランザクション識別子 |
任意の英数字テキスト(FBDI_SRK_0318_08など)を入力します。 |
ソース・トランザクション・システム |
GPRなどの英数字テキストを入力します。 |
ソース・トランザクション明細識別子 |
ソース・トランザクションのオーダー明細を識別します(1など)。 |
ソース・トランザクション・スケジュール識別子 |
ソース・トランザクションのスケジュールを識別します(1など)。 |
プロジェクト番号、プロジェクト名またはプロジェクトID |
プロジェクトを指定します。 プロジェクトIDに300100113461421など、これらの属性の少なくとも1つに値を含めます。 |
タスク番号、タスク名、タスクID |
タスクを識別します。 タスク番号の1.1など、これらの属性の少なくとも1つに値を含めます。 |
支出項目日 |
品目を経費計上する日付です。 年-月-日書式を使用する必要があります。 たとえば、2019-03-20は2019年3月20日を示します。 |
支出タイプまたは支出タイプID |
支出のタイプを識別します。 支出タイプの資材など、これらの属性の少なくとも1つに値を含めます。 |
支出組織または支出組織ID |
支出組織のVision Operationsなどのビジネス・ユニットを識別します。 |
契約番号または契約ID |
プロジェクトの許可を使用可能にする場合は、契約を識別します。 これらの属性の少なくとも1つに値を含めます。 |
資金ソース番号または資金ソースID |
プロジェクトの許可を使用可能にする場合は、資金ソースを識別します。 これらの属性の少なくとも1つに値を含めます。 |
必要に応じて、オプション属性の値を含めます。
-
BillableFlag
-
CapitalizableFlag
-
ContractLineId
-
WorkType
-
WorkTypeId
-
FundingAllocationId
-
UserDefinedAttribute 1からUserDefinedAttribute n
-
ReservedAttribute 2からReservedAttribute n
値の例を含むテンプレートについては、「Order Managementの技術リファレンス(ドキュメントID 2051639.1)」に移動し、ペイロードおよびファイルの添付をダウンロードします。
詳細は、オーダー管理へのオーダーのインポートの概要を参照してください。 テンプレートを使用したプロジェクト詳細のインポートに関するヘルプが必要な場合は、Oracle Supportに連絡してください。
REST APIによる統合
オーダー・ハブREST APIの販売オーダーでプロジェクト・リソースを使用します。
リソース |
説明 |
---|---|
プロジェクト |
DooOrderPrjId属性が含まれます。 300100010341182などのプロジェクトを識別します。 |
プロジェクト詳細 |
その他のプロジェクト属性が含まれます。 |
プロジェクト詳細リソースを使用するペイロード例の属性を次に示します。
"DooOrderPrjId": 300100181049087,
"__FLEX_Context": "OM_Sales_Order",
"__FLEX_Context_DisplayValue": "SCM: General",
"projectId": 300100010341182,
"projectId_Display": "Projects-TL-Int-01",
"taskId": 300100010341193,
"taskId_Display": "1.1",
"expenditureItemDate": null,
"expenditureTypeId": 10028,
"expenditureTypeId_Display": "Material",
"organizationId": 204,
"organizationId_Display": "Vision Operations",
"contractId": null,
"contractId_Display": null,
"reservedAttribute1": null,
"reservedAttribute1_Display": null,
"billableFlag": null,
"billableFlag_Display": null,
"capitalizableFlag": null,
"capitalizableFlag_Display": null,
"workTypeId": null,
"workTypeId_Display": null,
プロジェクトProjects-TL-Int-01で品目AS92888の販売オーダーを作成するペイロードの例を次に示します。 これには、projectId_Displayなど、プロジェクトを識別する値を使用する表示属性が含まれます。
URL: https://fuscdrmsmc347-fa-ext.myCompany.com:443/fscmRestApi/resources/11.13.20.01/salesOrdersForOrderHub
METHOD: POST
{
"SourceTransactionNumber": "R13_project_valueattrs_01",
"SourceTransactionSystem": "GPR",
"SourceTransactionId": "R13_project_valueattrs_01",
"BusinessUnitId": 204,
"BuyingPartyId": 1006,
"BuyingPartyContactId": 2663,
"TransactionalCurrencyName": "US Dollar",
"RequestedShipDate": "2019-01-20T20:51:21+00:00",
"PartialShipAllowedFlag": false,
"RequestingBusinessUnitId": 204,
"RequestingLegalEntityId": 204,
"FreezePriceFlag": "N",
"FreezeTaxFlag": "N",
"RequestedFulfillmentOrganizationId":207,
"PaymentTerms": "30 Net",
"SubmittedFlag": true,
"billToCustomer": [
{
"CustomerAccountId": 1006,
"SiteUseId": 1025,
"ContactFirstName": "Sarah",
"ContactLastName": "Takesh"
}
],
"shipToCustomer": [
{
"PartyId": 1006,
"SiteId": 1036
}
],
"lines": [
{
"SourceTransactionLineId": "1",
"SourceTransactionLineNumber": "1",
"SourceScheduleNumber": "1",
"SourceTransactionScheduleId": "1",
"ProductNumber": "AS92888",
"OrderedUOMCode": "Ea",
"PurchasingUOMCode": "Ea",
"OrderedQuantity": 1,
"project": [
{
"projectDetail": [
{
"projectId_Display": "Projects-TL-Int-01",
"taskId_Display": 1.1,
"expenditureTypeId_Display": "Material",
"organizationId_Display": "Vision Operations",
"contractId": null,
"reservedAttribute1": null,
"billableFlag": null,
"capitalizableFlag": null,
"workTypeId": null
}
]
}
]
}
]
}
プロジェクト300100010341182で品目AS92888の販売オーダーを作成する別の例を次に示します。 これには、projectIdなどの識別子を使用してプロジェクトを識別する属性が含まれます。
URL: https://fuscdrmsmc347-fa-ext.myCompany.com:443/fscmRestApi/resources/11.13.20.01/salesOrdersForOrderHub
METHOD: POST
{
"SourceTransactionNumber": "R13_project_Idattrs_01",
"SourceTransactionSystem": "GPR",
"SourceTransactionId": "R13_project_Idattrs_01",
"BusinessUnitId": 204,
"BuyingPartyId": 1006,
"BuyingPartyContactId": 2663,
"TransactionalCurrencyName": "US Dollar",
"RequestedShipDate": "2019-01-20T20:51:21+00:00",
"PartialShipAllowedFlag": false,
"RequestingBusinessUnitId": 204,
"RequestingLegalEntityId": 204,
"FreezePriceFlag": "N",
"FreezeTaxFlag": "N",
"RequestedFulfillmentOrganizationId":207,
"PaymentTerms": "30 Net",
"SubmittedFlag": true,
"billToCustomer": [
{
"CustomerAccountId": 1006,
"SiteUseId": 1025,
"ContactFirstName": "Sarah",
"ContactLastName": "Takesh"
}
],
"shipToCustomer": [
{
"PartyId": 1006,
"SiteId": 1036
}
],
"lines": [
{
"SourceTransactionLineId": "1",
"SourceTransactionLineNumber": "1",
"SourceScheduleNumber": "1",
"SourceTransactionScheduleId": "1",
"ProductNumber": "AS92888",
"OrderedUOMCode": "Ea",
"PurchasingUOMCode": "Ea",
"OrderedQuantity": 1,
"project": [
{
"projectDetail": [
{
"projectId": 300100010341182,
"taskId": 300100010341193,
"expenditureTypeId": 10028,
"organizationId": 204,
"expenditureItemDate": "2019-09-24",
"contractId": null,
"reservedAttribute1": null,
"billableFlag": null,
"capitalizableFlag": null,
"workTypeId": null
}
]
}
]
}
]
}
詳細と例については、「Oracle Supply Chain Management CloudのREST API」、「Order Management」>「Order Hubの販売オーダー」の順に展開します。