SystemwalkerService Catalog Manager アプリケーション開発ガイド

B.3 サービス提供代行部門の売上配分データ

以下の節では、サービス提供代行部門の売上配分データを構成するXML要素と属性を説明します。

ResellerRevenueShareResult

サービス提供代行部門の売上配分データの最上位のコンテナ要素です。対象のサービス提供代行部門それぞれについて、売上配分データファイルにResellerRevenueShareResult要素が追加されます。

ResellerRevenueShareResultには、以下の属性があります。

• organizationId - (必須。データ型： string) サービス提供代行部門のID。

• organizationKey - (必須。データ型： positiveInteger) サービス提供代行部門の内部数値キー。

ResellerRevenueShareResultには、以下の下位要素が格納されます。

• OrganizationData要素。この要素は、組織の詳細情報を示します(“OrganizationData”を参照).

• Period要素。この要素は、請求期間を示します(“Period”を参照)。

• Currency要素。この要素は、サービス提供代行部門の売上配分データで使用されている各通貨を示しますCurrency要素 (“Currency”を参照)。

例：

<ResellerRevenueShareResult organizationId="cd9ffaac" organizationKey="19000">
  <OrganizationData> ... </OrganizationData>
  <Period> ... </Period>
  <Currency> ... </Currency>
</ResellerRevenueShareResult>

Currency

特定の通貨についてのサービス提供代行部門の売上配分データが格納されます。

Currency要素には、以下の属性があります。

• id - (必須。データ型： string) 通貨のISOコード。

Currency要素には、以下の下位要素が格納されます。

• Supplier要素。この要素は、サービス提供代行部門が売上配分を受けることのできるサービスの提供元のサービス提供部門を示します。(“Supplier”を参照)。

• ResellerRevenue要素。この要素には以下の属性があります。

  • totalAmount - (オプション。データ型：positive decimal, scale 2) 該当に通貨についての売上全体

  • amount - （必須。データ型：positive decimal, scale 2) サービス提供代行部門に対する売上配分の全体。

  • purchasePrice - (オプション。データ型：positive decimal, scale 2) totalAmount属性とamount属性の差。

例：

<Currency id="EUR">
  <Supplier>...</Supplier>
  <ResellerRevenue totalAmount="1000.50" amount="200.10" purchasePrice="800.40"/>
</Currency>

Supplier

特定のサービス提供部門が提供するサービスに対するサービス仲介部門の売上配分データが格納されます。

Supplier要素には、以下の下位要素が格納されます。

• OrganizationData要素。この要素は、サービス提供部門の組織の詳細を示します(“OrganizationData”を参照)。

• Service要素。この要素は、サービス提供部門が提供し、サービス提供代行部門の組織が売上配分を受けることのできるサービスを示します(“Service”を参照)。

• ResellerRevenuePerSupplier要素。この要素には、以下の属性があります。

  • totalAmount - (オプション。データ型：positive decimal, scale 2) 提供部門の売上全体。

  • amount - (必須。データ型：positive decimal, scale 2) このサービス提供部門についてのサービス提供代行部門の売上配分の全体。

  • purchasePrice - (オプション。データ型：positive decimal, scale 2) totalAmount属性とamount属性の差。

例：

<Supplier>
  <OrganizationData> ... </OrganizationData>
  <Service> ... </Service>
  <ResellerRevenuePerSupplier totalAmount="200.50" amount="40.10" purchasePrice="160.40"/>
</Supplier>

Service

特定のサービスについてのサービス提供代行部門の売上配分データを示します。

Service要素には、以下の属性があります。

• id - (必須。データ型： string) サービスの名称。

• key - (必須。データ型： positiveInteger) サービス提供代行部門が提供するサービスの内部数値キー。この値は、サービス提供部門によって定義された元々のサービスの値の複製になります。

• templateKey - (必須。データ型： positiveInteger) サービス提供部門によって定義された元々のサービスの内部数値キー。

Service要素には、以下の下位要素が格納されます。

• Subscription要素。この要素は、サービス提供代行部門が提供するサービスに対する購入済サービスを示します。(“Subscription”を参照)。

• ServiceRevenue要素。この要素は、サービスに対するサービス提供代行部門の売上配分全体を示します(“ServiceRevenue”を参照)。

例：

<Service id="Mega Office" key="17005" templateKey="10501">
  <Subscription> ... </Subscription>
  <ServiceRevenue> ... </ServiceRevenue>
</Service>

Subscription

特定の購入済みサービスに対する売上を示します。

Subscriptionには、以下の属性があります。

• id - (必須。データ型： string) 購入済みサービスの名称。

• key - (必須。データ型： positiveInteger) 購入済みサービスの内部数値キー。

• billingKey - (必須。データ型： positiveInteger) 一意の識別子。例えば、会計システムで請求データと請求書を関連付けるために使用できます。請求データキーは請求書に印刷されます。

• revenue - (必須。データ型： positive decimal, scale 2) 請求期間における購入済みサービスに対する売上の合計。

Subscription要素には、適用される請求期間を示すPeriod下位要素が格納されます(“Period”を参照)。

例：

<Subscription id="Mega Office Basic" key="17005" billingKey="19032" revenue="600.00">
  <Period>... </Period>
</Subscription>

ServiceRevenue

サービスの売上全体とサービス提供代行部門への売上配分を示します。

ServiceRevenue要素には、以下の属性があります。

• totalAmount - (必須。データ型： positive decimal, scale 2) 請求期間における購入済みサービスに対する売上全体。

• resellerRevenueSharePercentage - (必須。データ型： positive decimal, scale 2) サービス提供代行部門が受け取ることができる売上のパーセント率。

• resellerRevenue - (必須。データ型： positive decimal, scale 2)請求期間におけるサービスに対するサービス提供代行部門への売上配分。

ServiceRevenue要素には、サービスを利用しているサービス利用部門ごとに、下位要素としてServiceCustomerRevenue要素が格納されます。ServiceCustomerRevenueの属性では、サービス利用部門によってもたらされた売上の合計と、サービス提供代行部門への売上配分が示されます。

• customerName - (オプション。データ型： string) サービス利用部門の名称。

• customerId - (オプション。データ型： string) サービス利用部門のID。

• totalAmount - (オプション。データ型： positive decimal, scale 2) サービス利用部門によってもたらされた請求期間におけるサービスに対する売上の合計。

• brokerRevenueSharePercentage - (オプション。データ型： positive decimal, scale 2) サービス提供代行部門が受け取ることができる売上のパーセント率。

• resellerRevenue - (オプション。データ型： positive decimal, scale 2) サービス利用部門によってもたらされた請求期間におけるサービスに対するサービス提供代行部門への売上配分。

• purchasePrice - (オプション。データ型： positive decimal, scale 2) totalAmount属性とresellerRevenue属性の差。

例：

<ServiceRevenue totalAmount="200.00" resellerRevenueSharePercentage="10.00" resellerRevenue="20.00">
  <ServiceCustomerRevenue customerName="MyCompany" customerId="862cfb94" totalAmount="50.00"
   resellerRevenueSharePercentage="10.00" resellerRevenue="5.00" purchasePrice="45"/>
</ServiceRevenue>