Jump to

• Request
• Response
• Examples

Create a subscription preview

post

/crmRestApi/resources/11.13.18.05/previewSubscriptions

Request

Header Parameters

• Metadata-Context: string
  If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
• REST-Framework-Version: string
  The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.

Supported Media Types

• application/json

Request Body - application/json ()

Root Schema : schema

Type: object

Show Source

• BillToAccountId: integer
  The bill-to account ID.
• BillToAccountNumber: string
  Maximum Length: 255

  The bill-to account number.
• BillToSiteNumber: string
  Maximum Length: 255

  The bill-to site number.
• BillToSiteUseId: integer
  The bill-to site use ID.
• BusinessUnitId: integer
  The business unit ID.
• Currency(required): string
  Maximum Length: 255

  The currency of the preview subscription.
• DocumentFiscalClassification: string
  Maximum Length: 255

  The document fiscal classification.
• EndDate: string (date)
  The end date of the subscription.
• ExemptCertificateNumber: string
  Maximum Length: 255

  The exempt certificate number.
• LegalEntityId: integer
  The legal entity ID.
• PricingStrategyId: integer
  The pricing strategy ID.
• PrimaryPartyId: integer
  The unique primary party identifier of the preview subscription.
• PrimaryPartyNumber: string
  Maximum Length: 255

  The primary party number.
• products: array Preview Subscription Products
  Title: Preview Subscription Products

  Preview subscriptions lets you view a subscription product before creating, updating, or deleting a subscription.
• ShipToParty: integer
  The ship-to party.
• ShipToPartyNumber: string
  Maximum Length: 255

  The ship-to party number.
• StartDate: string (date)
  The start date of the subscription.
• SubscriptionId(required): integer
  The unique subscription identifier of the preview subscription.
• SubscriptionNumber: string
  Maximum Length: 255

  The subscription number of the preview subscription.
• SubscriptionProfileName: string
  Maximum Length: 300

  The subscription profile name.
• TaxClassificationCode: string
  Maximum Length: 255

  The tax classification code.

{
    "required":[
        "Currency",
        "SubscriptionId"
    ],
    "type":"object",
    "properties":{
        "SubscriptionNumber":{
            "maxLength":255,
            "type":"string",
            "description":"The subscription number of the preview subscription.",
            "nullable":true
        },
        "SubscriptionProfileName":{
            "maxLength":300,
            "type":"string",
            "description":"The subscription profile name.",
            "nullable":true
        },
        "BillToSiteUseId":{
            "type":"integer",
            "description":"The bill-to site use ID.",
            "nullable":true
        },
        "ShipToPartyNumber":{
            "maxLength":255,
            "type":"string",
            "description":"The ship-to party number.",
            "nullable":true
        },
        "BusinessUnitId":{
            "type":"integer",
            "description":"The business unit ID.",
            "nullable":true
        },
        "PrimaryPartyId":{
            "type":"integer",
            "description":"The unique primary party identifier of the preview subscription.",
            "nullable":true
        },
        "BillToAccountNumber":{
            "maxLength":255,
            "type":"string",
            "description":"The bill-to account number.",
            "nullable":true
        },
        "ExemptCertificateNumber":{
            "maxLength":255,
            "type":"string",
            "description":"The exempt certificate number.",
            "nullable":true
        },
        "EndDate":{
            "type":"string",
            "description":"The end date of the subscription.",
            "format":"date",
            "nullable":true
        },
        "products":{
            "title":"Preview Subscription Products",
            "type":"array",
            "description":"Preview subscriptions lets you view a subscription product before creating, updating, or deleting a subscription.",
            "items":{
                "$ref":"#/components/schemas/previewSubscriptions-products-item-post-request"
            }
        },
        "BillToSiteNumber":{
            "maxLength":255,
            "type":"string",
            "description":"The bill-to site number.",
            "nullable":true
        },
        "StartDate":{
            "type":"string",
            "description":"The start date of the subscription.",
            "format":"date",
            "nullable":true
        },
        "DocumentFiscalClassification":{
            "maxLength":255,
            "type":"string",
            "description":"The document fiscal classification.",
            "nullable":true
        },
        "SubscriptionId":{
            "type":"integer",
            "description":"The unique subscription identifier of the preview subscription.",
            "nullable":false
        },
        "ShipToParty":{
            "type":"integer",
            "description":"The ship-to party.",
            "nullable":true
        },
        "BillToAccountId":{
            "type":"integer",
            "description":"The bill-to account ID.",
            "nullable":true
        },
        "LegalEntityId":{
            "type":"integer",
            "description":"The legal entity ID.",
            "nullable":true
        },
        "Currency":{
            "maxLength":255,
            "type":"string",
            "description":"The currency of the preview subscription.",
            "nullable":false
        },
        "TaxClassificationCode":{
            "maxLength":255,
            "type":"string",
            "description":"The tax classification code.",
            "nullable":true
        },
        "PricingStrategyId":{
            "type":"integer",
            "description":"The pricing strategy ID.",
            "nullable":true
        },
        "PrimaryPartyNumber":{
            "maxLength":255,
            "type":"string",
            "description":"The primary party number.",
            "nullable":true
        }
    }
}

Nested Schema : Preview Subscription Products

Type: array

Title: Preview Subscription Products

Preview subscriptions lets you view a subscription product before creating, updating, or deleting a subscription.

Show Source

• Array of: object previewSubscriptions-products-item-post-request

{
    "title":"Preview Subscription Products",
    "type":"array",
    "description":"Preview subscriptions lets you view a subscription product before creating, updating, or deleting a subscription.",
    "items":{
        "$ref":"#/components/schemas/previewSubscriptions-products-item-post-request"
    }
}

Nested Schema : previewSubscriptions-products-item-post-request

Type: object

Show Source

• ActionCode: string
  Maximum Length: 255

  The action code for the preview.
• AlignBillingFrom: string (date)
  The align billing from for the preview.
• AmendCreditMethod: string
  Maximum Length: 255

  The amendment credit method.
• AmendDescription: string
  Maximum Length: 255

  The amendment description.
• amendedProduct: array Amended Product
  Title: Amended Product

  Preview subscriptions lets you view amended subscription product details before creating, updating or deleting a subscription.
• AmendEffectiveDate: string (date)
  The amendment effective date.
• AmendReason: string
  Maximum Length: 255

  The amendment reason.
• BillingFrequency: string
  The billing frequency of the subscription product.
• charges: array Preview Subscription Charges
  Title: Preview Subscription Charges

  Preview subscriptions lets you view amended subscription product charges before creating, updating, or deleting a subscription.
• CloseCreditMethod: string
  Maximum Length: 255

  The close credit method for the preview.
• ClosedAmount: number
  The closed amount.
• ClosedDate: string (date)
  The closed date.
• CloseReason: string
  Maximum Length: 255

  The close reason.
• CopyAdjustments: string
  Maximum Length: 255

  Indicates whether the adjustments should be copied for the product or not.
• CopyCharges: string
  Indicates whether the charges should be copied for the product or not.
• CopyOneTimeCharges: string
  Maximum Length: 255

  Indicates whether the one time charges should be copied for the product or not.
• CreditedAmount: number
  The credited amount.
• DefinitionOrganizationId: integer
  The definition organization ID.
• EndDate: string (date)
  The end date of the subscription product.
• EstimatedTax: number
  The estimated tax.
• ExemptCertificateNumber: string
  Maximum Length: 255

  The exempt certificate number.
• InventoryItemId: integer
  The inventory item ID.
• ItemUnitOfMeasure: string
  The item unit of measure of the subscription product.
• output: array Preview Subscription Bill Lines
  Title: Preview Subscription Bill Lines

  Preview subscriptions lets you view subscription product details before creating, updating, or deleting a subscription.
• OutputTaxClassification: string
  Maximum Length: 255

  The output tax classification.
• PriceListId: integer
  The price list ID.
• ProductFiscClassification: string
  Maximum Length: 255

  The product fiscal classification.
• ProductName: string
  The product name of the subscription product.
• Quantity: number
  The quantity of the subscription product.
• RequestedAlignBillingDate: string (date)
  The requested align billing date.
• RequestedRatePlanId: integer
  The request rate plan identifier of the subscription product.
• RequestedRatePlanNumber: string
  Maximum Length: 255

  The requested rate plan number.
• SalesProductType: string
  Maximum Length: 255

  The sales product type.
• StartDate: string (date)
  The start date of the subscription product.
• SubscriptionProductPuid: string
  Maximum Length: 255

  The subscription product PUID.
• SuppressedCreditAmount: number
  The suppressed credit amount.
• TotalContractValue: number
  The total contract value.

{
    "type":"object",
    "properties":{
        "SalesProductType":{
            "maxLength":255,
            "type":"string",
            "description":"The sales product type.",
            "nullable":true
        },
        "AmendReason":{
            "maxLength":255,
            "type":"string",
            "description":"The amendment reason.",
            "nullable":true
        },
        "ProductName":{
            "type":"string",
            "description":"The product name of the subscription product.",
            "nullable":true
        },
        "AmendCreditMethod":{
            "maxLength":255,
            "type":"string",
            "description":"The amendment credit method.",
            "nullable":true
        },
        "ActionCode":{
            "maxLength":255,
            "type":"string",
            "description":"The action code for the preview.",
            "nullable":true
        },
        "StartDate":{
            "type":"string",
            "description":"The start date of the subscription product.",
            "format":"date",
            "nullable":true
        },
        "output":{
            "title":"Preview Subscription Bill Lines",
            "type":"array",
            "description":"Preview subscriptions lets you view subscription product details before creating, updating, or deleting a subscription.",
            "items":{
                "$ref":"#/components/schemas/previewSubscriptions-products-output-item-post-request"
            }
        },
        "RequestedRatePlanNumber":{
            "maxLength":255,
            "type":"string",
            "description":"The requested rate plan number.",
            "nullable":true
        },
        "CloseReason":{
            "maxLength":255,
            "type":"string",
            "description":"The close reason.",
            "nullable":true
        },
        "AmendEffectiveDate":{
            "type":"string",
            "description":"The amendment effective date.",
            "format":"date",
            "nullable":true
        },
        "amendedProduct":{
            "title":"Amended Product",
            "type":"array",
            "description":"Preview subscriptions lets you view amended subscription product details before creating, updating or deleting a subscription.",
            "items":{
                "$ref":"#/components/schemas/previewSubscriptions-products-amendedProduct-item-post-request"
            }
        },
        "ItemUnitOfMeasure":{
            "type":"string",
            "description":"The item unit of measure of the subscription product.",
            "nullable":true
        },
        "CopyAdjustments":{
            "maxLength":255,
            "type":"string",
            "description":"Indicates whether the adjustments should be copied for the product or not.",
            "nullable":true
        },
        "AlignBillingFrom":{
            "type":"string",
            "description":"The align billing from for the preview.",
            "format":"date",
            "nullable":true
        },
        "BillingFrequency":{
            "type":"string",
            "description":"The billing frequency of the subscription product.",
            "nullable":true
        },
        "TotalContractValue":{
            "type":"number",
            "description":"The total contract value.",
            "nullable":true
        },
        "SubscriptionProductPuid":{
            "maxLength":255,
            "type":"string",
            "description":"The subscription product PUID.",
            "nullable":true
        },
        "InventoryItemId":{
            "type":"integer",
            "description":"The inventory item ID.",
            "nullable":true
        },
        "CreditedAmount":{
            "type":"number",
            "description":"The credited amount.",
            "nullable":true
        },
        "Quantity":{
            "type":"number",
            "description":"The quantity of the subscription product.",
            "nullable":true
        },
        "CloseCreditMethod":{
            "maxLength":255,
            "type":"string",
            "description":"The close credit method for the preview.",
            "nullable":true
        },
        "RequestedRatePlanId":{
            "type":"integer",
            "description":"The request rate plan identifier of the subscription product.",
            "nullable":true
        },
        "AmendDescription":{
            "maxLength":255,
            "type":"string",
            "description":"The amendment description.",
            "nullable":true
        },
        "EstimatedTax":{
            "type":"number",
            "description":"The estimated tax.",
            "nullable":true
        },
        "ExemptCertificateNumber":{
            "maxLength":255,
            "type":"string",
            "description":"The exempt certificate number.",
            "nullable":true
        },
        "EndDate":{
            "type":"string",
            "description":"The end date of the subscription product.",
            "format":"date",
            "nullable":true
        },
        "ClosedAmount":{
            "type":"number",
            "description":"The closed amount.",
            "nullable":true
        },
        "RequestedAlignBillingDate":{
            "type":"string",
            "description":"The requested align billing date.",
            "format":"date",
            "nullable":true
        },
        "charges":{
            "title":"Preview Subscription Charges",
            "type":"array",
            "description":"Preview subscriptions lets you view amended subscription product charges before creating, updating, or deleting a subscription.",
            "items":{
                "$ref":"#/components/schemas/previewSubscriptions-products-charges-item-post-request"
            }
        },
        "SuppressedCreditAmount":{
            "type":"number",
            "description":"The suppressed credit amount.",
            "nullable":true
        },
        "ProductFiscClassification":{
            "maxLength":255,
            "type":"string",
            "description":"The product fiscal classification.",
            "nullable":true
        },
        "PriceListId":{
            "type":"integer",
            "description":"The price list ID.",
            "nullable":true
        },
        "CopyOneTimeCharges":{
            "maxLength":255,
            "type":"string",
            "description":"Indicates whether the one time charges should be copied for the product or not.",
            "nullable":true
        },
        "ClosedDate":{
            "type":"string",
            "description":"The closed date.",
            "format":"date",
            "nullable":true
        },
        "CopyCharges":{
            "type":"string",
            "description":"Indicates whether the charges should be copied for the product or not.",
            "nullable":true
        },
        "DefinitionOrganizationId":{
            "type":"integer",
            "description":"The definition organization ID.",
            "nullable":true
        },
        "OutputTaxClassification":{
            "maxLength":255,
            "type":"string",
            "description":"The output tax classification.",
            "nullable":true
        }
    }
}

