Skip to end of banner
Go to start of banner

POST resource_requests/create

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

Version 1 Next »

This method creates new resource requests. A single resource request can be created by each call

Available from CRM.COM R4.0.0


 

Resource URL

Parameters

Name

Type

Description

token

String

The token retrieved from the login method

requested_by_group_identifier

(mandatory)

Group Identifier

The Identifier of the Group that is requesting the resource. The available Group Identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the group

name

(semi-optional)

String

The code of the group

alternative_code

(semi-optional)

String

The alternative code of  the group

requested_by_unit_identifier

(mandatory)

Unit Identifier

The Identifier of the Unit that is requesting the resource. The available Unit Identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the Unit

name

(semi-optional)

String

The name of the Unit

alternative_code

(semi-optional)

String

The alternative code of  the Unit

requested_by_user_identifier

(mandatory)

User Identifier

The Identifier of the User that is requesting the resource. The available User Identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the user

username

(semi-optional)

String

The username of the user

requested_unit_identifier

(mandatory)

Unit Identifier

The Identifier of the Unit that is requested as a resource. The available Unit Identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the Unit

name

(semi-optional)

String

The name of the Unit

alternative_code

(semi-optional)

String

The alternative code of  the Unit

number_of_resources

(mandatory)

Number

The number of required resources

planned_date

(mandatory)

DateThe planned date

from_time

(mandatory)

StringThe from time that the required resource should be start.

to_time

(mandatory)

StringThe from time that the required resource should be end.

requested_resource_plan_entry _identifier

(mandatory)

Resource Plan Entry Identifier

The identifier of the resource plan entry which should be reserved for this resource request, in the case were the resource request was accepted. The available resource plan entry identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the resource plan entry

number

(semi-optional)

String

The number of the resource plan entry

 

 

to_be_used_by_activity _identifier

(mandatory)

Activity Identifier

The identifier of the Activity for which the requested resource should be provided for. The available activity identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the activity

number

(semi-optional)

String

The number of the activity

to_be_used_by_activity_service _identifier

(mandatory)

Activity Services to be Provided Identifier

The identifier of the Activity service for which the requested resource should be provided for. The available activity service identifier fields are the following:

Name

Type

Description

id

(mandatory)

String

The ID of the activity service

description

(optional)

StringThe description of the resource request

udf_string_1

(optional)

String

User Defined Field of type String

udf_string_2

(optional)

String

User Defined Field of type String

udf_string_3

(optional)

String

User Defined Field of type String

udf_string_4

(optional)

String

User Defined Field of type String

udf_string_5

(optional)

String

User Defined Field of type String

udf_string_6

(optional)

String

User Defined Field of type String

udf_string_7

(optional)

String

User Defined Field of type String

udf_string_8

(optional)

String

User Defined Field of type String

udf_float_1

(optional)

Float

User Defined Field of type Float

udf_float_2

(optional)

Float

User Defined Field of type Float

udf_float_3

(optional)

Float

User Defined Field of type Float

udf_float_4

(optional)

Float

User Defined Field of type Float

udf_date_1

(optional)

Date

User Defined Field of type Date

udf_date_2

(optional)

Date

User Defined Field of type Date

udf_date_3

(optional)

Date

User Defined Field of type Date

udf_date_4

(optional)

Date

User Defined Field of type Date

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

id

String

The ID of the retrieved  resource request

number

String

The number of the retrieved resource request

descriptionStringThe description of the retrieved resource request
number_of_resourcesNumber

The number of required resources

from_dateDate

The start date and time of the period for which the resource is requested for

to_dateDate

The end date and time of the period for which the resource is requested for

life_cycle_state

String

The life cycle state of the retrieved resource request which can be PENDING, ACCEPTED, REJECTED or CANCELLED

udf_string_1

String

User Defined Field of type String

udf_string_2

String

User Defined Field of type String

udf_string_3

String

User Defined Field of type String

udf_string_4

String

User Defined Field of type String

udf_string_5

String

