Server

<back to all web services

UpdateObjekt

Requires Authentication
The following routes are available for this service:
PUT/Objekte
UpdateObjekt Parameters:
NameParameterData TypeRequiredDescription
ObjektbodyObjektNo
CustomerGuidbodystringNo
CustomerObjektbodyCustomerObjektNo
CustomerObjektebodyList<CustomerObjekt>No
AddressesbodyList<Address>No
NutzerbodyList<Nutzer>No
NutzerCoOwnershipbodyList<NutzerCoOwnership>No
NutzerPersonenbodyList<NutzerPersonen>No
NutzerQuadratmeterbodyList<NutzerQuadratmeter>No
OwnerNutzeinheitenbodyList<OwnerNutzeinheit>No
NutzeinheitenbodyList<Nutzeinheit>No
DirektkostenbodyList<Direktkosten>No
PrepaymentsbodyList<Prepayment>No
EnergieVerwerterbodyList<EnergieVerwerter>No
BrennstofflieferungenbodyList<Brennstofflieferung>No
NebenkostenbodyList<Nebenkosten>No
HeizbetriebskostenbodyList<Heizbetriebskosten>No
NutzeinheitDevicesbodyList<NutzeinheitDevice>No
DevicesbodyList<Device>No
DeviceConsumptionsbodyList<DeviceConsumption>No
BillingInformationsbodyList<BillingInformation>No
DeleteUVIbodyboolNo
Objekt Parameters:
NameParameterData TypeRequiredDescription
GuidformstringNo
NumberformstringNo
IsCompletedformstringNo
UviformstringNo
IsUviDisabledformstringNo
CompletedDateformDateTime?No
AddressGuidformstringNo
AnmerkungKundenportalformstringNo
KundenportalMarkedDoneformboolNo
MarkedDoneAtformDateTime?No
CustomerObjekt Parameters:
NameParameterData TypeRequiredDescription
GuidformstringNo
RangeFromformDateTimeNo
RangeToformDateTime?No
IsCustomerformboolNo
IsOwnerformboolNo
IsOwnerPseudoformboolNo
ObjektGuidformstringNo
CustomerGuidformstringNo
Address Parameters:
NameParameterData TypeRequiredDescription
GuidformstringNo
StreetformstringNo
Street2formstringNo
StreetNumberformstringNo
ZipcodeformstringNo
CityformstringNo
MailboxformstringNo
AdditionalformstringNo
Nutzer Parameters:
NameParameterData TypeRequiredDescription
GuidformGuidNo
Name1formstringNo
Name2formstringNo
Name3formstringNo
Name4formstringNo
NutzerTypeformNutzerType?Yes

Allowable Values

  • Leerstand
  • Gewerblich
  • Privat
  • AllgemeineNutzung
NutzeinheitNumberExternalformstringNo
NutzerInNutzeinheitSequenceformuintYes
RangeFromformDateTimeYes
RangeToformDateTime?No
IsDeletedformboolNo
IsCreatedByAppformboolNo
IsUviRecievedformstringNo
IsNutzerOwnerformstringNo
EmailformstringNo
MobilePhoneformstringNo
TitleformstringNo
SalutationbodystringYes
NutzerType Enum:
Leerstand
Gewerblich
Privat
AllgemeineNutzung
NutzerCoOwnership Parameters:
NameParameterData TypeRequiredDescription
GuidformstringNo
ShareValueformdecimal?No
RangeFromformDateTimeNo
RangeToformDateTime?No
NutzerGuidformstringNo
IsCreatedByAppformboolNo
IsDeletedformboolNo
NutzerPersonen Parameters:
NameParameterData TypeRequiredDescription
GuidformstringNo
NumberOfPeopleformint?No
RangeFromformDateTimeNo
RangeToformDateTime?No
NutzerGuidformstringNo
IsCreatedByAppformboolNo
IsDeletedformboolNo
NutzerQuadratmeter Parameters:
NameParameterData TypeRequiredDescription
GuidformstringNo
SquareMeters_Hzgformdecimal?No
SquareMeters_Wwformdecimal?No
SquareMeters_Nkformdecimal?No
RangeFromformDateTimeNo
RangeToformDateTime?No
NutzerGuidformstringNo
IsCreatedByAppformboolNo
IsDeletedformboolNo
OwnerNutzeinheit Parameters:
NameParameterData TypeRequiredDescription
GuidformstringNo
Name1formstringNo
Name2formstringNo
Name3formstringNo
Name4formstringNo
RangeFromformDateTimeNo
RangeToformDateTime?No
TitleformstringNo
SalutationformstringNo
AddressGuidformstringNo
NutzeinheitGuidformstringNo
Nutzeinheit Parameters:
NameParameterData TypeRequiredDescription
GuidformstringNo
NumberformstringNo
LocationformstringNo
ObjektGuidformstringNo
AddressGuidformstringNo
Direktkosten Parameters:
NameParameterData TypeRequiredDescription
GuidformGuidNo
LabelformstringNo
DateformDateTimeNo
BruttoformdecimalNo
SalesTaxformdecimalNo
QuantityformdecimalNo
TypeformstringNo

