Objekttyp-Mapping

JSON-Attribut

Datentp

Pflicht

Hinweise

Entität

Feldname

Interner Feldname

pk

String(50)

Nein

Bei leerem pk wird eine neue Aktivität erzeugt

Wenn der pk gefüllt ist, erfolgt keine Aktualisierung in TINA. In diesem Fall werden die Aktivitäten von TINA an das Portal übertragen

Aktivitäten

Primärschlüssel

Pk.Activity

subject

String(255)

Nein

Aktivitäten

Betreff

Subject.Activity

startDate

Date

Nein

Aktivitäten

Beginn

StartDate.Activity

text

CLOB

Nein

Plaintext ohne HTML-Formatierung

Aktivitäten

Beschreibung

Text.Activity

JSON-Attribut

Datentp

Pflicht

Anmerkungen

Entität

Feldname

Interner Feldname

Anmerkungen

street

String(250)

Ja

Adressen

Straße

Street.Address

Postadresse des Geschäftspartners

houseNo

String(10)

Ja

Adressen

Haus-Nr.

StreetNumber.Address

houseNoAffix

String(10)

Nein

Adressen

Haus-Nr. Zusatz

StreetNumberAddition.Address

postalCode

String(5)

Ja

Adressen

PLZ

ZIPKey.Address

city

String(250)

Ja

Adressen

Ort

City.Address

country

String(2)

Nein

Ländercode nach ISO 3166-1

Adressen

Land

CountryKey.Address

coName1

String(250)

Nein

Adressen

Abw. Langname

CoName1.Address

JSON-Attribut

Datentp

Pflicht

Entität

Feldname

Interner Feldname

Anmerkungen

bankName

String(100)

Banken

Bankname

BankName.BankHouse

Wird aktuell lediglich im JSON übertragen, keine Übernahme nach TINA

BLZ

String(10)

Banken

Bankleitzahl

BLZ.BankHouse

Wird aktuell lediglich im JSON übertragen, keine Übernahme nach TINA

bic

String(11)

Banken

BIC

BIC.BankHouse

Wird aktuell lediglich im JSON übertragen, keine Übernahme nach TINA

JSON-Attribut

Datentp

Pflicht

Entität

Feldname

Interner Feldname

Anmerkungen

iban

String(34)

Konten

IBAN

IBAN.BankAccount

Wird aktuell lediglich im JSON übertragen, keine Übernahme nach TINA

bicKey

@bank

Konten

BIC

BICKey.BankAccount

Wird aktuell lediglich im JSON übertragen, keine Übernahme nach TINA

accOwner

String(100)

Konten

Kontoinhaber

AccOwner.BankAccount

Wird aktuell lediglich im JSON übertragen, keine Übernahme nach TINA

JSON-Attribut

Datentp

Pflicht

Anmerkungen

Entität

Feldname

Interner Feldname

fromDate

Date

Ja

Abschlagsplan

Beginn

StartDate.C12BILLPLAN

toDate

Date

Ja

Abschlagsplan

Ende

EndDate.C12BILLPLAN

budgetBillings

List<@budgetBillings>

Ja

Die Liste darf leer sein

Abschlag

JSON-Attribut

Datentp

Pflicht

Anmerkungen

Entität

Feldname

Interner Feldname

amount

Double(10,2)

Ja

Betrag

Abschlag

Betrag

Amount.C12ADVPAY

maturityDate

Date

Ja

• Fälligkeitsdatum

• ISO-Format

• 0 Uhr wenn keine Uhrzeit angegeben ist

Abschlag

Gültig ab

ValidFrom.C12ADVPAY

JSON-Attribut

Datentyp/Objekttyp

Pflicht

Anmerkungen

Entität

Feldname

Feld.Tabelle (intern)

Anmerkungen

pk

String

Nein

Wenn gefüllt, wird der Datensatz gesucht und mit den gelieferten Werten aktualisiert

Leistungsänderung

Pk

Pk.CapacityChange

meterNo

String

Ja

Zählernummer

Leistungsänderung

Zählernummer

MeterNo.CapacityChange

totalPower

Double

Ja

Ausgebaute Gesamtleistung

Leistungsänderung

Ausgebaute Gesamtleistung

TotalPowRemoved.CapacityChange

loadManagementProducer

String

Nein

Hersteller Lastmanagement

Leistungsänderung

Hersteller Lastmanagement

ManLoadMgmt.CapacityChange

loadManagementType

String

Nein

Typ Lastmanagement

Leistungsänderung

Typ Lastmanagement

LoadMgmtType.CapacityChange

transformerMetering

Boolean

Nein

Wandlermessung

Leistungsänderung

Wandlermessung

IsTransMeter.CapacityChange

newMeterEnclosure

Boolean

Nein

Neuer Zählerschrank

Leistungsänderung

Neuer Zählerschrank

NewMtrEnclosure.CapacityChange

setSealing

Boolean

Nein

Plombierung

Leistungsänderung

Plombierung

Sealing.CapacityChange

wMSB

Boolean

Nein

Wettbewerblicher Messstellenbetreiber

Wenn true, muss wMSBProfile übergeben werden

Leistungsänderung

Wettbewerblicher MSB

IsWMSB.CapacityChange

wMSBProfile

@serviceProvider

Ja*

Pflicht, wenn wMSB == true ist, sonst nicht

Leistungsänderung

Messstellenbetreiber

WMSBPk.CapacityChange

Wurde im Portal ein aus TINA gelieferter Serviceprovider aus der Liste ausgewählt, wird dieser in das Feld übernommen.

removedDevices

List<@device>

Ja

Liste von ausgebauten Geräten

Gerät

-

-

Die Geräte werden als Geräte-Datensätze angelegt und mit dem Leistungsänderung-Datensatz verknüpft

Aktuell in Umstellung von Gerät auf Energieverbraucher

constructionType

Schlüssel

Nein

Bauform des neuen Zählers, mögliche Werte

• 3-Punkt

• eHz

Leistungsänderung

Bauform des neuen Zählers

ConstructionType.CapacityChange

currentPressure

Double

Nein

Leistungsänderung

Aktueller Druck

CurrentPressure.CapacityChange

newPressure

Double

Nein

Leistungsänderung

Neuer Druck

NewPressure.CapacityChange

maxUsablePower

Double

Nein

Leistungsänderung

Maximale Nennbelastung

MaxNominalLoad.CapacityChange

maxPower

Double

Nein

Leistungsänderung

Maximale Nennleistung

MaxNominalPower.CapacityChange

consumptionPerYear

Double

Nein

Leistungsänderung

Jahresverbrauch

AnnualCons.CapacityChange

methodOfFlowRateDimensioning

Schlüssel

Nein

Mögliche Werte:

• DIN1988-300

• DIN-EN806-3

• W406

Leistungsänderung

Art der Leistungsbemessung Wasser

FlowRateDimKey.CapacityChange

totalConsumption

Double

Nein

Leistungsänderung

Verbrauchssumme/Durchflussmenge

TtlConsFlowRate.CapacityChange

JSON-Attribut

Datentyp

Pflicht

Anmerkungen

Entität

Feldname

Feld.Tabelle (intern)

Anmerkungen

pk

String

Nein

Wenn gefüllt, wird der Datensatz gesucht und mit den gelieferten Werten aktualisiert

Bauanschluss

Pk

Pk.ConstructionSupply

meterNo

String

Ja*

Enthält entweder den ausgewählten Zähler oder die Zählernummer, falls der Zähler nicht in der Liste war

Pflicht, wenn meterAvailable == true

Bauanschluss

Zählernummer

MeterNo.ConstructSupply

Es wird keine komplette Messeinrichtung übergeben, sondern die Zählernummer

disconnectMeterEnclosure

Boolean

Nein

Rückbau Zählerschrank

Bauanschluss

Rückbau Zählerschrank

DiscMeterEncl.ConstructSupply

productType

Schlüssel

Ja

Sparte

• Strom

• Wasser

Bauanschluss

Sparte

ProductTypeKey.ConstructSupply

type

Schlüssel

Ja

Schlüssel:

• Anmeldung

• Abmeldung

Bauanschluss

Meldungsgrund

ConstructSupplyType.ConstructSupply

occasion

Schlüssel

Ja

Anlass

Schlüssel:

• Neubau

• Umbau/Sanierung

• Veranstaltung/Fest

• Straßenbau

Bauanschluss

Anlass

Occasion.ConstructSupply

connectionPoint

Schlüssel

Ja

Anschlusspunkt

Schlüssel:

• Ortsnetz

• Hausanschlusskasten

• Vorgezogener Netzanschluss

Bauanschluss

Anschlusspunkt

ConnectionPoint.ConstructSupply

preConnectionAvailable

Boolean

Nein

Vorgezogener Netzanschluss vorhanden

Bauanschluss

Vorgezogener Netzanschluss vorhanden

PreConAvaliable.ConstructSupply

totalPower

Double

Ja

Benötigte Leistung

Bauanschluss

Benötigte Leistung