Nested Schema : Amended Product

Type: array

Title: Amended Product

Preview subscriptions lets you view amended subscription product details before creating, updating or deleting a subscription.

Show Source

• Array of: object schema

{
    "title":"Amended Product",
    "type":"array",
    "description":"Preview subscriptions lets you view amended subscription product details before creating, updating or deleting a subscription.",
    "items":{
        "$ref":"#/components/schemas/previewSubscriptions-products-amendedProduct-item-post-request"
    }
}

Nested Schema : Preview Subscription Charges

Type: array

Title: Preview Subscription Charges

Preview subscriptions lets you view amended subscription product charges before creating, updating, or deleting a subscription.

Show Source

• Array of: object schema

{
    "title":"Preview Subscription Charges",
    "type":"array",
    "description":"Preview subscriptions lets you view amended subscription product charges before creating, updating, or deleting a subscription.",
    "items":{
        "$ref":"#/components/schemas/previewSubscriptions-products-charges-item-post-request"
    }
}

Nested Schema : Preview Subscription Bill Lines

Type: array

Title: Preview Subscription Bill Lines

Preview subscriptions lets you view subscription product details before creating, updating, or deleting a subscription.

Show Source

• Array of: object previewSubscriptions-products-output-item-post-request

{
    "title":"Preview Subscription Bill Lines",
    "type":"array",
    "description":"Preview subscriptions lets you view subscription product details before creating, updating, or deleting a subscription.",
    "items":{
        "$ref":"#/components/schemas/previewSubscriptions-products-output-item-post-request"
    }
}

Nested Schema : schema

Type: object

Show Source

• AlignBillingFrom: string (date)
  The align billing from of the amended product.
• BillingFrequency: string
  The billing frequency of the amended product.
• charges: array Preview Subscription Charges
  Title: Preview Subscription Charges

  Preview subscriptions lets you view amended subscription product charges before creating, updating, or deleting a subscription.
• EndDate: string (date)
  The end date of the amended product.
• EstimatedTax: number
  The estimated tax of the amended product.
• InventoryItemId: integer
  The inventory item ID of the amended product.
• ItemUnitOfMeasure: string
  The item unit of measure of the amended product.
• output: array Preview Subscription Bill Lines
  Title: Preview Subscription Bill Lines

  Preview subscriptions lets you view subscription product details before creating, updating, or deleting a subscription.
• PriceListId: integer
  The price list ID of the amended product.
• ProductName: string
  The name of the amended product.
• Quantity: number
  The quantity of the amended product.
• RequestedAlignBillingDate: string (date)
  The requested align billing date of the amended product.
• RequestedRatePlanId: integer
  The requested rate plan ID of the amended product.
• RequestedRatePlanNumber: string
  Maximum Length: 255

  The requested rate plan number of the amended product.
• StartDate: string (date)
  The start date of the amended product.
• TotalContractValue: number
  The total contract value of the amended product.

{
    "type":"object",
    "properties":{
        "AlignBillingFrom":{
            "type":"string",
            "description":"The align billing from of the amended product.",
            "format":"date",
            "nullable":true
        },
        "ProductName":{
            "type":"string",
            "description":"The name of the amended product.",
            "nullable":true
        },
        "BillingFrequency":{
            "type":"string",
            "description":"The billing frequency of the amended product.",
            "nullable":true
        },
        "TotalContractValue":{
            "type":"number",
            "description":"The total contract value of the amended product.",
            "nullable":true
        },
        "InventoryItemId":{
            "type":"integer",
            "description":"The inventory item ID of the amended product.",
            "nullable":true
        },
        "Quantity":{
            "type":"number",
            "description":"The quantity of the amended product.",
            "nullable":true
        },
        "RequestedRatePlanId":{
            "type":"integer",
            "description":"The requested rate plan ID of the amended product.",
            "nullable":true
        },
        "EstimatedTax":{
            "type":"number",
            "description":"The estimated tax of the amended product.",
            "nullable":true
        },
        "EndDate":{
            "type":"string",
            "description":"The end date of the amended product.",
            "format":"date",
            "nullable":true
        },
        "StartDate":{
            "type":"string",
            "description":"The start date of the amended product.",
            "format":"date",
            "nullable":true
        },
        "output":{
            "title":"Preview Subscription Bill Lines",
            "type":"array",
            "description":"Preview subscriptions lets you view subscription product details before creating, updating, or deleting a subscription.",
            "items":{
                "$ref":"#/components/schemas/previewSubscriptions-products-amendedProduct-output-item-post-request"
            }
        },
        "RequestedAlignBillingDate":{
            "type":"string",
            "description":"The requested align billing date of the amended product.",
            "format":"date",
            "nullable":true
        },
        "charges":{
            "title":"Preview Subscription Charges",
            "type":"array",
            "description":"Preview subscriptions lets you view amended subscription product charges before creating, updating, or deleting a subscription.",
            "items":{
                "$ref":"#/components/schemas/previewSubscriptions-products-amendedProduct-charges-item-post-request"
            }
        },
        "RequestedRatePlanNumber":{
            "maxLength":255,
            "type":"string",
            "description":"The requested rate plan number of the amended product.",
            "nullable":true
        },
        "PriceListId":{
            "type":"integer",
            "description":"The price list ID of the amended product.",
            "nullable":true
        },
        "ItemUnitOfMeasure":{
            "type":"string",
            "description":"The item unit of measure of the amended product.",
            "nullable":true
        }
    }
}

Nested Schema : Preview Subscription Charges

Type: array

Title: Preview Subscription Charges

Preview subscriptions lets you view amended subscription product charges before creating, updating, or deleting a subscription.

Show Source

• Array of: object previewSubscriptions-products-amendedProduct-charges-item-post-request

{
    "title":"Preview Subscription Charges",
    "type":"array",
    "description":"Preview subscriptions lets you view amended subscription product charges before creating, updating, or deleting a subscription.",
    "items":{
        "$ref":"#/components/schemas/previewSubscriptions-products-amendedProduct-charges-item-post-request"
    }
}

Nested Schema : Preview Subscription Bill Lines

Type: array

Title: Preview Subscription Bill Lines

Preview subscriptions lets you view subscription product details before creating, updating, or deleting a subscription.

Show Source

• Array of: object schema

{
    "title":"Preview Subscription Bill Lines",
    "type":"array",
    "description":"Preview subscriptions lets you view subscription product details before creating, updating, or deleting a subscription.",
    "items":{
        "$ref":"#/components/schemas/previewSubscriptions-products-amendedProduct-output-item-post-request"
    }
}

Nested Schema : previewSubscriptions-products-amendedProduct-charges-item-post-request

Type: object

Show Source

• adjustments: array Subscription Charge Adjustment
  Title: Subscription Charge Adjustment
• BillingFreq: string
  Maximum Length: 255

  The billing frequency of the subscription product charge.
• ChargeDefinition: string
  The charge definition of the charge.
• ChargeName: string
  The charge name of the charge.
• EstimatedAmount: number
  The estimated amount of the charge.
• EstimatedQuantity: number
  The estimated quantity of a charge.
• EstimationMethod: string
  Maximum Length: 255

  The estimation method of the charge.
• InvoicingRuleId: integer
  The invoicing rule ID.
• PeriodicBillingFlag: boolean
  Maximum Length: 255

  The period billing indicator.
• PricePeriodicity: string
  The price periodicity of the charge.
• PriceType: string
  The price type of the charge.
• QuotedTcv: number
  The quoted TCV of the charge.
• UnitListPrice: number
  The unit list price of the charge.

{
    "type":"object",
    "properties":{
        "EstimatedQuantity":{
            "type":"number",
            "description":"The estimated quantity of a charge.",
            "nullable":true
        },
        "InvoicingRuleId":{
            "type":"integer",
            "description":"The invoicing rule ID.",
            "nullable":true
        },
        "adjustments":{
            "title":"Subscription Charge Adjustment",
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/previewSubscriptions-products-amendedProduct-charges-adjustments-item-post-request"
            }
        },
        "ChargeDefinition":{
            "type":"string",
            "description":"The charge definition of the charge.",
            "nullable":true
        },
        "EstimatedAmount":{
            "type":"number",
            "description":"The estimated amount of the charge.",
            "nullable":true
        },
        "ChargeName":{
            "type":"string",
            "description":"The charge name of the charge.",
            "nullable":true
        },
        "QuotedTcv":{
            "type":"number",
            "description":"The quoted TCV of the charge.",
            "nullable":true
        },
        "BillingFreq":{
            "maxLength":255,
            "type":"string",
            "description":"The billing frequency of the subscription product charge.",
            "nullable":true
        },
        "EstimationMethod":{
            "maxLength":255,
            "type":"string",
            "description":"The estimation method of the charge.",
            "nullable":true
        },
        "PricePeriodicity":{
            "type":"string",
            "description":"The price periodicity of the charge.",
            "nullable":true
        },
        "PeriodicBillingFlag":{
            "maxLength":255,
            "type":"boolean",
            "description":"The period billing indicator.",
            "nullable":true
        },
        "UnitListPrice":{
            "type":"number",
            "description":"The unit list price of the charge.",
            "nullable":true
        },
        "PriceType":{
            "type":"string",
            "description":"The price type of the charge.",
            "nullable":true
        }
    }
}

Nested Schema : Subscription Charge Adjustment

Type: array

Title: Subscription Charge Adjustment

Show Source

• Array of: object previewSubscriptions-products-amendedProduct-charges-adjustments-item-post-request

{
    "title":"Subscription Charge Adjustment",
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/previewSubscriptions-products-amendedProduct-charges-adjustments-item-post-request"
    }
}

Nested Schema : previewSubscriptions-products-amendedProduct-charges-adjustments-item-post-request

Type: object

Show Source

• AdjustmentBasis: string
  Maximum Length: 255
• AdjustmentName: string
  Maximum Length: 255
• AdjustmentType: string
  Maximum Length: 255
• AdjustmentValue: number
• AutoAdjustmentFlag: boolean
  Maximum Length: 255
• Effectivity: string
  Maximum Length: 255
• NumberOfPeriods: number
• PeriodFrom: number
• PeriodUntil: number
• SequenceNumber: integer

{
    "type":"object",
    "properties":{
        "AutoAdjustmentFlag":{
            "maxLength":255,
            "type":"boolean",
            "nullable":true
        },
        "AdjustmentValue":{
            "type":"number",
            "nullable":true
        },
        "AdjustmentBasis":{
            "maxLength":255,
            "type":"string",
            "nullable":true
        },
        "SequenceNumber":{
            "type":"integer",
            "nullable":true
        },
        "NumberOfPeriods":{
            "type":"number",
            "nullable":true
        },
        "Effectivity":{
            "maxLength":255,
            "type":"string",
            "nullable":true
        },
        "AdjustmentName":{
            "maxLength":255,
            "type":"string",
            "nullable":true
        },
        "PeriodUntil":{
            "type":"number",
            "nullable":true
        },
        "AdjustmentType":{
            "maxLength":255,
            "type":"string",
            "nullable":true
        },
        "PeriodFrom":{
            "type":"number",
            "nullable":true
        }
    }
}

Nested Schema : schema

Type: object

Show Source

• BillLineHeader: string
  Maximum Length: 255

  The bill line header of the bill lines.
• BillLineValues: string
  The bill line values of the bill lines.
• ChargeAdjustmentHeader: string
  Maximum Length: 255

  The charge adjustment header of the preview.
• ChargeHeader: string
  Maximum Length: 255

  The charge header of the preview.
• ChargeValues: string
  The charge values of the preview.
• NumberOfBillingCycles: integer
  The number of billing cycles for preview.

{
    "type":"object",
    "properties":{
        "BillLineHeader":{
            "maxLength":255,
            "type":"string",
            "description":"The bill line header of the bill lines.",
            "nullable":false
        },
        "BillLineValues":{
            "type":"string",
            "description":"The bill line values of the bill lines.",
            "nullable":false
        },
        "NumberOfBillingCycles":{
            "type":"integer",
            "description":"The number of billing cycles for preview.",
            "nullable":true
        },
        "ChargeValues":{
            "type":"string",
            "description":"The charge values of the preview.",
            "nullable":true
        },
        "ChargeHeader":{
            "maxLength":255,
            "type":"string",
            "description":"The charge header of the preview.",
            "nullable":true
        },
        "ChargeAdjustmentHeader":{
            "maxLength":255,
            "type":"string",
            "description":"The charge adjustment header of the preview.",
            "nullable":true
        }
    }
}

Nested Schema : schema

Type: object

Show Source

• adjustments: array Subscription Charge Adjustment
  Title: Subscription Charge Adjustment
• BillingFreq: string
  Maximum Length: 255

  The billing frequency of the subscription product charge.
• ChargeDefinition: string
  The charge definition of the charge.
• ChargeName: string
  The charge name of the charge.
• EstimatedAmount: number
  The estimated amount of the charge.
• EstimatedQuantity: number
  The estimated quantity of a charge.
• EstimationMethod: string
  Maximum Length: 255

  The estimation method of the charge.
• InvoicingRuleId: integer
  The invoicing rule ID.
• PeriodicBillingFlag: boolean
  Maximum Length: 255

  The period billing indicator.
• PricePeriodicity: string
  The price periodicity of the charge.
• PriceType: string
  The price type of the charge.
• QuotedTcv: number
  The quoted TCV of the charge.
• UnitListPrice: number
  The unit list price of the charge.