Allowable Values

  • Heizkosten
  • Nebenkosten
IsDeletedformboolNo
IsCreatedByAppformboolNo
NutzerGuidformGuidNo
BillingInformationformBillingInformationNo
BillingInformation Parameters:
NameParameterData TypeRequiredDescription
GuidformstringNo
FromformDateTimeNo
ToformDateTimeNo
IsCompletedformboolNo
HasNebenkostenformboolNo
Prepayment Parameters:
NameParameterData TypeRequiredDescription
GuidformstringNo
FromformDateTimeNo
ToformDateTimeNo
Amount_Nkformdecimal?No
Amount_HKformdecimal?No
Amount_Wwformdecimal?No
IsDeletedformboolNo
IsCreatedByAppformboolNo
ObjektGuidformstringNo
NutzerGuidformstringNo
BillingInformationGuidformstringNo
EnergieVerwerter Parameters:
NameParameterData TypeRequiredDescription
GuidformstringNo
LabelformstringNo
EfficiencyFactorformdecimal?No
AssemblyDateformDateTimeNo
DisassemblyDateformDateTime?No
BuildYearformuint?No
Temperatureformuint?No
CommercialSupplyformboolNo
BrennwertformboolNo
ObjektGuidformstringNo
BrennstoffMediumGuidformstringNo
Brennstofflieferung Parameters:
NameParameterData TypeRequiredDescription
GuidformGuidNo
DeliveryDateformDateTimeNo
SalexTaxformdecimal?No
EmisionsTaxformdecimal?No
C02Taxesformdecimal?No
CustomsTaxformdecimal?No
OtherChargesformdecimal?No
C02Priceformdecimal?No
C02Tonsformdecimal?No
Quantityformdecimal?No
Amountformdecimal?No
StartMeterReadingValueformdecimal?No
EndMeterReadingValueformdecimal?No
HeizwertformdecimalNo
BrennwertformboolNo
EnergyReliefAmountDescriptionformstringNo
EnergyReliefAmountformdecimal?No
ElectricityReliefAmountDescriptionformstringNo
ElectricityReliefAmountformdecimal?No
CO2EmissionsFactorformdecimal?No
CO2TextformstringNo
CO2Activeformbool?No
CO2PriceKndformbool?No
CO2PriceLandlordformdecimal?No
CO2PriceRenterformdecimal?No
CO2Areaformdecimal?No
IsForCommercialUseformbool?No
IsRenovationRequiredformbool?No
IsHeatingPadsImprovedformbool?No
CO2KWhformdecimal?No
IncludedCO2SalesTaxformdecimal?No
CO2Costsformdecimal?No
TotalC02Weightformdecimal?No
NoTotalDeductionC02Costsformbool?No
IsDeletedformboolNo
IsCreatedByAppformboolNo
BrennstoffMediumGuidformGuidNo
BillingInformationformBillingInformationNo
Nebenkosten Parameters:
NameParameterData TypeRequiredDescription
GuidformGuidNo
NumberformuintNo
FromformDateTimeNo
ToformDateTimeNo
TargetAllocationformNebenkostenTargetAllocation?No

Allowable Values

  • Null
  • AlleNutzer
  • ZugeordneteNutzer
  • ZugeordneteNutzeinheiten
  • ZugeordneteNutzerDiff
  • ZugeordneteNutzeinheitenDiff
TargetAllocationInformNebenkostenTargetAllocationIn?No

Allowable Values

  • Nebenkosten
  • Heizkosten
  • Warmwasserkosten
NebenkostenKindformstringNo

Allowable Values

  • Nebenkosten
  • Heizkosten
  • Warmwasserkosten
KostenartformstringNoFreitext
Bruttoformdecimal?No
BruttoLastYearformdecimal?No
SalesTaxformdecimal?No
HaushaltsnahediensteLabelformstringNo
HaushaltsnahediensteBruttoformdecimal?No
KostenartUnitformstringNoFreitext
ReduzierungsartTypeformstringNo

Allowable Values

  • KeineReduzierung
  • NachTagen
  • NachGradtagen
CommentformstringNo
IsDeletedformboolNo
IsCreatedByAppformboolNo
NebenkostenNutzeinheitenformList<NebenkostenNutzeinheit>No
NebenkostenNutzerformList<NebenkostenNutzer>No
BillingInformationformBillingInformationNo
NebenkostenTargetAllocation Enum:
Null
AlleNutzer
ZugeordneteNutzer
ZugeordneteNutzeinheiten
ZugeordneteNutzerDiff
ZugeordneteNutzeinheitenDiff
NebenkostenTargetAllocationIn Enum:
Nebenkosten
Heizkosten
Warmwasserkosten
NebenkostenNutzeinheit Parameters:
NameParameterData TypeRequiredDescription
RelativeAmountformdecimal?No
IsDeletedformboolNo
IsCreatedByAppformboolNo
NutzeinheitGuidformGuidNo
NebenkostenNutzer Parameters:
NameParameterData TypeRequiredDescription
RelativeAmountformdecimal?No
IsDeletedformboolNo
IsCreatedByAppformboolNo
NutzerGuidformGuidNo
Heizbetriebskosten Parameters:
NameParameterData TypeRequiredDescription
GuidformGuidNo
FromformDateTimeNo
ToformDateTimeNo
SalesTaxformdecimalNo
HaushatlsnahediensteBruttoformdecimal?No
Bruttoformdecimal?No
HaushatlsnahediensteLabelformstringNo
DescriptionformstringNo
IsDeletedformboolNo
IsCreatedByAppformboolNo
NutzeinheitDevice Parameters:
NameParameterData TypeRequiredDescription
GuidformstringNo
AssignedFromDateformDateTimeNo
AssignedToDateformDateTime?No
RoomformstringNo
OngoingNumberformstringNo
IsRentedformboolNo
IsMaintainedformboolNo
DeviceGuidformstringNo
NutzeinheitGuidformstringNo
Device Parameters:
NameParameterData TypeRequiredDescription
GuidformstringNo
NumberformstringNo
LabelformstringNo
DescriptionformstringNo
InstallationDateformDateTimeNo
DeinstallationDateformDateTime?No
CalibrationDateformDateTime?No
UnitformstringNo
NoteformstringNo
DeviceCatalogGuidformstringNo
DeviceConsumption Parameters:
NameParameterData TypeRequiredDescription
GuidformGuidNo
DeviceReadingformdouble?No
DeviceReadingDateformDateTime?No
DeviceReadingKindformDeviceReadingKindNo

Allowable Values

  • ZA
  • HA
  • MO
  • EB
  • AB
ChangeDateformDateTime?No
NoteformstringNo
AmpouleColourformstringNo
DeviceGuidformstringNo
DeviceReadingKind Enum:
ZA
HA
MO
EB
AB
BillingInformation Parameters:
NameParameterData TypeRequiredDescription
GuidformstringNo
FromformDateTimeNo
ToformDateTimeNo
IsCompletedformboolNo
HasNebenkostenformboolNo
ObjektGuidformstringNo
AnmerkungKundenportalformstringNo
KundenportalMarkedDoneformboolNo
MarkedDoneAtformDateTime?No
KundenportalMarkedClosedformboolNo
MarkedClosedAtformDateTime?No
UpdateObjektResponse Parameters:
NameParameterData TypeRequiredDescription
ResponseStatusformResponseStatusNo
WarningsformList<string>No

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