User Defined Field of type String

udf_string_6

String

User Defined Field of type String

udf_string_7

String

User Defined Field of type String

udf_string_8

String

User Defined Field of type String

udf_float_1

Float

User Defined Field of type Float

udf_float_2

Float

User Defined Field of type Float

udf_float_3

Float

User Defined Field of type Float

udf_float_4

Float

User Defined Field of type Float

udf_date_1

Date

User Defined Field of type Date

udf_date_2

Date

User Defined Field of type Date

udf_date_3

Date

User Defined Field of type Date

udf_date_4

Date

User Defined Field of type Date

requested_by_business_unitBusiness Unit Object

The business unit that is requesting the resource

Available from CRM.COM R18.0.0

requested_by_group

Group Object

The Group that is requesting the resource

Deprecated from CRM.COM R18.0.0 (replaced with requested_by_business_unit)

requested_by_unit

Unit Object

The Unit that is requesting the resource

Deprecated from CRM.COM R18.0.0 (replaced with requested_by_business_unit)

requested_by_user

User Object

The User that is requesting the resource

requested_business_unit

Unit Object

The Unit that is requested as a resource

Available from CRM.COM R18.0.0

requested_unit

Unit Object

The Unit that is requested as a resource

Deprecated from CRM.COM R18.0.0 (replaced with requested_business_unit)

requested_one_time_service

Product Object

The one time service that the requested resource should provide

to_be_used_by_activity

Activity Object

The Activity for which the requested resource should be provided for

to_be_used_by_activity_serviceActivity Services to be Provided ObjectThe Activity Service for which the requested resource should be provided for

requested_resource_plan_entry

Resource Plan Entry Object

The Resource Availability record which was requested for this resource request, in the case were the resource request was accepted

log_informationLog Information ObjectThe log information of the retrieved resource request

Referred Objects Response Data

 group object response data

Name

Type

Description

id

String

The ID of the retrieved group

name

String

The name of the retrieved group

community_name

String

The name of the community that the retrieved group belongs to

alternative_code

String

The alternative code of the retrieved group

unified_codeString

The unified code of the retrieved group

Available from CRM.COM R16.2.2

description

String

The description of the retrieved group

 unit object response data

Name

Type

Description

id

String

The ID of the retrieved unit

name

String

The name of the retrieved unit

group_name

String

The name of the group that the retrieved unit belongs to

community_name

String

The name of the community that the retrieved unit belongs to

alternative_code

String

The alternative code of the retrieved unit

description

String

The description of the retrieved unit

 user object response data

Name

Type

Description

id

String

The ID of the retrieved user

username

String

The user name of the retrieved user

person_name

String

The full name of the retrieved user

email

String

The email of the retrieved user

 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

 activity object response data

Name

Type

Description

id

String

The ID of the retrieved activity

number

String

The number of the retrieved activity

life_cycle_state

String

The life cycle state of the activity. One of the following values is returned:

PENDING, IN PROGRESS, COMPLETED, CANCELLED

contact_informationContact information objectThe contact information owning the activity
typeActivity Type ObjectThe type information of the retrieved activity

Referred Objects Response Data

 contact_information object response data

Name

Type

Description

id

String

The ID of the retrieved contact information

type

String

The type of the retrieved contact information which can be PERSON or COMPANY

life_cycle_state

String

The lifecycle state of the retrieved contact information which can be MARKETING or FINANCIAL

name

String

The full name of the retrieved contact information

first_name

String

The first name of the retrieved contact information

middle_name

String

The middle name of the retrieved contact information

last_name

String

The last name of the retrieved contact information

title

String

The title of the retrieved contact information

company_nameSting

The company name of the retrieved contact information

demographics

Demographics Object

The demographics information of the retrieved contact information

company_profile

Company profile object

The company profile of the retrieve contact information

Referred Objects Response Data

 demographics object response data

Name

Type

Description

gender

String

The gender of the retrieved contact information which can be MALE or FEMALE

id_number

String

The ID number of the retrieved contact information