{
    "type":"object",
    "properties":{
        "EstimatedQuantity":{
            "type":"number",
            "description":"The estimated quantity of a charge.",
            "nullable":true
        },
        "InvoicingRuleId":{
            "type":"integer",
            "description":"The invoicing rule ID.",
            "nullable":true
        },
        "adjustments":{
            "title":"Subscription Charge Adjustment",
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/previewSubscriptions-products-charges-adjustments-item-post-request"
            }
        },
        "ChargeDefinition":{
            "type":"string",
            "description":"The charge definition of the charge.",
            "nullable":true
        },
        "EstimatedAmount":{
            "type":"number",
            "description":"The estimated amount of the charge.",
            "nullable":true
        },
        "ChargeName":{
            "type":"string",
            "description":"The charge name of the charge.",
            "nullable":true
        },
        "QuotedTcv":{
            "type":"number",
            "description":"The quoted TCV of the charge.",
            "nullable":true
        },
        "BillingFreq":{
            "maxLength":255,
            "type":"string",
            "description":"The billing frequency of the subscription product charge.",
            "nullable":true
        },
        "EstimationMethod":{
            "maxLength":255,
            "type":"string",
            "description":"The estimation method of the charge.",
            "nullable":true
        },
        "PricePeriodicity":{
            "type":"string",
            "description":"The price periodicity of the charge.",
            "nullable":true
        },
        "PeriodicBillingFlag":{
            "maxLength":255,
            "type":"boolean",
            "description":"The period billing indicator.",
            "nullable":true
        },
        "UnitListPrice":{
            "type":"number",
            "description":"The unit list price of the charge.",
            "nullable":true
        },
        "PriceType":{
            "type":"string",
            "description":"The price type of the charge.",
            "nullable":true
        }
    }
}

Nested Schema : Subscription Charge Adjustment

Type: array

Title: Subscription Charge Adjustment

Show Source

• Array of: object previewSubscriptions-products-charges-adjustments-item-post-request

{
    "title":"Subscription Charge Adjustment",
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/previewSubscriptions-products-charges-adjustments-item-post-request"
    }
}

Nested Schema : previewSubscriptions-products-charges-adjustments-item-post-request

Type: object

Show Source

• AdjustmentBasis: string
  Maximum Length: 255
• AdjustmentName: string
  Maximum Length: 255
• AdjustmentType: string
  Maximum Length: 255
• AdjustmentValue: number
• AutoAdjustmentFlag: boolean
  Maximum Length: 255
• Effectivity: string
  Maximum Length: 255
• NumberOfPeriods: number
• PeriodFrom: number
• PeriodUntil: number
• SequenceNumber: integer

{
    "type":"object",
    "properties":{
        "AutoAdjustmentFlag":{
            "maxLength":255,
            "type":"boolean",
            "nullable":true
        },
        "AdjustmentValue":{
            "type":"number",
            "nullable":true
        },
        "AdjustmentBasis":{
            "maxLength":255,
            "type":"string",
            "nullable":true
        },
        "SequenceNumber":{
            "type":"integer",
            "nullable":true
        },
        "NumberOfPeriods":{
            "type":"number",
            "nullable":true
        },
        "Effectivity":{
            "maxLength":255,
            "type":"string",
            "nullable":true
        },
        "AdjustmentName":{
            "maxLength":255,
            "type":"string",
            "nullable":true
        },
        "PeriodUntil":{
            "type":"number",
            "nullable":true
        },
        "AdjustmentType":{
            "maxLength":255,
            "type":"string",
            "nullable":true
        },
        "PeriodFrom":{
            "type":"number",
            "nullable":true
        }
    }
}

Nested Schema : previewSubscriptions-products-output-item-post-request

Type: object

Show Source

• BillLineHeader: string
  Maximum Length: 255

  The bill line header of the bill lines.
• BillLineValues: string
  The bill line values of the bill lines.
• ChargeAdjustmentHeader: string
  Maximum Length: 255

  The charge adjustment header of the preview.
• ChargeHeader: string
  Maximum Length: 255

  The charge header of the preview.
• ChargeValues: string
  The charge values of the preview.
• NumberOfBillingCycles: integer
  The number of billing cycles for preview.

{
    "type":"object",
    "properties":{
        "BillLineHeader":{
            "maxLength":255,
            "type":"string",
            "description":"The bill line header of the bill lines.",
            "nullable":false
        },
        "BillLineValues":{
            "type":"string",
            "description":"The bill line values of the bill lines.",
            "nullable":false
        },
        "NumberOfBillingCycles":{
            "type":"integer",
            "description":"The number of billing cycles for preview.",
            "nullable":true
        },
        "ChargeValues":{
            "type":"string",
            "description":"The charge values of the preview.",
            "nullable":true
        },
        "ChargeHeader":{
            "maxLength":255,
            "type":"string",
            "description":"The charge header of the preview.",
            "nullable":true
        },
        "ChargeAdjustmentHeader":{
            "maxLength":255,
            "type":"string",
            "description":"The charge adjustment header of the preview.",
            "nullable":true
        }
    }
}

Back to Top

Response

Supported Media Types

• application/json

Default Response

The following table describes the default response for this task.

Headers

• Metadata-Context:
  If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
• REST-Framework-Version:
  The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.

Body ()

Root Schema : previewSubscriptions-item-response

Type: object

Show Source

• BillToAccountId: integer
  The bill-to account ID.
• BillToAccountNumber: string
  Maximum Length: 255

  The bill-to account number.
• BillToSiteNumber: string
  Maximum Length: 255

  The bill-to site number.
• BillToSiteUseId: integer
  The bill-to site use ID.
• BusinessUnitId: integer
  The business unit ID.
• Currency: string
  Maximum Length: 255

  The currency of the preview subscription.
• DocumentFiscalClassification: string
  Maximum Length: 255

  The document fiscal classification.
• EndDate: string (date)
  The end date of the subscription.
• ExemptCertificateNumber: string
  Maximum Length: 255

  The exempt certificate number.
• LegalEntityId: integer
  The legal entity ID.
• links: array Links
  Title: Links

  The link relations associated with the resource instance.
• PricingStrategyId: integer
  The pricing strategy ID.
• PrimaryPartyId: integer
  The unique primary party identifier of the preview subscription.
• PrimaryPartyNumber: string
  Maximum Length: 255

  The primary party number.
• products: array Preview Subscription Products
  Title: Preview Subscription Products

  Preview subscriptions lets you view a subscription product before creating, updating, or deleting a subscription.
• ShipToParty: integer
  The ship-to party.
• ShipToPartyNumber: string
  Maximum Length: 255

  The ship-to party number.
• StartDate: string (date)
  The start date of the subscription.
• SubscriptionId: integer
  The unique subscription identifier of the preview subscription.
• SubscriptionNumber: string
  Maximum Length: 255

  The subscription number of the preview subscription.
• SubscriptionProfileName: string
  Maximum Length: 300

  The subscription profile name.
• TaxClassificationCode: string
  Maximum Length: 255

  The tax classification code.

{
    "type":"object",
    "properties":{
        "SubscriptionNumber":{
            "maxLength":255,
            "type":"string",
            "description":"The subscription number of the preview subscription.",
            "nullable":true,
            "x-queryable":true
        },
        "SubscriptionProfileName":{
            "maxLength":300,
            "type":"string",
            "description":"The subscription profile name.",
            "nullable":true,
            "x-queryable":true
        },
        "BillToSiteUseId":{
            "type":"integer",
            "description":"The bill-to site use ID.",
            "nullable":true,
            "x-queryable":true
        },
        "ShipToPartyNumber":{
            "maxLength":255,
            "type":"string",
            "description":"The ship-to party number.",
            "nullable":true,
            "x-queryable":true
        },
        "BusinessUnitId":{
            "type":"integer",
            "description":"The business unit ID.",
            "nullable":true,
            "x-queryable":true
        },
        "PrimaryPartyId":{
            "type":"integer",
            "description":"The unique primary party identifier of the preview subscription.",
            "nullable":true,
            "x-queryable":true
        },
        "BillToAccountNumber":{
            "maxLength":255,
            "type":"string",
            "description":"The bill-to account number.",
            "nullable":true,
            "x-queryable":true
        },
        "ExemptCertificateNumber":{
            "maxLength":255,
            "type":"string",
            "description":"The exempt certificate number.",
            "nullable":true,
            "x-queryable":true
        },
        "EndDate":{
            "type":"string",
            "description":"The end date of the subscription.",
            "format":"date",
            "nullable":true,
            "x-queryable":true
        },
        "products":{
            "title":"Preview Subscription Products",
            "type":"array",
            "description":"Preview subscriptions lets you view a subscription product before creating, updating, or deleting a subscription.",
            "items":{
                "$ref":"#/components/schemas/previewSubscriptions-products-item-response"
            }
        },
        "BillToSiteNumber":{
            "maxLength":255,
            "type":"string",
            "description":"The bill-to site number.",
            "nullable":true,
            "x-queryable":true
        },
        "StartDate":{
            "type":"string",
            "description":"The start date of the subscription.",
            "format":"date",
            "nullable":true,
            "x-queryable":true
        },
        "DocumentFiscalClassification":{
            "maxLength":255,
            "type":"string",
            "description":"The document fiscal classification.",
            "nullable":true,
            "x-queryable":true
        },
        "SubscriptionId":{
            "type":"integer",
            "description":"The unique subscription identifier of the preview subscription.",
            "nullable":false,
            "x-queryable":true
        },
        "ShipToParty":{
            "type":"integer",
            "description":"The ship-to party.",
            "nullable":true,
            "x-queryable":true
        },
        "BillToAccountId":{
            "type":"integer",
            "description":"The bill-to account ID.",
            "nullable":true,
            "x-queryable":true
        },
        "LegalEntityId":{
            "type":"integer",
            "description":"The legal entity ID.",
            "nullable":true,
            "x-queryable":true
        },
        "Currency":{
            "maxLength":255,
            "type":"string",
            "description":"The currency of the preview subscription.",
            "nullable":false,
            "x-queryable":true
        },
        "TaxClassificationCode":{
            "maxLength":255,
            "type":"string",
            "description":"The tax classification code.",
            "nullable":true,
            "x-queryable":true
        },
        "links":{
            "title":"Links",
            "type":"array",
            "description":"The link relations associated with the resource instance.",
            "items":{
                "$ref":"#/components/schemas/link"
            }
        },
        "PricingStrategyId":{
            "type":"integer",
            "description":"The pricing strategy ID.",
            "nullable":true,
            "x-queryable":true
        },
        "PrimaryPartyNumber":{
            "maxLength":255,
            "type":"string",
            "description":"The primary party number.",
            "nullable":true,
            "x-queryable":true
        }
    }
}

Nested Schema : Links

Type: array

Title: Links

The link relations associated with the resource instance.

Show Source

• Array of: object link

{
    "title":"Links",
    "type":"array",
    "description":"The link relations associated with the resource instance.",
    "items":{
        "$ref":"#/components/schemas/link"
    }
}

Nested Schema : Preview Subscription Products

Type: array

Title: Preview Subscription Products

Preview subscriptions lets you view a subscription product before creating, updating, or deleting a subscription.

Show Source

• Array of: object previewSubscriptions-products-item-response

{
    "title":"Preview Subscription Products",
    "type":"array",
    "description":"Preview subscriptions lets you view a subscription product before creating, updating, or deleting a subscription.",
    "items":{
        "$ref":"#/components/schemas/previewSubscriptions-products-item-response"
    }
}

Nested Schema : link

Type: object

Show Source

• href: string
  Title: hyperlink reference

  The URI to the related resource.
• kind: string
  Title: kind

  Allowed Values: [ "collection", "item", "describe", "other" ]

  The kind of the related resource.
• name: string
  Title: name

  The name of the link to the related resource.
• properties: object properties
• rel: string
  Title: relation

  Allowed Values: [ "self", "lov", "parent", "canonical", "child", "enclosure", "action", "custom" ]

  The name of the relation to the resource instance. Example: self.

{
    "type":"object",
    "properties":{
        "kind":{
            "title":"kind",
            "type":"string",
            "description":"The kind of the related resource.",
            "enum":[
                "collection",
                "item",
                "describe",
                "other"
            ]
        },
        "rel":{
            "title":"relation",
            "type":"string",
            "description":"The name of the relation to the resource instance.  Example: self.",
            "enum":[
                "self",
                "lov",
                "parent",
                "canonical",
                "child",
                "enclosure",
                "action",
                "custom"
            ]
        },
        "name":{
            "title":"name",
            "type":"string",
            "description":"The name of the link to the related resource."
        },
        "href":{
            "title":"hyperlink reference",
            "type":"string",
            "description":"The URI to the related resource."
        },
        "properties":{
            "type":"object",
            "properties":{
                "changeIndicator":{
                    "type":"string",
                    "description":"Change indicator or the ETag value of the resource instance."
                }
            }
        }
    }
}

Nested Schema : properties

Type: object

Show Source

• changeIndicator: string
  Change indicator or the ETag value of the resource instance.

{
    "type":"object",
    "properties":{
        "changeIndicator":{
            "type":"string",
            "description":"Change indicator or the ETag value of the resource instance."
        }
    }
}

Nested Schema : previewSubscriptions-products-item-response

Type: object

Show Source

• ActionCode: string
  Maximum Length: 255

  The action code for the preview.
• AlignBillingFrom: string (date)
  The align billing from for the preview.
• AmendCreditMethod: string
  Maximum Length: 255

  The amendment credit method.
• AmendDescription: string
  Maximum Length: 255

  The amendment description.
• amendedProduct: array Amended Product
  Title: Amended Product

  Preview subscriptions lets you view amended subscription product details before creating, updating or deleting a subscription.
• AmendEffectiveDate: string (date)
  The amendment effective date.
• AmendReason: string
  Maximum Length: 255

  The amendment reason.
• BillingFrequency: string
  The billing frequency of the subscription product.
