getProductDemandCostByDiscountList

Prev Next

Classic/VPC環境で利用できます。

割引が適用された請求内訳を照会します。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド URI
GET、POST /discount/getProductDemandCostByDiscountList

リクエストヘッダ

NAVERクラウドプラットフォームで共通して使用されるヘッダの詳細は、Ncloud APIの共通ヘッダをご参照ください。

リクエストクエリパラメータ

パラメータの説明は次の通りです。

フィールド タイプ 必須の有無 説明
startMonth String Required 照会開始月(yyyyMM)
  • 最大6か月照会可能
  • <例> 202401
endMonth String Required 照会最終月(yyyyMM)
  • 最大6か月照会可能
  • <例> 202406
pageNo Integer Optional ページ番号
pageSize Integer Optional ページサイズ
  • 1,000以下(デフォルト: 1,000)
productDemandTypeCodeList.N List Optional 照会対象のサービス請求タイプコード
  • 未入力時、全請求リストを返す
isOrganization Boolean Optional Organizationサービスアカウントの統合照会かどうか
  • マスターのみ使用可能
  • isOrganizationisPartnerのいずれもtrueの場合、エラーを返す
isPartner Boolean Optional パートナーアカウントの照会かどうか
  • パートナー代表のみ使用可能
  • isOrganizationisPartnerのいずれもtrueの場合、エラーを返す
memberNoList List<String> Optional 会員番号リスト
  • マスターまたはパートナー代表のみ使用可能
responseFormatType String Optional レスポンス結果の形式
  • xml(デフォルト) | json

リクエスト例

リクエストのサンプルコードは次の通りです。

curl --location --request GET 'https://billingapi.apigw.ntruss.com/billing/v1/discount/getProductDemandCostByDiscountList?startMonth=202311&endMonth=202404' \
--header 'x-ncp-apigw-timestamp: {timestamp}' \
--header 'x-ncp-iam-access-key: {access key}' \
--header 'x-ncp-apigw-signature-v2: {signature}' \

レスポンス

レスポンス形式を説明します。

レスポンスボディ

レスポンスボディの詳細は、ProductDemandCostByDiscountListをご参照ください。

レスポンスステータスコード

NAVERクラウドプラットフォームでで共通して使用されるレスポンスステータスコードの詳細は、Ncloud APIのレスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

<?xml version="1.0" encoding="UTF-8"?>
<getProductDemandCostByDiscountListResponse>
  <requestId>89b5d61f-****-****-****-fc1289eeb72e</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>2</totalRows>
  <productDemandCostByDiscountList>
    <productDemandCostByDiscount>
      <memberNo>1***9</memberNo>
      <demandMonth>202212</demandMonth>
      <productDemandType>
        <code>GDNS</code>
        <codeName>Global DNS</codeName>
        <regionCode/>
      </productDemandType>
      <promiseDiscountAmount>0</promiseDiscountAmount>
      <promotionDiscountAmount>0</promotionDiscountAmount>
      <etcDiscountAmount>0</etcDiscountAmount>
      <productDiscountAmount>60</productDiscountAmount>
      <creditDiscountAmount>0</creditDiscountAmount>
      <defaultAmount>0</defaultAmount>
      <useAmount>690</useAmount>
      <demandAmount>630</demandAmount>
      <writeDate>2022-12-14T07:59:53+0900</writeDate>
      <memberPriceDiscountAmount>0</memberPriceDiscountAmount>
      <memberPromiseDiscountAddAmount>0</memberPromiseDiscountAddAmount>
      <discountAppliedCount>1</discountAppliedCount>
      <appliedCreditHistoryList/>
      <appliedProductDiscountHistoryList>
        <appliedProductDiscountHistory>
          <discountTargetAmount>690</discountTargetAmount>
          <discountAppliedAmount>60</discountAppliedAmount>
          <discountNo>9694</discountNo>
          <productDiscountName>test-product-discount</productDiscountName>
          <discountRate>10.0</discountRate>
          <discountCondition>true</discountCondition>
          <minimumAmount>0</minimumAmount>
          <maximumDiscountCondition>true</maximumDiscountCondition>
          <maximumDiscountAmount>0</maximumDiscountAmount>
          <validityStartMonth>202212</validityStartMonth>
          <validityEndMonth>202212</validityEndMonth>
          <eligibleProductDemandTypeList>
            <productDemandType>
              <code>SCMTR</code>
              <codeName>Security Monitoring</codeName>
              <regionCode>KR</regionCode>
            </productDemandType>
            <productDemandType>
              <code>GDNS</code>
              <codeName>Global DNS</codeName>
              <regionCode>COM</regionCode>
            </productDemandType>
          </eligibleProductDemandTypeList>
        </appliedProductDiscountHistory>
      </appliedProductDiscountHistoryList>
      <payCurrency>
        <code>KRW</code>
        <codeName>South Korea Won</codeName>
      </payCurrency>
    </productDemandCostByDiscount>
  </productDemandCostByDiscountList>
</getProductDemandCostByDiscountListResponse>