Skip to end of banner
Go to start of banner

POST jobs/all_scopes/preview_bill

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Current »

Available from CRM.COM R10.0.0

It previews the bill of one job of any fulfillment scope


Resource URL

Parameters

Name

Type

Description

token

String

The token retrieved from the login method

job_identifier

(mandatory)

Job identifier  

The identifier of the job that should be previewed. The allowed jobs identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the job

number

(semi-optional)

String

The number of the job

fields_set

(optional)

List of Strings, comma separated 

A list of fields that should be included in the results. If not specified then all the available fields will be returned

Restrictions

  • It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.

Response Data

Name

Type

Description

bill_previewBill preview objectThe bill preview results

Referred Objects Response Data

 bill preview object response data

Name

Type

Description

from_dateDateThe date from which the accounts receivable is billed for
to_dateDateThe date until which the accounts receivable is billed for
total_billed_amountNumberThe total billed amount
total_billed_amount_of_parentNumber

The total amount that the parent account will be billed for. Applicable only if a parent account funds its members

Available from CRM.COM R13.0.0

Starting from CRM.COM R14.0.0, this parameter will be deprecated

total_billed_amount_of_member

Number

The total amount that the member account will be billed for. Applicable if account owner is a member in a group

Available from CRM.COM R13.0.0

Starting from CRM.COM R14.0.0, this parameter will be deprecated

total_amount_to_be_paidNumberThe total amount to be paid
total_amount_to_be_paid_by_parentNumber

The total amount that the parent account should pay. Applicable only if a parent account fund its members

Available from CRM.COM R13.0.0

Starting from CRM.COM R14.0.0, this parameter will be deprecated

total_amount_to_be_paid_by_memberNumber

The total amount that the member account should pay. Applicable only if the account owner is a member in a group

Available from CRM.COM R13.0.0

Starting from CRM.COM R14.0.0, this parameter will be deprecated

total_vat_amountNumber

The total VAT amount billed

Available from CRM.COM R12.0.0

Deprecated from CRM.COM R17.0.0

total_vat_amount_of_parentNumber

The total VAT amount that the parent account will be billed for. Applicable only if a parent account fund its members

Available from CRM.COM R13.0.0

Starting from CRM.COM R14.0.0, this parameter will be deprecated

total_vat_amount_of_memberNumber

The total VAT amount that the member account will be billed for. Applicable only if the account owner is a member in a group

Available from CRM.COM R13.0.0

Starting from CRM.COM R14.0.0, this parameter will be deprecated


total_tax_amountNumber

The total Tax amount billed

Available from CRM.COM R12.0.0

total_tax_amount_of_parentNumber

The total Tax amount that the parent account will be billed for. Applicable only if a parent account fund its members

Available from CRM.COM R13.0.0

Starting from CRM.COM R14.0.0, this parameter will be deprecated


total_tax_amount_of_memberNumber

The total Tax amount that the member account will be billed for. Applicable only if the account owner is a member in a group

Available from CRM.COM R13.0.0

Starting from CRM.COM R14.0.0, this parameter will be deprecated


currencyCurrency Object

The bill's currency

Available from CRM.COM R10.0.0

product_setSet of bill preview productsThe products that will be included in the bill preview

Referred Objects Response Data

 currency object response data

Name

Type

Description

id

String

The ID of the retrieved currency

code

String

The code of the retrieved currency

prefix_symbolStringThe prefix symbol for the specified currency

suffix_symbol

StringThe suffix symbol for the specified currency
life_cycle_stateString

The life cycle state for the specified currency, which can be EFFECTIVE or NOT EFFECTIVE

Available from CRM.COM R14.0.0

integer_part_nameStringThe integer part name for the specified currency
decimal_part_nameStringThe decimal part name for the specified currency

 bill_preview_product object response data

Name

Type

Description

from_dateDateThe date from which the accounts receivable is billed for
to_dateDateThe date until which the accounts receivable is billed for
total_amountNumberThe total billed amount
productProduct objectthe product that was billed
applied_additive_discounts_setSet of Applied Additive Discount Objects

The additive discounts that will be applied on the retrieved product

Referred Objects Response Data

 product object response data
Name
Type
Description
IdStringThe ID of the product
codeStringThe code of product

alternative_code

String

The alternative code of product

description

String

The description of product

priority_levelInteger

The priority level of the product

Available from CRM.COM R12.3.0

global_rateGlobal Rate Object

The global rate of the retrieved product

Available from CRM.COM R15.0.0

product_typeProduct type objectThe type of the product

Referred Objects Response Data

 product_type object data response