• charges: array Preview Subscription Charges
  Title: Preview Subscription Charges

  Preview subscriptions lets you view amended subscription product charges before creating, updating, or deleting a subscription.
• CloseCreditMethod: string
  Maximum Length: 255

  The close credit method for the preview.
• ClosedAmount: number
  The closed amount.
• ClosedDate: string (date)
  The closed date.
• CloseReason: string
  Maximum Length: 255

  The close reason.
• CopyAdjustments: string
  Maximum Length: 255

  Indicates whether the adjustments should be copied for the product or not.
• CopyCharges: string
  Indicates whether the charges should be copied for the product or not.
• CopyOneTimeCharges: string
  Maximum Length: 255

  Indicates whether the one time charges should be copied for the product or not.
• CreditedAmount: number
  The credited amount.
• DefinitionOrganizationId: integer
  The definition organization ID.
• EndDate: string (date)
  The end date of the subscription product.
• EstimatedTax: number
  The estimated tax.
• ExemptCertificateNumber: string
  Maximum Length: 255

  The exempt certificate number.
• InventoryItemId: integer
  The inventory item ID.
• ItemUnitOfMeasure: string
  The item unit of measure of the subscription product.
• links: array Links
  Title: Links

  The link relations associated with the resource instance.
• output: array Preview Subscription Bill Lines
  Title: Preview Subscription Bill Lines

  Preview subscriptions lets you view subscription product details before creating, updating, or deleting a subscription.
• OutputTaxClassification: string
  Maximum Length: 255

  The output tax classification.
• PriceListId: integer
  The price list ID.
• ProductFiscClassification: string
  Maximum Length: 255

  The product fiscal classification.
• ProductName: string
  The product name of the subscription product.
• Quantity: number
  The quantity of the subscription product.
• RequestedAlignBillingDate: string (date)
  The requested align billing date.
• RequestedRatePlanId: integer
  The request rate plan identifier of the subscription product.
• RequestedRatePlanNumber: string
  Maximum Length: 255

  The requested rate plan number.
• SalesProductType: string
  Maximum Length: 255

  The sales product type.
• StartDate: string (date)
  The start date of the subscription product.
• SubscriptionProductPuid: string
  Maximum Length: 255

  The subscription product PUID.
• SuppressedCreditAmount: number
  The suppressed credit amount.
• TotalContractValue: number
  The total contract value.

{
    "type":"object",
    "properties":{
        "SalesProductType":{
            "maxLength":255,
            "type":"string",
            "description":"The sales product type.",
            "nullable":true,
            "x-queryable":true
        },
        "AmendReason":{
            "maxLength":255,
            "type":"string",
            "description":"The amendment reason.",
            "nullable":true,
            "x-queryable":true
        },
        "ProductName":{
            "type":"string",
            "description":"The product name of the subscription product.",
            "nullable":true,
            "x-queryable":true
        },
        "AmendCreditMethod":{
            "maxLength":255,
            "type":"string",
            "description":"The amendment credit method.",
            "nullable":true,
            "x-queryable":true
        },
        "ActionCode":{
            "maxLength":255,
            "type":"string",
            "description":"The action code for the preview.",
            "nullable":true,
            "x-queryable":true
        },
        "StartDate":{
            "type":"string",
            "description":"The start date of the subscription product.",
            "format":"date",
            "nullable":true,
            "x-queryable":true
        },
        "output":{
            "title":"Preview Subscription Bill Lines",
            "type":"array",
            "description":"Preview subscriptions lets you view subscription product details before creating, updating, or deleting a subscription.",
            "items":{
                "$ref":"#/components/schemas/previewSubscriptions-products-output-item-response"
            }
        },
        "RequestedRatePlanNumber":{
            "maxLength":255,
            "type":"string",
            "description":"The requested rate plan number.",
            "nullable":true,
            "x-queryable":true
        },
        "CloseReason":{
            "maxLength":255,
            "type":"string",
            "description":"The close reason.",
            "nullable":true,
            "x-queryable":true
        },
        "AmendEffectiveDate":{
            "type":"string",
            "description":"The amendment effective date.",
            "format":"date",
            "nullable":true,
            "x-queryable":true
        },
        "links":{
            "title":"Links",
            "type":"array",
            "description":"The link relations associated with the resource instance.",
            "items":{
                "$ref":"#/components/schemas/link"
            }
        },
        "amendedProduct":{
            "title":"Amended Product",
            "type":"array",
            "description":"Preview subscriptions lets you view amended subscription product details before creating, updating or deleting a subscription.",
            "items":{
                "$ref":"#/components/schemas/previewSubscriptions-products-amendedProduct-item-response"
            }
        },
        "ItemUnitOfMeasure":{
            "type":"string",
            "description":"The item unit of measure of the subscription product.",
            "nullable":true,
            "x-queryable":true
        },
        "CopyAdjustments":{
            "maxLength":255,
            "type":"string",
            "description":"Indicates whether the adjustments should be copied for the product or not.",
            "nullable":true,
            "x-queryable":true
        },
        "AlignBillingFrom":{
            "type":"string",
            "description":"The align billing from for the preview.",
            "format":"date",
            "nullable":true,
            "x-queryable":true
        },
        "BillingFrequency":{
            "type":"string",
            "description":"The billing frequency of the subscription product.",
            "nullable":true,
            "x-queryable":true
        },
        "TotalContractValue":{
            "type":"number",
            "description":"The total contract value.",
            "nullable":true,
            "x-queryable":true
        },
        "SubscriptionProductPuid":{
            "maxLength":255,
            "type":"string",
            "description":"The subscription product PUID.",
            "nullable":true,
            "x-queryable":true
        },
        "InventoryItemId":{
            "type":"integer",
            "description":"The inventory item ID.",
            "nullable":true,
            "x-queryable":true
        },
        "CreditedAmount":{
            "type":"number",
            "description":"The credited amount.",
            "nullable":true,
            "x-queryable":true
        },
        "Quantity":{
            "type":"number",
            "description":"The quantity of the subscription product.",
            "nullable":true,
            "x-queryable":true
        },
        "CloseCreditMethod":{
            "maxLength":255,
            "type":"string",
            "description":"The close credit method for the preview.",
            "nullable":true,
            "x-queryable":true
        },
        "RequestedRatePlanId":{
            "type":"integer",
            "description":"The request rate plan identifier of the subscription product.",
            "nullable":true,
            "x-queryable":true
        },
        "AmendDescription":{
            "maxLength":255,
            "type":"string",
            "description":"The amendment description.",
            "nullable":true,
            "x-queryable":true
        },
        "EstimatedTax":{
            "type":"number",
            "description":"The estimated tax.",
            "nullable":true,
            "x-queryable":true
        },
        "ExemptCertificateNumber":{
            "maxLength":255,
            "type":"string",
            "description":"The exempt certificate number.",
            "nullable":true,
            "x-queryable":true
        },
        "EndDate":{
            "type":"string",
            "description":"The end date of the subscription product.",
            "format":"date",
            "nullable":true,
            "x-queryable":true
        },
        "ClosedAmount":{
            "type":"number",
            "description":"The closed amount.",
            "nullable":true,
            "x-queryable":true
        },
        "RequestedAlignBillingDate":{
            "type":"string",
            "description":"The requested align billing date.",
            "format":"date",
            "nullable":true,
            "x-queryable":true
        },
        "charges":{
            "title":"Preview Subscription Charges",
            "type":"array",
            "description":"Preview subscriptions lets you view amended subscription product charges before creating, updating, or deleting a subscription.",
            "items":{
                "$ref":"#/components/schemas/previewSubscriptions-products-charges-item-response"
            }
        },
        "SuppressedCreditAmount":{
            "type":"number",
            "description":"The suppressed credit amount.",
            "nullable":true,
            "x-queryable":true
        },
        "ProductFiscClassification":{
            "maxLength":255,
            "type":"string",
            "description":"The product fiscal classification.",
            "nullable":true,
            "x-queryable":true
        },
        "PriceListId":{
            "type":"integer",
            "description":"The price list ID.",
            "nullable":true,
            "x-queryable":true
        },
        "CopyOneTimeCharges":{
            "maxLength":255,
            "type":"string",
            "description":"Indicates whether the one time charges should be copied for the product or not.",
            "nullable":true,
            "x-queryable":true
        },
        "ClosedDate":{
            "type":"string",
            "description":"The closed date.",
            "format":"date",
            "nullable":true,
            "x-queryable":true
        },
        "CopyCharges":{
            "type":"string",
            "description":"Indicates whether the charges should be copied for the product or not.",
            "nullable":true,
            "x-queryable":true
        },
        "DefinitionOrganizationId":{
            "type":"integer",
            "description":"The definition organization ID.",
            "nullable":true,
            "x-queryable":true
        },
        "OutputTaxClassification":{
            "maxLength":255,
            "type":"string",
            "description":"The output tax classification.",
            "nullable":true,
            "x-queryable":true
        }
    }
}

Nested Schema : Amended Product

Type: array

Title: Amended Product

Preview subscriptions lets you view amended subscription product details before creating, updating or deleting a subscription.

Show Source

• Array of: object previewSubscriptions-products-amendedProduct-item-response

{
    "title":"Amended Product",
    "type":"array",
    "description":"Preview subscriptions lets you view amended subscription product details before creating, updating or deleting a subscription.",
    "items":{
        "$ref":"#/components/schemas/previewSubscriptions-products-amendedProduct-item-response"
    }
}

Nested Schema : Preview Subscription Charges

Type: array

Title: Preview Subscription Charges

Preview subscriptions lets you view amended subscription product charges before creating, updating, or deleting a subscription.

Show Source

• Array of: object previewSubscriptions-products-charges-item-response

{
    "title":"Preview Subscription Charges",
    "type":"array",
    "description":"Preview subscriptions lets you view amended subscription product charges before creating, updating, or deleting a subscription.",
    "items":{
        "$ref":"#/components/schemas/previewSubscriptions-products-charges-item-response"
    }
}

Nested Schema : Links

Type: array

Title: Links

The link relations associated with the resource instance.

Show Source

• Array of: object link

{
    "title":"Links",
    "type":"array",
    "description":"The link relations associated with the resource instance.",
    "items":{
        "$ref":"#/components/schemas/link"
    }
}

Nested Schema : Preview Subscription Bill Lines

Type: array

Title: Preview Subscription Bill Lines

Preview subscriptions lets you view subscription product details before creating, updating, or deleting a subscription.

Show Source

• Array of: object previewSubscriptions-products-output-item-response

{
    "title":"Preview Subscription Bill Lines",
    "type":"array",
    "description":"Preview subscriptions lets you view subscription product details before creating, updating, or deleting a subscription.",
    "items":{
        "$ref":"#/components/schemas/previewSubscriptions-products-output-item-response"
    }
}

Nested Schema : previewSubscriptions-products-amendedProduct-item-response

Type: object

Show Source

• AlignBillingFrom: string (date)
  The align billing from of the amended product.
• BillingFrequency: string
  The billing frequency of the amended product.
• charges: array Preview Subscription Charges
  Title: Preview Subscription Charges

  Preview subscriptions lets you view amended subscription product charges before creating, updating, or deleting a subscription.
• EndDate: string (date)
  The end date of the amended product.
• EstimatedTax: number
  The estimated tax of the amended product.
• InventoryItemId: integer
  The inventory item ID of the amended product.
• ItemUnitOfMeasure: string
  The item unit of measure of the amended product.
• links: array Links
  Title: Links

  The link relations associated with the resource instance.
• output: array Preview Subscription Bill Lines
  Title: Preview Subscription Bill Lines

  Preview subscriptions lets you view subscription product details before creating, updating, or deleting a subscription.
• PriceListId: integer
  The price list ID of the amended product.
• ProductName: string
  The name of the amended product.
• Quantity: number
  The quantity of the amended product.
• RequestedAlignBillingDate: string (date)
  The requested align billing date of the amended product.
• RequestedRatePlanId: integer
  The requested rate plan ID of the amended product.
• RequestedRatePlanNumber: string
  Maximum Length: 255

  The requested rate plan number of the amended product.
• StartDate: string (date)
  The start date of the amended product.
• TotalContractValue: number
  The total contract value of the amended product.

{
    "type":"object",
    "properties":{
        "AlignBillingFrom":{
            "type":"string",
            "description":"The align billing from of the amended product.",
            "format":"date",
            "nullable":true,
            "x-queryable":true
        },
        "ProductName":{
            "type":"string",
            "description":"The name of the amended product.",
            "nullable":true,
            "x-queryable":true
        },
        "BillingFrequency":{
            "type":"string",
            "description":"The billing frequency of the amended product.",
            "nullable":true,
            "x-queryable":true
        },
        "TotalContractValue":{
            "type":"number",
            "description":"The total contract value of the amended product.",
            "nullable":true,
            "x-queryable":true
        },
        "InventoryItemId":{
            "type":"integer",
            "description":"The inventory item ID of the amended product.",
            "nullable":true,
            "x-queryable":true
        },
        "Quantity":{
            "type":"number",
            "description":"The quantity of the amended product.",
            "nullable":true,
            "x-queryable":true
        },
        "RequestedRatePlanId":{
            "type":"integer",
            "description":"The requested rate plan ID of the amended product.",
            "nullable":true,
            "x-queryable":true
        },
        "EstimatedTax":{
            "type":"number",
            "description":"The estimated tax of the amended product.",
            "nullable":true,
            "x-queryable":true
        },
        "EndDate":{
            "type":"string",
            "description":"The end date of the amended product.",
            "format":"date",
            "nullable":true,
            "x-queryable":true
        },
        "StartDate":{
            "type":"string",
            "description":"The start date of the amended product.",
            "format":"date",
            "nullable":true,
            "x-queryable":true
        },
        "output":{
            "title":"Preview Subscription Bill Lines",
            "type":"array",
            "description":"Preview subscriptions lets you view subscription product details before creating, updating, or deleting a subscription.",
            "items":{
                "$ref":"#/components/schemas/previewSubscriptions-products-amendedProduct-output-item-response"
            }
        },
        "RequestedAlignBillingDate":{
            "type":"string",
            "description":"The requested align billing date of the amended product.",
            "format":"date",
            "nullable":true,
            "x-queryable":true
        },
        "charges":{
            "title":"Preview Subscription Charges",
            "type":"array",
            "description":"Preview subscriptions lets you view amended subscription product charges before creating, updating, or deleting a subscription.",
            "items":{
                "$ref":"#/components/schemas/previewSubscriptions-products-amendedProduct-charges-item-response"
            }
        },
        "RequestedRatePlanNumber":{
            "maxLength":255,
            "type":"string",
            "description":"The requested rate plan number of the amended product.",
            "nullable":true,
            "x-queryable":true
        },
        "PriceListId":{
            "type":"integer",
            "description":"The price list ID of the amended product.",
            "nullable":true,
            "x-queryable":true
        },
        "links":{
            "title":"Links",
            "type":"array",
            "description":"The link relations associated with the resource instance.",
            "items":{
                "$ref":"#/components/schemas/link"
            }
        },
        "ItemUnitOfMeasure":{
            "type":"string",
            "description":"The item unit of measure of the amended product.",
            "nullable":true,
            "x-queryable":true
        }
    }
}