id_number_expiration_dateDate

The ID number's expiration date of the retrieved contact information

Available from CRM.COM R14.0.0

passport_number

String

The passport number of the retrieved contact information

passport_number_expiration_dateDate

The passport's expiration date of the retrieved contact information

Available from CRM.COM R14.0.0

social_security_number

String

The social security number of the retrieved contact information

date_of_birth

Date of Birth Object

The date of birth of the retrieved contact information

name_day

Name Day Object

The name day of the retrieved contact information

country_of_residence

Country Object

The country of residence of the retrieved contact information

id_issued_by_country

Country Object

The ID issued country of retrieved contact information

passport_issued_by_country

Country Object

The passport  issued country of retrieved contact information

industry

Industry Object

The industry of retrieved contact information

industry_sector

Industry sector Object

The sector of retrieved contact information

Referred Objects Response Data

 date_of_birth object response data

Name

Type

Description

day

Integer

The day of the retrieved date of birth

month

Integer

The month of the retrieved date of birth

year

Integer

The year of the retrieved date of birth

 name_day object response data

Name

Type

Description

day

Integer

The day of the retrieved name day

month

Integer

The month of the retrieved name day

 country object response data

Name

Type

Description

id

String

The id of the retrieved country

name

String

The name of the retrieved country

alternative_codeString

The alternative code of the retrieved country

dialing_codeString

The dialing code of the retrieved country

Available from CRM.COM R15.1.0

two_character_codeString

The two character code of the retrieved country

three_character_codeString

The three character code of the retrieved country

country_flagImage Object

The flag of the retrieved country

Available from CRM.COM R15.1.0

Referred Objects Response Data

 country_flag object response data

Name

Type

Description

id

String

The ID of the retrieved country flag

fileFile ObjectThe information of the attached file

Referred Objects Response Data

 file object response data

 

Name

Type

Description

file_nameStringThe name of the file
file_content_urlStringThe url that can be used to access the actual content of the file
file_mime_typeStringThe mime type of the attached file

 industry object response data

Name

Type

Description

id

String

The id of the retrieved industry

name

String

The name of the retrieved industry

code

String

The code of the retrieved industry

 industry sector object response data

Name

Type

Description

id

String

The id of the retrieved industry sector

name

String

The name of the retrieved industry sector

alternative_code

String

The alternative code of the retrieved industry sector

 company profile object response data

Name

Type

Description

profile_year

Number

The profile year of the retrieved contact information

annual_turnover

Number

The annual turnover of the retrieved contact information

established_date

Date

The established date of the retrieved contact information

number_of_employeesNumber

The number of employees of the retrieved contact information

registration_number

String

The registration number of the retrieved contact information

vat_registration_numberString

The vat registration number of the retrieved contact information

vat_registered_byString

The vat registration by of the retrieved contact information

vat_registration_date

Date

The vat registration date of the retrieved contact information

tax_reference_numberString

The tax referenece number of the retrieved contact information

registered_in_country

Country Object

The country of residence of the retrieved contact information

industry

Industry Object

The industry of retrieved contact information

industry_sector

Industry sector Object

The sector of retrieved contact information

Referred Objects Response Data

 country object response data

Name

Type

Description

id

String

The id of the retrieved country

name

String

The name of the retrieved country

alternative_codeString

The alternative code of the retrieved country

dialing_codeString

The dialing code of the retrieved country

Available from CRM.COM R15.1.0

two_character_codeString

The two character code of the retrieved country

three_character_codeString

The three character code of the retrieved country

country_flagImage Object

The flag of the retrieved country

Available from CRM.COM R15.1.0

Referred Objects Response Data

 country_flag object response data

Name

Type

Description

id

String

The ID of the retrieved country flag

fileFile ObjectThe information of the attached file

Referred Objects Response Data

 file object response data

 

Name

Type

Description

file_nameStringThe name of the file
file_content_urlStringThe url that can be used to access the actual content of the file
file_mime_typeStringThe mime type of the attached file

 industry object response data

Name