NameType Description
IdStringThe ID of the retrieved product type
nameStringThe Name of the retrieved product type
alternative_codeStringThe Alternative Code of the retrieved product type
descriptionStringThe Description of the retrieved product type
classificationStringThe Classification of the retrieved product type which can be SERVICES or PHYSICALGOODS
service_typeStringThe Service Type of the retrieved product type which can be TERMED, USAGE, ONETIME or EXPENSE
physical_good_typeStringThe physical Good Type of the retrieved product type which can be TRACEABLE or NONTRACEABLE
composition_methodStringThe Composition Method of the retrieved product type which can be FLAT, FLEXIBLEBUNDLE or FIXEDBUNDLE
used_for_provisioningBooleanThe flag shows if the retrieved product type is used for provisioning
udr_typeUsage Detail Record TypeThe UDR type related with the product type. This is applicable only if the product type is classified as SERVICES and the service type is set to USAGE
meter_reading_typeMeter Reading Type

The Meter Reading type related with the product type. This is applicable only for traceable physical goods

Available from CRM.COM R14.0.0

Referred Objects Response Data

 usage_detail_record_type object data response
NameType Description
IdStringThe ID of the retrieved usage detail record type
nameStringThe Name of the retrieved usage detail record type
alternative_codeStringThe Alternative Code of the retrieved usage detail record type
descriptionStringThe Description of the retrieved usage detail record type
unit_of_measurementStringThe Unit of measurement of the retrieved usage detail record type

Referred Objects Response Data

 unit_of_measurement object response data

Name

Type

Description

idStringThe identifier of the Unit of measurement

name

String

The name of the Unit of measurement

description

String

The description of the Unit of measurement

alternative_codeStringThe alternative code of the Unit of measurement

 

 meter_reading_type object data response
NameType Description
IdStringThe ID of the retrieved meter reading type
nameStringThe Name of the retrieved meter reading type
alternative_codeStringThe Alternative Code of the retrieved meter reading type
classificationStringThe Classification of the retrieved meter reading type
descriptionStringThe Description of the retrieved meter reading type
unit_of_measurementStringThe Unit of measurement of the retrieved meter reading type

Referred Objects Response Data

 unit_of_measurement object response data

Name

Type

Description

idStringThe identifier of the Unit of measurement

name

String

The name of the Unit of measurement

description

String

The description of the Unit of measurement

alternative_codeStringThe alternative code of the Unit of measurement

 global rate object response data

Name

Type

Description

id

String

The ID of the retrieved rate

rate_model

String

The price plan rate model which can be one of the following:

  • QUANTITYBASED
  • QUANTITYANDPERIODBASED
  • BILLABLEPERIODBASED
  • DURATIONBASED
  • FLATFEEBASED
  • USAGEBASED

From CRM.COM R17.0.0, QUANTITYANDMATURITYBASED is renamed to QUANTITYANDPERIODBASED

global_base_amountNumber

The base price of the product in the Global Price Plan

base_rate_applied_perString

The value for 'Base Rate Applied per'

Available when the rate model is 'Quantity & Quantity Based' and it is a selection between

  • Period
  • Period_Item
uotString

The 'UOT' applicable for the rate

  • Seconds
  • Minute
  • Hour
  • Day
  • Week
  • Month
  • Year

Available for one-time services

time_periodTime Period Object

 The period and unit of time for which the base amount is applicable for. This is available only on termed services rates.

uomString

The 'UOM' applicable for the rate

Available when the product type is of Usage Service Classification 

Referred Objects Response Data

 period object response data

Name

Type

Description

time_period_valueNumber

The time period value

time_period_uot

String

The time period unit of time. The supported values are the following:

MINUTES, HOURS, DAYS, WEEKS, MONTHS, YEARS

 applied_additive_discounts object response data

Name

Type

Description

id

String

The ID of the retrieved applied additive discount

number

String

The number of the retrieved applied additive discount

discount_amountNumberThe discount amount that was applied by the additive discount
from_dateDateThe date that the additive discount was applied from
to_dateDateThe date that the additive discount was applied to
currency_rate_periodCurrency Rate Period object

The currency rate period based on which the applied additive discount's amounts were calculated

Available from CRM.COM R10.0.0

ad_hoc_discountAd hoc Discount ObjectThe ad hoc discount that was applied
applied_additive_discount_definitionAdditive Discount Definition ObjectThe additive discount definition that was applied
productProduct Object

The product on which the additive discount was applied on

 

Referred Objects Response Data

 currency rate period object response data

Name

Type

Description

id

String

The ID of the retrieved currency rate period

