ADP Employee Self-Service (Vorschau)
ADP Employee Self-Service bringt die Leistungsfähigkeit der Personal- und Gehaltsabrechnungskompetenz von ADP direkt in Ihren Workflow ein, sodass Mitarbeiter Antworten erhalten und nahtlos Maßnahmen ergreifen können. Dieser Connector hilft Agenten und Mitarbeitern, schnell auf HR- und Lohnbuchhaltungsinformationen zuzugreifen, ohne ihre täglichen Tools zu verlassen.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Standard | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: - Azure Government Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | ADP-Unterstützung |
| URL | https://www.adp.com/contact-us.aspx |
| support@adp.com |
| Connectormetadaten | |
|---|---|
| Herausgeber | ADP, Inc. |
| Website | https://www.adp.com |
| Datenschutzrichtlinie | https://www.adp.com/privacy.aspx |
| Kategorien | Personalabteilung; Produktivität |
ADP Mitarbeiter-Selbstbedienung
- Hinweis: Dieser Connector ist für die Verwendung mit dem Microsoft Employee Self-Service (ESS)-Agent vorgesehen und ist für ESS-Szenarien optimiert. Die Verwendung dieses Connectors außerhalb der ESS-Agent-Oberfläche wird nicht empfohlen.
ADP Employee Self-Service bringt die Leistungsfähigkeit der Personal- und Gehaltsabrechnungskompetenz von ADP direkt in Ihren Workflow ein, sodass Mitarbeiter Antworten erhalten und nahtlos Maßnahmen ergreifen können. Dieser Connector hilft Agenten und Mitarbeitern, schnell auf HR- und Lohnbuchhaltungsinformationen zuzugreifen, ohne ihre täglichen Tools zu verlassen.
Publisher: ADP, Inc.
Voraussetzungen
- Ein unterstütztes Abonnement für ein ADP-Produkt (z. B. Mitarbeiter jetzt, Mitarbeiter jetzt nächste Generation).
- Globale Administratorrechte, um der Azure Unternehmensanwendung in Ihrem Mandanten zuzustimmen.
Unterstützte Vorgänge
Der Connector unterstützt die folgenden Vorgänge:
-
create-emergency-contact: Erstellt einen neuen Notfallkontakteintrag für den Mitarbeiter. Verwenden Sie dies, wenn ein Mitarbeiter eine Person hinzufügen möchte, die im Notfall kontaktiert werden soll, einschließlich der Kontaktinformationen und der Beziehung. -
delete-emergency-contacts: Entfernt Notfallkontakte aus dem Profil des Mitarbeiters. Verwenden Sie dies, wenn ein Notfallkontakt nicht mehr benötigt oder relevant ist. -
get-emergency-contacts: Ruft eine Liste aller Notfallkontakte ab, die für den Mitarbeiter konfiguriert sind. Verwenden Sie diese Option, um vorhandene Notfallkontaktinformationen anzuzeigen oder zu überprüfen, ob Kontakte aktualisiert werden müssen. -
update-emergency-contact: Aktualisiert die Informationen eines vorhandenen Notfallkontakts für den Mitarbeiter. Verwenden Sie diese Vorgehensweise, wenn Kontaktdetails, Adresse oder Beziehungsinformationen geändert werden müssen. -
get-pay-distributions: Gibt die Liste aller aktiven Einlagen (bis zum aktuellen Gültigkeitsdatum) für einen Mitarbeiter zurück. Standardmäßig sind Kontonummer und Routingnummer in der Antwort der Direct Deposit API maskiert. -
get-pay-statements: Fordert die Liste der letzten 5 clientspezifischen Zahlungsanweisungen für einen Geschäftspartner an. -
get-worker: Ruft die vollständigen Mitarbeiterprofilinformationen von WorkforceNow ab, einschließlich persönlicher Details, Kontaktinformationen und Beschäftigungsdaten. Verwenden Sie diese Informationen, um aktuelle Mitarbeiterinformationen anzuzeigen. -
update-profile: Aktualisiert die Mitarbeiterprofilinformationen in WorkforceNow, einschließlich persönlicher Details und Kontaktinformationen. Verwenden Sie diese Funktion, um vorhandene Mitarbeiterinformationen zu ändern.
Abrufen von Anmeldeinformationen
Wenn die Organisation, in der Sie sich befinden, Microsoft als Identitätsanbieter für ADP-Produkte zugewiesen hat, ist die Anmeldung mit Ihrem Microsoft-Konto alle Anmeldevorgänge, die Sie ausführen müssen. Wenn Sie nicht Teil einer Verbundkonfiguration sind, müssen Sie sich bei Microsoft anmelden und dann zur ADP-Anmeldeseite umgeleitet werden, um sich mit Ihren ADP-Anmeldeinformationen anzumelden.
Getting Started
- Fügen Sie den Self-Service-Connector für ADP-Mitarbeiter zu Ihrem Copilot hinzu, und veröffentlichen Sie ihn.
- Starten Sie mithilfe eines veröffentlichten Kanals jede Unterhaltung, und werden Sie aufgefordert, eine Verbindung zu erstellen.
- Melden Sie sich mit Ihrer Entra-ID (und der ADP-Anmeldung nach dem Nichtverbund) an.
- Definiert in Ihrem Copilot sollten die Connectoraktionen beginnen, ihre Anmeldung für den Zugriff auf Ihre Daten zu verwenden.
Bekannte Probleme und Einschränkungen
- Rate limiting: Requests are pooled per organization: 780 requests/minute, with a maximum of 50 concurrent requests.
Bereitstellungsanweisungen
Fügen Sie der Lösung den Verbinder hinzu, oder stellen Sie eine einzelne Verbindung mit dem Verbinder dar. Wenn diese App zum ersten Mal verwendet wird, werden Sie aufgefordert, dieser App als Administrator für Ihren Mandanten zuzustimmen. Nach der Zustimmung sind keine weiteren Schritte erforderlich.
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| Abrufen von Notfallkontakten |
Ruft eine Liste aller Notfallkontakte ab, die für den Mitarbeiter konfiguriert sind. Verwenden Sie diese Option, um vorhandene Notfallkontaktinformationen anzuzeigen oder zu überprüfen, ob Kontakte aktualisiert werden müssen. |
| Aktualisieren des Mitarbeiterprofils |
Aktualisiert die Mitarbeiterprofilinformationen in WorkforceNow, einschließlich persönlicher Details und Kontaktinformationen. Verwenden Sie diese Funktion, um vorhandene Mitarbeiterinformationen zu ändern. |
| Aktualisieren des Notfallkontakts |
Aktualisiert die Informationen eines vorhandenen Notfallkontakts für den Mitarbeiter. Verwenden Sie diese Vorgehensweise, wenn Kontaktdetails, Adresse oder Beziehungsinformationen geändert werden müssen. |
| Arbeitsprofil abrufen |
Ruft die vollständigen Mitarbeiterprofilinformationen von WorkforceNow ab, einschließlich persönlicher Details, Kontaktinformationen und Beschäftigungsdaten. Verwenden Sie diese Informationen, um aktuelle Mitarbeiterinformationen anzuzeigen. |
| Direkte Einzahlungen erhalten |
Gibt die Liste aller aktiven Einlagen (bis zum aktuellen Gültigkeitsdatum) für einen Mitarbeiter zurück. Standardmäßig sind Kontonummer und Routingnummer in der Antwort der Direct Deposit API maskiert. |
| Entfernen von Notfallkontakten |
Entfernt Notfallkontakte aus dem Profil des Mitarbeiters. Verwenden Sie dies, wenn ein Notfallkontakt nicht mehr benötigt oder relevant ist. |
| Hinzufügen eines Notfallkontakts |
Erstellt einen neuen Notfallkontakteintrag für den Mitarbeiter. Verwenden Sie dies, wenn ein Mitarbeiter eine Person hinzufügen möchte, die im Notfall kontaktiert werden soll, einschließlich der Kontaktinformationen und der Beziehung. |
| Zahlungsauszüge abrufen |
Fordern Sie die Liste der letzten 5 clientspezifischen Zahlungsanweisungen für einen Geschäftspartner an. |
Abrufen von Notfallkontakten
Ruft eine Liste aller Notfallkontakte ab, die für den Mitarbeiter konfiguriert sind. Verwenden Sie diese Option, um vorhandene Notfallkontaktinformationen anzuzeigen oder zu überprüfen, ob Kontakte aktualisiert werden müssen.
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
result
|
result | array of object |
personalContacts |
|
itemId
|
result.itemId | string |
Die Element-ID des Kontakts |
|
contactName
|
result.contactName | string |
Name des Kontakts |
|
AdresseZeile1
|
result.addressLine1 | string |
Die erste Zeile in der Adresse des Kontakts |
|
AdresseZeile2
|
result.addressLine2 | string |
Die zweite Zeile in der Adresse des Kontakts |
|
AdresseZeile3
|
result.addressLine3 | string |
Die dritte Zeile in der Adresse des Kontakts |
|
addressCity
|
result.addressCity | string |
Die Stadt in der Adresse des Kontakts |
|
addressState
|
result.addressState | string |
Das Bundesland/die Provinz in der Adresse des Kontakts (verwenden Sie Postkürzel, oder dies wird ignoriert). |
|
addressCountry
|
result.addressCountry | string |
Das Land in der Adresse des Kontakts (verwenden Sie postspezifische Abkürzungen, oder dies wird ignoriert) |
|
addressPostalCode
|
result.addressPostalCode | string |
Der Postcode in der Adresse des Kontakts |
|
phones
|
result.phones | array of object |
phones |
|
phoneType
|
result.phones.phoneType | string |
Welche Art von Nummer ist dies für den Kontakt? |
|
countryCode
|
result.phones.countryCode | integer |
Die Ländervorwahl für die Telefonnummer (NANP-Regeln gelten) |
|
areaCode
|
result.phones.areaCode | integer |
Die Vorwahl für die Telefonnummer (NANP-Regeln gelten) |
|
Zahl
|
result.phones.number | integer |
Die Zeilennummer (NANP-Regeln gelten) |
|
Erweiterung
|
result.phones.extension | integer |
Erweiterungscode für diese Nummer |
|
E-Mails
|
result.emails | array of object |
E-Mails |
|
E-Mail-Adresse
|
result.emails.address | string |
E-Mail, die der Kontakt besitzt und Zugriff hat |
|
Beziehung
|
result.relation | string |
Beziehung des Kontakts zu der Person, die sie hinzufügt |
|
isPrimär
|
result.isPrimary | boolean |
Festlegen dieses Kontakts als primären Kontakt |
Aktualisieren des Mitarbeiterprofils
Aktualisiert die Mitarbeiterprofilinformationen in WorkforceNow, einschließlich persönlicher Details und Kontaktinformationen. Verwenden Sie diese Funktion, um vorhandene Mitarbeiterinformationen zu ändern.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
name
|
name | string |
Der bevorzugte Name des Mitarbeiters |
|
|
E-Mail
|
string |
Die persönliche E-Mail des Mitarbeiters |
||
|
mobileCountry
|
mobileCountry | string |
Die Mobilfunk-Ländervorwahl des Mitarbeiters |
|
|
mobileArea
|
mobileArea | string |
Die mobile Vorwahl des Mitarbeiters |
|
|
mobileNumber
|
mobileNumber | string |
Die Mobiltelefonnummer des Mitarbeiters |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
result
|
result | array of object |
Array von Aktualisierungsergebnissen für jeden Feldvorgang |
|
Nummerierung“
|
result.field | string |
Der Name des felds, das aktualisiert wurde (z. B. "email", "name", "mobile") |
|
Erfolgreich
|
result.success | boolean |
Ob die Feldaktualisierung erfolgreich war |
|
Fehler
|
result.error | string |
Fehlermeldung, wenn das Update fehlgeschlagen ist, leere Zeichenfolge bei erfolgreicher Ausführung |
Aktualisieren des Notfallkontakts
Aktualisiert die Informationen eines vorhandenen Notfallkontakts für den Mitarbeiter. Verwenden Sie diese Vorgehensweise, wenn Kontaktdetails, Adresse oder Beziehungsinformationen geändert werden müssen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
itemId
|
itemId | True | string |
Die Element-ID des zu entfernenden Kontakts (IDs, die aus getContacts gefunden wurden) |
|
contactName
|
contactName | True | string |
Name des Kontakts |
|
AdresseZeile1
|
addressLine1 | string |
Die erste Zeile in der Adresse des Kontakts |
|
|
AdresseZeile2
|
addressLine2 | string |
Die zweite Zeile in der Adresse des Kontakts |
|
|
AdresseZeile3
|
addressLine3 | string |
Die dritte Zeile in der Adresse des Kontakts |
|
|
addressCity
|
addressCity | string |
Die Stadt in der Adresse des Kontakts |
|
|
addressState
|
addressState | string |
Das Bundesland/die Provinz in der Adresse des Kontakts (verwenden Sie Postkürzel, oder dies wird ignoriert). |
|
|
addressCountry
|
addressCountry | string |
Das Land in der Adresse des Kontakts (verwenden Sie postspezifische Abkürzungen, oder dies wird ignoriert) |
|
|
addressPostalCode
|
addressPostalCode | string |
Der Postcode in der Adresse des Kontakts |
|
|
phoneType
|
phoneType | string |
Welche Art von Nummer ist dies für den Kontakt? |
|
|
countryCode
|
countryCode | integer |
Der Ländercode dieser Nummer (NANP-Regeln gelten) |
|
|
areaCode
|
areaCode | integer |
Die Vorwahl dieser Nummer (NANP-Regeln gelten) |
|
|
Zahl
|
number | integer |
Die Zeilennummer (NANP-Regeln gelten) |
|
|
Erweiterung
|
extension | integer |
Erweiterungscode für diese Nummer |
|
|
E-Mail-Adresse
|
address | string |
E-Mail, die der Kontakt besitzt und Zugriff hat |
|
|
Beziehung
|
relation | True | string |
Beziehung des Kontakts zu der Person, die sie hinzufügt |
|
isPrimär
|
isPrimary | True | boolean |
Festlegen dieses Kontakts als primären Kontakt |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Nachricht
|
result.message | string |
Die Statusmeldung des Aktualisierungsvorgangs |
Arbeitsprofil abrufen
Ruft die vollständigen Mitarbeiterprofilinformationen von WorkforceNow ab, einschließlich persönlicher Details, Kontaktinformationen und Beschäftigungsdaten. Verwenden Sie diese Informationen, um aktuelle Mitarbeiterinformationen anzuzeigen.
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
preferredName
|
result.preferredName | string |
Der bevorzugte Name des Mitarbeiters |
|
legalName
|
result.legalName | string |
Der rechtliche Name des Mitarbeiters |
|
personalEmail
|
result.personalEmail | string |
Die persönliche E-Mail des Mitarbeiters |
|
Mobil
|
result.mobile | string |
Die Mobiltelefonnummer des Mitarbeiters |
|
businessEmail
|
result.businessEmail | string |
Die geschäftliche E-Mail des Mitarbeiters |
Direkte Einzahlungen erhalten
Gibt die Liste aller aktiven Einlagen (bis zum aktuellen Gültigkeitsdatum) für einen Mitarbeiter zurück. Standardmäßig sind Kontonummer und Routingnummer in der Antwort der Direct Deposit API maskiert.
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Distributionen
|
result | array of object |
Liste aller Lohnverteilungen mit flacher Struktur |
|
status
|
result.status | string |
Der Status dieser Auszahlungsverteilung (z. B. Aktiv, Ausstehend, Inaktiv) |
|
Datum des Inkrafttretens
|
result.effectiveDate | string |
Das Datum, an dem diese Auszahlungsverteilung wirksam wird |
|
KontoTyp
|
result.accountType | string |
Art des Bankkontos (z. B. ACH-CHECKING, ACH-SAVINGS) |
|
accountNumber
|
result.accountNumber | string |
Die maskierte Bankkontonummer |
|
routingNumber
|
result.routingNumber | string |
Die maskierte Bankweiterleitungsnummer |
|
Betrag
|
result.amount | integer |
Der Betrag, der an dieses Konto verteilt werden soll |
|
isBonusOnly
|
result.isBonusOnly | boolean |
Gibt an, ob diese Verteilung nur für Bonuszahlungen gilt |
Entfernen von Notfallkontakten
Entfernt Notfallkontakte aus dem Profil des Mitarbeiters. Verwenden Sie dies, wenn ein Notfallkontakt nicht mehr benötigt oder relevant ist.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
itemIds
|
itemIds | True | array of string |
Die Element-IDs, von denen kontakt entfernt werden soll (IDs, die aus getContacts gefunden wurden) |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
result
|
result | array of object |
Array von Aktualisierungsergebnissen für jeden Feldvorgang |
|
Nummerierung“
|
result.field | string |
Der Name des aktualisierten Felds/Werts. In diesem Fall wurde die Element-ID des Kontakts entfernt. |
|
Erfolgreich
|
result.success | boolean |
Ob das Feld entfernt wurde |
|
Fehler
|
result.error | string |
Fehlermeldung, wenn die Entfernung fehlgeschlagen ist, leere Zeichenfolge bei erfolgreicher Ausführung |
Hinzufügen eines Notfallkontakts
Erstellt einen neuen Notfallkontakteintrag für den Mitarbeiter. Verwenden Sie dies, wenn ein Mitarbeiter eine Person hinzufügen möchte, die im Notfall kontaktiert werden soll, einschließlich der Kontaktinformationen und der Beziehung.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
contactName
|
contactName | True | string |
Name des Kontakts |
|
AdresseZeile1
|
addressLine1 | string |
Die erste Zeile in der Adresse des Kontakts |
|
|
AdresseZeile2
|
addressLine2 | string |
Die zweite Zeile in der Adresse des Kontakts |
|
|
AdresseZeile3
|
addressLine3 | string |
Die dritte Zeile in der Adresse des Kontakts |
|
|
addressCity
|
addressCity | string |
Die Stadt in der Adresse des Kontakts |
|
|
addressState
|
addressState | string |
Das Bundesland/die Provinz in der Adresse des Kontakts (verwenden Sie Postkürzel, oder dies wird ignoriert). |
|
|
addressCountry
|
addressCountry | string |
Das Land in der Adresse des Kontakts (verwenden Sie postspezifische Abkürzungen, oder dies wird ignoriert) |
|
|
addressPostalCode
|
addressPostalCode | string |
Der Postcode in der Adresse des Kontakts |
|
|
phoneType
|
phoneType | string |
Welche Art von Nummer ist dies für den Kontakt? |
|
|
countryCode
|
countryCode | integer |
Der Ländercode dieser Nummer (NANP-Regeln gelten) |
|
|
areaCode
|
areaCode | integer |
Die Vorwahl dieser Nummer (NANP-Regeln gelten) |
|
|
Zahl
|
number | integer |
Die Zeilennummer (NANP-Regeln gelten) |
|
|
Erweiterung
|
extension | integer |
Erweiterungscode für diese Nummer |
|
|
E-Mail-Adresse
|
address | string |
E-Mail, die der Kontakt besitzt und Zugriff hat |
|
|
Beziehung
|
relation | True | string |
Beziehung des Kontakts zu der Person, die sie hinzufügt |
|
isPrimär
|
isPrimary | True | boolean |
Festlegen dieses Kontakts als primären Kontakt |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
itemId
|
result.itemId | string |
Die Element-ID des kontakts, der erstellt wurde |
Zahlungsauszüge abrufen
Fordern Sie die Liste der letzten 5 clientspezifischen Zahlungsanweisungen für einen Geschäftspartner an.
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
result
|
result | array of object |
payStatements |
|
payDate
|
result.payDate | string |
Datum der Zahlungsabrechnung |
|
Währungscode
|
result.currencyCode | string |
Währungseinheit für diese Zahlungsabrechnung |
|
netPayAmount
|
result.netPayAmount | float |
Nettozahlungsbetrag für diese Zahlungsabrechnung |
|
grossPayAmount
|
result.grossPayAmount | float |
Bruttozahlungsbetrag für diese Abrechnung |
|
totalHours
|
result.totalHours | float |
Gesamtstunden, die in dieser Zahlungsabrechnung bezahlt werden |