Nested Schema : Preview Subscription Charges

Type: array

Title: Preview Subscription Charges

Preview subscriptions lets you view amended subscription product charges before creating, updating, or deleting a subscription.

Show Source

• Array of: object previewSubscriptions-products-amendedProduct-charges-item-response

{
    "title":"Preview Subscription Charges",
    "type":"array",
    "description":"Preview subscriptions lets you view amended subscription product charges before creating, updating, or deleting a subscription.",
    "items":{
        "$ref":"#/components/schemas/previewSubscriptions-products-amendedProduct-charges-item-response"
    }
}

Nested Schema : Links

Type: array

Title: Links

The link relations associated with the resource instance.

Show Source

• Array of: object link

{
    "title":"Links",
    "type":"array",
    "description":"The link relations associated with the resource instance.",
    "items":{
        "$ref":"#/components/schemas/link"
    }
}

Nested Schema : Preview Subscription Bill Lines

Type: array

Title: Preview Subscription Bill Lines

Preview subscriptions lets you view subscription product details before creating, updating, or deleting a subscription.

Show Source

• Array of: object previewSubscriptions-products-amendedProduct-output-item-response

{
    "title":"Preview Subscription Bill Lines",
    "type":"array",
    "description":"Preview subscriptions lets you view subscription product details before creating, updating, or deleting a subscription.",
    "items":{
        "$ref":"#/components/schemas/previewSubscriptions-products-amendedProduct-output-item-response"
    }
}

Nested Schema : previewSubscriptions-products-amendedProduct-charges-item-response

Type: object

Show Source

• adjustments: array Subscription Charge Adjustment
  Title: Subscription Charge Adjustment
• BillingFreq: string
  Maximum Length: 255

  The billing frequency of the subscription product charge.
• ChargeDefinition: string
  The charge definition of the charge.
• ChargeName: string
  The charge name of the charge.
• EstimatedAmount: number
  The estimated amount of the charge.
• EstimatedQuantity: number
  The estimated quantity of a charge.
• EstimationMethod: string
  Maximum Length: 255

  The estimation method of the charge.
• InvoicingRuleId: integer
  The invoicing rule ID.
• links: array Links
  Title: Links

  The link relations associated with the resource instance.
• PeriodicBillingFlag: boolean
  Maximum Length: 255

  The period billing indicator.
• PricePeriodicity: string
  The price periodicity of the charge.
• PriceType: string
  The price type of the charge.
• QuotedTcv: number
  The quoted TCV of the charge.
• UnitListPrice: number
  The unit list price of the charge.

{
    "type":"object",
    "properties":{
        "EstimatedQuantity":{
            "type":"number",
            "description":"The estimated quantity of a charge.",
            "nullable":true,
            "x-queryable":true
        },
        "InvoicingRuleId":{
            "type":"integer",
            "description":"The invoicing rule ID.",
            "nullable":true,
            "x-queryable":true
        },
        "adjustments":{
            "title":"Subscription Charge Adjustment",
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/previewSubscriptions-products-amendedProduct-charges-adjustments-item-response"
            }
        },
        "ChargeDefinition":{
            "type":"string",
            "description":"The charge definition of the charge.",
            "nullable":true,
            "x-queryable":true
        },
        "EstimatedAmount":{
            "type":"number",
            "description":"The estimated amount of the charge.",
            "nullable":true,
            "x-queryable":true
        },
        "ChargeName":{
            "type":"string",
            "description":"The charge name of the charge.",
            "nullable":true,
            "x-queryable":true
        },
        "QuotedTcv":{
            "type":"number",
            "description":"The quoted TCV of the charge.",
            "nullable":true,
            "x-queryable":true
        },
        "BillingFreq":{
            "maxLength":255,
            "type":"string",
            "description":"The billing frequency of the subscription product charge.",
            "nullable":true,
            "x-queryable":true
        },
        "EstimationMethod":{
            "maxLength":255,
            "type":"string",
            "description":"The estimation method of the charge.",
            "nullable":true,
            "x-queryable":true
        },
        "PricePeriodicity":{
            "type":"string",
            "description":"The price periodicity of the charge.",
            "nullable":true,
            "x-queryable":true
        },
        "PeriodicBillingFlag":{
            "maxLength":255,
            "type":"boolean",
            "description":"The period billing indicator.",
            "nullable":true,
            "x-queryable":true
        },
        "UnitListPrice":{
            "type":"number",
            "description":"The unit list price of the charge.",
            "nullable":true,
            "x-queryable":true
        },
        "links":{
            "title":"Links",
            "type":"array",
            "description":"The link relations associated with the resource instance.",
            "items":{
                "$ref":"#/components/schemas/link"
            }
        },
        "PriceType":{
            "type":"string",
            "description":"The price type of the charge.",
            "nullable":true,
            "x-queryable":true
        }
    }
}

Nested Schema : Subscription Charge Adjustment

Type: array

Title: Subscription Charge Adjustment

Show Source

• Array of: object previewSubscriptions-products-amendedProduct-charges-adjustments-item-response

{
    "title":"Subscription Charge Adjustment",
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/previewSubscriptions-products-amendedProduct-charges-adjustments-item-response"
    }
}

Nested Schema : Links

Type: array

Title: Links

The link relations associated with the resource instance.

Show Source

• Array of: object link

{
    "title":"Links",
    "type":"array",
    "description":"The link relations associated with the resource instance.",
    "items":{
        "$ref":"#/components/schemas/link"
    }
}

Nested Schema : previewSubscriptions-products-amendedProduct-charges-adjustments-item-response

Type: object

Show Source

• AdjustmentBasis: string
  Maximum Length: 255
• AdjustmentName: string
  Maximum Length: 255
• AdjustmentType: string
  Maximum Length: 255
• AdjustmentValue: number
• AutoAdjustmentFlag: boolean
  Maximum Length: 255
• Effectivity: string
  Maximum Length: 255
• links: array Links
  Title: Links

  The link relations associated with the resource instance.
• NumberOfPeriods: number
• PeriodFrom: number
• PeriodUntil: number
• SequenceNumber: integer

{
    "type":"object",
    "properties":{
        "AutoAdjustmentFlag":{
            "maxLength":255,
            "type":"boolean",
            "nullable":true,
            "x-queryable":true
        },
        "AdjustmentValue":{
            "type":"number",
            "nullable":true,
            "x-queryable":true
        },
        "AdjustmentBasis":{
            "maxLength":255,
            "type":"string",
            "nullable":true,
            "x-queryable":true
        },
        "SequenceNumber":{
            "type":"integer",
            "nullable":true,
            "x-queryable":true
        },
        "NumberOfPeriods":{
            "type":"number",
            "nullable":true,
            "x-queryable":true
        },
        "links":{
            "title":"Links",
            "type":"array",
            "description":"The link relations associated with the resource instance.",
            "items":{
                "$ref":"#/components/schemas/link"
            }
        },
        "Effectivity":{
            "maxLength":255,
            "type":"string",
            "nullable":true,
            "x-queryable":true
        },
        "AdjustmentName":{
            "maxLength":255,
            "type":"string",
            "nullable":true,
            "x-queryable":true
        },
        "PeriodUntil":{
            "type":"number",
            "nullable":true,
            "x-queryable":true
        },
        "AdjustmentType":{
            "maxLength":255,
            "type":"string",
            "nullable":true,
            "x-queryable":true
        },
        "PeriodFrom":{
            "type":"number",
            "nullable":true,
            "x-queryable":true
        }
    }
}

Nested Schema : Links

Type: array

Title: Links

The link relations associated with the resource instance.

Show Source

• Array of: object link

{
    "title":"Links",
    "type":"array",
    "description":"The link relations associated with the resource instance.",
    "items":{
        "$ref":"#/components/schemas/link"
    }
}

Nested Schema : previewSubscriptions-products-amendedProduct-output-item-response

Type: object

Show Source

• BillLineHeader: string
  Maximum Length: 255

  The bill line header of the bill lines.
• BillLineValues: string
  The bill line values of the bill lines.
• ChargeAdjustmentHeader: string
  Maximum Length: 255

  The charge adjustment header of the preview.
• ChargeHeader: string
  Maximum Length: 255

  The charge header of the preview.
• ChargeValues: string
  The charge values of the preview.
• links: array Links
  Title: Links

  The link relations associated with the resource instance.
• NumberOfBillingCycles: integer
  The number of billing cycles for preview.

{
    "type":"object",
    "properties":{
        "BillLineHeader":{
            "maxLength":255,
            "type":"string",
            "description":"The bill line header of the bill lines.",
            "nullable":false,
            "x-queryable":true
        },
        "BillLineValues":{
            "type":"string",
            "description":"The bill line values of the bill lines.",
            "nullable":false,
            "x-queryable":true
        },
        "NumberOfBillingCycles":{
            "type":"integer",
            "description":"The number of billing cycles for preview.",
            "nullable":true,
            "x-queryable":true
        },
        "links":{
            "title":"Links",
            "type":"array",
            "description":"The link relations associated with the resource instance.",
            "items":{
                "$ref":"#/components/schemas/link"
            }
        },
        "ChargeValues":{
            "type":"string",
            "description":"The charge values of the preview.",
            "nullable":true,
            "x-queryable":true
        },
        "ChargeHeader":{
            "maxLength":255,
            "type":"string",
            "description":"The charge header of the preview.",
            "nullable":true,
            "x-queryable":true
        },
        "ChargeAdjustmentHeader":{
            "maxLength":255,
            "type":"string",
            "description":"The charge adjustment header of the preview.",
            "nullable":true,
            "x-queryable":true
        }
    }
}

Nested Schema : Links

Type: array

Title: Links

The link relations associated with the resource instance.

Show Source

• Array of: object link

{
    "title":"Links",
    "type":"array",
    "description":"The link relations associated with the resource instance.",
    "items":{
        "$ref":"#/components/schemas/link"
    }
}

Nested Schema : previewSubscriptions-products-charges-item-response

Type: object

Show Source

• adjustments: array Subscription Charge Adjustment
  Title: Subscription Charge Adjustment
• BillingFreq: string
  Maximum Length: 255

  The billing frequency of the subscription product charge.
• ChargeDefinition: string
  The charge definition of the charge.
• ChargeName: string
  The charge name of the charge.
• EstimatedAmount: number
  The estimated amount of the charge.
• EstimatedQuantity: number
  The estimated quantity of a charge.
• EstimationMethod: string
  Maximum Length: 255

  The estimation method of the charge.
• InvoicingRuleId: integer
  The invoicing rule ID.
• links: array Links
  Title: Links

  The link relations associated with the resource instance.
• PeriodicBillingFlag: boolean
  Maximum Length: 255

  The period billing indicator.
• PricePeriodicity: string
  The price periodicity of the charge.
• PriceType: string
  The price type of the charge.
• QuotedTcv: number
  The quoted TCV of the charge.
• UnitListPrice: number
  The unit list price of the charge.

{
    "type":"object",
    "properties":{
        "EstimatedQuantity":{
            "type":"number",
            "description":"The estimated quantity of a charge.",
            "nullable":true,
            "x-queryable":true
        },
        "InvoicingRuleId":{
            "type":"integer",
            "description":"The invoicing rule ID.",
            "nullable":true,
            "x-queryable":true
        },
        "adjustments":{
            "title":"Subscription Charge Adjustment",
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/previewSubscriptions-products-charges-adjustments-item-response"
            }
        },
        "ChargeDefinition":{
            "type":"string",
            "description":"The charge definition of the charge.",
            "nullable":true,
            "x-queryable":true
        },
        "EstimatedAmount":{
            "type":"number",
            "description":"The estimated amount of the charge.",
            "nullable":true,
            "x-queryable":true
        },
        "ChargeName":{
            "type":"string",
            "description":"The charge name of the charge.",
            "nullable":true,
            "x-queryable":true
        },
        "QuotedTcv":{
            "type":"number",
            "description":"The quoted TCV of the charge.",
            "nullable":true,
            "x-queryable":true
        },
        "BillingFreq":{
            "maxLength":255,
            "type":"string",
            "description":"The billing frequency of the subscription product charge.",
            "nullable":true,
            "x-queryable":true
        },
        "EstimationMethod":{
            "maxLength":255,
            "type":"string",
            "description":"The estimation method of the charge.",
            "nullable":true,
            "x-queryable":true
        },
        "PricePeriodicity":{
            "type":"string",
            "description":"The price periodicity of the charge.",
            "nullable":true,
            "x-queryable":true
        },
        "PeriodicBillingFlag":{
            "maxLength":255,
            "type":"boolean",
            "description":"The period billing indicator.",
            "nullable":true,
            "x-queryable":true
        },
        "UnitListPrice":{
            "type":"number",
            "description":"The unit list price of the charge.",
            "nullable":true,
            "x-queryable":true
        },
        "links":{
            "title":"Links",
            "type":"array",
            "description":"The link relations associated with the resource instance.",
            "items":{
                "$ref":"#/components/schemas/link"
            }
        },
        "PriceType":{
            "type":"string",
            "description":"The price type of the charge.",
            "nullable":true,
            "x-queryable":true
        }
    }
}