TotalPower.ConstructSupply

meterAvailable

Boolean

Nein

Zähler bereits eingebaut

Wenn true muss meterNo und currentMSB angegeben werden

Bauanschluss

Zähler bereits eingebaut

MeterAvailable.ConstructSupply

currentMSB

@serviceProvider

Ja*

Pflicht, wenn meterAvailable = true ist

Bauanschluss

Messstellenbetreiber

MeterOperator.ConstructSupply

• Wurde im Portal ein aus TINA gelieferter Serviceprovider aus der Liste ausgewählt, wird dieser in das Feld übernommen

transformerMetering

Boolean

Nein

Wandlermessung erforderlich (= true) oder nicht (= false)

Bauanschluss

Wandlermessung

TransfMetering.ConstructSupply

Die Wandlermessung an sich ist Pflicht, wenn die Leistung (totalPower) > 30, es muss zudem angegeben werden, ob kundeneigene Wandler verwendet werden oder nicht

customersTransformerMeter

Boolean

Nein

Angabe, ob kundeneigener Wandler verwendet wird (= true) oder nicht (= false)

Bauanschluss

Kundeneigener Wandler

CustTransfMeter.ConstructSupply

existsMeterShaft

Boolean

Nein

Angabe, ob ein Zählerschacht vorhanden ist

Wenn true, muss der meterShaftType ausgewählt und übergeben werden

Bauanschluss

Zählerschacht vorhanden

ExistsMeterShaft.ConstructSupply

meterShaftType

Schlüssel

Ja*

Pflicht, wenn existsMeterShaft == true, sonst nicht

Mögliche Werte:

• BEGEHBAR

• AUSZIEHSCHACHT

Bauanschluss

Schachtart

MeterShaftType.ConstructSupply

notes

String

Nein

Möglichkeiten weitere Informationen mitzugeben

Bauanschluss

Notizen

Note.ConstructionSupply

JSON-Attribut

Datentp

Pflicht

Anmerkungen

Entität

Feldname

Interner Feldname

pk

String(50)

Ja

Ansprechpartner

Primärschlüssel

PK.ContactPerson

customerType

String(250)

Ja

Ansprechpartner

Typ

Sex.ContactPerson

name1

String(128)

Ja

Ansprechpartner

Nachname/Firma

LastName.ContactPerson

name2

String(70)

Nein

Ansprechpartner

Vorname/Zusatz1

FirstName.ContactPerson

salutation

String(250)

Nein

Ansprechpartner

Anrede

Salutation.ContactPerson

title

String(40)

Nein

Ansprechpartner

Namenstitel

AcademicTitle.ContactPerson

letterSalutation

String(250)

Nein

Ansprechpartner

Briefanrede

LetterSalutation.ContactPerson

birthday

Date

Nein

Ansprechpartner

Geb. Datum

DateOfBirth.ContactPerson

phoneNoCountry

String(10)

Nein

Sind alle phoneNo-Werte gefüllt, wird die Nummer in die jeweiligen Felder aufgeteilt übernommen

Wird die gesamte Nummer nicht aufgeteilt in einem Feld geliefert, muss diese in phoneNoBase übergeben werden

Standard-Kommunikation zu Ansprechpartner

FN-Ländervorwahl

PhoneNoCountry.Telecom

phoneNoCity

String(10)

Nein

Standard-Kommunikation zu Ansprechpartner

FN-Ortsvorwahl

PhoneNoCity.Telecom

phoneNoBase

String(50)

Nein

Standard-Kommunikation zu Ansprechpartner

FN-Rufnummer

PhoneNoBase.Telecom

phoneNoExt

String(10)

Nein

Standard-Kommunikation zu Ansprechpartner

FN-Durchwahl

PhoneNoExtension.Telecom

mobileNoCountry

String(10)

Nein

Sind alle mobileNo-Werte gefüllt, wird die Nummer in die jeweiligen Felder aufgeteilt übernommen

Wird die gesamte Nummer nicht aufgeteilt in einem Feld geliefert, muss diese in mobileNoBase übergeben werden

Standard-Kommunikation zu Ansprechpartner

Mobil-Ländervorwahl

MobilePhoneCountry.Telecom

mobileNoCity

String(10)

Nein

Standard-Kommunikation zu Ansprechpartner

Mobil-Ortsvorwahl

MobilePhoneCity.Telecom

mobileNoBase

String(50)

Nein

Standard-Kommunikation zu Ansprechpartner

Mobil-Rufnummer

MobilePhoneBase.Telecom

mobileNoExt

String(10)

Nein

Standard-Kommunikation zu Ansprechpartner

Mobil-Durchwahl

MobilePhoneExtension.Telecom

faxNoCountry

String(10)

Nein

Sind alle faxNo-Werte gefüllt, wird die Nummer in die jeweiligen Felder aufgeteilt übernommen

Wird die gesamte Nummer nicht aufgeteilt in einem Feld geliefert, muss diese in faxNoBase übergeben werden

Standard-Kommunikation zu Ansprechpartner

Fax-Ländervorwahl

FaxNoCountry.Telecom

faxNoCity

String(10)

Nein

Standard-Kommunikation zu Ansprechpartner

Fax-Ortsvorwahl

FaxNoCity.Telecom

faxNoBase

String(50)

Nein

Standard-Kommunikation zu Ansprechpartner

Fax-Rufnummer

FaxNoBase.Telecom

faxNoExt

String(10)

Nein

Standard-Kommunikation zu Ansprechpartner

Fax-Durchwahl

FaxNoExtension.Telecom

email

String(255)

Nein

Standard-Kommunikation zu Ansprechpartner

E-Mail-Adresse

Email.Telecom

optIns

List<@optIn>

Nein

Consent/OptIn

JSON-Attribut

Datentp

Pflicht

Entität

Feldname

Interner Feldname

Anmerkungen

contractNo

String(255)

Ja

Abrechnungsverträge

Vertrags-Nr.

Vertrag.BillingContract

mediaType

String(255)

Ja

Anlagenkonten

Sparte

Medium.BillingContract

contractStartDate

Date

Nein*

Abrechnungsverträge

Vertragsbeginn

ISU_VBeginn.BillingContract

contractEndDate

Date

Nein

Abrechnungsverträge

Vertragsende

ISU_VEnde.BillingContract

moveInDate

Date

Ja

Abrechnungsverträge

Einzugsdatum

FromDate.BillingContract

moveOutDate

Date

Nein

Abrechnungsverträge

Auszugsdatum

UntilDate.BillingContract

reverseCharge

Boolean

Nein

-

-

-

Dient der Abbildung des Steuerstatus und muss im jeweiligen Kundenprojekt definiert und umgesetzt werden

Im Standard wird hier das Kontenfindungsmerkmal (ISU_KoFizSD.ContractAccount) herangezogen. Die PKs der Schlüssel, die das Reverse Charge Verfahren kennzeichnen, sind in der Skriptbibliotheksmethode SC12ITCUtils.getReverseChargePkList() zu hinterlegen. Für dort hinterlegte Schlüssel wird reverseCharge == true übermittelt, für alle anderen false

brutto

Boolean

Nein

-

-

-

Dient der Abbildung des Steuerstatus und muss im jeweiligen Kundenprojekt definiert und umgesetzt werden

Im Standard wird hier das Kontenfindungsmerkmal (ISU_KoFizSD.ContractAccount) herangezogen. Die PKs der Schlüssel, die als Umsatzsteuerbefreit gelten, sind in der Skriptbibliotheksmethode SC12ITCUtils.getBruttoPkList() zu hinterlegen. Für dort hinterlegte Schlüssel wird brutto == true übermittelt, für alle anderen false

countingType

String

Nein

Anlagen-Zeitdaten

Ableseeinheit

ISU_AblEinh.TimeSlicingIs

installation

@installation

Ja

Anlagenkonten

Anlage

InstallationPk.C12INSTACC

budgetBillingPlan

List<@budgetBillingPlan>

Nein

Abschlagspläne

Aktueller Abschlagsplan via Abrechnungsvertrag.

Sind keine Abschläge zum Abschlagsplan vorhanden, wird eine leere Liste zurückgeliefert.

2025.5 Ist kein Abschlagsplan vorhanden, wird das Attribut in der Response weggelassen

meterReadingType

String(250) 

Nein 

Vertragskonten

Ableseart

C12ReadingType.ContractAccount

invType

String(255)

Nein

Vertragskonten

Rechnungsversandart

C12InvType.ContractAccount

cession

Boolean

Ja

Vertragskonten

Abtretungserklärung

C12Cession.ContractAccount

Wenn eine Abtretungserklärung vorliegt, stehen im Portal bestimmte Aktionen wie bspw. die Änderung der Bankverbindung für die Einspeisevergütung nicht zur Verfügung

canBeChanged

Boolean

Nein

JSON-Attribut

Datentp

Pflicht

Entität

Feldname

Interner Feldname

Anmerkungen

customerNo

String(250)

Ja

Geschäftspartner

ERP-GP-Nr.

