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

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(250)

Ja

Abrechnungsverträge

Vertrags-Nr.

Vertrag.BillingContract

mediaType

String(250)

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

Anlagenkonten

Messmethode

MeasuringMethod.C12INSTACC

installation

@installation

Ja

Anlagenkonten

Anlage

InstallationPk.C12INSTACC

budgetBillingPlan

List<@budgetBillingPlan>

Ja

Abschlagspläne

Aktueller Abschlagsplan via Abrechnungsvertrag

energyDirection

String(250)

Nein

Anlagen

Energierichtung

EnergyDirection.Installation

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

serviceType

String(255)

Nein

Anlagen

Serviceart (IS-U)

ISU_ServArt

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

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

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

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

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

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

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

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

Datentp

Pflicht

Entität

Feldname

Interner Feldname

obis

String

Ja

Ableseaufträge

OBIS

OBIS.C12METERREADORD

maxValue

Double

Ja

Ableseaufträge

Größter erwarteter Wert

MaximumValue.C12METERREADORD

minValue

Double

Ja

Ableseaufträge

Kleinster erwarteter Wert

MinimumValue.C12METERREADORD

reason

String

Ja

Ableseaufträge

Ablesegrund

ReadingReason.C12METERREADORD

orderId

String

Ja

Ableseaufträge

ID

OrderId.C12METERREADORD

validFrom

Date

Ja

Ableseaufträge

Gültig von

ValidFrom.C12METERREADORD

validTo

Date

Ja

Ableseaufträge

Gültig bis

ValidTo.C12METERREADORD

readingDateMax

Date

Ja

Ableseaufträge

Maximales Ablesedatum

ReadingDateMax.C12METERREADORD

readingDateMin

Date

Ja

Ableseaufträge

Minimales Ablesedatumj

ReadingDateMin.C12METERREADORD

decimalCount

Integer

Nein

Ableseaufträge

Anzahl der Nachkommastellen

DecimalCount.C12METERREADORD

JSON-Attribut

Datentp

Pflicht

Anmerkung

Entität

Feldname

Interner Feldname

obis

String(250)

Ja

OBIS-Code des Zählwerks der Ablesung

Zählwerk

ZW-Nummer

CODE.C12OPCOUNTER

readingDate

Date

Ja

Ablesedatum

Zählerstände

Ablesedatum

ReadingDate.C12METERREAD

value

String

Ja

Ablesewert

Zählerstände

Zählerstand

ReadingAmount.C12METERREAD

unit

String

Ja

Einheit

Zählwerk

Ablesemaßeinheit

Unit.C12OPCOUNTER

type

String

Ja

Ablesegrund

Zählerstände

Ablesegrund

ReadingReason.C12METERREAD

decimalCount

Double

Ja

Nachkommastellen

Zählwerk

Nachkommastellen

PostDecimal.C12OPCOUNTER

preDecimalCount

Double

Ja

Vorkommastellen

Zählwerk

Vorkommastellen

PreDecimal.C12OPCOUNTER

factor

Double

Nein

Wandlerfaktor

Zählerstände

Faktor

Factor.C12METERREAD

consumption

Double

Nein

Verbrauch

Zählerstände

Verbrauch

Consumption.C12METERREAD

readingMethod

String

Nein

Ableseart

Zählerstände

Ableseart

ReadingByType.C12METERREAD

JSON-Attribut

Datentp

Pflicht

Anmerkungen

Entität

Feldname

Interner Feldname

category

String (50)

Ja

OptIn (Consent)

Kategorie

Channel.OptIn

informationType

String (50)

Nein

OptIn (Consent)

Informationsart

InfoType.OptIn

optInState

String (50)

Ja

[ABLEHNUNG, ZUSTIMMUNG]

OptIn (Consent)

Genehmigungsstatus

ApprovalStatus.OptIn

optInDate

Datum

-

Wird nicht übertragen, sondern mit dem aktuellen Datum gesetzt

OptIn (Consent)

Genehmigungsdatum

ApprovalDate.OptIn

optInPk

String (100)

Nein

OptIn (Consent)

Primärschlüssel

Pk.OptIn

JSON-Attribut

Datentp

Pflicht

Anmerkungen

Entität

Feldname

Interner Feldname

productPk

String(50)

Nein

Produkte

Produkt-PK

Pk.Product

productNo

String(100)

Nein

Produkte

Produkt-Nr.

ProdMatchCode.Product

productName

String(100)

Nein

Produkte

Bezeichnung

PrdName.Product

productType

String(50)

Nein

Schlüssel [WECHSELRICHTER, PV-MODUL, SPEICHER, NA-SCHUTZ, WÄRMEPUMPE, PUFFERSPEICHER, FRISCHWASSER]

Produkte

Produktgruppe

ProdGrpKey.Product

customerProfile

@customerProfile

Nein

Über Pk.Customer

Produkte

Hersteller

ManufacturerKey.Product