Nested Schema : Subscription Charge Adjustment

Type: array

Title: Subscription Charge Adjustment

Show Source

• Array of: object previewSubscriptions-products-charges-adjustments-item-response

{
    "title":"Subscription Charge Adjustment",
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/previewSubscriptions-products-charges-adjustments-item-response"
    }
}

Nested Schema : Links

Type: array

Title: Links

The link relations associated with the resource instance.

Show Source

• Array of: object link

{
    "title":"Links",
    "type":"array",
    "description":"The link relations associated with the resource instance.",
    "items":{
        "$ref":"#/components/schemas/link"
    }
}

Nested Schema : previewSubscriptions-products-charges-adjustments-item-response

Type: object

Show Source

• AdjustmentBasis: string
  Maximum Length: 255
• AdjustmentName: string
  Maximum Length: 255
• AdjustmentType: string
  Maximum Length: 255
• AdjustmentValue: number
• AutoAdjustmentFlag: boolean
  Maximum Length: 255
• Effectivity: string
  Maximum Length: 255
• links: array Links
  Title: Links

  The link relations associated with the resource instance.
• NumberOfPeriods: number
• PeriodFrom: number
• PeriodUntil: number
• SequenceNumber: integer

{
    "type":"object",
    "properties":{
        "AutoAdjustmentFlag":{
            "maxLength":255,
            "type":"boolean",
            "nullable":true,
            "x-queryable":true
        },
        "AdjustmentValue":{
            "type":"number",
            "nullable":true,
            "x-queryable":true
        },
        "AdjustmentBasis":{
            "maxLength":255,
            "type":"string",
            "nullable":true,
            "x-queryable":true
        },
        "SequenceNumber":{
            "type":"integer",
            "nullable":true,
            "x-queryable":true
        },
        "NumberOfPeriods":{
            "type":"number",
            "nullable":true,
            "x-queryable":true
        },
        "links":{
            "title":"Links",
            "type":"array",
            "description":"The link relations associated with the resource instance.",
            "items":{
                "$ref":"#/components/schemas/link"
            }
        },
        "Effectivity":{
            "maxLength":255,
            "type":"string",
            "nullable":true,
            "x-queryable":true
        },
        "AdjustmentName":{
            "maxLength":255,
            "type":"string",
            "nullable":true,
            "x-queryable":true
        },
        "PeriodUntil":{
            "type":"number",
            "nullable":true,
            "x-queryable":true
        },
        "AdjustmentType":{
            "maxLength":255,
            "type":"string",
            "nullable":true,
            "x-queryable":true
        },
        "PeriodFrom":{
            "type":"number",
            "nullable":true,
            "x-queryable":true
        }
    }
}

Nested Schema : Links

Type: array

Title: Links

The link relations associated with the resource instance.

Show Source

• Array of: object link

{
    "title":"Links",
    "type":"array",
    "description":"The link relations associated with the resource instance.",
    "items":{
        "$ref":"#/components/schemas/link"
    }
}

Nested Schema : previewSubscriptions-products-output-item-response

Type: object

Show Source

• BillLineHeader: string
  Maximum Length: 255

  The bill line header of the bill lines.
• BillLineValues: string
  The bill line values of the bill lines.
• ChargeAdjustmentHeader: string
  Maximum Length: 255

  The charge adjustment header of the preview.
• ChargeHeader: string
  Maximum Length: 255

  The charge header of the preview.
• ChargeValues: string
  The charge values of the preview.
• links: array Links
  Title: Links

  The link relations associated with the resource instance.
• NumberOfBillingCycles: integer
  The number of billing cycles for preview.

{
    "type":"object",
    "properties":{
        "BillLineHeader":{
            "maxLength":255,
            "type":"string",
            "description":"The bill line header of the bill lines.",
            "nullable":false,
            "x-queryable":true
        },
        "BillLineValues":{
            "type":"string",
            "description":"The bill line values of the bill lines.",
            "nullable":false,
            "x-queryable":true
        },
        "NumberOfBillingCycles":{
            "type":"integer",
            "description":"The number of billing cycles for preview.",
            "nullable":true,
            "x-queryable":true
        },
        "links":{
            "title":"Links",
            "type":"array",
            "description":"The link relations associated with the resource instance.",
            "items":{
                "$ref":"#/components/schemas/link"
            }
        },
        "ChargeValues":{
            "type":"string",
            "description":"The charge values of the preview.",
            "nullable":true,
            "x-queryable":true
        },
        "ChargeHeader":{
            "maxLength":255,
            "type":"string",
            "description":"The charge header of the preview.",
            "nullable":true,
            "x-queryable":true
        },
        "ChargeAdjustmentHeader":{
            "maxLength":255,
            "type":"string",
            "description":"The charge adjustment header of the preview.",
            "nullable":true,
            "x-queryable":true
        }
    }
}

Nested Schema : Links

Type: array

Title: Links

The link relations associated with the resource instance.

Show Source

• Array of: object link

{
    "title":"Links",
    "type":"array",
    "description":"The link relations associated with the resource instance.",
    "items":{
        "$ref":"#/components/schemas/link"
    }
}

Links

products

Operation: /crmRestApi/resources/11.13.18.05/previewSubscriptions/{SubscriptionId}/child/products

Parameters:

• SubscriptionId: $request.path.SubscriptionId

Preview subscriptions lets you view a subscription product before creating, updating, or deleting a subscription.

Back to Top

Examples

The following example shows how to create a subsciption preview by submitting a POST request on the REST resource.

You can create subscription preview with pre-priced charges, based on rate plan, and also close and create a new preview.

Create subscription preview with pre-priced charges

The following example shows how to create a subscription preview with pre-priced charges.

Example URL:

https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/previewSubscriptions

Example of Request Body

{
  "BusinessUnitId": 204,
  "LegalEntityId": 204,
  "SubscriptionProfileName": "zOSS_SP_ServiceStartActual_Advance_Month",
  "PrimaryPartyId": 1006,
  "Currency": "USD",
  "StartDate": "2024-01-01",
  "EndDate": "2024-12-31",
  "BillToAccountId": 1006,
  "BillToSiteUseId": 10921,
  "TaxClassificationCode": "VAT20",
  "products": [
    {
      "ActionCode": "BILLGENERATION",
      "ProductName": "ZOSS_SubscriptionItem002_AUTO",
      //"ProductName": "Fiber Connect",
      "Quantity": 1,
      "StartDate": "2024-01-01",
      "EndDate": "2024-06-30",
      "BillingFrequency": "0zF",
      "charges": [
        {
          "ChargeName": "Service Fee",
          "ChargeDefinition": "ZOKCRECURRINCHARGE",
          "PricePeriodicity": "0zG",
          "PriceType": "RECURRING",
          "UnitListPrice": 20000,
          "adjustments": [
            {
              "AdjustmentName": "Adj1",
              "AdjustmentType": "ORA_PRICE_OVERRIDE",
              "AdjustmentValue": 100,
              "AutoAdjustmentFlag": false,
              "Effectivity": "ORA_ALL_TERM"
            }
          ]
        }
      ],
      "output": [
        {
          "NumberOfBillingCycles": 2
        }
      ]
    }
  ]
}

Example of Response Body

{
    "SubscriptionId": 300100635171996,
    "SubscriptionNumber": "Preview_2025-03-26 10:17:40.435",
    "Currency": "USD",
    "BusinessUnitId": 204,
    "SubscriptionProfileName": "zOSS_SP_ServiceStartActual_Advance_Month",
    "PrimaryPartyId": 1006,
    "BillToAccountId": 1006,
    "BillToSiteUseId": 10921,
    "PrimaryPartyNumber": null,
    "BillToAccountNumber": null,
    "BillToSiteNumber": null,
    "PricingStrategyId": null,
    "StartDate": "2024-01-01",
    "EndDate": "2024-12-31",
    "TaxClassificationCode": "VAT20",
    "ExemptCertificateNumber": null,
    "LegalEntityId": 204,
    "DocumentFiscalClassification": null,
    "ShipToPartyNumber": null,
    "ShipToParty": null,
    "products": [
        {
            "ActionCode": "BILLGENERATION",
            "ProductName": "ZOSS_SubscriptionItem002_AUTO",
            "InventoryItemId": null,
            "DefinitionOrganizationId": null,
            "SalesProductType": null,
            "Quantity": 1,
            "ItemUnitOfMeasure": null,
            "StartDate": "2024-01-01",
            "EndDate": "2024-06-30",
            "BillingFrequency": "0zF",
            "RequestedRatePlanId": null,
            "RequestedRatePlanNumber": null,
            "PriceListId": null,
            "EstimatedTax": 120,
            "ExemptCertificateNumber": null,
            "OutputTaxClassification": null,
            "ProductFiscClassification": null,
            "TotalContractValue": null,
            "AlignBillingFrom": null,
            "RequestedAlignBillingDate": null,
            "SubscriptionProductPuid": null,
            "CloseReason": null,
            "CloseCreditMethod": null,
            "ClosedDate": null,
            "charges": [
                {
                    "ChargeName": "Service Fee",
                    "ChargeDefinition": "ZOKCRECURRINCHARGE",
                    "PriceType": "RECURRING",
                    "PricePeriodicity": "0zG",
                    "UnitListPrice": 20000,
                    "BillingFreq": null,
                    "EstimatedAmount": null,
                    "EstimatedQuantity": null,
                    "EstimationMethod": null,
                    "InvoicingRuleId": null,
                    "PeriodicBillingFlag": null,
                    "QuotedTcv": null,
                    "adjustments": [
                        {
                            "AdjustmentType": "ORA_PRICE_OVERRIDE",
                            "AdjustmentValue": 100,
                            "SequenceNumber": null,
                            "AdjustmentName": "Adj1",
                            "Effectivity": "ORA_ALL_TERM",
                            "AutoAdjustmentFlag": false,
                            "PeriodFrom": null,
                            "PeriodUntil": null,
                            "NumberOfPeriods": null,
                            "AdjustmentBasis": null,
                            "links": [
                                {
                                    "rel": "self",
                                    "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/previewSubscriptions/300100635171996/child/products/300100635171999/child/charges/300100635172000/child/adjustments/300100635172001",
                                    "name": "adjustments",
                                    "kind": "item"
                                },
                                {
                                    "rel": "canonical",
                                    "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/previewSubscriptions/300100635171996/child/products/300100635171999/child/charges/300100635172000/child/adjustments/300100635172001",
                                    "name": "adjustments",
                                    "kind": "item"
                                },
                                {
                                    "rel": "parent",
                                    "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/previewSubscriptions/300100635171996/child/products/300100635171999/child/charges/300100635172000",
                                    "name": "charges",
                                    "kind": "item"
                                }
                            ]
                        }
                    ],
                    "links": [
                        {
                            "rel": "self",
                            "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/previewSubscriptions/300100635171996/child/products/300100635171999/child/charges/300100635172000",
                            "name": "charges",
                            "kind": "item"
                        },
                        {
                            "rel": "canonical",
                            "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/previewSubscriptions/300100635171996/child/products/300100635171999/child/charges/300100635172000",
                            "name": "charges",
                            "kind": "item"
                        },
                        {
                            "rel": "parent",
                            "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/previewSubscriptions/300100635171996/child/products/300100635171999",
                            "name": "products",
                            "kind": "item"
                        },
                        {
                            "rel": "child",
                            "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/previewSubscriptions/300100635171996/child/products/300100635171999/child/charges/300100635172000/child/adjustments",
                            "name": "adjustments",
                            "kind": "collection"
                        }
                    ]
                }
            ],
            "output": [
                {
                    "NumberOfBillingCycles": 2,
                    "BillLineHeader": "ChargeName,DateBilledFrom,DateBilledTo,InvoiceDate,DateToInterface,Amount",
                    "BillLineValues": "[{'ChargeName':'Service Fee','DateBilledFrom':'2024-01-01','DateBilledTo':'2024-01-31','InvoiceDate':'2024-01-01','DateToInterface':'2024-01-01','Amount':'100'},{'ChargeName':'Service Fee','DateBilledFrom':'2024-02-01','DateBilledTo':'2024-02-29','InvoiceDate':'2024-01-01','DateToInterface':'2024-01-01','Amount':'100'},{'ChargeName':'Service Fee','DateBilledFrom':'2024-03-01','DateBilledTo':'2024-03-31','InvoiceDate':'2024-01-01','DateToInterface':'2024-01-01','Amount':'100'},{'ChargeName':'Service Fee','DateBilledFrom':'2024-04-01','DateBilledTo':'2024-04-30','InvoiceDate':'2024-04-01','DateToInterface':'2024-04-01','Amount':'100'},{'ChargeName':'Service Fee','DateBilledFrom':'2024-05-01','DateBilledTo':'2024-05-31','InvoiceDate':'2024-04-01','DateToInterface':'2024-04-01','Amount':'100'},{'ChargeName':'Service Fee','DateBilledFrom':'2024-06-01','DateBilledTo':'2024-06-30','InvoiceDate':'2024-04-01','DateToInterface':'2024-04-01','Amount':'100'}]",
                    "ChargeHeader": null,
                    "ChargeValues": null,
                    "ChargeAdjustmentHeader": null,
                    "links": [
                        {
                            "rel": "self",
                            "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/previewSubscriptions/300100635171996/child/products/300100635171999/child/output/300100635171999",
                            "name": "output",
                            "kind": "item"
                        },
                        {
                            "rel": "canonical",
                            "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/previewSubscriptions/300100635171996/child/products/300100635171999/child/output/300100635171999",
                            "name": "output",
                            "kind": "item"
                        },
                        {
                            "rel": "parent",
                            "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/previewSubscriptions/300100635171996/child/products/300100635171999",
                            "name": "products",
                            "kind": "item"
                        }
                    ]
                }
            ],
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/previewSubscriptions/300100635171996/child/products/300100635171999",
                    "name": "products",
                    "kind": "item"
                },
                {
                    "rel": "canonical",
                    "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/previewSubscriptions/300100635171996/child/products/300100635171999",
                    "name": "products",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/previewSubscriptions/300100635171996",
                    "name": "previewSubscriptions",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/previewSubscriptions/300100635171996/child/products/300100635171999/child/charges",
                    "name": "charges",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/previewSubscriptions/300100635171996/child/products/300100635171999/child/output",
                    "name": "output",
                    "kind": "collection"
                }
            ]
        }
    ],
    "links": [
        {
            "rel": "self",
            "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/previewSubscriptions/300100635171996",
            "name": "previewSubscriptions",
            "kind": "item"
        },
        {
            "rel": "canonical",
            "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/previewSubscriptions/300100635171996",
            "name": "previewSubscriptions",
            "kind": "item"
        },
        {
            "rel": "child",
            "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/previewSubscriptions/300100635171996/child/products",
            "name": "products",
            "kind": "collection"
        }
    ]
}