CustomerNo2.Customer

contractAccountNo

String(250)

Ja

Vertragskonten

Vertragskonto-Nr.

ContAccountNo.ContractAccount

contractNo

String(250)

Ja

Abrechnungsverträge

Vertrags-Nr.

Vertrag.BillingContract

Abrechnungsvertrag zu Anlagenkonto, das über Current_BC mit der übergebenen contractNo verknüpft ist

mediaType

String(250)

Ja

Anlagenkonten

Sparte

Medium.C12INSTACC

Das Anlagenkonto wird indentifiziert über Abrechnungsverträge, Vertragskonto und MaLo

Anlagenkonto, das über ContractAccPk mit der übergebenen contractNo verknüpft ist

installationNo

String(250)

Ja

Anlagen

Anlagen-Nr

InstallationNo.Installation

Anlage zu Anlagenkonto, das über ContractAccPk mit der übergebenen contractNo verknüpft ist

meterNo

String(250)

Ja

Messeinrichtungen

Zählernummer

MeterNo.MeasuringDevice

Messeinrichtung zur Anlage, die im Anlagenkonto im Feld InstallationPk verknüpft ist

Einbaudatum <= HEUTE && Ausbaudatum >= HEUTE oder leer

melo

String(250)

Ja, wenn malo leer

Anlagen

MaLo/MeLo (Zählpunktbezeichnung)

MeteringCode.Installation

malo

String(250)

Ja, wenn melo leer

Anlagen

MaLo/MeLo (Zählpunktbezeichnung)

MeteringCode.Installation

JSON-Attribut

Datentp

Pflicht

Anmerkungen

Entität

Feldname

Interner Feldname

pk

String(50)

Ja**

Pflicht für Service getCustomer (TINA an Portal), ansonsten keine Pflicht

Geschäftspartner

Primärschlüssel

PK.Customer

customerNo

String(50)

Nein

Geschäftspartner

GP-Nr.

CustomerNo2.Customer

customerType

String(250)

Ja

Geschäftspartner

Typ

PersontypeKey.Customer

name1

String(128)

Ja

Geschäftspartner

Nachname/Firma

Name1.Customer

name2

String(70)

Nein

Geschäftspartner

Vorname/Zusatz1

Name2.Customer

name3

String(80)

Nein

Geschäftspartner

Zusatz/Zusatz2

Name3.Customer

phoneNoCountry

String(10)

Nein

Standard-Kommunikation zu Geschäftspartner

Festnetz-Ländervorwahl

PhoneNoCountry.Telecom

phoneNoCity

String(10)

Nein

Standard-Kommunikation zu Geschäftspartner

Festnetz-Ortsvorwahl

PhoneNoCity.Telecom

phoneNoBase

String(50)

Nein

Standard-Kommunikation zu Geschäftspartner

Festnetz-Rufnummer

PhoneNoBase.Telecom

phoneNoExt

String(10)

Nein

Standard-Kommunikation zu Geschäftspartner

Festnetz-Durchwahl

PhoneNoExtension.Telecom

mobileNoCountry

String(10)

Nein

Standard-Kommunikation zu Geschäftspartner

Mobil-Ländervorwahl

MobilePhoneCountry.Telecom

mobileNoCity

String(10)

Nein

Standard-Kommunikation zu Geschäftspartner

Mobil-Ortsvorwahl

MobilePhoneCity.Telecom

mobileNoBase

String(50)

Nein

Standard-Kommunikation zu Geschäftspartner

Mobil-Rufnummer

MobilePhoneBase.Telecom

mobileNoExt

String(10)

Nein

Standard-Kommunikation zu Geschäftspartner

Mobil-Durchwahl

MobilePhoneExtension.Telecom

faxNoCountry

String(10)

Nein

Standard-Kommunikation zu Geschäftspartner

Fax-Ländervorwahl

FaxNoCountry.Telecom

faxNoCity

String(10)

Nein

Standard-Kommunikation zu Geschäftspartner

Fax-Ortsvorwahl

FaxNoCity.Telecom

faxNoBase

String(50)

Nein

Standard-Kommunikation zu Geschäftspartner

Fax-Rufnummer

FaxNoBase.Telecom

faxNoExt

String(10)

Nein

Standard-Kommunikation zu Geschäftspartner

Fax-Durchwahl

FaxNoExtension.Telecom

email

String(255)

Nein

Standard-Kommunikation zu Geschäftspartner

E-Mail

Email.Telecom

abrNo

String(255)

Nein

Geschäftspartner

ABR-Nummer

C12ABRNo.Customer

taxOffice

String(255)

Nein

Finanzamt

-

-

-

taxNo

String(255)

Nein

Steuernummer

-

-

-

bankAccount

@bankAccount

Nein

-

-

-

serviceProvider

@serviceProvider

Nein

-

-

-

isLegitimized

Boolean

Ja

Geschäftspartner

Legitimiert (Portal)

C12PortalLegit.Customer

registryNumber

String(40)

Ja*, wenn Geschäftspartnertyp = Unternehmen

2025.6

Geschäftspartner

Handelsregister

TradeRegister.Customer

registryCourt

String(40)

Ja*, wenn Geschäftspartnertyp = Unternehmen

2025.6

Geschäftspartner

Handelsregister-Ort

TradeRegisterCity.Customer

JSON-Attribut

Datentyp

Pflicht

Anmerkungen

Entität

Feldname

Feld.Tabelle (intern)

pk

String

Nein

Wird übergeben wenn Datensatz bereits in TINA vorhanden ist bzw. aus dem Portal an TINA gesendet, wenn eine Aktualisierung stattfindet

Energieverbraucher

Pk

Pk.EnergyConsumer

count

Integer

Ja

Energieverbraucher

Anzahl Geräte

DeviceCount.EnergyConsumer

power

Double

Ja

wird verwendet für Leistungsaufnahme Heizen, Einzelleistung Wp und Einzelleistung (E-Mobilität, Direktheizung, Elek. Fußbodenheizung, sonstiges), Bei Durchlauferhitzer setzt das Portal automatisch 8

Energieverbraucher

Leistung

DevicePower.EnergyConsumer

powerHeatStick

Double

Nein

Energieverbraucher

Leistung Heizstab

PowerHeatStick.EnergyConsumer

totalPower

Double

Ja

Energieverbraucher

Gesamtleistung

TotalPower.EnergyConsumer

meterNo

String

Nein

Energieverbraucher

Zählernummer

MeterNo.EnergyConsumer

deviceType

Schlüssel

Ja*

Schlüssel:

• Heizung

  • Wärmepump

  • Nachtspeicherheizung

  • Direktheizung

  • Elektrische Fußbodenheizung

• Klimagerät

• Ladeeinrichtung

• Sonstiges

• Durchlauferhitzer

• Speicher

Energieverbraucher

Verbrauchertyp

ConsumerTypeKey.EnergyConsumer

product

@product

Nein

Energieverbraucher

Produkt

ProductPk.EnergyConsumer

producer

String

Nein

Pflicht wenn product leer ist

Energieverbraucher

Hersteller (Freie Eingabe)

Producer.EnergyConsumer

model

String

Nein

Pflicht wenn product leer ist

Energieverbraucher

Modell

Model.EnergyConsumer

series

String

Nein

Pflicht wenn product leer ist

Energieverbraucher

Baureihe

Series.EnergyConsumer

description

String

Ja*

Wird nur genutzt, wenn Geräteart SONSTIGES ist

Energieverbraucher

Verbrauchertyp Beschreibung

TypeDescription.EnergyConsumer

powerComprEl

Double

Nein

Maximalleistung Verdichter

Energieverbraucher

Maximalleistung Verdichter

PowerComprEl.EnergyConsumer

additHeaterType

Schlüssel

Ja

Position Heizstab

• INTERN

• EXTERN

• KEINE

Künftig kein Pflichtfeld, wird noch korrigiert

Energieverbraucher

Position Heizstab

AdditHeaterType.EnergyConsumer

numberOfChargingPointsAC

Integer

Nein

Energieverbraucher

Anzahl Ladepunkte AC

CPCountAC.EnergyConsumer

numberOfChargingPointsDC

Integer

Nein

Energieverbraucher

Anzahl Ladepunkte DC

CPCountDC.EnergyConsumer

criticalInfrastructure

Boolean

Nein

Kritische Infrastruktur

Energieverbraucher

Nutzung in kritischer Infrastruktur

CriticalInfra.EnergyConsumer

commercialUse

Boolean

Nein

Gewerbliche Nutzung

Energieverbraucher

Gewerbliche Nutzung

CommercialUse.EnergyConsumer

powerCooling

Double

Nein

Leistungsaufnahme kühlen

Energieverbraucher

Leistungsaufnahme Kühlen

PowerCooling.EnergyConsumer

is14a

Boolean

Nein

Unterliegt §14a

Gerätemeldung

Unterliegt § 14a

Para14a.EnergyConsumer

powerSupply

Schlüssel
230V
400V

Nein

Energieverbraucher

Stromzufuhr

