Erstellen von Serviceanforderungen

Verwenden Sie zum Erstellen einer Serviceanforderung den folgenden Endpunkt:

POST /claims/{claimId}/service-requests

Sobald eine Serviceanforderung erstellt wurde, wird ihr Feld Fortschritt auf „Entwurf“ gesetzt.

Mindestkriterien für die Erstellung

Eine Serviceanforderung muss mindestens Folgendes angeben:

die Art der Serviceanforderung, z. B. „Nur Service“ oder „Nicht verwaltet“ (im Feld kind)
den Anbieter (im Feld specialist)
eine Serviceanweisung (im Feld instruction), die mindestens Folgendes enthalten muss:
- den Kunden (im Feld customer).
- den Ort, an dem der Service erbracht wird (im Feld serviceAddress)
- den Umfang der zu erbringenden Services (im services-Array)
ein gewünschtes Datum für Angebotsfertigstellung, wenn die Serviceanforderung den Status „Nur Angebot“ oder „Angebot und Service“ hat
ein gewünschtes Fertigstellungsdatum des Service, wenn die Serviceanforderung den Status „Nur Service“ hat

Zusätzliche Details zu den einzelnen erforderlichen Feldern

In einer Serviceanforderung muss die Art der Serviceanfrage angegeben werden. Diese wird im Feld kind angegeben und muss auf einen Typencode aus der Typenliste ServiceRequestKind festgelegt werden, z. B.:

quoteonly
quoteandservice
serviceonly
unmanaged

In einer Serviceanforderung muss der Anbieter angegeben werden. Dieser wird im Feld specialist angegeben.

Sie können einen vorhandenen ClaimContact angeben, indem Sie das Feld id auflisten und auf die ClaimContact-ID setzen.
Sie können einen neuen ClaimContact erstellen, indem Sie das refid-Feld auflisten und einen neuen ClaimContact im included-Abschnitt angeben.

Eine Serviceanforderung muss eine Serviceanweisung enthalten. Diese wird im Feld instruction angegeben. Eine Serviceanweisung muss mindestens einen Kunden, einen Ort, an dem der Service erbracht wird, und ein Set von Services enthalten.

Der Kunde wird im Feld customer angegeben. Dies muss ein Verweis auf einen vorhandenen oder neuen ClaimContact sein. Sie können den ClaimContact angeben:

nach id (sofern in ClaimCenter bereits vorhanden)
nach policySystemId (sofern im Policenverwaltungssystem vorhanden)
nach refid (sofern noch nicht vorhanden und im included-Abschnitt des POST erstellt wird).

Der Ort, an dem der Service erbracht wird, wird im Feld serviceAddress angegeben. Sie können die Adresse angeben:

nach id (sofern in ClaimCenter bereits vorhanden)
inline (sofern in ClaimCenter noch nicht vorhanden)

Das Set von Services wird im Array services angegeben. Jeder Eintrag in diesem Array gibt den Code des Service an. Die Codes stammen aus der Datei vendorservicetree.xml, auf die Sie über Studio zugreifen können. Jeder Service muss ein Service auf Blattebene in der Servicestruktur sein. Außerdem muss jeder Service mit der Art der Serviceanforderung kompatibel sein. Die Servicekompatibilität ist in der Datei vendorservicedetails.xml definiert, auf die Sie ebenfalls über Studio zugreifen können.

Wenn die Art der Serviceanforderung quoteonly oder quoteandservice lautet, müssen Sie auch ein gewünschtes Datum für Angebotsfertigstellung in requestedQuoteCompletionDate angeben.

Wenn die Art der Serviceanforderung serviceonly lautet, müssen Sie auch ein gewünschtes Fertigstellungsdatum des Service in requestedServiceCompletionDate angeben.

Beispiel einer Serviceanforderung mit dem Status „Nur Service“

Die folgenden Nutzdaten zeigt ein Beispiel für eine minimale Serviceanforderungen mit dem Status „Nur Service“ für den Schadenfall 235-53-365889 in den Beispieldaten (deren ID cc:33 ist). Die Serviceanforderung wird von Joe's Auto Body Shop (ClaimContact cc:16) an der Mockingbird Lane 1313 in Arcadia, Kalifornien, für Robert Farley (ClaimContact cc:13) durchgeführt. Es soll ein Service erbracht werden: Restwert (autoothersalvage). Der Service muss bis zum 3. März 2021 abgeschlossen sein.

POST http://localhost:8080/cc/rest/claim/v1/claims/demo_sample:20/service-requests

{
  "data": {
    "attributes": {	
       "kind": {
           "code": "serviceonly"
       },
       "specialist": {
           "id": "cc:16"
       },
       "instruction": {
         "customer": {
           "id": "cc:13"
         },
         "serviceAddress": {
                        "addressLine1": "1313 Mockingbird Lane",
                        "city": "Arcadia",
                        "country": "US",
                        "postalCode": "91006",
                        "state": {
                            "code": "CA",
                            "name": "California"
                          }
         },
         "services": [
           {
             "code": "autoothersalvage"
           }
         ]					
      },
      "requestedServiceCompletionDate": "2021-03-19"
    }
  }
}

Beispiel einer Serviceanforderung mit dem Status „Nicht verwaltet“

Die folgenden Nutzdaten zeigt ein Beispiel für eine minimale Serviceanforderungen mit dem Status „Nicht verwaltet“ für den Schadenfall 235-53-365889 in den Beispieldaten (deren ID cc:33 ist). Die Serviceanforderung wird von Joe's Auto Body Shop (ClaimContact cc:16) an der Mockingbird Lane 1313 in Arcadia, Kalifornien, für Robert Farley (ClaimContact cc:13) durchgeführt. Es soll ein Service erbracht werden: Abschleppen (autoothertowing).

POST http://localhost:8080/cc/rest/claim/v1/claims/demo_sample:20/service-requests

{
  "data": {
    "attributes": {	
       "kind": {
           "code": "unmanaged"
       },
       "specialist": {
           "id": "cc:16"
       },
       "instruction": {
         "customer": {
           "id": "cc:13"
         },
         "serviceAddress": {
                        "addressLine1": "1313 Mockingbird Lane",
                        "city": "Arcadia",
                        "country": "US",
                        "postalCode": "91006",
                        "state": {
                            "code": "CA",
                            "name": "California"
                          }
         },
         "services": [
           {
             "code": "autoothertowing"
           }
         ]					
      }
    }
  }
}