Create subscription preview with pricing call

This example shows how to create a subscription preview with pricing call.

Example URL:

https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/previewSubscriptions

Example of Request Body

{
"BusinessUnitId": 204,
  "LegalEntityId": 204,
  "SubscriptionProfileName": "zOSS_SP_ServiceStartActual_Advance_Month",
  "PrimaryPartyId": 1006,
  "Currency": "USD",
  "StartDate": "2024-01-01",
  "EndDate": "2024-12-31",
  "BillToAccountId": 1006,
  "BillToSiteUseId": 10921,
  "TaxClassificationCode": "VAT20",
  "products": [
    {
      "ActionCode": "PRICING",
      "ProductName": "ZOSS_SubscriptionItem003_AUTO",
      "Quantity": 1,
      "StartDate": "2024-01-01",
      "EndDate": "2024-12-31",
      "BillingFrequency": "0zG",
      "output": [
        {
            
        }
      ]
    }
  ]
}

Example of Response Body

{
    "SubscriptionId": 300100635172005,
    "SubscriptionNumber": "Preview_2025-03-26 10:18:51.556",
    "Currency": "USD",
    "BusinessUnitId": 204,
    "SubscriptionProfileName": "zOSS_SP_ServiceStartActual_Advance_Month",
    "PrimaryPartyId": 1006,
    "BillToAccountId": 1006,
    "BillToSiteUseId": 10921,
    "PrimaryPartyNumber": null,
    "BillToAccountNumber": null,
    "BillToSiteNumber": null,
    "PricingStrategyId": null,
    "StartDate": "2024-01-01",
    "EndDate": "2024-12-31",
    "TaxClassificationCode": "VAT20",
    "ExemptCertificateNumber": null,
    "LegalEntityId": 204,
    "DocumentFiscalClassification": null,
    "ShipToPartyNumber": null,
    "ShipToParty": null,
    "products": [
        {
            "ActionCode": "PRICING",
            "ProductName": "ZOSS_SubscriptionItem003_AUTO",
            "InventoryItemId": null,
            "DefinitionOrganizationId": null,
            "SalesProductType": null,
            "Quantity": 1,
            "ItemUnitOfMeasure": null,
            "StartDate": "2024-01-01",
            "EndDate": "2024-12-31",
            "BillingFrequency": "0zG",
            "RequestedRatePlanId": null,
            "RequestedRatePlanNumber": null,
            "PriceListId": null,
            "EstimatedTax": 1320,
            "ExemptCertificateNumber": null,
            "OutputTaxClassification": null,
            "ProductFiscClassification": null,
            "TotalContractValue": null,
            "AlignBillingFrom": null,
            "RequestedAlignBillingDate": null,
            "SubscriptionProductPuid": null,
            "CloseReason": null,
            "CloseCreditMethod": null,
            "ClosedDate": null,
            "output": [
                {
                    "NumberOfBillingCycles": null,
                    "BillLineHeader": "ChargeName,DateBilledFrom,DateBilledTo,InvoiceDate,DateToInterface,Amount",
                    "BillLineValues": "[{'ChargeName':'Activation Fee','DateBilledFrom':'2024-01-01','DateBilledTo':'2024-12-31','InvoiceDate':'2024-01-01','DateToInterface':'2024-01-01','Amount':'3000'},{'ChargeName':'Monthly Fee','DateBilledFrom':'2024-01-01','DateBilledTo':'2024-01-31','InvoiceDate':'2024-01-01','DateToInterface':'2024-01-01','Amount':'300'},{'ChargeName':'USAGE SPM CHARGE','DateBilledFrom':'2024-01-01','DateBilledTo':'2024-01-31','InvoiceDate':'2024-02-01','DateToInterface':'2024-02-01','Amount':'0'},{'ChargeName':'Monthly Fee','DateBilledFrom':'2024-02-01','DateBilledTo':'2024-02-29','InvoiceDate':'2024-02-01','DateToInterface':'2024-02-01','Amount':'300'},{'ChargeName':'USAGE SPM CHARGE','DateBilledFrom':'2024-02-01','DateBilledTo':'2024-02-29','InvoiceDate':'2024-03-01','DateToInterface':'2024-03-01','Amount':'0'},{'ChargeName':'Monthly Fee','DateBilledFrom':'2024-03-01','DateBilledTo':'2024-03-31','InvoiceDate':'2024-03-01','DateToInterface':'2024-03-01','Amount':'300'},{'ChargeName':'USAGE SPM CHARGE','DateBilledFrom':'2024-03-01','DateBilledTo':'2024-03-31','InvoiceDate':'2024-04-01','DateToInterface':'2024-04-01','Amount':'0'},{'ChargeName':'Monthly Fee','DateBilledFrom':'2024-04-01','DateBilledTo':'2024-04-30','InvoiceDate':'2024-04-01','DateToInterface':'2024-04-01','Amount':'300'},{'ChargeName':'USAGE SPM CHARGE','DateBilledFrom':'2024-04-01','DateBilledTo':'2024-04-30','InvoiceDate':'2024-05-01','DateToInterface':'2024-05-01','Amount':'0'},{'ChargeName':'Monthly Fee','DateBilledFrom':'2024-05-01','DateBilledTo':'2024-05-31','InvoiceDate':'2024-05-01','DateToInterface':'2024-05-01','Amount':'300'},{'ChargeName':'USAGE SPM CHARGE','DateBilledFrom':'2024-05-01','DateBilledTo':'2024-05-31','InvoiceDate':'2024-06-01','DateToInterface':'2024-06-01','Amount':'0'},{'ChargeName':'Monthly Fee','DateBilledFrom':'2024-06-01','DateBilledTo':'2024-06-30','InvoiceDate':'2024-06-01','DateToInterface':'2024-06-01','Amount':'300'},{'ChargeName':'USAGE SPM CHARGE','DateBilledFrom':'2024-06-01','DateBilledTo':'2024-06-30','InvoiceDate':'2024-07-01','DateToInterface':'2024-07-01','Amount':'0'},{'ChargeName':'Monthly Fee','DateBilledFrom':'2024-07-01','DateBilledTo':'2024-07-31','InvoiceDate':'2024-07-01','DateToInterface':'2024-07-01','Amount':'300'},{'ChargeName':'USAGE SPM CHARGE','DateBilledFrom':'2024-07-01','DateBilledTo':'2024-07-31','InvoiceDate':'2024-08-01','DateToInterface':'2024-08-01','Amount':'0'},{'ChargeName':'Monthly Fee','DateBilledFrom':'2024-08-01','DateBilledTo':'2024-08-31','InvoiceDate':'2024-08-01','DateToInterface':'2024-08-01','Amount':'300'},{'ChargeName':'USAGE SPM CHARGE','DateBilledFrom':'2024-08-01','DateBilledTo':'2024-08-31','InvoiceDate':'2024-09-01','DateToInterface':'2024-09-01','Amount':'0'},{'ChargeName':'Monthly Fee','DateBilledFrom':'2024-09-01','DateBilledTo':'2024-09-30','InvoiceDate':'2024-09-01','DateToInterface':'2024-09-01','Amount':'300'},{'ChargeName':'USAGE SPM CHARGE','DateBilledFrom':'2024-09-01','DateBilledTo':'2024-09-30','InvoiceDate':'2024-10-01','DateToInterface':'2024-10-01','Amount':'0'},{'ChargeName':'Monthly Fee','DateBilledFrom':'2024-10-01','DateBilledTo':'2024-10-31','InvoiceDate':'2024-10-01','DateToInterface':'2024-10-01','Amount':'300'},{'ChargeName':'USAGE SPM CHARGE','DateBilledFrom':'2024-10-01','DateBilledTo':'2024-10-31','InvoiceDate':'2024-11-01','DateToInterface':'2024-11-01','Amount':'0'},{'ChargeName':'Monthly Fee','DateBilledFrom':'2024-11-01','DateBilledTo':'2024-11-30','InvoiceDate':'2024-11-01','DateToInterface':'2024-11-01','Amount':'300'},{'ChargeName':'USAGE SPM CHARGE','DateBilledFrom':'2024-11-01','DateBilledTo':'2024-11-30','InvoiceDate':'2024-12-01','DateToInterface':'2024-12-01','Amount':'0'},{'ChargeName':'Monthly Fee','DateBilledFrom':'2024-12-01','DateBilledTo':'2024-12-31','InvoiceDate':'2024-12-01','DateToInterface':'2024-12-01','Amount':'300'},{'ChargeName':'USAGE SPM CHARGE','DateBilledFrom':'2024-12-01','DateBilledTo':'2024-12-31','InvoiceDate':'2025-01-01','DateToInterface':'2025-01-01','Amount':'0'}]",
                    "ChargeHeader": "ChargeName,ChargeDefinition,PricePeriodicity,PriceType,UnitListPrice,BillingFreq,EstimatedAmount,EstimatedQuantity,EstimationMethod,InvoicingRuleId,PeriodicBillingFlag,QuotedTcv",
                    "ChargeValues": "[{'ChargeName':'Activation Fee','ChargeDefinition':'ACTIVATIONFEE','PriceType':'ONE_TIME','UnitListPrice':'3000','EstimationMethod':'ORA_OSS_USAGE_EST_NONE','adjustments':{}},{'ChargeName':'Monthly Fee','ChargeDefinition':'MONTHLYFEE','PricePeriodicity':'0zG','PriceType':'RECURRING','UnitListPrice':'300','EstimationMethod':'ORA_OSS_USAGE_EST_NONE','adjustments':{}},{'ChargeName':'USAGE SPM CHARGE','ChargeDefinition':'USAGE_CHARGESPM','PricePeriodicity':'0zG','PriceType':'RECURRING','UnitListPrice':'20','EstimationMethod':'ORA_OSS_USAGE_EST_NONE','adjustments':{}}]",
                    "ChargeAdjustmentHeader": "AdjustmentType,AdjustmentValue,SequenceNumber,AdjustmentName,Effectivity,AutoAdjustmentFlag,PeriodFrom,PeriodUntil,NumberOfPeriods,AdjustmentBasis",
                    "links": [
                        {
                            "rel": "self",
                            "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/previewSubscriptions/300100635172005/child/products/300100635172008/child/output/300100635172008",
                            "name": "output",
                            "kind": "item"
                        },
                        {
                            "rel": "canonical",
                            "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/previewSubscriptions/300100635172005/child/products/300100635172008/child/output/300100635172008",
                            "name": "output",
                            "kind": "item"
                        },
                        {
                            "rel": "parent",
                            "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/previewSubscriptions/300100635172005/child/products/300100635172008",
                            "name": "products",
                            "kind": "item"
                        }
                    ]
                }
            ],
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/previewSubscriptions/300100635172005/child/products/300100635172008",
                    "name": "products",
                    "kind": "item"
                },
                {
                    "rel": "canonical",
                    "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/previewSubscriptions/300100635172005/child/products/300100635172008",
                    "name": "products",
                    "kind": "item"
                },
                {
                    "rel": "parent",
                    "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/previewSubscriptions/300100635172005",
                    "name": "previewSubscriptions",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/previewSubscriptions/300100635172005/child/products/300100635172008/child/charges",
                    "name": "charges",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/previewSubscriptions/300100635172005/child/products/300100635172008/child/output",
                    "name": "output",
                    "kind": "collection"
                }
            ]
        }
    ],
    "links": [
        {
            "rel": "self",
            "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/previewSubscriptions/300100635172005",
            "name": "previewSubscriptions",
            "kind": "item"
        },
        {
            "rel": "canonical",
            "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/previewSubscriptions/300100635172005",
            "name": "previewSubscriptions",
            "kind": "item"
        },
        {
            "rel": "child",
            "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/previewSubscriptions/300100635172005/child/products",
            "name": "products",
            "kind": "collection"
        }
    ]
}

Create preview subscription based on rate plans

This example shows how to create preview subscriptions based on rate plans by submitting a POST request on the REST resource using cURL.

Example URL:

https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/previewSubscriptions

Example of Request Body