VoltageKey.EnergyConsumer

deviceRefNo

String(255)

Nein

Externe Referenznummer

Energieverbraucher

Referenz-Nr.

ExtRefNo.EnergyConsumer

JSON-Attribut

Datentyp

Pflicht

Anmerkungen

Entität

Feldname

Feld.Tabelle (intern)

pk

String

Nein

Wenn gefüllt, wird der Datensatz gesucht und mit den gelieferten Werten aktualisiert

Gerätemeldung

Pk

Pk.DeviceReg

devices

List<@device>

Ja

Liste von Geräten

Energieverbraucher

type

Schlüssel

Ja

Art der Meldung

Schlüssel:

• Gerät anmelden

• Gerät nachmelden §14a

Gerätemeldung

Meldungsart

RegType.DeviceReg

loadBalanceType

Schlüssel

Ja

Art der Lastverteilung

Schlüssel:

• Direktansteuerung

• Energiemanagementsystem

• Keine

Gerätemeldung

Art des Lastausgleichs

LoadBalanceType.DeviceReg

isManageable

Boolean

Gibt an ob das Gerät steuerbar ist

Gerätemeldung

Steuerbar

IsManageable.DeviceReg

gridFeeModule

Schlüssel

Ja

Netzentgeltmodul

Schlüssel:

• 01

• 02

• 03

Gerätemeldung

Netzentgeltmodul

GridFeeModule.DeviceReg

controlBoxInstaller

Schlüssel

Nein

Mögliche Werte

• gMSB

• wMSB

Gibt an ob die Steuerbox vom grundzuständigen Messtellenbetreiber oder einem wettbewerblichen Messtellenbetreiber installiert wird

Gerätemeldung

Installateur Steuerbox

CntrlBoxInstKey.DeviceReg

totalPowerLoadBalancer

Double

Nein

Gesamtleistung Lastmanagement

Gerätemeldung

Gesamtleistung Lastmanagement

TtlPowerLoadB.DeviceReg

JSON-Attribut

Datentp

Pflicht

Anmerkungen

Entität

Feldname

Interner Feldname

documentNo

String(250)

Ja

Dokumentennummer

Dokumente

Primärschlüssel

Pk.Document

documentDate

date

Ja

Dokumentdatum

Dokumente

Dokumentdatum

FileSystemCreation.Document

documentType

String(40)

Ja

Dokumenttyp Wertemenge TINA

TINA stellt nur Dokumente der Kategorie: NZB30, NZA30, NAB, E9_4105, NZA30V zur Verfügung

Dokumente

Dokumenttyp Wertemenge TINA

DocumentCategoryKey.Document

displayName

String(250)

Ja

Anzeigename

Dokumente

Dateiname

DocumentName.Document

fileType

String(250)

Ja

Dokumente

Dateierweiterung

DocExtension.Document

documentPk

String(250)

Ja

Dokumente

Primärschlüssel

Pk.Document

processLists

String(250)

Nein

Kommaseparierte List der am Dokument verknüpften Projektnummern. Z.B. "PRJ 0000009, PRJ 0000099, PRJ 0004711"

Projekte

Projekt-Nr.

ProjectNo.Project

JSON-Attribut

Datentyp

Pflicht

Anmerkungen

Entität

Feldname

Feld.Tabelle (intern)

Anmerkungen

pk

String(50)

Nein

Anlagen

Pk

Pk.Installation

seeNo

String(50)

Nein

Anlagen

SEE-Nummer

C12SEENr.Installation

eegInstallationKey

String(255)

Nein

Anlagen

EEG Anlagenschlüssel

EEGInstKey.Installation

eegNo

String(255)

Nein

Anlagen

EEG Nr.

C12EEGNo.Installation

kwkNo

String(255)

Nein

Anlagen

KWK Nr.

C12KWKNo.Installation

feedInType

Schlüssel

Nein

Anlagen

Einspeiseart

C12FeedInType.Installation

feedInManag

Schlüssel

Nein

Anlagen

Einspeisemanagement

C12FeedInManag.Installation

feedInSym

Boolean

Nein

• True: Symmetrisch

• False: Asymmetrisch

Anlagen

Symmetrisch

C12FeedInSym.Installation

feedInSelling

String(255)

Nein

Anlagen

Veräußerungsform der Einspeisung

C12FeedInSell.Installation

centSupProt

Boolean

Nein

• True: Am Zählerplatz

• False: Integriert am Wechselrichter

Anlagen

Zentraler NA-Schutz

C12CentSupProt.Installation

feedInSellingAd

String

Nein

Weitere Angaben zur Veräußerungsform

Anlagen

Weitere Angaben zur Veräußerungsform

FeedInSellingAd.Installation

registerDateMaStR

Date

Nein

Datum der Registrierung im MaStR

Anlagen

Registierungsdatum MaStR

MaStRRegDate.Installation

modulePowerTotal

Double

Nein

Gesamtleistung der Module aus TINA/Anmeldung der Eigenerzeugungsanlage

Anlagen

Gesamtleistung Module

C12PvPower.Installation

modulePowerMaStR

Double

Nein

Gesamtleistung der Module wie sie im MaStR gemeldet wurde

Anlagen

Gesamtleistung Module aus MaStR

C12PvPowerMaStR.Installation

powerStorageCapacityTotal

Double

Nein

Gesamtspeicherkapazität

Anlagen

Gesamtspeicherkapazität

C12StorCapacTtl.Installation

powerTotal

Double

Nein

Anlagen

Gesamtwirkleistung

C12TotalPower.Installation

powerTotalApp

Double

Nein

Anlagen

Gesamtscheinleistung

C12TotalAppPow.Installation

powerTotalExisting

Double

Nein

Anlagen

Gesamtwirkleistung vorhanden

C12EffectPowEx.Installation

powerTotalAppExisting

Double

Nein

Anlagen

Gesamtscheinleistung vorhanden

C12ApparePowEx.Installation

modulePowerTotalExisting

Double

Nein

Anlagen

Gesamtleistung Module vorhanden

C12ModulePowEx.Installation

trId

String(50)

Nein

Anlagen

TR-ID

TechResId.Installation

srId

String(50)

Nein

Anlagen

SR-ID

ControllableId.Installation

allPoleDisconnection

Boolean

Nein

Allpolige Trennung

Anlagen

Allpolige Trennung

AllPoleDisconn.Installation

powerSupplyProtection

Boolean

Nein

NA-Schutz nach VDE-AR-N 4105 vorhanden

Anlagen

NA-Schutz nach VDE-AR-N 4105 vorhanden

GridProtVDE.Installation

numberFNNGuidelines

String

Nein

Nummer der Abbildung nach FNN-Hinweis

Anlagen

Nummer der Abbildung nach FNN-Hinweis

NumFNNGuide.Installation

remoteActivePowerLimitation

Boolean

Nein

Wirkleistungsbegrenzung ferngesteuert

Anlagen

Wirkleistungsbegrenzung ferngesteuert

RemConPowLim.Installation

permanentActivePowerLimitation

Boolean

Nein

Wirkleistungsbegrenzung dauerhaft begrenzt

Anlagen

Wirkleistungsbegrenzung dauerhaft begrenzt

RemConPerm.Installation

noPowerFromGrid

Boolean

Nein

Energie des Speichers wird nicht aus dem Netz bezogen

Anlagen

Kein Energiebezug des Speichers aus dem Netz

NoGridConsStor.Installation

constructionType

Schlüssel

Nein

Mögliche Schlüssel:

• DACH - Dach

• FREIFL - Freifläche

• KWK - Blockheizkraftwerk

• ANDERE - Andere

Anlagen

Art der Erzeugungsanlage

CustGenType.Installation

constructionTypeDesc

Text

Ja*

Pflicht, wenn constructionType == ANDERE

Anlagen

Beschreibung Art der Erzeugungsanlage

CustGenTypeDesc.Installation

JSON-Attribut

Datentyp

Pflicht

Anmerkungen

Entität

Feldname

Feld.Tabelle (intern)

Anmerkungen

pk

String

Nein

Wenn gefüllt, wird der Datensatz gesucht und mit den gelieferten Werten aktualisiert

Hausanschluss

Pk

Pk.HouseConnection

connectorPosition

String

Nein

Schlüssel:

• Im Gebäude

• Außerhalb des Gebäudes

Hausanschluss

Anschlussposition

ConnectorPosKey.HouseConnection

connectionType

Schlüssel

Nein

Schlüssel:

(nur wenn connectorPosition Im Gebäude)

• Guss-/Bakelitkasten (<63A)

• Kunststoff Gr. 01 (<80A)

• Kunststoff Gr. 02 (<160A)

• Kunststoff Gr. 03 (<250A)

• Sonderanschluss

(nur wenn connectorPosition Außerhalb des Gebäudes)

• ZAS - Zähleranschlusssäule

• HAS - Hausanschlusssäule

Hausanschluss

Anschlussart

ConnectTypeKey.HouseConnection

fusing

Integer

Nein

