Insert Appraisal

POST /perizia

Insert the appraisal with data about the asset being appraised to obtain a requested output UUID for use in subsequent calls. This is the entry point of the appraisal into the system. In output, a unique uuid of the request will be returned based on the input (perizia_id and bene_id).

Using the UUID thus generated, it will be possible to call up the following services for the newly entered appraisal:

Example Request

curl -X POST 'https://sandbox-appraisal.realitycs.it/perizia' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <token>' \
  --data-raw '{
  "perizia_id": "xxxxxxxxx",
  "bene_id": "yyyyyyyyy", 
  "tipologia_id": 1,
  "categoria_catastale": "A3",
  "latitudine": 45.467,
  "longitudine": 9.190,
  "indirizzo": "Via Roma",
  "civico": "12",
  "comune": "Milano",
  "superficie": 120,
  "prezzo": 200000,
  "durata_mutuo": 15,
  "stato_id": 3,
  "anno_costruzione": 1990,
  "classe_energetica": 5,
  "epgl_nren": 174.87,
  "piano": 3,
  "bagni": 2,
  "locali": 5,
  "ascensore": false,
  "riscaldamento_id": 1,
  "comune_catastale": "F205",
  "sez_urbana": "",
  "sez_amministrativa": "",
  "foglio_catastale": "186",
  "particella_catastale": "384",
  "subalterno_catastale": "72",
  "rendita": 1500
}
'

Request Fields

ATTENTION: see the specific sections for mandatory inputs of each services

Field	Description	Type	Example
`perizia_id`	Unique appraisal identifier for the client	string	`xxxxxxxxx`
`bene_id`	Unique identifier for the asset subject to the client's appraisal	string	`yyyyyyyyy`
`tipologia_id`	Property type ID (see Taxonomies)	integer	`1`
`categoria_catastale`	Cadastral category type ID (see Taxonomies)	string	`A3`
`latitudine`	Geographical latitude of the property	number	`45.467`
`longitudine`	Geographical longitude of the property	number	`9.190`
`indirizzo`	Property address	string	`Via Roma`
`civico`	Street number of the property	string	`12`
`comune`	Municipality of the property	string	`Milano`
`superficie`	Total surface area in square meters	integer	`120`
`prezzo`	Property price	integer	`200000`
`durata_mutuo`	Remaining mortgage duration	integer	`15`
`stato_id`	State of the property (see Taxonomies)	integer	`3`
`anno_costruzione`	Year of construction of the property	integer	`1990`
`classe_energetica`	ID of the property's energy class (see Taxonomies)	integer	`5`
`epgl_nren`	Non-renewable energy performance index kwh/sqm year	number	`174.87`
`piano`	Floor of the property	integer	`3`
`bagni`	Total number of bathrooms	integer	`2`
`locali`	Total number of rooms	integer	`5`
`ascensore`	Indicates whether the property has an elevator	boolean	`False`
`riscaldamento_id`	Type of heating (see Taxonomies)	integer	`1`
`comune_catastale`	Cadastral municipality of registration	string	`F205`
`sez_urbana`	Urban section	string	`PEG`
`sez_amministrativa`	Administrative section	string	`A`
`foglio_catastale`	Cadastral sheet of the property	string	`186`
`particella_catastale`	Cadastral parcel of the property	string	`384`
`subalterno_catastale`	Cadastral sub-parcel of the property	string	`72`
`rendita`	cadastral income	number	`1500`

Example Response

{
  "richiesta_uid": "f80235fc-fa81-53a1-b05a-28fc0e3b4b7b"
}

Note: if present, the 'warnings' field in output is for debugging purposes only