{
  "BusinessUnitId": 204,
  "LegalEntityId": 204,
  "SubscriptionProfileName": "zOSS_SP_ServiceStartActual_Advance_Month",
  "PrimaryPartyId": 1006,
  "Currency": "USD",
  "StartDate": "2024-01-01",
  "EndDate": "2024-12-31",
  "BillToAccountId": 1006,
  "BillToSiteUseId": 10921,
  "TaxClassificationCode": "VAT20",
    "products": [
      
        {
      "ActionCode": "PRICING",
      "ProductName": "Fiber Connect",
      "RequestedRatePlanId": 300100573915062,
      "Quantity": 1,
      "StartDate": "2024-01-01",
      "EndDate": "2024-12-31",
      "BillingFrequency": "0zG",
      "output": [
        {
            "NumberOfBillingCycles": 2
        }
      ]
        }
    ]
}

Example of Response Body

{
    "SubscriptionId": 300100630645662,
    "SubscriptionNumber": "Preview_sub_1",
    "Currency": "INR",
    "BusinessUnitId": 204,
    "SubscriptionProfileName": "zOSS_SP_ServiceStartActual_Advance_Month",
    "PrimaryPartyId": 1001,
    "BillToAccountId": 1006,
    "BillToSiteUseId": 1025,
    "PrimaryPartyNumber": "1001",
    "BillToAccountNumber": "1006",
    "BillToSiteNumber": "Chattanooga (OPS)",
    "PricingStrategyId": null,
    "StartDate": "2024-12-01",
    "EndDate": "2026-12-31",
    "TaxClassificationCode": "VAT20",
    "ExemptCertificateNumber": null,
    "LegalEntityId": 204,
    "DocumentFiscalClassification": null,
    "ShipToPartyNumber": "1001",
    "ShipToParty": 1001,
    "products": [
        {
            "ActionCode": "CLOSE",
            "ProductName": null,
            "InventoryItemId": null,
            "DefinitionOrganizationId": null,
            "SalesProductType": null,
            "Quantity": 1,
            "ItemUnitOfMeasure": null,
            "StartDate": "2024-12-01",
            "EndDate": "2026-12-31",
            "BillingFrequency": "0zG",
            "RequestedRatePlanId": null,
            "RequestedRatePlanNumber": null,
            "PriceListId": null,
            "EstimatedTax": 2200,
            "ExemptCertificateNumber": null,
            "OutputTaxClassification": null,
            "ProductFiscClassification": null,
            "TotalContractValue": null,
            "AlignBillingFrom": null,
            "RequestedAlignBillingDate": null,
            "SubscriptionProductPuid": "Preview_sub_1-PRDT-36428",
            "CloseReason": "ORA_BREACH",
            "CloseCreditMethod": "ORA_PRORATE_WITH_CREDIT",
            "ClosedDate": "2025-06-20",
            "output": [
                {
                    "NumberOfBillingCycles": null,
                    "BillLineHeader": "ChargeName,DateBilledFrom,DateBilledTo,InvoiceDate,DateToInterface,Amount",
                    "BillLineValues": "[{'ChargeName':'Activation Fee','DateBilledFrom':'2024-12-01','DateBilledTo':'2026-12-31','InvoiceDate':'2024-12-01','DateToInterface':'2024-12-01','Amount':'1000'},{'ChargeName':'Monthly Fee','DateBilledFrom':'2024-12-01','DateBilledTo':'2024-12-31','InvoiceDate':'2024-12-01','DateToInterface':'2024-12-01','Amount':'100'},{'ChargeName':'QTR Fee','DateBilledFrom':'2024-12-01','DateBilledTo':'2024-12-31','InvoiceDate':'2024-12-01','DateToInterface':'2024-12-01','Amount':'200'},{'ChargeName':'Year Fee','DateBilledFrom':'2024-12-01','DateBilledTo':'2024-12-31','InvoiceDate':'2024-12-01','DateToInterface':'2024-12-01','Amount':'100'},{'ChargeName':'QTR Fee','DateBilledFrom':'2025-01-01','DateBilledTo':'2025-01-31','InvoiceDate':'2025-01-01','DateToInterface':'2025-01-01','Amount':'200'},{'ChargeName':'Year Fee','DateBilledFrom':'2025-01-01','DateBilledTo':'2025-01-31','InvoiceDate':'2025-01-01','DateToInterface':'2025-01-01','Amount':'100'},{'ChargeName':'Monthly Fee','DateBilledFrom':'2025-01-01','DateBilledTo':'2025-01-31','InvoiceDate':'2025-01-01','DateToInterface':'2025-01-01','Amount':'100'},{'ChargeName':'QTR Fee','DateBilledFrom':'2025-02-01','DateBilledTo':'2025-02-28','InvoiceDate':'2025-02-01','DateToInterface':'2025-02-01','Amount':'200'},{'ChargeName':'Year Fee','DateBilledFrom':'2025-02-01','DateBilledTo':'2025-02-28','InvoiceDate':'2025-02-01','DateToInterface':'2025-02-01','Amount':'100'},{'ChargeName':'Monthly Fee','DateBilledFrom':'2025-02-01','DateBilledTo':'2025-02-28','InvoiceDate':'2025-02-01','DateToInterface':'2025-02-01','Amount':'100'},{'ChargeName':'Year Fee','DateBilledFrom':'2025-03-01','DateBilledTo':'2025-03-31','InvoiceDate':'2025-03-01','DateToInterface':'2025-03-01','Amount':'100'},{'ChargeName':'QTR Fee','DateBilledFrom':'2025-03-01','DateBilledTo':'2025-03-31','InvoiceDate':'2025-03-01','DateToInterface':'2025-03-01','Amount':'200'},{'ChargeName':'Monthly Fee','DateBilledFrom':'2025-03-01','DateBilledTo':'2025-03-31','InvoiceDate':'2025-03-01','DateToInterface':'2025-03-01','Amount':'100'},{'ChargeName':'Year Fee','DateBilledFrom':'2025-04-01','DateBilledTo':'2025-04-30','InvoiceDate':'2025-04-01','DateToInterface':'2025-04-01','Amount':'100'},{'ChargeName':'QTR Fee','DateBilledFrom':'2025-04-01','DateBilledTo':'2025-04-30','InvoiceDate':'2025-04-01','DateToInterface':'2025-04-01','Amount':'200'},{'ChargeName':'Monthly Fee','DateBilledFrom':'2025-04-01','DateBilledTo':'2025-04-30','InvoiceDate':'2025-04-01','DateToInterface':'2025-04-01','Amount':'100'},{'ChargeName':'Year Fee','DateBilledFrom':'2025-05-01','DateBilledTo':'2025-05-31','InvoiceDate':'2025-05-01','DateToInterface':'2025-05-01','Amount':'100'},{'ChargeName':'QTR Fee','DateBilledFrom':'2025-05-01','DateBilledTo':'2025-05-31','InvoiceDate':'2025-05-01','DateToInterface':'2025-05-01','Amount':'200'},{'ChargeName':'Monthly Fee','DateBilledFrom':'2025-05-01','DateBilledTo':'2025-05-31','InvoiceDate':'2025-05-01','DateToInterface':'2025-05-01','Amount':'100'},{'ChargeName':'Year Fee','DateBilledFrom':'2025-06-01','DateBilledTo':'2025-06-19','InvoiceDate':'2025-06-01','DateToInterface':'2025-06-01','Amount':'63.33'},{'ChargeName':'QTR Fee','DateBilledFrom':'2025-06-01','DateBilledTo':'2025-06-19','InvoiceDate':'2025-06-01','DateToInterface':'2025-06-01','Amount':'126.67'},{'ChargeName':'Monthly Fee','DateBilledFrom':'2025-06-01','DateBilledTo':'2025-06-19','InvoiceDate':'2025-06-01','DateToInterface':'2025-06-01','Amount':'63.33'}]",
                    "ChargeHeader": null,
                    "ChargeValues": null,
                    "ChargeAdjustmentHeader": null
                }
            ]
        },
        {
            "ActionCode": "PRICING",
            "ProductName": "ZOSS_SubscriptionItem002_AUTO",
            "InventoryItemId": null,
            "DefinitionOrganizationId": null,
            "SalesProductType": null,
            "Quantity": 1,
            "ItemUnitOfMeasure": null,
            "StartDate": "2025-06-21",
            "EndDate": "2025-12-31",
            "BillingFrequency": "0zF",
            "RequestedRatePlanId": null,
            "RequestedRatePlanNumber": null,
            "PriceListId": null,
            "EstimatedTax": 32382.58,
            "ExemptCertificateNumber": null,
            "OutputTaxClassification": null,
            "ProductFiscClassification": null,
            "TotalContractValue": null,
            "AlignBillingFrom": null,
            "RequestedAlignBillingDate": null,
            "SubscriptionProductPuid": null,
            "CloseReason": null,
            "CloseCreditMethod": null,
            "ClosedDate": null,
            "output": [
                {
                    "NumberOfBillingCycles": null,
                    "BillLineHeader": "ChargeName,DateBilledFrom,DateBilledTo,InvoiceDate,DateToInterface,Amount",
                    "BillLineValues": "[{'ChargeName':'Activation Fee','DateBilledFrom':'2025-06-21','DateBilledTo':'2025-12-31','InvoiceDate':'2025-06-21','DateToInterface':'2025-06-21','Amount':'99000'},{'ChargeName':'Monthly Fee','DateBilledFrom':'2025-06-21','DateBilledTo':'2025-07-20','InvoiceDate':'2025-06-21','DateToInterface':'2025-06-21','Amount':'9900'},{'ChargeName':'USAGE SPM CHARGE','DateBilledFrom':'2025-06-21','DateBilledTo':'2025-07-20','InvoiceDate':'2025-09-21','DateToInterface':'2025-09-21','Amount':'0'},{'ChargeName':'Monthly Fee','DateBilledFrom':'2025-07-21','DateBilledTo':'2025-08-20','InvoiceDate':'2025-06-21','DateToInterface':'2025-06-21','Amount':'9900'},{'ChargeName':'USAGE SPM CHARGE','DateBilledFrom':'2025-07-21','DateBilledTo':'2025-08-20','InvoiceDate':'2025-09-21','DateToInterface':'2025-09-21','Amount':'0'},{'ChargeName':'Monthly Fee','DateBilledFrom':'2025-08-21','DateBilledTo':'2025-09-20','InvoiceDate':'2025-06-21','DateToInterface':'2025-06-21','Amount':'9900'},{'ChargeName':'USAGE SPM CHARGE','DateBilledFrom':'2025-08-21','DateBilledTo':'2025-09-20','InvoiceDate':'2025-09-21','DateToInterface':'2025-09-21','Amount':'0'},{'ChargeName':'Monthly Fee','DateBilledFrom':'2025-09-21','DateBilledTo':'2025-10-20','InvoiceDate':'2025-09-21','DateToInterface':'2025-09-21','Amount':'9900'},{'ChargeName':'USAGE SPM CHARGE','DateBilledFrom':'2025-09-21','DateBilledTo':'2025-10-20','InvoiceDate':'2025-12-21','DateToInterface':'2025-12-21','Amount':'0'},{'ChargeName':'Monthly Fee','DateBilledFrom':'2025-10-21','DateBilledTo':'2025-11-20','InvoiceDate':'2025-09-21','DateToInterface':'2025-09-21','Amount':'9900'},{'ChargeName':'USAGE SPM CHARGE','DateBilledFrom':'2025-10-21','DateBilledTo':'2025-11-20','InvoiceDate':'2025-12-21','DateToInterface':'2025-12-21','Amount':'0'},{'ChargeName':'Monthly Fee','DateBilledFrom':'2025-11-21','DateBilledTo':'2025-12-20','InvoiceDate':'2025-09-21','DateToInterface':'2025-09-21','Amount':'9900'},{'ChargeName':'USAGE SPM CHARGE','DateBilledFrom':'2025-11-21','DateBilledTo':'2025-12-20','InvoiceDate':'2025-12-21','DateToInterface':'2025-12-21','Amount':'0'},{'ChargeName':'Monthly Fee','DateBilledFrom':'2025-12-21','DateBilledTo':'2025-12-31','InvoiceDate':'2025-12-21','DateToInterface':'2025-12-21','Amount':'3512.9'},{'ChargeName':'USAGE SPM CHARGE','DateBilledFrom':'2025-12-21','DateBilledTo':'2025-12-31','InvoiceDate':'2026-01-01','DateToInterface':'2026-01-01','Amount':'0'}]",
                    "ChargeHeader": "ChargeName,ChargeDefinition,PricePeriodicity,PriceType,UnitListPrice,BillingFreq,EstimatedAmount,EstimatedQuantity,EstimationMethod,InvoicingRuleId,PeriodicBillingFlag,QuotedTcv",
                    "ChargeValues": "[{'ChargeName':'USAGE SPM CHARGE','ChargeDefinition':'USAGE_CHARGESPM','PricePeriodicity':'0zG','PriceType':'RECURRING','UnitListPrice':'495','EstimationMethod':'ORA_OSS_USAGE_EST_NONE','adjustments':{}},{'ChargeName':'Monthly Fee','ChargeDefinition':'MONTHLYFEE','PricePeriodicity':'0zG','PriceType':'RECURRING','UnitListPrice':'9900','EstimationMethod':'ORA_OSS_USAGE_EST_NONE','adjustments':{}},{'ChargeName':'Activation Fee','ChargeDefinition':'ACTIVATIONFEE','PriceType':'ONE_TIME','UnitListPrice':'99000','EstimationMethod':'ORA_OSS_USAGE_EST_NONE','adjustments':{}}]",
                    "ChargeAdjustmentHeader": "AdjustmentType,AdjustmentValue,SequenceNumber,AdjustmentName,Effectivity,AutoAdjustmentFlag,PeriodFrom,PeriodUntil,NumberOfPeriods,AdjustmentBasis"
                }
            ]
        }
    ]
}

Back to Top