Auto Light Dark
Auto Light Dark
German English

getCustomer

ag.itc.getCustomer

Geschäftspartnerinformationen abrufen

Beim Aufruf von getCustomer wird zudem das Datum der letzten Anmeldung (LastLogin.C12PORTALLOG) des Kundenkontos im Portal auf dem zugehörigen Portal-Login-Datensatz des Kunden auf das aktuelle Datum aktualisiert.

Request

JSON-Attribut

Datentyp

Pflicht

Anmerkungen

Entität

Feldname

Feldname intern

Anmerkungen

contactID

String(250)

Nein

AnsprechpartnerID

 Ansprechpartner

Primärschlüssel

Pk.ContactPerson

Pk.ContactPerson aus ag.itc.checkRegistration/registrationState

customerPk

String(250)

Ja*

Es muss entweder der customerPk oder die customerNo übergeben werden

Geschäftspartner

Primärschlüssel

Pk.Customer


customerNo

String(250)

Ja*

ERP-GP-Nummer

ERP GP-Nr.

CustomerNo2.Customer


rolle

String(20)

Ja

Schlüsselliste mit [INSTALLATEUR, SOLARTEUR, KUNDE]

  • SOLARTEUR: Entspricht der Registrierung Solarteur

  • KUNDE: Entspricht der Registrierung Anlagenbetreiber, Anschlussnehmer und 2026.2 Auftraggeber

  • INSTALLATEUR: Entspricht Registrierung Installateur





fullData 2026.6

Boolean

Nein

Gibt an, ob die vollen Daten inklusive Vertragsdaten geladen werden sollen oder nicht

  • Wird nichts mitgegeben oder der Parameter mit true übergeben, wird wie bisher die vollständige Response zurückgeliefert (inkl. contexts und projects).

  • Wird der Parameter mit false übergeben, wird die reduzierte Response zurückgeliefert, die folgende Attribute beinhaltet

-

-

-


Beispiel
JSON
{
  "eventType" : "ag.itc.getCustomer",
  "payload" : {
    "customerPk": "InstallateurAGCu",
    "contactId" : "IngolfInhaberCoPe",
    "rolle" :   "INSTALLATEUR",
    "fullData" : true
  }
}

Response

JSON-Attribut

Datentyp

Pflicht

Anmerkungen

Entität

Feldname

Feldname intern

Anmerkungen

customerProfile

@customerProfile

Ja

Muss enthalten sein, wenn ein Kundendatensatz gefunden wurde

Geschäftspartner

 

 

 

customerAddress

@address

Ja

Standard Kundenadresse

Adressen 

 

 

 

contactProfile

@contactProfile

Ja

Ansprechpartnerinformationen

Ansprechpartner




contractContexts

List<@contractContext>

Nein

Liste von Vertrags-Kontexten




Wird nicht zurückgeliefert, wenn fullData == false übergeben wurde

projects

List<@project>

Nein

Liste von Projekten zum Geschäftspartner

Projekte



Attribut rolle=KUNDE:
Alle Projekte zum GP mit der Projektrolle=ANLAGENBETREIBER ODER ANSCHLUSSNEHMER.

Attribut rolle=SOLARTEUR:
Alle Projekte zum GP mit der Projektrolle=AUFTRAGGEBER

Attribute rolle=INSTALLATEUR:
Alle Projekte zum GP mit der Projektrolle=INSTALLATEUR

Im Standard keine weiteren Einschränkung über z.B. Status oder Zeitraum. Einschränkung erfolgt individuell im Projekt. Filterung erfolgt im Projekt.

verificationProject 2026.6

List<@verificationProject>

Nein

Liste von Zulassungsprojekten zum Geschäftspartner

Projekte



Wird zurückgeliefert, wenn fullData == false im Request übergeben wurde

Beispiel
JSON
{
    "id": "fvvvvvvrjtrt61k5hc9q15EvAr",
    "status": "DONE",
    "payload": {
        "duration": 1247,
        "installer": {
            "customerAddress": {
                "country": "DE",
                "coName1": "",
                "houseNoAffix": "",
                "city": "Gießen",
                "street": "Friedrich-List-Straße",
                "postalCode": "35398",
                "district": "",
                "houseNo": "31"
            },
            "customerProfile": {
                "phoneNoExt": "",
                "mobileNoCountry": "",
                "codeValidUntil": null,
                "faxNoCountry": "",
                "mobileNoBase": "",
                "faxNoCity": "",
                "customerType": "Unternehmen",
                "phoneNoCountry": "+49",
                "abrNo": "",
                "checkedEnterprise": true,
                "isLegitimized": false,
                "email": "info-installteur@example.com",
                "mobileNoExt": "",
                "website": "",
                "phoneNoCity": "6151",
                "mobileNoCity": "",
                "legalForm": "GMBH",
                "enterpriseType": "HAUPTB",
                "name3": "",
                "registryCourt": "",
                "codeRetryCount": null,
                "registryNumber": "",
                "faxNoBase": "",
                "pk": "InstallateurAGCu",
                "faxNoExt": "",
                "name2": "GmbH",
                "phoneNoBase": "7714456",
                "name1": "Installateur AG",
                "customerNo": "ERP-007"
            },
            "contactProfile": [
                {
                    "birthday": "1965-04-30T23:00:00+00:00",
                    "mobileNoExt": "",
                    "phoneNoExt": "",
                    "letterSalutation": "Sehr geehrter Herr Inhaber",
                    "phoneNoCity": "6151",
                    "mobileNoCity": "173",
                    "title": "",
                    "mobileNoCountry": "+49",
                    "faxNoCountry": "",
                    "mobileNoBase": "266530656",
                    "faxNoCity": "",
                    "optIns": [],
                    "customerType": "Mann",
                    "phoneNoCountry": "+49",
                    "isOwner": true,
                    "faxNoBase": "",
                    "customerPk": "InstallateurAGCu",
                    "pk": "IngolfInhaberCoPe",
                    "salutation": "Herrn Ingolf Inhaber",
                    "faxNoExt": "",
                    "name2": "Ingolf",
                    "phoneNoBase": "321456987",
                    "name1": "Inhaber",
                    "email": "ingolf.inhaber@example.com"
                },
                {
                    ...
                }
            ],
            "installerDetail": [
                {
                    "qualification": "ELINS",
                    "admissionNo": "30004",
                    "contractType": "VERTRAG",
                    "validyDate": "2030-06-29T22:00:00+00:00",
                    "homeGridOperator": "",
                    "mediaType": "POWER",
                    "masterDate": "2020-06-14T22:00:00+00:00"
                },
                {
                    ...
                },
                {
                    ...
                }
            ]
        },
        "contractContexts": []
    }
}