- Created by Former user, last modified on Jul 06, 2017
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:
| |||||||||
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_preview | Bill preview object | The bill preview results |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
from_date | Date | The date from which the accounts receivable is billed for |
to_date | Date | The date until which the accounts receivable is billed for |
total_billed_amount | Number | The total billed amount |
total_billed_amount_of_parent | Number | 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_paid | Number | The total amount to be paid |
total_amount_to_be_paid_by_parent | Number | 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_member | Number | 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_amount | Number | The total VAT amount billed Available from CRM.COM R12.0.0 Deprecated from CRM.COM R17.0.0 |
total_vat_amount_of_parent | Number | 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_member | Number | 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_amount | Number | The total Tax amount billed Available from CRM.COM R12.0.0 |
total_tax_amount_of_parent | Number | 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_member | Number | 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 |
currency | Currency Object | The bill's currency Available from CRM.COM R10.0.0 |
product_set | Set of bill preview products | The products that will be included in the bill preview |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved currency |
code | String | The code of the retrieved currency |
prefix_symbol | String | The prefix symbol for the specified currency |
suffix_symbol | String | The suffix symbol for the specified currency |
life_cycle_state | String | The life cycle state for the specified currency, which can be EFFECTIVE or NOT EFFECTIVE Available from CRM.COM R14.0.0 |
integer_part_name | String | The integer part name for the specified currency |
decimal_part_name | String | The decimal part name for the specified currency |
Name | Type | Description |
---|---|---|
from_date | Date | The date from which the accounts receivable is billed for |
to_date | Date | The date until which the accounts receivable is billed for |
total_amount | Number | The total billed amount |
product | Product object | the product that was billed |
applied_additive_discounts_set | Set of Applied Additive Discount Objects | The additive discounts that will be applied on the retrieved product |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
Id | String | The ID of the product |
code | String | The code of product |
alternative_code | String | The alternative code of product |
description | String | The description of product |
priority_level | Integer | The priority level of the product Available from CRM.COM R12.3.0 |
global_rate | Global Rate Object | The global rate of the retrieved product Available from CRM.COM R15.0.0 |
product_type | Product type object | The type of the product |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
Id | String | The ID of the retrieved product type |
name | String | The Name of the retrieved product type |
alternative_code | String | The Alternative Code of the retrieved product type |
description | String | The Description of the retrieved product type |
classification | String | The Classification of the retrieved product type which can be SERVICES or PHYSICALGOODS |
service_type | String | The Service Type of the retrieved product type which can be TERMED, USAGE, ONETIME or EXPENSE |
physical_good_type | String | The physical Good Type of the retrieved product type which can be TRACEABLE or NONTRACEABLE |
composition_method | String | The Composition Method of the retrieved product type which can be FLAT, FLEXIBLEBUNDLE or FIXEDBUNDLE |
used_for_provisioning | Boolean | The flag shows if the retrieved product type is used for provisioning |
udr_type | Usage Detail Record Type | The 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_type | Meter 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
Name | Type | Description |
---|---|---|
Id | String | The ID of the retrieved usage detail record type |
name | String | The Name of the retrieved usage detail record type |
alternative_code | String | The Alternative Code of the retrieved usage detail record type |
description | String | The Description of the retrieved usage detail record type |
unit_of_measurement | String | The Unit of measurement of the retrieved usage detail record type |
Referred Objects Response Data
Name | Type | Description |
id | String | The 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_code | String | The alternative code of the Unit of measurement |
Name | Type | Description |
---|---|---|
Id | String | The ID of the retrieved meter reading type |
name | String | The Name of the retrieved meter reading type |
alternative_code | String | The Alternative Code of the retrieved meter reading type |
classification | String | The Classification of the retrieved meter reading type |
description | String | The Description of the retrieved meter reading type |
unit_of_measurement | String | The Unit of measurement of the retrieved meter reading type |
Referred Objects Response Data
Name | Type | Description |
id | String | The 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_code | String | The alternative code of the Unit of measurement |
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:
From CRM.COM R17.0.0, QUANTITYANDMATURITYBASED is renamed to QUANTITYANDPERIODBASED |
global_base_amount | Number | The base price of the product in the Global Price Plan |
base_rate_applied_per | String | The value for 'Base Rate Applied per' Available when the rate model is 'Quantity & Quantity Based' and it is a selection between
|
uot | String | The 'UOT' applicable for the rate
Available for one-time services |
time_period | Time Period Object | The period and unit of time for which the base amount is applicable for. This is available only on termed services rates. |
uom | String | The 'UOM' applicable for the rate Available when the product type is of Usage Service Classification |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
time_period_value | Number | 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 |
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved applied additive discount |
number | String | The number of the retrieved applied additive discount |
discount_amount | Number | The discount amount that was applied by the additive discount |
from_date | Date | The date that the additive discount was applied from |
to_date | Date | The date that the additive discount was applied to |
currency_rate_period | Currency 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_discount | Ad hoc Discount Object | The ad hoc discount that was applied |
applied_additive_discount_definition | Additive Discount Definition Object | The additive discount definition that was applied |
product | Product Object | The product on which the additive discount was applied on
|
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved currency rate period |
rate | Number | The exchange rate of the currency rate period |
inverse_rate | Number | The inverse exchange rate of the currency rate period |
from_date | Date | The date from which the exchange rate is valid |
to_date | Date | The date until which the exchange rate is valid |
currency | Currency Object | The Currency with which the returned exchange rate information refers to |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved currency |
code | String | The code of the retrieved currency |
prefix_symbol | String | The prefix symbol for the specified currency |
suffix_symbol | String | The suffix symbol for the specified currency |
life_cycle_state | String | The life cycle state for the specified currency, which can be EFFECTIVE or NOT EFFECTIVE Available from CRM.COM R14.0.0 |
integer_part_name | String | The integer part name for the specified currency |
decimal_part_name | String | The decimal part name for the specified currency |
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved ad hoc discount |
number | String | The number of the retrieved ad hoc discount |
discount_amount | Number | The 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_percentage | Number | The 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_date | Date | The date that the discount becomes effective |
expiration_date | Date | The date that the discount will expire |
life_cycle_state | String | The life cycle state of the retrieved ad hoc discount. Supported values are PENDING_APPROVAL, APPROVED and CANCELLED |
discount_free_period | Time Period Object | The 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
Name | Type | Description |
---|---|---|
time_period_value | Number | 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 |
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved additive discount definition |
alternative_code | String | The alternative code of the retrieved additive discount definition |
name | String | The name of the retrieved additive discount definition |
life_cycle_state | String | The life cycle state of the retrieved additive discount definition. The supported life cycle states are EFFECTIVE or NOT_EFFECTIVE |
classification | String | 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 |
type | String | The type of the additive discount definition which can be AUTO_APPLY or AD_HOC |
Name | Type | Description |
---|---|---|
Id | String | The ID of the product |
code | String | The code of product |
alternative_code | String | The alternative code of product |
description | String | The description of product |
priority_level | Integer | The priority level of the product Available from CRM.COM R12.3.0 |
global_rate | Global Rate Object | The global rate of the retrieved product Available from CRM.COM R15.0.0 |
product_type | Product type object | The type of the product |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
Id | String | The ID of the retrieved product type |
name | String | The Name of the retrieved product type |
alternative_code | String | The Alternative Code of the retrieved product type |
description | String | The Description of the retrieved product type |
classification | String | The Classification of the retrieved product type which can be SERVICES or PHYSICALGOODS |
service_type | String | The Service Type of the retrieved product type which can be TERMED, USAGE, ONETIME or EXPENSE |
physical_good_type | String | The physical Good Type of the retrieved product type which can be TRACEABLE or NONTRACEABLE |
composition_method | String | The Composition Method of the retrieved product type which can be FLAT, FLEXIBLEBUNDLE or FIXEDBUNDLE |
used_for_provisioning | Boolean | The flag shows if the retrieved product type is used for provisioning |
udr_type | Usage Detail Record Type | The 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_type | Meter 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
Name | Type | Description |
---|---|---|
Id | String | The ID of the retrieved usage detail record type |
name | String | The Name of the retrieved usage detail record type |
alternative_code | String | The Alternative Code of the retrieved usage detail record type |
description | String | The Description of the retrieved usage detail record type |
unit_of_measurement | String | The Unit of measurement of the retrieved usage detail record type |
Referred Objects Response Data
Name | Type | Description |
id | String | The 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_code | String | The alternative code of the Unit of measurement |
Name | Type | Description |
---|---|---|
Id | String | The ID of the retrieved meter reading type |
name | String | The Name of the retrieved meter reading type |
alternative_code | String | The Alternative Code of the retrieved meter reading type |
classification | String | The Classification of the retrieved meter reading type |
description | String | The Description of the retrieved meter reading type |
unit_of_measurement | String | The Unit of measurement of the retrieved meter reading type |
Referred Objects Response Data
Name | Type | Description |
id | String | The 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_code | String | The alternative code of the Unit of measurement |
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:
From CRM.COM R17.0.0, QUANTITYANDMATURITYBASED is renamed to QUANTITYANDPERIODBASED |
global_base_amount | Number | The base price of the product in the Global Price Plan |
base_rate_applied_per | String | The value for 'Base Rate Applied per' Available when the rate model is 'Quantity & Quantity Based' and it is a selection between
|
uot | String | The 'UOT' applicable for the rate
Available for one-time services |
time_period | Time Period Object | The period and unit of time for which the base amount is applicable for. This is available only on termed services rates. |
uom | String | The 'UOM' applicable for the rate Available when the product type is of Usage Service Classification |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
time_period_value | Number | 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
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