Absicherung [A]

Wird nur übergeben, wenn connectionType = HAS

Hausanschluss

Absicherung

Fusing.HouseConnection

obstacleStreet

Boolean

Nein

Hindernisse im Bereich der Anschlussstraße

Hausanschluss

Hindernisse im Bereich der Anschlussstraße

ObstacleStreet.HouseConnection

obstacleStreetDate

Date

Nein

Termin Anschlussstraße hindernisfrei

Hausanschluss

Termin Anschlussstraße hindernisfrei

ObstFreeDate.HouseConnection

totalPower

Double

Nein

Benötigte Gesamtleistung

Hausanschluss

Benötigte Gesamtleistung

TotalPower.HouseConnection

devices

List<@devices>

Nein

Liste von Energieverbrauchern

Energieverbraucher

-

-

Die übergebenen Energieverbraucher sollen mit dem Hausanschluss-Datensatz verknüpft werden

electricWarmWater

Boolean

Nein

Gibt die Art der Warmwasserbereitung an

• true: Elektrisch

• false: Nicht-elektrisch

Hausanschluss

Elektrische Warmwasserbereitung

IsElWarmWater.HouseConnection

warmWaterEnergyMedium

Schlüssel

Nein

Mögliche Werte

• Gas

• Öl

• Holz

• Sonstiges

Hausanschluss

Energieträger Warmwasserbereitung

WWMediumKey.HouseConnection

warmWaterEnergyMediumDescription

String

Ja*

• wenn warmWaterEnergyMedium == Sonstiges: Pflicht, sonst nicht

Hausanschluss

Beschreibung Energieträger Warmwasserbereitung

WWMediumDesc.HouseConnection

ℹ Wird genutzt um bei Auswahl Sonstiges den Energieträger für die Warmwasserbereitung detaillierter zu beschreiben

electricHeating

Boolean

Nein

Gibt die Art der Heizung an

• true: Elektrisch

• false: Nicht-elektrisch

Hausanschluss

Elektrische Heizung

IsElHeating.HouseConnection

heatingEnergyMedium

Schlüssel

Nein

Mögliche Werte

• Gas

• Öl

• Holz

• Sonstiges

Hausanschluss

Energieträger Heizung

HeatingTypeKey.HouseConnection

mediaType

Schlüssel

Nein

Mögliche Werte

• Strom

• Gas

• Wasser

Hausanschluss

Sparte

MediaTypeKey.HouseConnection

maxFlowRate

Double

Nein

Hausanschluss

Spitzendurchfluss

MaxFlowRate.HouseConnection

type

Schlüssel

Nein

Mögliche Werte

• Neuanschluss

• Anschlussänderung

Hausanschluss

Typ

ReportTypeKey.HouseConnection

changeType

Schlüssel

Nein

Mögliche Werte

• Umverlegung

• Abtrennung

Hausanschluss

Änderungsart

ChangeTypeKey.HouseConnection

relocationType

Schlüssel

Nein

Mögliche Werte

• Garagenbau

• Swimmingpool

• Anbau/Umbau

• Sonstiges

Hausanschluss

Grund der Umverlegung

RelocReasonKey.HouseConnection

relocationTypeDescription

String

Ja*

• Pflicht wenn relocationType == Sonstiges, ansonsten keine Pflicht

Hausanschluss

Beschreibung Umverlegungsgrund

RelocReasonDesc.HouseConnection

demolition

Boolean

Nein

Hausanschluss

Gebäudeabriss

IsDemolition.HouseConnection

newBuilding

Boolean

Nein

Hausanschluss

Neubau geplant

IsNewBuilding.HouseConnection

isConstructionSupply

Boolean

Nein

Gibt an, ob ein Bauanschluss benötigt wird

Hausanschluss

Bauanschluss erforderlich

IsConsSupply.HouseConnection

Wenn true, wird zusätzlich zur HouseConnection noch ein ConstructionSupply-Datensatz erzeugt

JSON-Attribut

Datentp

Pflicht

Anmerkungen

Entität

Feldname

Interner Feldname

Anmerkungen

pk

String(50)

Nein

Anlagen

PK

Pk.Installation

seeNo

String(255)

Nein

Anlagen

SEE-Nr.

C12SEENr.Installation

installationNo

String(50)

Nein

Anlagen

Anlagennummer

InstallationNo.Installation

eegInstallationKey

String(34)

Nein

Bsp.: E339970…

Wird von SAP vergeben und geliefert

Anlagen

EEG Anlagenschlüssel

EEGInstKey.Installation

eegNo

String(250)

Nein

Bsp.: EEG9022… kommt aus MaStR über Portal

Anlagen

EEG Nr.

C12EEGNo.Installation

kwkNo

String(250)

Nein

Bsp.: KWK9023… kommt aus MaStR über Portal

Anlagen

KWK Nr.

C12KWKNo.Installation

commissionDate

@date

Nein

Anlagen

Inbetriebnahme

InstallDate.Installation

completionDate

@date

Nein

Anlagen

Fertigmeldungs-Datum

C12ComplDate. Installation

installationState

String(50)

Nein

Schlüssel [AKTIV, IN-PLAN, INAKTIV]

• AKTIV (Aktiv)

• IN-PLAN (in Planung)

• INAKTIV (Inaktiv)

Anlagen

Anlagenstatus

InstStatusKey.Installation

mediaType

String(50)

Ja

Anlagen

Produktart

ProducttypeKey .Installation

meteringConcept

String(50)

Nein

Anlagen

Messkonzept

C12MeasuringCon.Installation

Keine Standard-Schlüssel, da immer kundenindividuell

feedInType

String(50)

Nein

Schlüssel

• VOLL (Volleinspeisung)

• SELBST (Selbstverbrauch)

• NULL (Nulleinspeisung)

Anlagen

Einspeiseart

C12FeedInType.Installation

feedInManag

String(50)

Nein

Schlüssel: [NR, RFWG, RBTRE]

• NR: nicht regelbar

• RFWG:  regelbar Fernwirkgerät

• RBTRE: regelbar TRE

Anlagen

Einspeisemanagement

C12FeedInManag.Installation

decommissionDate

@date

Nein

Anlagen

Stilllegung

ShutDownDate.Installation

feedInSym

Boolean

Ja

true = symmetrisch

sonst = unsymmetrisch

Anlagen

Symmetrisch

C12FeedInSym.Installation

feedInSelling

String(250)

Nein

[DV, EV, MSZ, SDV, VOGV]
Schlüssel:

• DV: Geförderte Direktvermarktung (Marktprämie) nach § 20 EEG

• EV: Einspeisevergütung nach § 21 Abs. 1 EEG

• MSZ: Mieterstromzuschlag nach § 21 Abs. 3 EEG

• SDV: sonstige Direktvermarktung nach § 21a EEG

• VOGV: Vermarktung ohne gesetzliche Vergütung

Anlagen

Veräußerungsform der Einspeisung

C12FeedInSell.Installation

centSupProt

Boolean

Ja

true = am Zählerplatz
false = integriert im Wechselrichter

Anlagen

Zentraler NA-Schutz

C12CentSupProt.Installation

feedInSellingAd

String(250)

Nein

Weitere Angabe zur Veräußerungsform

Anlagen

 -

-

Wird nur im JSON (TINA) gehalten, keine Übernahme nach TINA

installationType

String (250)

Nein

Anlagen

Anlagenart (IS-U)

ISU_ANLART.Installation

Wird nur im JSON (TINA) gehalten, keine Übernahme nach TINA

registerDateMaStR

Date

Nein

Datum der Registrierung im MaStR

Anlagen

 -

wird nur im JSON (TINA) gehalten, keine Übernahme nach TINA

Wird nur im JSON (TINA) gehalten, keine Übernahme nach TINA

modulePowerTotal

Zahl

Nein

Gesamtleistung Module aus TINA/Anmeldung Eigenerzeugungs-Anlage.

Wird nach TINA Übernommen, wenn noch nicht gefüllt bzw. leer

Anlagen

Gesamtleistung Module

C12PvPower.Installation

modulePowerMaStR

Zahl

Nein

Gesamtleistung Module aus MaStR

Anlagen

Gesamtleistung Module aus MaStR

C12PvPowerMaStR.Installation

powerStorageCapacityTotal

Zahl

Nein

Gesamtspeicherkapazität
Wird nach TINA Übernommen, wenn noch nicht gefüllt bzw. leer.

Anlagen

Gesamtspeicherkapazität 

C12StorCapacTtl.Installation

powerTotal

Zahl

Nein

Gesamtwirkleistung Speicher (aus MaStR bei Anmeldung Einspeisevergütung) oder Wechselrichter

Wird nach TINA Übernommen, wenn noch nicht gefüllt bzw. leer

Anlagen

Gesamtwirkleistung

C12TotalPower.Installation

powerTotalApp

Zahl

Nein

Gesamtscheinleistung

Anlagen

Gesamtscheinleistung

C12TotalAppPow.Installation

powerTotalExisting

Zahl

Nein

