Erstellen von Vorbehalten

Verwenden Sie die folgenden Endpunkte, um einen Vorbehalt zu erstellen, der entweder mit einem Job oder einer Police verknüpft ist:

  • POST /jobs​/{jobId}​/contingencies
  • POST ​/policies​/{policyId}​/contingencies

Mindestkriterien für die Erstellung

Ein Vorbehalt muss mindestens Folgendes angeben:

  • Einen title
  • Eine description
  • Ein dueDate
  • Eine action, die auf einen Typencode aus der Typenliste ContingencyAction gesetzt werden muss

Die folgende Anforderung erstellt beispielsweise einen neuen Vorbehalt für die Police pc:62 mit dem angegebenen Titel und der angegebenen Beschreibung. Das Fälligkeitsdatum ist der 11. November 2021. Wenn der Vorbehalt bis dahin nicht aufgelöst ist, führt PolicyCenter eine rückwirkende Änderung der Police durch (um den Rabatt für gute Fahrer zu entfernen).

POST /policy/v1/policies/pc:62/contingencies

{
  "data": {
    "attributes": {
      "action": {
        "code": "ChangeRetroactively"
      },
      "description": "Driving record required for good driver discount",
      "dueDate": "2021-11-11T00:00:00.000Z",
      "title": "Driving record required"
    }
  }
}

Erstellen zugehöriger Objekte

Verwenden Sie den folgenden Endpunkt, um Aktivitäten, Dokumente und Notizen für einen Vorbehalt zu erstellen.

Mit Jobs verknüpfte Vorbehalte

Endpunkt Beschreibung
POST ​/jobs​/{jobId}​/contingencies​/{contingencyId}​/activities Erstellen einer Aktivität, die mit dem gegebenen Vorbehalt für den gegebenen Job verknüpft ist.
POST /jobs​/{jobId}​/contingencies​/{contingencyId}​/documents Erstellen eines Dokuments, das mit dem gegebenen Vorbehalt für den gegebenen Job verknüpft ist.
POST /jobs​/{jobId}​/contingencies​/{contingencyId}​/notes Erstellen einer Notiz, die mit dem gegebenen Vorbehalt für den gegebenen Job verknüpft ist.

Mit Policen verbundene Vorbehalte

Endpunkt Beschreibung
POST /policies​/{policyId}​/contingencies​/{contingencyId}​/activities Erstellen einer Aktivität, die mit dem gegebenen Vorbehalt für die gegebene Police verknüpft ist.
POST /policies​/{policyId}​/contingencies​/{contingencyId}​/documents Erstellen eines Dokuments, das mit dem gegebenen Vorbehalt für die gegebene Police verknüpft ist.
POST /policies​/{policyId}​/contingencies​/{contingencyId}​/notes Erstellen einer Notiz, die mit dem gegebenen Vorbehalt für die gegebene Police verknüpft ist.

Wenn eine Aktivität direkt für ein Konto, einen Job oder eine Police erstellt wird, müssen Sie ein Aktivitätenmuster angeben. Wenn jedoch eine Aktivität für einen Vorbehalt erstellt wird, müssen Sie das Aktivitätenmuster auslassen. Alle über Vorbehalte erstellten Aktivitäten verwenden das Aktivitätenmuster „Neuer Vorbehalt“ (uw_review_contingency). Wenn die Anforderungs-Nutzdaten ein Aktivitätenmuster enthalten, schlägt die Anforderung fehl.

Weitere Informationen zum Arbeiten mit Aktivitäten, Dokumenten oder Notizen finden Sie unter: