Page Comparison

Tip
Available from CRM.COM R14.0.0

Excerpt
This method add updates a meter reading to an installed_item. A single installed itemof an Installed Item. A single Installed Item's meter reading information is updated by each call. Applicable only for Installed Items that their Meter Reading Type is classified as ONETIME

Resource URL

Parameters

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

Name

Type

Description

token

String

The token retrieved from the login method

installed_item_identifier

(mandatorysemi-optional)

Identifier

The identifier of the installed item that should be returned as a resultInstalled Item that a meter reading will be updated. The allowed installed item identifier fields are the following:

Include Page

	V4:installed_item_identifier
	V4:installed_item_identifier

Note: installed_item_identifier and meter_reading_identifier parameters are semi-optional

meter_reading_identifier

(semi-optional)

Meter Reading Identifier

The identifier of the meter reading. The allowed meter reading identifier fields are the following:

Include Page

	V4:meter_reading_identifier
	V4:meter_reading_identifier

Note: installed_item_identifier and meter_reading_identifier parameters are semi-optional

meter_reading_value

(mandatorysemi-optional)

Number

The meter reading value that was documented

created_on

(.

Note: meter_reading_value, from_date and to_date parameters are semi-optional

from_date

(semi-optional)

Date

The starting date

that

of the period related with the meter reading

was created.

If not specified,

the current date will be set

fields_set

(optional)

List of Strings, comma separated

then this parameter will be set as the To date of the previous entry (if any) - otherwise will be set as the current date

Note: meter_reading_value, from_date and to_date parameters are semi-optional

to_date

(semi-optional)

Date

The ending date of the period related with the meter reading

Note: meter_reading_value, from_date and to_date parameters are semi-optional

Restrictions

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

Response Data

Include Page

	V4:installed_item_meter_reading_completeshort
	V4:installed_item_meter_reading_completeshort

Examples

Expand

title	Example 1

HTTP Method: POST

Request

Body

Code Block

theme	Confluence
language	javascript
linenumbers	true

 {
    "token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c3IiOiJNUEFkbWluaXN0cmF0b3IiLCJvcmciOiJwc19kZXYiLCJvdW4iOiIxIiwiZXhwIjoiMTUwODg1NDU1NSIsImlhdCI6IjE1MDg4NDczNTUiLCJqdGkiOiI2NTlCQTE2MTNEMzY0OUI3ODBBOUJENEIwQzIwMDA2OSJ9.i7632RZEY9eI-iQLLOh5NRorLx4xzqXh6zblZlasbHs",
"meter_reading_identifier":{"id":"DEA230783CF846BDA022A6BE641F0D00"},
"meter_reading_value":"100"
}

Response

Code Block

theme	Confluence
language	javascript
linenumbers	true

     {
        "data":
        {
            "udr":
            {
                "number": "2267",
                "subscription_service":
                {
                    "product":
                    {
                        "code": "Gold",
                        "product_type":
                        {
                            "meter_reading_type": null,
                            "service_type": "TERMED",
                            "used_for_provisioning": true,
                            "alternative_code": "Main Packages",
                            "udr_type": null,
                            "composition_method": "FLAT",
                            "name": "Main Packages",
                            "description": null,
                            "id": "E186E293AAAB49EE86A729540A4287FE",
                            "classification": "SERVICES",
                            "physical_good_type": null
                        },
                        "alternative_code": "G",
                        "description": "Gold",
                        "id": "D1EB074DFD904E54A0C67CAB9DC7E010",
                        "priority_level": null
                    },
                    "first_activated_date": "2017-10-24T13:42:24",
                    "rating_state": "PENDING",
                    "service_bundle": null,
                    "rated_up_to_date": null,
                    "id": "147E11C430CF40048BE07314DAA71767",
                    "life_cycle_state": "EFFECTIVE"
                },
                "product":
                {
                    "code": "Usage2-Litre",
                    "product_type":
                    {
                        "meter_reading_type": null,
                        "service_type": "USAGE",
                        "used_for_provisioning": false,
                        "alternative_code": "U_2",
                        "udr_type":
                        {
                            "unit_of_measurement":
                            {
                                "alternative_code": "L_1",
                                "name": "Litre",
                                "description": null,
                                "id": "6571B6FE392645318B7EBD9F918960D3"
                            },
                            "alternative_code": "U_1",
                            "name": "UDR2-Litre",
                            "description": null,
                            "id": "ABF0BEBE518C45AD80628890DAC03AD1"
                        },
                        "composition_method": "FLAT",
                        "name": "Usage2-Litre",
                        "description": null,
                        "id": "D1EF0D9DA6A44762913C5C9BFD8708A0",
                        "classification": "SERVICES",
                        "physical_good_type": null
                    },
                    "alternative_code": "U_1",
                    "description": "Usage2-Litre",
                    "id": "D555EB6194E64CBB8738DF060F5C05C7",
                    "priority_level": null
                },
                "installed_item":
                {
                    "product":
                    {
                        "code": "Product1 - ProductType1",
                        "product_type":
                        {
                            "meter_reading_type":
                            {
                                "unit_of_measurement": null,
                                "alternative_code": "O",
                                "name": "OneTimeMRType",
                                "description": null,
                                "id": "60DDDE4D46EC48B1B6E85885367B8780",
                                "classification": "ONE_TIME_READING"
                            },
                            "service_type": null,
                            "used_for_provisioning": false,
                            "alternative_code": "P-O",
                            "udr_type": null,
                            "composition_method": "FLAT",
                            "name": "ProductType1 - OneTimeMRType",
                            "description": null,
                            "id": "90532785266D44C8AD789E3410022E99",
                            "classification": "PHYSICALGOODS",
                            "physical_good_type": "TRACEABLE"
                        },
                        "alternative_code": "P-P",
                        "description": "Product1 - ProductType1",
                        "id": "52A2315A7DE541EAA1900BEE7BACB75E",
                        "priority_level": null
                    },
                    "alternative_code": "Item11 - Product1",
                    "serial_number": "Item11 - Product1",
                    "id": "6AA921821A0D4F5F98A4C7B4A1C8638A",
                    "state": "EFFECTIVE"
                },
                "log_information":
                {
                    "created_by_unit":
                    {
                        "alternative_code": "adminunit",
                        "group_name": "Main Group",
                        "community_name": "Community",
                        "name": "Admin Unit",
                        "description": "admin unit",
                        "id": "1"
                    },
                    "updated_by_unit":
                    {
                        "alternative_code": "adminunit",
                        "group_name": "Main Group",
                        "community_name": "Community",
                        "name": "Admin Unit",
                        "description": "admin unit",
                        "id": "1"
                    },
                    "created_date": "2017-10-24T15:30:04",
                    "updated_date": "2017-10-24T15:30:05",
                    "updated_by_user":
                    {
                        "person_name": "CRM COM",
                        "id": "1",
                        "username": "MPAdministrator"
                    },
                    "created_by_user":
                    {
                        "person_name": "CRM COM",
                        "id": "1",
                        "username": "MPAdministrator"
                    }
                },
                "source_system": null,
                "id": "29BBD6F552574909BE8F622112DBBDD1",
                "type":
                {
                    "alternative_code": "U_1",
                    "name": "UDR2-Litre",
                    "description": null,
                    "id": "ABF0BEBE518C45AD80628890DAC03AD1"
                }
            },
            "unit_of_measurement":
            {
                "alternative_code": "L_1",
                "name": "Litre",
                "description": null,
                "id": "6571B6FE392645318B7EBD9F918960D3"
            },
            "from_date": "2017-10-24T15:07:44",
            "to_date": "2017-10-24T16:00:00",
            "log_information":
            {
                "created_by_unit":
                {
                    "alternative_code": "adminunit",
                    "group_name": "Main Group",
                    "community_name": "Community",
                    "name": "Admin Unit",
                    "description": "admin unit",
                    "id": "1"
                },
                "updated_by_unit":
                {
                    "alternative_code": "adminunit",
                    "group_name": "Main Group",
                    "community_name": "Community",
                    "name": "Admin Unit",
                    "description": "admin unit",
                    "id": "1"
                },
                "created_date": "2017-10-24T15:29:18",
                "updated_date": "2017-10-24T15:30:06",
                "updated_by_user":
                {
                    "person_name": "CRM COM",
                    "id": "1",
                    "username": "MPAdministrator"
                },
                "created_by_user":
                {
                    "person_name": "MPAdministrator",
                    "id": "1",
                    "email": "dev@crm.com",
                    "username": "MPAdministrator"
                }
            },
            "accounts_receivable":
            {
                "number": "ACR0000012788",
                "name": "ACR0000012788 Test 7738_06",
                "id": "04184E056A24484B9DB306A64A73C696",
                "life_cycle_state": "ACTIVE",
                "account_owner":
                {
                    "company_profile": null,
                    "company_name": null,
                    "name": "Test 7738_06",
                    "last_name": "7738_06",
                    "id": "E398A7774D224DE9822C3C067C334274",
                    "life_cycle_state": "FINANCIAL",
                    "middle_name": null,
                    "title": null,
                    "type": "PERSON",
                    "first_name": "Test",
                    "demographics":
                    {
                        "name_day":
                        {
                            "month": null,
                            "day": null
                        },
                        "id_number": "7738_06",
                        "gender": null,
                        "country_of_residence":
                        {
                            "alternative_code": "CYP",
                            "three_character_code": "CYP",
                            "name": "CYPRUS",
                            "id": "181",
                            "two_character_code": "CY"
                        },
                        "date_of_birth":
                        {
                            "month": null,
                            "year": null,
                            "day": null
                        },
                        "industry_sector": null,
                        "passport_number": null,
                        "industry": null,
                        "social_security_number": null,
                        "id_issued_by_country": null,
                        "passport_issued_by_country": null
                    }
                }
            },
            "id": "DEA230783CF846BDA022A6BE641F0D00",
            "meter_reading_value": 100
        },
        "status":
        {
            "code": "OK",
            "description": "",
            "message": ""
        }
    }

Versions Compared

Old Version 1

New Version Current

Key

Resource URL

Parameters

Restrictions

Response Data

Examples