Gesamtwirkleistung vorhanden

Anlagen

Gesamtwirkleistung vorhanden

C12EffectPowEx.Installation

powerTotalAppExisting

Zahl

Nein

Gesamtscheinleistung vorhanden

Anlagen

Gesamtscheinleistung vorhanden

C12ApparePowEx.Installation

modulePowerTotalExisting

Zahl

Nein

Gesamtleistung Module vorhanden

Anlagen

Gesamtleistung Module vorhanden

C12ModulePowEx.Installation

accountingModel

String (255)

Nein

Bilanzierungsmodell (als Text, kein Schlüsselfeld)

Anlagen

 -

-

wird nur im JSON (TINA) gehalten, keine Übernahme nach TINA

billingModel

String (255)

Nein

Abrechnungsmodell (als Text, kein Schlüsselfeld)

Anlagen

 -

-

wird nur im JSON (TINA) gehalten, keine Übernahme nach TINA

malo

String  (255)

Nein

Anlagen

 MaLo/MeLo (Zählpunktbe.)

MeteringCode.Installation

Wenn Strukturtyp der Anlage = MALO

instDetailPVs

List<@instDetailPV>

Nein

Liste von Anlagendetails-PV

Anlagendetails PV

In TINA wird eine Anlage und n Anlagen-Details-PV zu einem Projekt erzeugt

instDetailInvs

List<@instDetailInv>

Nein

Liste von Wechselrichter

Wechselrichter

In TINA werden n Wechselrichter-Datensätze erzeugt zu der gleichen Anlage aus instDetailPVs.

instDetailSts

List<@instDetailSt>

Nein

Liste von Anlagendetails-Speicher

Anlagendetails Speicher

In TINA wird eine Anlage und n Anlagen-Details-Speicher zu einem Projekt erzeugt.

address

@address

Nein

Adresse wird nur über getContract geliefert

Adresse aus Anschlussobjekt

trId

String(255)

Nein

Anlagen

TR-ID

TechResId.Installation

sRId

String(255)

Nein

Anlagen

SR-ID

ControllableId.Installation

meter

List<@meter>

Nein

Messeinrichtungen

houseConnection

@houseConnection

Nein

Hausanschluss

Der Datensatz wird neu angelegt, wenn das Feld pk leer ist und mit Projekt und Anschlussobjekt verknüpft.

Werden zu der übergebenen Zählernummer Anlagen gefunden, wird der Datensatz mit diesen verknüpft.

deviceRegistration

@deviceRegistration

Nein

Gerätemeldung

Der Datensatz wird neu angelegt, wenn das Feld pk leer ist und mit Projekt und Anschlussobjekt verknüpft.
Werden zu der übergebenen Zählernummer Anlagen gefunden, wird der Datensatz mit diesen verknüpft.

meterExchange

@meterExchange

Nein

Zählertausch

Der Datensatz wird neu angelegt, wenn das Feld pk leer ist und mit Projekt und Anschlussobjekt verknüpft.
Werden zu der übergebenen Zählernummer Anlagen gefunden, wird der Datensatz mit diesen verknüpft.

capacityChange

@capacityChange

Nein

Leistungsänderung

Der Datensatz wird neu angelegt, wenn das Feld pk leer ist und mit Projekt und Anschlussobjekt verknüpft.
Werden zu der übergebenen Zählernummer Anlagen gefunden, wird der Datensatz mit diesen verknüpft.

meterRemoval

@meterRemoval

Nein

Zählerausbau

Der Datensatz wird neu angelegt, wenn das Feld pk leer ist und mit Projekt und Anschlussobjekt verknüpft.
Werden zu der übergebenen Zählernummer Anlagen gefunden, wird der Datensatz mit diesen verknüpft.

constructionSupply

@constructionSupply

Nein

Bauanschluss

Der Datensatz wird neu angelegt, wenn das Feld pk leer ist und mit Projekt und Anschlussobjekt verknüpft.
Werden zu der übergebenen Zählernummer Anlagen gefunden, wird der Datensatz mit diesen verknüpft.

sealing

@sealing

Nein

Plombierung

Der Datensatz wird neu angelegt, wenn das Feld pk leer ist und mit Projekt und Anschlussobjekt verknüpft.
Werden zu der übergebenen Zählernummer Anlagen gefunden, wird der Datensatz mit diesen verknüpft.

newMeteringConceptMeters

List<@newMeteringConceptMeters>

Nein

Entspricht einer Liste von Zählern mit Info zur Messkonzept-ID und Info, ob Netzbezug für neues Messkonzept

Meskonzeptwechsel

instDetailBts

List<@instDetailBt>

Anlagendetails BHKW

instDetailWind

List<@instDetailWind>

Anlagendetails Wind

instDetailWater

List<@instDetailWater>

Anlagendetails Wasser

address

@address

Adresse

Wird nur bei getContract lesend geliefert, wird nicht geschrieben

generatingUnit

List<@generatingUnit>

Erzeugungsanlage

meterReactivation

@meterReactivation

Wiederinbetriebsetzung

-

newMeter

List<@meterExchange>

Neuer Zähler wird über Objekt meterExchange reingereicht

Zählertausch

energyDirection

String(250)

Nein

Anlagen

Energierichtung

EnergyDirection.Installation

serviceType

String(250)

Nein

Anlagen

Serviceart (ISU)

ISU_ServArt.Installation

generatingUnit

2025.5

@generatingUnit

Nein

JSON-Attribut

Datentp

Pflicht

Anmerkungen

Entität

Feldname

Interner Feldname

InstallerDetail

@installerDetail

Ja

Im Fall von getCustomer leer

Installateursverzeichnis

-

-

customerProfile

@customerProfile

Ja

Geschäftspartner

-

-

customerAddress

@address

Ja

Standardadresse Geschäftspartner

-

-

contactProfile

@contactProfile

Ja

Im Fall von getCustomer wird der Default-Ansprechpartner geliefert

Ansprechpartner

-

-

JSON-Attribut

Datentp

Pflicht

Entität

Feldname

Interner Feldname

mediatype

String (250)

Ja

Installateursverzeichnis

Produktart

ProducttypeKey.C12INSTDIR

AdmissionNo

String(255)

Nein

Installateursverzeichnis

Zulassungs-Nr.

AdmissionNo.C12INSTDIR

IdNo

String(255)

Nein

Installateursverzeichnis

Ausweis-Nr.

IdNo.C12INSTDIR

IssueDate

@date

Nein

Installateursverzeichnis

Ausgestellt am

IssueDate.C12INSTDIR

ValidyDate

@date

Nein

Installateursverzeichnis

Gültig bis

ValidyDate.C12INSTDIR

JSON-Attribut

Datentyp

Pflicht

Anmerkungen

Entität

Feldname

Feld.Tabelle (intern)

btPk

String(50)

Nein

Anlagendetails BHKW

Pk

Pk.InstDetailBT

btProducer

String(255)

Ja*

• Pflicht, wenn product leer übergeben wird

Anlagendetails BHKW

Hersteller

Producer.InstDetailBT

btType

String(255)

Ja*

• Pflicht, wenn product leer übergeben wird

Anlagendetails BHKW

Typ

BTType.InstDetailBT

product

@product

Nein

Wenn das Produkt vorhanden ist muss Pk.Product im Objekt product gefüllt sein.
Es werden keine Produkte automatisch neu angelegt.

Anlagendetails BHKW

BHKW

ProductKey.InstDetailBT

btCount

Ganzzahl

Ja

Anlagendetails BHKW

Anzahl

CountBT.InstDetailBT

powerTotalApp

Zahl

Ja

Anlagendetails BHKW

Scheinleistung

PowerTotalApp.InstDetailBT

powerTotalExisting

Zahl

Ja

Anlagendetails BHKW

Wirkleistung

PowerTotalEx.InstDetailBT

JSON-Attribut

Datentp

Pflicht

Anmerkungen

Entität

Feldname

Interner Feldname

inverterPk

String(50)

Nein

Wechselrichter

Anlagendetails-WR-Pk

Pk.C12INVERTER

inverterNo

String(100)

Nein

Wechselrichter

Wechselrichter-Nr.

InverterNo.C12INVERTER

inverterProducer

String(255)

Nein*

Muss gefüllt sein, wenn kein product übergeben wird

Wechselrichter

Hersteller

Producer.C12INVERTER

inverterType

String(255)

Nein*

Muss gefüllt sein, wenn kein product übergeben wird

Wechselrichter

Typ

InvType.C12INVERTER

product

@product

Nein

Wenn das Produkt vorhanden ist, muss Pk.Product im Objekt product gesetzt sein. Es erfolgt keine automatische Neuanlage des Produkts oder des Herstellers.

Wechselrichter

Produkt (Wechselrichter)

ProductKeyPk.C12INVERTER

inverterCount

Ganzzahl

Ja

Wechselrichter

Anzahl Wechselrichter

InverterNumber.C12INVERTER

activePower

Zahl

Ja

Wechselrichter

Wirkleistung