rateNumberThe exchange rate of the currency rate period
inverse_rateNumberThe inverse exchange rate of the currency rate period
from_dateDateThe date from which the exchange rate is valid
to_dateDateThe date until which the exchange rate is valid
currencyCurrency ObjectThe Currency with which the returned exchange rate information refers to

Referred Objects Response Data

 currency object response data

Name

Type

Description

id

String

The ID of the retrieved currency

code

String

The code of the retrieved currency

prefix_symbolStringThe prefix symbol for the specified currency

suffix_symbol

StringThe suffix symbol for the specified currency
life_cycle_stateString

The life cycle state for the specified currency, which can be EFFECTIVE or NOT EFFECTIVE

Available from CRM.COM R14.0.0

integer_part_nameStringThe integer part name for the specified currency
decimal_part_nameStringThe decimal part name for the specified currency

 ad_hoc_discount object response data

Name

Type

Description

id

String

The ID of the retrieved ad hoc discount

number

String

The number of the retrieved ad hoc discount

discount_amountNumberThe discount amount that will be applied,  if the additive discount definition is set up to provide a range of discount based on an amount
discount_percentageNumberThe discount percentage that will be applied,  if the additive discount definition is set up to provide a range of discount based on a percentage
effective_dateDateThe date that the discount becomes effective
expiration_dateDateThe date that the discount will expire
life_cycle_stateStringThe life cycle state of the retrieved ad hoc discount. Supported values are PENDING_APPROVAL, APPROVED and CANCELLED
discount_free_periodTime Period ObjectThe free period that will be provided, measured in days, weeks, months or years.  This information is available if the additive discount definition is set up to provide a range of discount based on free period

Referred Objects Response Data

 period object response data

Name

Type

Description

time_period_valueNumber

The time period value

time_period_uot

String

The time period unit of time. The supported values are the following:

MINUTES, HOURS, DAYS, WEEKS, MONTHS, YEARS

 additive_discount_definition object response data

Name

Type

Description

id

String

The ID of the retrieved additive discount definition

alternative_codeStringThe alternative code of the retrieved additive discount definition
nameStringThe name of the retrieved additive discount definition
life_cycle_stateString

The life cycle state of the retrieved additive discount definition. The supported life cycle states are EFFECTIVE or NOT_EFFECTIVE

classificationString

The classification of the retrieved additive discount definition which can be either SUBSCRIPTIONS, JOBS or GENERAL

GENERAL classification available from CRM.COM R15.0.0

JOB classification is not available from CRM.COM R17.0.0

typeStringThe type of the additive discount definition which can be AUTO_APPLY or AD_HOC

 product object response data
Name
Type
Description
IdStringThe ID of the product
codeStringThe code of product

alternative_code

String

The alternative code of product

description

String

The description of product

priority_levelInteger

The priority level of the product

Available from CRM.COM R12.3.0

global_rateGlobal Rate Object

The global rate of the retrieved product

Available from CRM.COM R15.0.0

product_typeProduct type objectThe type of the product

Referred Objects Response Data

 product_type object data response
NameType Description
IdStringThe ID of the retrieved product type
nameStringThe Name of the retrieved product type
alternative_codeStringThe Alternative Code of the retrieved product type
descriptionStringThe Description of the retrieved product type
classificationStringThe Classification of the retrieved product type which can be SERVICES or PHYSICALGOODS
service_typeStringThe Service Type of the retrieved product type which can be TERMED, USAGE, ONETIME or EXPENSE
physical_good_typeStringThe physical Good Type of the retrieved product type which can be TRACEABLE or NONTRACEABLE
composition_methodStringThe Composition Method of the retrieved product type which can be FLAT, FLEXIBLEBUNDLE or FIXEDBUNDLE
used_for_provisioningBooleanThe flag shows if the retrieved product type is used for provisioning
udr_typeUsage Detail Record TypeThe UDR type related with the product type. This is applicable only if the product type is classified as SERVICES and the service type is set to USAGE
meter_reading_typeMeter Reading Type

The Meter Reading type related with the product type. This is applicable only for traceable physical goods

Available from CRM.COM R14.0.0

Referred Objects Response Data

 usage_detail_record_type object data response
NameType Description
IdStringThe ID of the retrieved usage detail record type
nameStringThe Name of the retrieved usage detail record type
alternative_codeStringThe Alternative Code of the retrieved usage detail record type
descriptionStringThe Description of the retrieved usage detail record type
unit_of_measurementStringThe Unit of measurement of the retrieved usage detail record type

Referred Objects Response Data

 unit_of_measurement object response data

Name

Type

Description

idStringThe identifier of the Unit of measurement

name

String