Type

Description

id

String

The id of the retrieved industry

name

String

The name of the retrieved industry

code

String

The code of the retrieved industry

 industry sector object response data

Name

Type

Description

id

String

The id of the retrieved industry sector

name

String

The name of the retrieved industry sector

alternative_code

String

The alternative code of the retrieved industry sector

 activity_type object response data

Name

Type

Description

id

String

The ID of the retrieved activity type

name

String

The name of the retrieved activity type

alternative_code

String

The alternative code of the retrieved activity type

descriptionStringA description of the retrieved activity type

 activity_services_to_be_provided object response data

Name

Type

Description

id

String

The ID of the retrieved activity service to be provided

time_spendTime Period ObjectThe time that was spend on each service, measured in minutes, hours, days, weeks, months and years.
serviceProduct objectThe product classified as one time service which is related with the retrieved activity service
resource_requests_setSet of Resource Request ObjectsThe resource requests that were submitted against the retrieved activity service

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

 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

 resource request object response data

Name

Type

Description

id

String

The ID of the retrieved  resource request

number

String

The number of the retrieved resource request

descriptionStringThe description of the retrieved resource request
number_of_resourcesNumber

The number of required resources

from_dateDate

The start date and time of the period for which the resource is requested for

to_dateDate

The end date and time of the period for which the resource is requested for

life_cycle_state

String

The life cycle state of the retrieved resource request which can be PENDING, ACCEPTED, REJECTED or CANCELLED

requested_unit

Unit Object

The business unit that is requested as a resource

Deprecated from CRM.COM R18.0.0

requested_business_unit

Business Unit Object

The business unit that is requested as a resource

Available from CRM.COM R18.0.0

Referred Objects Response Data

 unit object response data

Name

Type

Description

id

String

The ID of the retrieved unit

name

String

The name of the retrieved unit

group_name

String

The name of the group that the retrieved unit belongs to

community_name

String

The name of the community that the retrieved unit belongs to

alternative_code

String

The alternative code of the retrieved unit

description

String

The description of the retrieved unit

 business unit object response data

Name

Type

Description

id

String

The ID of the retrieved business unit

name

String

The name of the retrieved business unit

codeStringThe code of the retrieved business unit
unified_codeString

The unified code of the retrieved business unit

description

String

The description of the retrieved business unit

parent_business_unit_nameStringThe name of the parent business unit that the retrieved business unit belongs to

 resource plan entry object response data

Name

Type

Description

id

String

The ID of the retrieved resource plan entry

number

String

The name of the retrieved resource plan entry

descriptionStringA description of the retrieved resource plan entry
effective_dateDateThe date that the retrieved resource plan entry is effective
resource_planResource Plan Object

The Resource Plan that the Resource Plan Entry belongs to

Referred Objects Response Data

 resource plan object response data

Name

Type

Description

id

String

The ID of the retrieved resource plan

number

String

The name of the retrieved resource plan

descriptionStringA description of the retrieved resource plan
effective_fromDate

The date which determines the start of the period which is covered by the resource plan

effective_toDate

The date which determines the end of the period which is covered by the resource plan

planned_for_unitUnit Object

The unit that the resource plan is created for

Deprecated from CRM.COM R18.0.0

planned_for_business_unitBusiness Unit Object

The business unit that the resource plan is created for

Available from CRM.COM R18.0.0

Referred Objects Response Data

 unit object response data

Name

Type

Description

id

String

The ID of the retrieved unit

name

String

The name of the retrieved unit

group_name

String

The name of the group that the retrieved unit belongs to

community_name

String

The name of the community that the retrieved unit belongs to

alternative_code

String

The alternative code of the retrieved unit

description

String

The description of the retrieved unit

 business unit object response data

Name

Type

Description

id

String

The ID of the retrieved business unit

name

String

The name of the retrieved business unit

codeStringThe code of the retrieved business unit
unified_codeString

The unified code of the retrieved business unit

description

String

The description of the retrieved business unit

