Create new electric premises

29 Aug 2023
3 Minutes to read
Contributors

Print
Dark
Light
PDF

Create new electric premises

Updated on 29 Aug 2023
3 Minutes to read
Contributors

Print
Dark
Light
PDF

Article summary

Did you find this summary helpful?

Thank you for your feedback

Post

/el_premises/

Operation is used to create new electric premises. Available from product version 3.2.2.

Security

API Key

Header parameter nameAuthorization

Token issued for API consumer.

Body parameters

Electric Premises to be created

object

address

integer

Apartment address id

capacity

integer

capacity

connection

integer

Electric Premises Connection id

contractor

integer

Electric Premises Contractor id

creation_date

string

Creation date and time

creator

string

Premises creator

deployment_date

string

deployment date

ground

integer

Electric Premises Ground id

group_fuse

Array of string

Group of fuses

string

guidance_address

integer

Unique Electric Premises guidance address id

guiding_type

integer

Electric Premises guiding type id

height_accuracy

integer

Height accuracy id

integer

Primary key

identification

string Required

Identification

installation_date

string

Installation date

installation_location

integer

Installation location

installation_year

integer

Installation year

location

string

Geographical location

location_accuracy

integer

Location accuracy id

main_fuse

integer

Electric Premises Main fuse type id

manufacturer

integer

Electric Premises Manufacturer id

mapper

string

mapper name

mapping_date

string

mapping date

mapping_method

integer

Mapping method id

network_area

integer

Network area id

owner

integer

Premises Owner id

plan

integer

Plan id

remarks

string

Remarks. Available from product version 3.2.14.

renter

integer

Premises Renter id

safety_distance

integer

Safety Distance id. Available from product version 3.6.4

shade

integer

Electric Premises Shade id

supplier

integer

Electric Premises Supplier id

surface

integer

Electric Premises Surface type id

surge_install_date

string

Surge protector installation date. Available from product version 3.2.22

surge_protector

integer

Electric Surge Protector id. Available from product version 3.2.22

survey_amount

integer

unknown

update_date

string

Last update date time

updated_by

string

Last updater of premises data

usage_state

integer Required

Usage state id

Responses

201

A created electric premises

{
  "address": null,
  "capacity": null,
  "connection": null,
  "contractor": null,
  "creation_date": "2019-02-21T21:04:53.809332Z",
  "creator": "api@keypro.fi",
  "deployment_date": null,
  "ground": null,
  "group_fuse": [],
  "guidance_address": null,
  "guiding_type": null,
  "height_accuracy": null,
  "id": 41241,
  "identification": "abc987",
  "installation_date": null,
  "installation_location": null,
  "installation_year": null,
  "location": null,
  "location_accuracy": null,
  "main_fuse": null,
  "manufacturer": null,
  "mapper": "",
  "mapping_date": null,
  "mapping_method": null,
  "network_area": null,
  "owner": null,
  "plan": null,
  "remarks": "",
  "renter": null,
  "safety_distance": 2060123445,
  "shade": null,
  "supplier": null,
  "surface": null,
  "surge_install_date": "2019-02-21T00:00:00Z",
  "surge_protector": 277877111,
  "survey_amount": "",
  "type": 21,
  "update_date": "2019-02-21T21:04:53.809332Z",
  "updated_by": "api@keypro.fi",
  "usage_state": 14621
}

object

address

integer

Apartment address id

capacity

integer

capacity

connection

integer

Electric Premises Connection id

contractor

integer

Electric Premises Contractor id

creation_date

string

Creation date and time

creator

string

Premises creator

deployment_date

string

deployment date

ground

integer

Electric Premises Ground id

group_fuse

Array of string

Group of fuses

string

guidance_address

integer

Unique Electric Premises guidance address id

guiding_type

integer

Electric Premises guiding type id

height_accuracy

integer

Height accuracy id

integer

Primary key

identification

string

Identification

installation_date

string

Installation date

installation_location

integer

Installation location

installation_year

integer

Installation year

location

string

Geographical location

location_accuracy

integer

Location accuracy id

main_fuse

integer

Electric Premises Main fuse type id

manufacturer

integer

Electric Premises Manufacturer id

mapper

string

mapper name

mapping_date

string

mapping date

mapping_method

integer

Mapping method id

network_area

integer

Network area id

owner

integer

Premises Owner id

plan

integer

Plan id

remarks

string

Remarks. Available from product version 3.2.14.

renter

integer

Premises Renter id

safety_distance

integer

Safety Distance id. Available from product version 3.6.4

shade

integer

Electric Premises Shade id

supplier

integer

Electric Premises Supplier id

surface

integer

Electric Premises Surface type id

surge_install_date

string

Surge protector installation date. Available from product version 3.2.22

surge_protector

integer

Electric Surge Protector id. Available from product version 3.2.22

survey_amount

integer

unknown

update_date

string

Last update date time

updated_by

string

Last updater of premises data

usage_state

integer

Usage state id

400

There was an error in request. Usually field validation failed.

{
  "type": [
    "This field is required."
  ],
  "usage_state": [
    "This field is required."
  ]
}

object

Fields which failed validation

401

Authentication credentials are missing or invalid

{
  "details": "Authentication credentials were not provided"
}

object

details

string

Detailed description of error

Was this article helpful?

What's Next

Delete electric premises