• Zuletzt bearbeitet am: 31 May 2021

Kandidaten-Bestätigungs-API

Kunden, die einige oder alle Onboarding-Aktivitäten von Kandidaten über Anwendungen von Drittanbietern verwalten, können den Prozess der Bestätigung von Kandidaten als Kontingentmitarbeiter mithilfe der CCW-Kandidatenbestätigungs-API nacheinander automatisieren.

Die CCW-Kandidatenbestätigungs-API wurde für Kunden entwickelt, die einige oder alle Onboarding-Aktivitäten von Kandidaten über Anwendungen von Drittanbietern verwalten und den Prozess der Bestätigung von Kandidaten als Zeitarbeitskräfte (CWs) nacheinander automatisieren möchten. Die API kann eine Anfrage verarbeiten, um einen einzelnen Kandidaten zu bestätigen, ohne dass andere Daten in der Anfrage übergeben werden.

Die CCW Candidate Lookup API kann in Verbindung verwendet werden, um Kandidaten zu finden, die die für die Bestätigung erforderlichen Kriterien erfüllen. Die Bewerberbestätigungs-API kann dann jeden berechtigten Bewerber einzeln bestätigen.

Die Basis-URL für den Zugriff auf die CCW-Kandidatenbestätigungs-API lautet: https://<instance>/api/candidates/<id>/confirm

Weitere Informationen zur Authentifizierung durch CCW-APIs finden Sie in der CCW-API-Übersicht. Anfragen sollten folgende Elemente enthalten:

Anforderungsköpfe

Für Authentifizierungszwecke sind Anforderungsheader erforderlich. Weitere Informationen finden Sie im Abschnitt Anforderungskopfzeilen der Dokumentation zur API-Übersicht von CCW.

Beispielanforderung

Die CCW-Kandidatenbestätigungs-API wird von der PUT-Methode unterstützt, um einen Kandidaten als CW zu bestätigen, indem nur die eindeutige ID dieses Kandidaten in der API-Anforderung übergeben wird, ohne dass ein expliziter Anforderungstext erforderlich ist. Im folgenden Beispiel ist "12345" die eindeutige ID, die aus einer Kandidaten-Lookup-API-Anfrage abgerufen wird:

PUT /api/candidates/12345/confirm

HOST: <CCW FQDN>

Autorisierung: Bearer <token>

Accept: "application/json"

Korrelations-ID: Z098Jth56Nkio343YY1vXt

Antworten-Beispiele

Nachfolgend finden Sie ein Beispiel für eine erfolgreiche Antwort. Die angeforderte Kandidaten-ID wird validiert und anschließend bestätigt. CCW gibt an, dass die Bestätigung erfolgreich war, indem eine Antwort mit dem HTTP-200-Antwortcode und der Kandidaten-ID gesendet wurde:

{

    "id":"12345"

}

Im folgenden Beispiel ist die Bestätigungsanforderung fehlgeschlagen. Der HTTP-Fehlercode wird zusammen mit den entsprechenden Fehlermeldungen zurückgegeben:

{   

 "error_code": "Zeichenfolge",

 "error_summary": "Zeichenfolge",

 "error_causes": [      

  {   

    "error_sub_code": "Zeichenfolge", 

    "error_sub_code_desc": "Zeichenfolge",

  }

 ]

}

Fehlercodes

Wenn eine API-Bestätigungsanforderung fehlschlägt, enthält die Antwort einen der folgenden Fehlercodes:

HTTP-Statuscode Fehlercode Fehler-Subcode Fehlermeldung
400 E4000000 E4000001 Fehlerhafte Anfrage. Mindestens einer der obligatorischen HTTP-Header fehlt
400 E4000000 E4000006 Startdatum darf nicht in der Vergangenheit liegen
400 E4000000 E4000007 Ungültiger Starttag
400 E4000000 E4000008 Das Enddatum muss nach dem Startdatum liegen
400 E4000000 E4000009 Vertragslaufzeit übersteigt die Dauer der Leistungsanforderungen von <configured number of days/weeks/months/years> <days/weeks/months/years>
400 E4000000 E4000010 Ungültiges Konto <account>
400 E4000000 E4000012 Es ist bereits ein Kandidat oder Mitarbeiter mit dieser CCW-ID vorhanden.
400 E4000000 E4000013 Startdatum darf kein Datum in der Zukunft sein
400 E4000000 E4000019 Die Aufgabenreihenfolge ist ungültig. Entweder wurde es storniert, ist inaktiv oder wurde nicht gefunden.
400 E4000000 E4000020 Arbeitspaket ist nicht gültig. Entweder wurde es storniert, ist inaktiv oder wurde nicht gefunden.
400 E4000000 E4000023 Kandidat hat die Bestätigungskriterien nicht erfüllt
400 E4000000 E4000024 Der Kandidat ist bereits bestätigt.
400 E4000000 E4000025 OT-Lohnsatz muss größer als oder gleich dem Lohnsatz sein
400 E4000000 E4000026 DT Pay Rate muss größer als oder gleich OT Pay Rate sein
400 E4000000 E4000027 Der OT-Rechnungssatz des Lieferanten muss größer als oder gleich dem Rechnungssatz des Lieferanten sein
400 E4000000 E4000028 Lieferanten-DT-Rechnungssatz muss größer als oder gleich dem Lieferanten-OT-Rechnungssatz sein
400 E4000000 E4000029 Der endgültige OT-Rechnungssatz muss größer als oder gleich dem endgültigen Rechnungssatz sein
400 E4000000 E4000030 Die endgültige DT-Rechnungsrate muss größer als oder gleich der endgültigen OT-Rechnungsrate sein
400 E4000000 E4000031 Rechnungssatz muss größer als oder gleich dem Auszahlungssatz sein
400 E4000000 E4000032 Endgültiger Rechnungssatz muss größer als oder gleich dem Lieferantenrechnungssatz sein
400 E4000000 E4000033 Der OT-Rechnungssatz des Lieferanten muss größer als oder gleich dem OT-Lohnsatz sein
400 E4000000 E4000034 Der endgültige OT-Rechnungssatz muss größer als oder gleich dem OT-Rechnungssatz des Lieferanten sein
400 E4000000 E4000035 Der DT-Rechnungssatz des Lieferanten muss größer als oder gleich dem DT-Lohnsatz sein
400 E4000000 E4000036 Der endgültige DT-Rechnungssatz muss größer als oder gleich dem DT-Rechnungssatz des Lieferanten sein
400 E4000000 E4000037 Der Rechnungssatz des Lieferanten sollte mit dem endgültigen Rechnungssatz übereinstimmen
400 E4000000 E4000038 Anforderung kann nicht abgeschlossen werden, da die Anforderung geschlossen ist
400 E4000000 E4000039 Anforderung kann nicht abgeschlossen werden, da die Anforderung storniert wird
401 E4010000 E4010001 Authentifizierung fehlgeschlagen. Überprüfen Sie die mit Ihrer Verbraucher-App verknüpften Anmeldeinformationen
401 E4010000 E4010002 Authentifizierung fehlgeschlagen. Das Zugriffstoken ist ungültig oder abgelaufen
403 E4030000 E4030001 Nicht berechtigt. Der Benutzer ist nicht berechtigt, die Aktion auszuführen
403 E4030000 E4030002 Nicht berechtigt. Ungültiger Geltungsbereich
403 E4030000 E4030003 Nicht berechtigt. Der API-Benutzer ist ungültig. Stellen Sie sicher, dass der Benutzer aktiv ist und als API-Benutzer festgelegt ist
404 E4040000 E4040001 Nicht gefunden
405 E4050000 E4050001 Methode wird nicht unterstützt. Der Dienst unterstützt nicht die angeforderte HTTP-Methode
500 E5000000 E5000001 Ein System- oder Anwendungsfehler ist aufgetreten. Bitte wenden Sie sich an den Coupa CW-Administrator

 

Vergleichbare Artikel


Kandidaten-Such-API

31 May 2021

Die Kandidaten-Such-API von CCW ermöglicht es Kunden, Daten über Kandidaten abzurufen, die bei einer CCW-Anforderung eingereicht wurden.

Überblick über die CCW-API

31 May 2021

Die REST-API von CCW ermöglicht es Kunden und Partnern, neue Anwendungen zu erstellen und auf neue Weise in CCW zu integrieren, um ihre Fähigkeiten bei der Verwaltung einer befristeten Belegschaft zu verbessern.

API-Explorer

31 May 2021

Der Rest API Explorer von CCW ist ein interaktives Tool, mit dem Benutzer CCW-APIs testen und erkunden können.

Unterschiede zwischen XML und json in Coupa

16 December 2016

Hinweis: Einige Inhalte wurden maschinell übersetzt.