parent_business_unit_nameStringThe name of the parent business unit that the retrieved business unit belongs to

 log_information object response data

Name

Type

Description

created_date

Date

The date that the retrieved record was created

updated_date

Date

The last date that the retrieved record was updated

created_by_unit

Unit Object

The unit that created the retrieved record

From CRM.COM R14.1.0 and onward, group_name and community_name attributes will be returned as empty, if the related legacy compatibility setting is disabled

Deprecated from CRM.COM R18.0.0

created_by_business_unit

Unit Object

The unit that created the retrieved record

From CRM.COM R14.1.0 and onward, group_name and community_name attributes will be returned as empty, if the related legacy compatibility setting is disabled

Available from CRM.COM R18.0.0

created_by_user

User Object

The user that created the retrieved record

From CRM.COM R14.1.0 and onward, person_name and email attributes will be returned as empty, if the related legacy compatibility setting is disabled

updated_by_unit

Unit Object

The last unit that updated the retrieved record

From CRM.COM R14.1.0 and onward, group_name and community_name attributes will be returned as empty, if the related legacy compatibility setting is disabled

Deprecated from CRM.COM R18.0.0

updated_by_business_unit

Unit Object

The last unit that updated the retrieved record

Available from CRM.COM R18.0.0

updated_by_user

User Object

The last user that updated the retrieved record

From CRM.COM R14.1.0 and onward, person_name and email attributes will be returned as empty, if the related legacy compatibility setting is disabled

Referred Objects Response Data

 unit object response data

Name

Type

Description

id

String

The ID of the retrieved unit

name

String

The name of the retrieved unit

group_name

String

The name of the group that the retrieved unit belongs to

community_name

String

The name of the community that the retrieved unit belongs to

alternative_code

String

The alternative code of the retrieved unit

description

String

The description of the retrieved unit

 business unit object response data

Name

Type

Description

id

String

The ID of the retrieved business unit

name

String

The name of the retrieved business unit

codeStringThe code of the retrieved business unit
unified_codeString

The unified code of the retrieved business unit

description

String

The description of the retrieved business unit

parent_business_unit_nameStringThe name of the parent business unit that the retrieved business unit belongs to

 user object response data

Name

Type

Description

id

String

The ID of the retrieved user

username

String

The user name of the retrieved user

person_name

String

The full name of the retrieved user

email

String

The email of the retrieved user

 business unit object response data

Name

Type

Description

id

String

The ID of the retrieved business unit

name

String

The name of the retrieved business unit

codeStringThe code of the retrieved business unit
unified_codeString

The unified code of the retrieved business unit

description

String

The description of the retrieved business unit

parent_business_unit_nameStringThe name of the parent business unit that the retrieved business unit belongs to

Examples

 Example 1

HTTP Method: POST

http://localhost:9080/crmapi/rest/v2/resource_requests/create

Request:

Body

{
    "token"    : "56272B2915C118117ABEB216E77BB518",
    "requested_by_group_identifier" : {"name" : "Main Group"},
    "requested_by_unit_identifier" : {"name" : "Admin Unit"},
    "requested_by_user_identifier" : {"username" : "MPAdministrator"},
    "requested_unit_identifier" : { "name" : "Team 4 (Installations)" },
    "requested_one_time_service_identifier" : { "code" : "Installation"},
    "number_of_resources" : 1 ,
    "planned_date" : "2014-12-04T00:00:00",
    "from_time" : "14:00",
    "to_time" : "18:00",
    "requested_resource_plan_entry_identifier" : { "number" : "1690"},
    "to_be_used_by_activity_identifier" : { "number" : "9"},
    "to_be_used_by_activity_service_identifier" : { "id" : "865FEE574CD1A24921E07FD0625AF4BD"},
    "description" : "Web Api Description Test"
}