The name of the Unit of measurement

description

String

The description of the Unit of measurement

alternative_codeStringThe alternative code of the Unit of measurement

 

 meter_reading_type object data response
NameType Description
IdStringThe ID of the retrieved meter reading type
nameStringThe Name of the retrieved meter reading type
alternative_codeStringThe Alternative Code of the retrieved meter reading type
classificationStringThe Classification of the retrieved meter reading type
descriptionStringThe Description of the retrieved meter reading type
unit_of_measurementStringThe Unit of measurement of the retrieved meter reading type

Referred Objects Response Data

 unit_of_measurement object response data

Name

Type

Description

idStringThe identifier of the Unit of measurement

name

String

The name of the Unit of measurement

description

String

The description of the Unit of measurement

alternative_codeStringThe alternative code of the Unit of measurement

 global rate object response data

Name

Type

Description

id

String

The ID of the retrieved rate

rate_model

String

The price plan rate model which can be one of the following:

  • QUANTITYBASED
  • QUANTITYANDPERIODBASED
  • BILLABLEPERIODBASED
  • DURATIONBASED
  • FLATFEEBASED
  • USAGEBASED

From CRM.COM R17.0.0, QUANTITYANDMATURITYBASED is renamed to QUANTITYANDPERIODBASED

global_base_amountNumber

The base price of the product in the Global Price Plan

base_rate_applied_perString

The value for 'Base Rate Applied per'

Available when the rate model is 'Quantity & Quantity Based' and it is a selection between

  • Period
  • Period_Item
uotString

The 'UOT' applicable for the rate

  • Seconds
  • Minute
  • Hour
  • Day
  • Week
  • Month
  • Year

Available for one-time services

time_periodTime Period Object

 The period and unit of time for which the base amount is applicable for. This is available only on termed services rates.

uomString

The 'UOM' applicable for the rate

Available when the product type is of Usage Service Classification 

Referred Objects Response Data

 period object response data

Name

Type

Description

time_period_valueNumber

The time period value

time_period_uot

String

The time period unit of time. The supported values are the following:

MINUTES, HOURS, DAYS, WEEKS, MONTHS, YEARS

Examples

 Example 1

HTTP Method: POST

Request:

Body:

 {
"token":"99638021",
"job_identifier":{"number":"JOB000654"}
}


Response:

 {
  "status": {
    "message": "",
    "description": "",
    "code": "OK"
  },
  "data": {
    "total_amount_to_be_paid": 1267.5,
    "product_set": [
      {
        "to_date": null,
        "total_amount": 532.8,
        "from_date": null,
        "applied_additive_discounts_set": [
          {
            "ad_hoc_discount": {
              "life_cycle_state": "APPROVED",
              "discount_amount": null,
              "effective_date": null,
              "discount_percentage": 20,
              "number": "61",
              "id": "E4D882EC92E0400DA51E44A607D888AA",
              "expiration_date": null
            },
            "applied_additive_discount_definition": {
              "life_cycle_state": "EFFECTIVE",
              "classification": "JOBS",
              "type": "AD_HOC",
              "id": "36336142D45F4735B44554A42FA7E070",
              "name": "5 % Discount",
              "alternative_code": "5%D"
            },
            "to_date": null,
            "from_date": null,
            "discount_amount": 133.2,
            "number": null,
            "id": "F271270842134EB48DD85671070673B1",
            "product": {
              "product_type": {
                "service_type": "EXPENSE",
                "physical_good_type": null,
                "used_for_provisioning": false,
                "classification": "SERVICES",
                "composition_method": "FLAT",
                "id": "67FA013211E348C58F7CD27F8399AADE",
                "name": "Expense Type",
                "description": null,
                "alternative_code": "ET"
              },
              "id": "81D5550CF6004CE0B206A371F9F3A18A",
              "description": "Expence 2",
              "code": "Expence 2",
              "alternative_code": "exp2"
            }
          }
        ],
        "product": {
          "product_type": {
            "service_type": "EXPENSE",
            "physical_good_type": null,
            "used_for_provisioning": false,
            "classification": "SERVICES",
            "composition_method": "FLAT",
            "id": "67FA013211E348C58F7CD27F8399AADE",
            "name": "Expense Type",
            "description": null,
            "alternative_code": "ET"
          },
          "id": "81D5550CF6004CE0B206A371F9F3A18A",
          "description": "Expence 2",
          "code": "Expence 2",
          "alternative_code": "exp2"
        }
      }
    ],
    "to_date": null,
    "from_date": "2016-07-19T17:51:20",
    "total_billed_amount": 532.8
  }
}
  • No labels