EffectivePower.C12INVERTER

apparentPower

Zahl

Ja

Wechselrichter

Scheinleistung

ApparentPower.C12INVERTER

symmetric

Boolean

Ja

Wechselrichter

Symmetrisch

IsSymmetric.C12INVERTER

L1

Double

Nein

Wechselrichter

L1

L1.C12INVERTER

L2

Double

Nein

Wechselrichter

L2

L2.C12INVERTER

L3

Double

Nein

Wechselrichter

L3

L3.C12INVERTER

powerSupplyProtection

Schlüssel

Nein

Mögliche Werte

• WR

• ZAEHLER

Wechselrichter

Ausführungsart NA-Schutz

PwrSuppProtKey.C12INVERTER

JSON-Attribut

Datentp

Pflicht

Anmerkungen

Entität

Feldname

Interner Feldname

modulePk

String(50)

Nein

Anlagendetails PV

Anlagendetails-PV-PK

Pk.InstDetailPV

moduleProducer

String(255)

Nein

Muss gefüllt sein, wenn kein product übergeben wird

Anlagendetails PV

Hersteller

C12Producer.InstDetailPV

moduleType

String(255)

Nein

Muss gefüllt sein, wenn kein product übergeben wird

Anlagendetails PV

Typ

C12Type.InstDetailPV

product

@product

Nein

Wenn das Produkt vorhanden ist, muss Pk.Product im Objekt product gesetzt sein. Es erfolgt keine automatische Neuanlage des Produkts oder des Herstellers.

Anlagendetails PV

PV-Modul

ProductKey.InstDetailPV

moduleCount

Ganzzahl

Ja

Anlagendetails PV

Module (Anzahl)

PvModules.InstDetailPV

modulePower

Zahl

Nein

Anlagendetails PV

Modulleistung

ModulePower.InstDetailPV

JSON-Attribut

Datentp

Pflicht

Anmerkungen

Entität

Feldname

Interner Feldname

powerStoragePk

String(50)

Nein

Anlagendetails Speicher

Anlagendetails-Speicher-PK

Pk.InstDetailSt

powerStorageProducer

String(255)

Nein

Muss gefüllt sein, wenn kein product übergeben wird

Anlagendetails Speicher

Hersteller

C12Producer.InstDetailSt

powerStorageType

String(255)

Nein

Muss gefüllt sein, wenn kein product übergeben wird

Anlagendetails Speicher

Typ

C12Type.InstDetailSt

product

@product

Nein

Wenn das Produkt vorhanden ist, muss Pk.Product im Objekt product gesetzt sein. Es erfolgt keine automatische Neuanlage des Produkts oder des Herstellers.

Anlagendetails Speicher

Batterie

ProductKey.InstDetailSt

powerStorageCount

Ganzzahl

Ja

Anlagendetails Speicher

Anzahl Speicher

C12StorageNum.InstDetailSt

powerStoragePower

Zahl

Ja

Anlagendetails Speicher

Wirkleistung

C12StoragePower.InstDetailSt

powerStorageCapacity 

Zahl

Ja

Anlagendetails Speicher

Speicherkapazität

StorageCapacity.InstDetailSt

meteringConcept

String(50)

Ja

Schlüssel [OLBEZ, OLBVE, OLI]

• OLBEZ: Speicher ohne Leistungsbezug aus dem öffentlichen Netz (Speicher bei Erzeugungsanlage)

• OLBVE: Speicher ohne Leistungsbezug aus dem öffentlichen Netz (Speicher bei Verbrauchseinrichtung)

• OLI: Speicher ohne Lieferung in das öffentliche Netz

Anlagendetails Speicher

Messkonzept

C12MeasuringCon.InstDetailSt

operatingMode

String(50)

Ja

[KBE, KBKE, BKE, BE]

• KBE: kein Bezug, aber Einspeisung

• KBKE: kein Bezug und keine Einspeisung

• BKE: Bezug und keine Einspeisung

• BE: Bezug und Einspeisung

Anlagendetails Speicher

Betriebsweise

C12PowConcept.InstDetailSt

couplingACDC

String(50)

Ja

Mögliche Schlüssel:

• AC: AC-gekoppelt (Speicher mit eigenem Wechselrichter)

• DC: DC-gekoppelt (Einspeisung über PV-Wechselrichter)

Anlagendetails Speicher

AC-/DC-gekoppelt

C12ACDC.InstDetailSt

separateMeter

Boolean

Ja

Anlagendetails Speicher

Separater Zähler

C12SeparMeter.InstDetailSt

consumptionEms

Double

Nein

Anlagendetails-Speicher

Bezugsleistung nach EMS

ConsumptionEMS.InstDetailSt

isManageable

Boolean

Ja

Anlagendetails-Speicher

Vereinbarung zur Steuerbarkeit

IsManageable.InstDetailSt

controlUnit

Schlüssel

Ja

Mögliche Werte

• EMS

• DIREKT

• KEINE

Anlagendetails-Speicher

Art der Steuerung

ControlUnitKey.InstDetailSt

gridFeeModule

Schlüssel

Nein

Mögliche Werte

• 01

• 02

• 03

Anlagendetails-Speicher

Netzentgeltmodul

GridFeeModule.InstDetailSt

loadBalancing

Boolean

Ja

Anlagendetails-Speicher

Lastmanagement

IsLoadBalancing.InstDetailSt

loadBalancingPower

Double

Ja*

• Pflicht, wenn loadBalancing true ist

Anlagendetails-Speicher

Gesamtleistung Lastmanagement

LoadBalancePow.InstDetailSt

inverter

@inverter

Ja

Wechselrichter

-

-

-

controlBoxInstaller

Schlüssel

Ja

Mögliche Werte

• GMSB

• WMSB

Anlagendetails-Speicher

Installateur Steuerbox

CntrlBoxInstKey.InstDetailSt

JSON-Attribut

Datentyp

Pflicht

Anmerkungen

Entität

Feldname

Feld.Tabelle (intern)

Anmerkungen

waterPk

String(50)

Nein

Anlagendetails Wasser

Pk

Pk.InstDetailWater

waterProducer

String(255)

Ja*

• Pflicht, wenn product leer übergeben wird

Anlagendetails Wasser

Hersteller

Producer.InstDetailWater

waterType

String(255)

Ja*

• Pflicht, wenn product leer übergeben wird

Anlagendetails Wasser

Typ

WaterType.InstDetailWater

product

@product

Nein

Wenn das Produkt vorhanden ist muss Pk.Product im Objekt product gefüllt sein.

Es werden keine Produkte automatisch neu angelegt.

Anlagendetails Wasser

Produkt

ProductPk.InstDetailWater

waterCount

Ganzzahl

Ja

Anlagendetails Wasser

Anzahl

WaterCount.InstDetailWater

powerTotalApp

Zahl

Ja

Anlagendetails Wasser

Scheinleistung

PowerTotalApp.InstDetailWater

powerTotalExisting

Zahl

Ja

Anlagendetails Wasser

Wirkleistung

PowerTotalEx.InstDetailWater

JSON-Attribut

Datentyp

Pflicht

Anmerkungen

Entität

Feldname

Feld.Tabelle (intern)

windPk

String(50)

Nein

Anlagendetails Wind

Pk

Pk.InstDetailWind

windProducer

String(255)

Ja*

• Pflicht, wenn product leer übergeben wird

Anlagendetails Wind

Hersteller

Producer.InstDetailWind

windType

String(255)

Ja*

• Pflicht, wenn product leer übergeben wird

Anlagendetails Wind

Typ

WindType.InstDetailWind

product

@product

Nein

Wenn das Produkt vorhanden ist muss Pk.Product im Objekt product gefüllt sein.

Es werden keine Produkte automatisch neu angelegt.

Anlagendetails Wind

Produkt

ProductPk.InstDetailWind

windCount

Ganzzahl

Ja

Anlagendetails Wind

Anzahl

WindCount.InstDetailWind

powerTotalApp

Zahl

Ja

Anlagendetails Wind

Scheinleistung

PowerTotalApp.InstDetailWind

powerTotalExisting

Zahl

Ja

Anlagendetails Wind

Wirkleistung

PowerTotalEx.InstDetailWind

JSON-Attribut

Datentp

Pflicht

Anmerkungen

Entität

Feldname

Interner Feldname

locationNo

String(50)

Nein

Anschlussobjektnummer

Anschlussobjekt

Anschlussobjekt-Nr.

ReferenceNumber.Location

pk

String(50)

Nein

Primärschlüssel

Anschlussobjekt

Primärschlüssel

PK.Location

postalCode

String(5)

Ja

PLZ

Anschlussobjekt

PLZ

ZIP.Location

city

String(250)

Ja

Ort

Anschlussobjekt

Ort

City.Location

dictrict

String(250)

Nein

Ortsteil

Anschlussobjekt

Ortsteil

District.Location

street

String(250)

Ja

Straße

Anschlussobjekt

Straße

Street.Location

houseNo

String(250)

Ja

Haus-Nr.