Response:

    {
       "status":
       {
           "message": null,
           "description": null,
           "code": "OK"
       },
       "data":
       {
           "udf_float_1": null,
           "udf_float_2": null,
           "requested_by_group":
           {
               "community_name": null,
               "name": "Main Group",
               "id": "84F33366CB592BAAE7E2044D93611C6A",
               "description": "Main Group",
               "alternative_code": "das"
           },
           "udf_float_3": null,
           "udf_float_4": null,
           "number": "60",
           "udf_string_1": null,
           "udf_string_2": null,
           "udf_string_3": null,
           "udf_string_4": null,
           "udf_string_5": null,
           "udf_string_6": null,
           "udf_string_7": null,
           "udf_string_8": null,
           "id": "92D30153AE02C7F15E26C3CD2F2AACD6",
           "requested_by_unit":
           {
               "community_name": null,
               "group_name": "Main Group",
               "name": "Admin Unit",
               "id": "48305F8849E3C18B227C5BE3A27BA6DF",
               "description": "r1",
               "alternative_code": "MG"
           },
           "requested_resource_plan_entry":
           {
               "effective_date": "2014-12-04T00:00:00",
               "number": "1690",
               "resource_plan":
               {
                   "effective_from": "2014-12-01T00:00:00",
                   "effective_to": "2014-12-07T00:00:00",
                   "planned_for_unit":
                   {
                       "group_name": null,
                       "name": "Team 4 (Installations)",
                       "id": "4B72C0B3BF5C38B002C8B6EA68B5852C",
                       "description": null,
                       "alternative_code": "T4I"
                   },
                   "number": "16",
                   "id": "BDFD9EFA018B3B4E587D4CD9DDA86B9A",
                   "description": null
               },
               "id": "0186B209103738494C4BC3B06D06C564",
               "description": null
           },
           "requested_by_user":
           {
               "person_name": "MPAdministrator",
               "username": "MPAdministrator",
               "id": "1",
               "email": null
           },
           "from_date": "2014-12-04T14:00:00",
           "to_be_used_by_activity_service":
           {
               "service":
               {
                   "product_type": null,
                   "id": "8E990D550CC2F4D2951A273E9D84F9E6",
                   "description": null,
                   "code": "Installation",
                   "alternative_code": "IN"
               },
               "id": "865FEE574CD1A24921E07FD0625AF4BD",
               "time_spend":
               {
                   "time_period_value": 2,
                   "time_period_uot": null
               }
           },
           "udf_date_1": null,
           "udf_date_2": null,
           "udf_date_3": null,
           "udf_date_4": null,
           "to_be_used_by_activity":
           {
               "life_cycle_state": "PENDING",
               "number": "9",
               "type":
               {
                   "name": "Installations",
                   "id": "BF60960C7FC5B0E5B81DB7E5BCC7F140",
                   "description": null,
                   "alternative_code": "IN"
               },
               "id": "D9C6BE3D7817C8DA8E16703CAAEC1A9A",
               "contact_information":
               {
                   "last_name": "Spector",
                   "life_cycle_state": "FINANCIAL",
                   "middle_name": null,
                   "company_profile": null,
                   "title": null,
                   "type": "PERSON",
                   "first_name": "Matt",
                   "name": null,
                   "id": "58F5508072753180E10322DBCA1862EE",
                   "company_name": null,
                   "demographics":
                   {
                       "gender": "MALE",
                       "passport_issued_by_country": null,
                       "passport_number": "JB0007689",
                       "social_security_number": null,
                       "industry_sector": null,
                       "date_of_birth":
                       {
                           "month": null,
                           "day": null,
                           "year": null
                       },
                       "name_day":
                       {
                           "month": null,
                           "day": null
                       },
                       "id_number": null,
                       "id_issued_by_country": null,
                       "industry": null
                   }
               }
           },
           "requested_one_time_service":
           {
               "product_type": null,
               "id": "8E990D550CC2F4D2951A273E9D84F9E6",
               "description": null,
               "code": "Installation",
               "alternative_code": "IN"
           },
           "to_date": "2014-12-04T18:00:00",
           "number_of_resources": 1,
           "life_cycle_state": "PENDING",
           "description": "Web Api Description Test"
       }
    }
  • No labels