PUT /Objekte HTTP/1.1 
Host: immo-account-servdesk.eras-online.de 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	Objekte: 
	{
		Guid: String,
		Objektnummer: String,
		IstAbgeschlossen: String,
		Uvi: String,
		IsUviDisabled: String,
		AbgeschlossenDatum: 0001-01-01T00:00:00Z,
		AdressGuid: String,
		AnmerkungKundenportal: String,
		KundenportalMarkedDone: False,
		MarkedDoneAt: 0001-01-01T00:00:00Z
	},
	CustomerGuid: String,
	KundenObjekt: 
	{
		Guid: String,
		ZeitraumVon: 0001-01-01T00:00:00Z,
		ZeitraumBis: 0001-01-01T00:00:00Z,
		IstKunde: False,
		IstEigentümer: False,
		IstEigentümerPseudo: False,
		ObjektGuid: String,
		KundeGuid: String
	},
	KundenObjekte: 
	[
		{
			Guid: String,
			ZeitraumVon: 0001-01-01T00:00:00Z,
			ZeitraumBis: 0001-01-01T00:00:00Z,
			IstKunde: False,
			IstEigentümer: False,
			IstEigentümerPseudo: False,
			ObjektGuid: String,
			KundeGuid: String
		}
	],
	Adressen: 
	[
		{
			Guid: String,
			Straße: String,
			Straße2: String,
			Hausnummer: String,
			Postleitzahl: String,
			Ort: String,
			Postfach: String,
			Adresszusatz: String
		}
	],
	Nutzer: 
	[
		{
			Guid: String,
			Name1: String,
			Name2: String,
			Name3: String,
			Name4: String,
			NutzerType: String,
			NutzeinheitNummerExtern: String,
			NutzerInNutzeinheitReihenfolge: 0,
			ZeitraumVon: 0001-01-01T00:00:00Z,
			ZeitraumBis: 0001-01-01T00:00:00Z,
			IstGeloescht: False,
			IstErzeugtVonApp: False,
			Uvi: String,
			EigentuemerBewohnt: String,
			Email: String,
			Mobil: String,
			Titel: String,
			Anrede: String,
			NutzeinheitGuid: String
		}
	],
	NutzerCoOwnership: 
	[
		{
			Guid: String,
			ShareValue: 0,
			Von: 0001-01-01T00:00:00Z,
			Bis: 0001-01-01T00:00:00Z,
			NutzerGuid: String,
			IsCreatedByApp: False,
			IsDeleted: False
		}
	],
	NutzerPersonen: 
	[
		{
			Guid: String,
			Personen: 0,
			Von: 0001-01-01T00:00:00Z,
			Bis: 0001-01-01T00:00:00Z,
			NutzerGuid: String,
			IsCreatedByApp: False,
			IsDeleted: False
		}
	],
	NutzerQuadratmeter: 
	[
		{
			Guid: String,
			Quadratmeter_Hzg: 0,
			Quadratmeter_Ww: 0,
			Quadratmeter_Nk: 0,
			Von: 0001-01-01T00:00:00Z,
			Bis: 0001-01-01T00:00:00Z,
			NutzerGuid: String,
			IsCreatedByApp: False,
			IsDeleted: False
		}
	],
	EigentuemerNutzeinheit: 
	[
		{
			Guid: String,
			Name1: String,
			Name2: String,
			Name3: String,
			Name4: String,
			ZeitraumVon: 0001-01-01T00:00:00Z,
			ZeitraumBis: 0001-01-01T00:00:00Z,
			Titel: String,
			Anrede: String,
			AdressGuid: String,
			NutzeinheitGuid: String
		}
	],
	Nutzeinheiten: 
	[
		{
			Guid: String,
			Nummer: String,
			Lage: String,
			ObjektGuid: String,
			AdressGuid: String
		}
	],
	Direktkosten: 
	[
		{
			Guid: String,
			Bezeichnung: String,
			Datum: 0001-01-01T00:00:00Z,
			Brutto: 0,
			Mwst: 0,
			Menge: 0,
			Typ: String,
			IstGeloescht: False,
			IstErzeugtVonApp: False,
			ObjektGuid: String,
			NutzerGuid: String,
			BillingInformationGuid: String
		}
	],
	Prepayments: 
	[
		{
			Guid: String,
			Von: 0001-01-01T00:00:00Z,
			Bis: 0001-01-01T00:00:00Z,
			VZ Nebenkosten: 0,
			VZ Heizkosten: 0,
			VZ Warmwasser: 0,
			IstGeloescht: False,
			IstErzeugtVonApp: False,
			ObjektGuid: String,
			NutzerGuid: String,
			BillingInformationGuid: String
		}
	],
	EnergieVerwerter: 
	[
		{
			Guid: String,
			Bezeichnung: String,
			Wirkungsgrad: 0,
			Einbau: 0001-01-01T00:00:00Z,
			Ausbau: 0001-01-01T00:00:00Z,
			Baujahr: 0,
			Temperatur: 0,
			EigenstGewerbLieferung: False,
			Brennwert: False,
			ObjektGuid: String,
			BrennstoffMediumGuid: String
		}
	],
	Brennstofflieferungen: 
	[
		{
			Guid: String,
			Lieferdatum: 0001-01-01T00:00:00Z,
			Mwst: 0,
			Emissionsangabe: 0,
			Steuern: 0,
			Zolle: 0,
			SonstigeAngaben: 0,
			C02Preis: 0,
			C02Tonnen: 0,
			Menge: 0,
			Betrag: 0,
			Anfangsstand: 0,
			Endstand: 0,
			Heizwert: 0,
			Brennwert: False,
			IstGeloescht: False,
			IstErzeugtVonApp: False,
			EnergieEntlastungsbetragBezeichnung: String,
			EnergieEntlastungsbetrag: 0,
			StromEntlastungsbetragBezeichnung: String,
			StromEntlastungsbetrag: 0,
			CO2Emissionsfaktor: 0,
			CO2Text: String,
			CO2Aktiv: False,
			CO2PreisKnd: False,
			CO2PreisVermieter: 0,
			CO2PreisMieter: 0,
			CO2Flaeche: 0,
			GewerblicheNutzung: False,
			Sanierungsauflagen: False,
			AuflagenHeizungsverbesserung: False,
			CO2KWH: 0,
			EnthalteneMwst: 0,
			CO2KostenBrutto: 0,
			CO2GesamtKg: 0,
			KeinGesamtabzugC02Kosten: False,
			EnergieVerwerterGuid: String,
			BrennstoffMediumGuid: String,
			BillingInformationGuid: String
		}
	],
	Nebenkosten: 
	[
		{
			Guid: String,
			Kostennummer: 0,
			Von: 0001-01-01T00:00:00Z,
			Bis: 0001-01-01T00:00:00Z,
			UmlageZiel: String,
			UmlageZielIn: String,
			NebenkostenArt: String,
			Kostenart: String,
			Brutto: 0,
			BruttoLetztesJahr: 0,
			Mwst: 0,
			HaushaltsnahediensteLabel: String,
			HaushaltsnahediensteBrutto: 0,
			EinheitDerKostenart: String,
			Reduzierungsart: String,
			Kommentar: String,
			IstGeloescht: False,
			IstErzeugtVonApp: False,
			ObjektGuid: String,
			BillingInformationGuid: String,
			NebenkostenNutzeinheiten: 
			[
				{
					Anteil: 0,
					IstGeloescht: False,
					IstErzeugtVonApp: False,
					NutzeinheitGuid: String
				}
			],
			NebenkostenNutzer: 
			[
				{
					Anteil: 0,
					IstGeloescht: False,
					IstErzeugtVonApp: False,
					NutzerGuid: String
				}
			]
		}
	],
	Heizbetriebskosten: 
	[
		{
			Guid: String,
			Von: 0001-01-01T00:00:00Z,
			Bis: 0001-01-01T00:00:00Z,
			Mwst: 0,
			HaushatlsnahediensteBrutto: 0,
			Brutto: 0,
			HaushatlsnahediensteLabel: String,
			Anmerkung: String,
			IstGeloescht: False,
			IstErzeugtVonApp: False,
			ObjektGuid: String,
			BillingInformationGuid: String
		}
	],
	NutzeinheitGeraete: 
	[
		{
			Guid: String,
			ZuordnungVon: 0001-01-01T00:00:00Z,
			ZuordnungBis: 0001-01-01T00:00:00Z,
			Raum: String,
			LaufendeNummer: String,
			gemietet: False,
			gewartet: False,
			DeviceGuid: String,
			NutzeinheitGuid: String
		}
	],
	Geraete: 
	[
		{
			Guid: String,
			Geraetenummer: String,
			Bezeichnung: String,
			Beschreibung: String,
			Einbaudatum: 0001-01-01T00:00:00Z,
			Ausbaudatum: 0001-01-01T00:00:00Z,
			Eichdatum: 0001-01-01T00:00:00Z,
			Einheit: String,
			Memo: String,
			DeviceCatalogGuid: String
		}
	],
	Geraeteverbraeuche: 
	[
		{
			Guid: String,
			Ablesung: 0,
			Ablesedatum: 0001-01-01T00:00:00Z,
			Ableseart: String,
			Aenderungsdatum: 0001-01-01T00:00:00Z,
			Anmerkung: String,
			Ampullenfarbe: String,
			DeviceGuid: String
		}
	],
	BillingInformations: 
	[
		{
			Guid: String,
			Von: 0001-01-01T00:00:00Z,
			Bis: 0001-01-01T00:00:00Z,
			IstAbgeschlossen: False,
			HatNebenkosten: False,
			ObjektGuid: String,
			AnmerkungKundenportal: String,
			KundenportalMarkedDone: False,
			MarkedDoneAt: 0001-01-01T00:00:00Z,
			KundenportalMarkedClosed: False,
			MarkedClosedAt: 0001-01-01T00:00:00Z
		}
	],
	DeleteUvi: False
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	responseStatus: 
	{
		errorCode: String,
		message: String,
		stackTrace: String,
		errors: 
		[
			{
				errorCode: String,
				fieldName: String,
				message: String,
				meta: 
				{
					String: String
				}
			}
		],
		meta: 
		{
			String: String
		}
	},
	warnings: 
	[
		String
	]
}