Anschlussobjekt

Hausnummer

StreetNumber.Location

houseNoAffix

String(10)

Nein

Haus-Nr. Zusatz

Anschlussobjekt

Haus-Nr. Zusatz

StreetNumberAddition.Location

localSubdistrict

String(250)

Nein

Gemarkung

Anschlussobjekt

Gemarkung

SubDistrict.Location

floorNumber

String(250)

Nein

Flur-Nr.

Anschlussobjekt

Flur

Parcel.Location

parcelNumber

String(250)

Nein

Flurstück-Nr.

Anschlussobjekt

Flurstücknummer

ParcelNumber.Location

mediaTypes

Liste

Nein

Siehe ag.itc.getInstaller.mediatype

Anschluss

Produkt

ProducttypeKey.Supply

mediaTypes

Liste

Nein

Siehe ag.itc.getInstaller.mediatype

Mögliche Schlüssel im Portal [POWER, GAS, HEAT]

Die folgenden Schlüssel werden noch nicht im Portal verwendet:
[PV, SP, E-M, BHKW] 

Anlagen

Produkt

ProducttypeKey.Installation über rLocationPk_Installation

installations

List<@installation>

Nein

Liste von Anlagen, die sowohl zu der location, als auch zum project verknüpft sind (wenn das übergeordnete Objekt vom Typ project ist z.B. beim Service getCustomer)

Anlagen

latitude

String

Nein

Anschlussobjekt

Breitengrad

Lat.Location

longitude

String

Nein

Anschlussobjekt

Längengrad

Lng.Location

locationType

String

Ja

Schlüssel:

• Bestandsgebäude

• Neubau

• Freifläche

• Sonstiges

Anschlussobjekt

Objekttyp

LocTypeKey.Location

locationTypeDescription

String

Ja*

Nur Pflicht, wenn locationType = Sonstiges

Anschlussobjekt

Anschlussart-Beschreibung

LocTypeDesc.Location

usage

String

Ja

Schlüssel:

• Einfamilienhaus

• Mehrfamilienhaus

• Gewerbe

• Wohn-Gewerbe

• Ladeinfrastruktur

• Sonstiges

Anschlussobjekt

Nutzungsart

LocUsageKey.Location

usageDescription

String

Ja*

Nur Pflicht, wenn usage = Sonstiges

Anschlussobjekt

Nutzungsart Beschreibung

LocUsageDesc.Location

housingUnitCount

Integer

Nein

Anzahl der Wohneinheiten

Wird nur geliefert, wenn usage Mehrfamilienhaus oder Wohn-Gewerbe

Anschlussobjekt

Anzahl der Wohneinheiten

HouseUnitCount.Location

meterCount

Integer

Nein

Anzahl der Zähler

Wird nur geliefert wenn usage = Ladeinfrastruktur oder Sonstiges

Anschlussobjekt

Anzahl der Zähler

MeterCount.Location

businessUnitCount

Integer

Nein

Anzahl der Gewerbeeinheiten

Wird nur geliefert, wenn usage = Gewerbe oder Wohn-Gewerbe

Anschlussobjekt

Anzahl der Gewerbeeinheiten

BuUnitCount.Location

generalUnitCount

Integer

Nein

Anzahl der Allgemeinanlagen

Wird geliefert wenn usage = Mehrfamilienhaus, Gewerbe, Wohn-Gewerbe

Anschlussobjekt

Anzahl der Allgemeinanlagen

GenUnitCount.Location

hasBasement

Boolean

Nein

Unterkellert

Anschlussobjekt

Unterkellert

HasBasement.Location

houseConnectionType

Schlüssel

Ja

Art der Hauseinführung

Anschlussobjekt

Art der Hauseinführung

HouseConType.Location

JSON-Attribut

Datentp

Pflicht

Entität

Feldname

Interner Feldname

meterNo

String(250)

Ja

Messeinrichtung

Zählernummer

MeterNo.MeasuringDevice

meterValues

List<@meterValues>

Nein

Zählerstände

meterType

String

Nein

Messeinrichtung

Gerätetyp

C12MeterClass.MeasuringDevice

meterReadingOrders

List<@meterReadingOrder>

Nein

Ableseaufträge

JSON-Attribut

Datentyp

Pflicht

Anmerkungen

Entität

Feldname

Feld.Tabelle (intern)

Anmerkungen

pk

String

Nein

Wenn gefüllt, wird der Datensatz gesucht und mit den gelieferten Werten aktualisiert

Zählertausch

Pk

Pk.MeterExchange

meterNos

List<String>

Ja

Zählernummern der auszustauschenden Zähler

Messeinrichtungen

Es werden keine kompletten Messeinrichtungen übergeben, sondern die Zählernummer

In TINA vorhandene Zähler sollen anhand der übergebenen Zählernummer identifiziert werden. Gefundene Messeinrichtungen werden mit dem Zählertausch-Datensatz verknüpft.

Konnte eine Messeinrichtung nicht gefunden werden wird diese neu angelegt und ebenfalls mit dem Zählertausch-Datensatz verknüpft.

2025.5 Bei Übergabe einer leeren Liste wird der Aufruf als Zählermeldung (neuer Zähler) interpretiert. Es entsteht ein Projekt der Art “Zählermeldung”.

constructionType

Schlüssel

Ja

Bauform des neuen Zählers

Mögliche Werte:

• 3-Punkt

• eHz

Zählertausch

Bauform neuer Zähler

ConstructionType.MeterExchange

transformerMetering

Boolean

Nein

Wandlermessung erforderlich

Zählertausch

IsTransMeter.MeterExchange

newMeterEnclosure

Boolean

Nein

Neuer Zählerschrank

Zählertausch

NewMeterEncl.MeterExchange

wMSB

Boolean

Nein

Wettbewerblicher Messstellenbetreiber

Zählertausch

IsWMSB.MeterExchange

wMSBProfile

@serviceProvider

Ja*

Pflicht, wenn wMSB == true, sonst keine Pflicht

Zählertausch

WMSBPk.MeterExchange

• Wurde im Portal ein aus TINA gelieferter Serviceprovider aus der Liste ausgewählt, wird dieser in das Feld übernommen.

reason

Schlüssel

Ja

Grund für den Zählertausch

Mögliche Werte:

• Doppel- auf Eintarif

• Wechsel der Heizungsart

• Wechsel auf Gewerbe

• Wechsel auf Haushalt

Zählertausch

Reason.MeterExchange

deviceAlreadyRegistered

Boolean

Nein

Gerät ist bereits angemeldet

Zählertausch

IsDevRegistered.MeterExchange

deviceRegistrations

List<@deviceRegistration>

Nein

Liste von Gerätemeldungen

Gerätemeldung

-

-

Die Gerätemeldungen werden mit dem Zählertausch verknüpft

usageType

Schlüssel

Ja

Mögliche Werte

• Heizung

• Ladeinfrastruktur

Zählertausch

Nutzungsart Heizung

Nutzungsart Ladeinfrastruktur

IsUsageHeating.MeterExchange

IsUsageCharging.MeterExchange

Im Portal wird ein Schlüsselwert geliefert, je nach Schlüssel wird folgendes Flag in TINA gesetzt

• Heizung → IsUsageHeating

• Ladeinfrastruktur → IsUsageCharging

loadManagement

Boolean

Nein

Lastmanagement am Zähler verbaut

Zählertausch

Lastmanagement am Zähler verbaut

IsLoadBalMeter.MeterExchange

loadManagementPower

Double

Nein

Zählertausch

Maximale Gesamtleistung Lastmanagement

MaxTtlPowerLB.MeterExchange

regulatedPressureKey

Schlüssel

Nein

Mögliche Werte

• 23mbar

• 50mbar

Zählertausch

Regeldruck

ControlPressureKey.MeterExchange

regulatedPressure

Integer

Nein

Zählertausch

Abweichender Regeldruck

DevContPressure.MeterExchange

maxUsablePower

Integer

Nein

Zählertausch

Nennbelastung max.

MaxNominalLoad.MeterExchange

maxPower

Integer

Nein

Zählertausch

Nennleistung max.

MaxNominalPower.MeterExchange

consumptionPerYear

Integer

Nein

Zählertausch

Geschätzter Jahresverbrauch

EstAnnualCons.MeterExchange

gushingShowerCount

Integer

Nein

Zählertausch

Anzahl Schwallbrausen

GushShowerCount.MeterExchange

pressureFlusherCount

Integer

Nein

Zählertausch

Anzahl Druckspüler

PressFlushCount.MeterExchange

gardeningIrrigation

Boolean

Nein

Zählertausch

Gartenbewässerung

HasGardIrrig.MeterExchange

wallHydrantConsumption

Double

Nein

Zählertausch

Löschwasserbedarf Wandhydrant

DemandWallHyd.MeterExchange

sprinklerSystemConsumption

Double

Nein

Zählertausch

Löschwasserbedarf Sprinkleranlage

DemandSprinkler.MeterExchange

aboveGroundHydrantConsumption

Double