modulePower

Zahl

Nein

Produkte

Modulleistung

C12ModulePower.Product

activePower

Zahl

Nein

Produkte

Wirkleistung

C12EffectivePow.Product

apparentPower

Zahl

Nein

Produkte

Scheinleistung

C12ApparentPow.Product

powerStorageCapacity

Zahl

Nein

Produkte

Speicherkapazität

C12StorageCapac.Product

JSON-Attribut

Datentp

Pflicht

Anmerkungen

Entität

Feldname

Interner Feldname

Anmerkungen

mediaType

String(50)

Ja

Fest POWER, siehe ag.itc.getInstaller.mediatype
mögliche Schlüssel im Portal [POWER, GAS, HEAT]
Die folgenden Schlüssel werden derzeit noch nicht im Portal verwendet:
[PV, SP, E-M, BHKW] 

Projekte

Sparte

C12Medium.Project

orderTypeKey

String(250)

Ja

Mögliche Schlüssel

• EA (Erzeugungsanlage)

Projekte

Projektart

TypeKey.Project

orderTypeKeyDetail

String(250)

Ja

Mögliche Schlüssel [NEU, AEND]:

• NEU (Neuanlage)

• AEND (Änderung)

Projekte

Projektart-Detail

C12TypeKeyDet.Project

projectNo

String(250)

Nein

Wenn Projektnummer vorhanden ist, keine Pflichtfelder, Projekt wird aktualisiert, sonst erfolgt die Neuanlage des Projekts

Projekte

Projekt-Nr.

Projectno.Project

projectStatusKey

String(250)

Nein

Projektstatus, Wertemenge TINA
Bei Neuanlage: 10 (Auftrag eingegangen),
Bei Rückgabe/Überarbeitung des Antrags durch den Kunden erfolgt Wechsel in Status 40 (Auftrag nachgebessert)

Projekte

Status

ProjectstatusKey.Project

feedInPayment

Boolean

Ja

true: Anmeldung Einspeisevergütung

false: sonst akt. Anmeldung Eigenerzeugungs-Anlage

Projekte

Einspeisevergütung beantragt

C12FeedInPaymAp.Project

locations

List<@location>

Ja*

Anschlussobjektdaten
Anschlussobjekt (AO) mit Projekt verküpfen.
Aktuell wird immer nur ein Anschussobjekt vom Portal geliefert. Es wurde der Typ Liste definiert, damit dies ggf. später erweitert werden kann.

Anschlussobjekte

projectParties

List<@projectParty>

Ja*

Geschäftspartner, Adressen, Ansprechpartner

Sonderfall Geschäftspartner-Identifizierung nicht abgeschlossen:
Wenn C12IdentCuCompl.Project = false, wird das Objekt projectParties (Liste) aus dem Zeitereignis zum Projekt C12EventArchive.Project für getCustomer an das Portal zurück gegeben

installer

@Installer

Nein

Der Geschäftspartner der Projektrolle INSTALLATEUR wire bei getCustomer aus TINA bereitgestellt. Bei createGeneratingUnit wird diese an TINA übertragen.

Installationsverzeichnis

meterNo

String(250)

Nein

Zählernummer

Projekte

Messeinrichtung (Zählernr.)

C12MeDePk.Project → MeterNo.MeasuringDevice

activities

List<@activity>

Nein

Portal → TINA:
Wenn pk leer, neue Aktivität erzeugen (Details siehe Object activity).
Die Aktivitäten werden nicht über diese Liste aktualisiert, sondern nur neu angelegt (pro Aufruf createGeneratingUnit eine).

TINA → Portal:
Liste von allen verknüpften Aktivitäten zum TINA-Projekt mit der Art PORTAL-ACT.

Aktivitäten

JSON-Attribut

Datentp

Pflicht

Anmerkungen

Entität

Feldname

Interner Feldname

type

Ja

[ANSCHLUSSNEHMER, ANLAGENBETREIBER, AUFTRAGGEBER]
Weiter Rollen:

• ANSCHLUSSNEHMER_MASTR

• KONTOINHABER

• EINSATZVERANTWORTLICHER

• BETREIBER

• RECHNUNGSEMPFAENGER

Diese werden nur im JSON gehalten und nicht nach TINA geschrieben

-

-

-

customerProfile

@customerProfile

Ja

Geschäftspartner

-

-

addresse

@address

Ja

Postadresse zum jeweiligen Geschäftspartner

-

-

contactProfile

@contactProfile

Nein

Ansprechpartner

-

-

JSON-Attribut

Datentp

Pflicht

Anmerkungen

Entität

Feldname

Interner Feldname

Anmerkungen

marketPartnerId

String(255)

Marktpartner-ID aus MaStR
für:

• Einsatzverantwortlicher (EIV) der TR

• Betreiber (BTR) der TR

Serviceprovider

BDEW/VDEW

BDEW_CODENUMMER.C12SERVPROV

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