uploadDocument

ag.itc.uploadDocument

Hochladen eines Dokuments zu einem Kunden bzw. einem Projekt, einer Messeinrichtung, einem Abrechnungsvertrag oder Vertragskonto unter Angabe der jeweiligen Nummer.

Request

JSON-Attribut

Datentyp

Pflicht

Anmerkungen

Entität

Feldname

Feldname intern

Anmerkungen

customerNo

String(250)

Nein


Geschäftspartner

Kundennummer

CustomerNo2.Customer


document

String

Ja


Dokumente



Das base64-codierte Dokument muss übergeben werden

projectNo

String(250)

Nein


Projekte

Projektnummer

Projectno.Project

Verknüpft das Dokument mit dem Projekt zur übergebenen Projektnummer

meterNo

String(250)

Nein


Messeinrichtungen

Zählernummer

MeterNo.MeasuringDevice

Verknüpft das Dokument mit der übergebenen Messeinrichtung zur übergebenen Zählernummer

contractNo

String(250)

Nein


Abrechnungsverträge

Vertragsnummer

ContractNo.BillingContract

Verknüpft das Dokument mit dem Abrechnungsvertrag zur übergebenen Vertragsnummer

contractAccountNo

String(250)

Nein


Vertragskonten

Vertragskontonummer

ContractAccountNo.ContractAccount

Verknüpft das Dokument mit dem Vertragskonto zur übergebenen Vertragskontonummer

documentType

String(40)

Nein


Dokument

Dokumenttyp/Kategorie

DocumentCategoryKey.Document

Mögliche Schlüssel:

  • EZ4110: Einheitenzertifikat nach 4110

  • EZ4105: Einheitenzertifikat nach 4105

  • ALP: Amtlicher Liegenschaftsplan

  • VM: Vollmacht

  • SLD: Single-line-Diagramm bzw. Übersichtsschaltplan

  • DPV: Datenblatt PV-Module

  • EZNA: Einheitenzertifikat NA-Schutz

  • NZB30: Netzzusage < 30 kVA

  • NZA30: Netzzusage > 30 kVA

  • DNVP: Datenblatt Netzverträglichkeitsprüfung

  • ABTRANZ: Abtretungsanzeige

  • ZUSAMMENFASSUNG: Zusammenfassung aus Kundenportal

  • EIBPV: Erklärung zur Inbetriebnahme PV Anlage

  • E8_4105: E.8 Dokument 4105

  • EZSP: Einheitenzertifikat Speicher

documentName

String(250)

Ja

Dateiname inkl. Dateityp z.B. Angebot.pdf, Kalkulation.xlsx

Dokument

Dokumentenname

ShortAbstract.Document


deviceRefNo

String(255)

Nein


Geräte

Externe Referenznummer

ExtRefNo.Device

warning Wird aktuell nicht verwendet, es erfolgt eine Umstellung auf die Energieverbraucher

Wird ein Gerätedatensatz mit der übergebenen Referenznummer gefunden, wird das hochgeladene Dokument mit dem entsprechenden Gerätedatensatz verknüpft.

Im Fehlerfall (= kein Gerätedatensatz mit der übergebenen Referenznummer gefunden):

  • Das Dokument wird dennoch in TINA angelegt, besitzt allerdings keine Verknüpfung

  • Das Portal erhält die Meldung zurück, dass kein Gerätedatensatz mit der Referenznummer <deviceRefNo> gefunden werden konnte.