Export der Partner-Kontaktdaten über die PKS Backend REST-API

Das PKS Backend stellt (seit dem Release aus Ende April 2023) REST Endpunkte zum Export der aktuellen PARTIN Partner-Kontaktdaten zur Verfügung. Diese können auch über die Swagger-UI des PKS Backends aufgerufen werden, welche üblicherweise unter der URL http://<PKS-Backend-URL>/pks/swagger-ui.html erreichbar ist.

Dabei werden drei Endpunkte unter zum Partner-Datenexport bereitgestellt:

  • GET /partner/data zum Abruf aller aktuell gültigen Kontaktdaten aller Partner im json-Format
  • GET /partner/data/{partnerIln} zum Abruf aller aktuell gültigen Kontaktdaten eines bestimmten Partners im json-Format
  • GET /partner/data-csv zum Abruf aller aktuell gültigen Kontaktdaten aller Partner im CSV-Format.

Der CSV Export kann zudem über den Listen-Typ Parameter ‘partnerDataColumnsFilter’ auf bestimmte Spalten eingeschränkt werden. Hierzu können aus der folgenden Liste der Partner-Kontaktdaten aus der PARTIN ensprechende Spaltennamen angegeben werden:

Mögliche Spalten-Namen als Parameter zur Filterung im CSV Download (zum Aufklappen klicken) partnerName
iln
registrar
marketRole
marketSection
currentDataValidityStartDate
futureDataValidityStartDate
generalCompanyData.taxId
generalCompanyData.companyTaxNumber
generalCompanyData.website
generalCompanyData.fax
generalCompanyData.marketCommunicationMail
generalCompanyData.mailCertificateDownloadLink
generalCompanyData.companyAddress.street
generalCompanyData.companyAddress.postalCode
generalCompanyData.companyAddress.location
generalCompanyData.companyAddress.country
generalCompanyData.commercialRegister.registerCourt
generalCompanyData.commercialRegister.commercialRegisterNumber
generalCompanyData.senderContact.contactPerson
generalCompanyData.senderContact.communicationLinks.MAIL
generalCompanyData.senderContact.communicationLinks.FAX
generalCompanyData.senderContact.communicationLinks.TELEFON
generalCompanyData.senderContact.communicationLinks.HANDY
generalCompanyData.availabilities.MONDAY
generalCompanyData.availabilities.TUESDAY
generalCompanyData.availabilities.WEDNESDAY
generalCompanyData.availabilities.THURSDAY
generalCompanyData.availabilities.FRIDAY
generalCompanyData.availabilities.LUNCH
bankDetails.iban
bankDetails.accountOwner
bankDetails.bic
bankDetails.creditInstitute
contacts.UEBERTRAGUNGSWEG_DATENAUSTAUSCH.companyName
contacts.RAHMENVERTRAEGE.companyName
contacts.KUENDIGUNGSPROZESSE.companyName
contacts.WECHSELPROZESSE.companyName
contacts.STAMMDATENPROZESSE.companyName
contacts.EINSPEISEPROZESSE.companyName
contacts.ABRECHNUNGSPROZESSE.companyName
contacts.MMMA_PROZESSE.companyName
contacts.BEWEGUNGSDATEN.companyName
contacts.ANSCHLUSSNUTZUNGSPROZESSE.companyName
contacts.BILANZIERUNGSPROZESSE.companyName
contacts.TECHNISCHER_NETZANSCHLUSS.companyName
contacts.UEBERTRAGUNGSWEG_DATENAUSTAUSCH.address.street
contacts.UEBERTRAGUNGSWEG_DATENAUSTAUSCH.address.postalCode
contacts.UEBERTRAGUNGSWEG_DATENAUSTAUSCH.address.location
contacts.UEBERTRAGUNGSWEG_DATENAUSTAUSCH.address.country
contacts.RAHMENVERTRAEGE.address.street
contacts.RAHMENVERTRAEGE.address.postalCode
contacts.RAHMENVERTRAEGE.address.location
contacts.RAHMENVERTRAEGE.address.country
contacts.KUENDIGUNGSPROZESSE.address.street
contacts.KUENDIGUNGSPROZESSE.address.postalCode
contacts.KUENDIGUNGSPROZESSE.address.location
contacts.KUENDIGUNGSPROZESSE.address.country
contacts.WECHSELPROZESSE.address.street
contacts.WECHSELPROZESSE.address.postalCode
contacts.WECHSELPROZESSE.address.location
contacts.WECHSELPROZESSE.address.country
contacts.STAMMDATENPROZESSE.address.street
contacts.STAMMDATENPROZESSE.address.postalCode
contacts.STAMMDATENPROZESSE.address.location
contacts.STAMMDATENPROZESSE.address.country
contacts.EINSPEISEPROZESSE.address.street
contacts.EINSPEISEPROZESSE.address.postalCode
contacts.EINSPEISEPROZESSE.address.location
contacts.EINSPEISEPROZESSE.address.country
contacts.ABRECHNUNGSPROZESSE.address.street
contacts.ABRECHNUNGSPROZESSE.address.postalCode
contacts.ABRECHNUNGSPROZESSE.address.location
contacts.ABRECHNUNGSPROZESSE.address.country
contacts.MMMA_PROZESSE.address.street
contacts.MMMA_PROZESSE.address.postalCode
contacts.MMMA_PROZESSE.address.location
contacts.MMMA_PROZESSE.address.country
contacts.BEWEGUNGSDATEN.address.street
contacts.BEWEGUNGSDATEN.address.postalCode
contacts.BEWEGUNGSDATEN.address.location
contacts.BEWEGUNGSDATEN.address.country
contacts.ANSCHLUSSNUTZUNGSPROZESSE.address.street
contacts.ANSCHLUSSNUTZUNGSPROZESSE.address.postalCode
contacts.ANSCHLUSSNUTZUNGSPROZESSE.address.location
contacts.ANSCHLUSSNUTZUNGSPROZESSE.address.country
contacts.BILANZIERUNGSPROZESSE.address.street
contacts.BILANZIERUNGSPROZESSE.address.postalCode
contacts.BILANZIERUNGSPROZESSE.address.location
contacts.BILANZIERUNGSPROZESSE.address.country
contacts.TECHNISCHER_NETZANSCHLUSS.address.street
contacts.TECHNISCHER_NETZANSCHLUSS.address.postalCode
contacts.TECHNISCHER_NETZANSCHLUSS.address.location
contacts.TECHNISCHER_NETZANSCHLUSS.address.country
contacts.UEBERTRAGUNGSWEG_DATENAUSTAUSCH.details.contactPerson
contacts.RAHMENVERTRAEGE.details.contactPerson
contacts.KUENDIGUNGSPROZESSE.details.contactPerson
contacts.WECHSELPROZESSE.details.contactPerson
contacts.STAMMDATENPROZESSE.details.contactPerson
contacts.EINSPEISEPROZESSE.details.contactPerson
contacts.ABRECHNUNGSPROZESSE.details.contactPerson
contacts.MMMA_PROZESSE.details.contactPerson
contacts.BEWEGUNGSDATEN.details.contactPerson
contacts.ANSCHLUSSNUTZUNGSPROZESSE.details.contactPerson
contacts.BILANZIERUNGSPROZESSE.details.contactPerson
contacts.TECHNISCHER_NETZANSCHLUSS.details.contactPerson
contacts.UEBERTRAGUNGSWEG_DATENAUSTAUSCH.details.communicationLinks.MAIL
contacts.UEBERTRAGUNGSWEG_DATENAUSTAUSCH.details.communicationLinks.FAX
contacts.UEBERTRAGUNGSWEG_DATENAUSTAUSCH.details.communicationLinks.TELEFON
contacts.UEBERTRAGUNGSWEG_DATENAUSTAUSCH.details.communicationLinks.HANDY
contacts.RAHMENVERTRAEGE.details.communicationLinks.MAIL
contacts.RAHMENVERTRAEGE.details.communicationLinks.FAX
contacts.RAHMENVERTRAEGE.details.communicationLinks.TELEFON
contacts.RAHMENVERTRAEGE.details.communicationLinks.HANDY
contacts.KUENDIGUNGSPROZESSE.details.communicationLinks.MAIL
contacts.KUENDIGUNGSPROZESSE.details.communicationLinks.FAX
contacts.KUENDIGUNGSPROZESSE.details.communicationLinks.TELEFON
contacts.KUENDIGUNGSPROZESSE.details.communicationLinks.HANDY
contacts.WECHSELPROZESSE.details.communicationLinks.MAIL
contacts.WECHSELPROZESSE.details.communicationLinks.FAX
contacts.WECHSELPROZESSE.details.communicationLinks.TELEFON
contacts.WECHSELPROZESSE.details.communicationLinks.HANDY
contacts.STAMMDATENPROZESSE.details.communicationLinks.MAIL
contacts.STAMMDATENPROZESSE.details.communicationLinks.FAX
contacts.STAMMDATENPROZESSE.details.communicationLinks.TELEFON
contacts.STAMMDATENPROZESSE.details.communicationLinks.HANDY
contacts.EINSPEISEPROZESSE.details.communicationLinks.MAIL
contacts.EINSPEISEPROZESSE.details.communicationLinks.FAX
contacts.EINSPEISEPROZESSE.details.communicationLinks.TELEFON
contacts.EINSPEISEPROZESSE.details.communicationLinks.HANDY
contacts.ABRECHNUNGSPROZESSE.details.communicationLinks.MAIL
contacts.ABRECHNUNGSPROZESSE.details.communicationLinks.FAX
contacts.ABRECHNUNGSPROZESSE.details.communicationLinks.TELEFON
contacts.ABRECHNUNGSPROZESSE.details.communicationLinks.HANDY
contacts.MMMA_PROZESSE.details.communicationLinks.MAIL
contacts.MMMA_PROZESSE.details.communicationLinks.FAX
contacts.MMMA_PROZESSE.details.communicationLinks.TELEFON
contacts.MMMA_PROZESSE.details.communicationLinks.HANDY
contacts.BEWEGUNGSDATEN.details.communicationLinks.MAIL
contacts.BEWEGUNGSDATEN.details.communicationLinks.FAX
contacts.BEWEGUNGSDATEN.details.communicationLinks.TELEFON
contacts.BEWEGUNGSDATEN.details.communicationLinks.HANDY
contacts.ANSCHLUSSNUTZUNGSPROZESSE.details.communicationLinks.MAIL
contacts.ANSCHLUSSNUTZUNGSPROZESSE.details.communicationLinks.FAX
contacts.ANSCHLUSSNUTZUNGSPROZESSE.details.communicationLinks.TELEFON
contacts.ANSCHLUSSNUTZUNGSPROZESSE.details.communicationLinks.HANDY
contacts.BILANZIERUNGSPROZESSE.details.communicationLinks.MAIL
contacts.BILANZIERUNGSPROZESSE.details.communicationLinks.FAX
contacts.BILANZIERUNGSPROZESSE.details.communicationLinks.TELEFON
contacts.BILANZIERUNGSPROZESSE.details.communicationLinks.HANDY
contacts.TECHNISCHER_NETZANSCHLUSS.details.communicationLinks.MAIL
contacts.TECHNISCHER_NETZANSCHLUSS.details.communicationLinks.FAX
contacts.TECHNISCHER_NETZANSCHLUSS.details.communicationLinks.TELEFON
contacts.TECHNISCHER_NETZANSCHLUSS.details.communicationLinks.HANDY
as4.validFrom
as4.certificateIssuer
as4.certificateSubject
as4.senderContact.contactPerson
as4.senderContact.communicationLinks.MAIL
as4.senderContact.communicationLinks.FAX
as4.senderContact.communicationLinks.TELEFON
as4.senderContact.communicationLinks.HANDY

Hinweis: Aktuell ist dieses Feature nur im PKS Backend implementiert. Wir stellen die Funktionalität auf Anfrage aber auch gerne über die PKS-UI bereit.

View Me   Edit Me