Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This guide explains how to use the Intake API to create claims, add reasons, transactions, and details about the claim, and submit the claim to be finalized.

...

Drawio
bordertrue
diagramNameQFD API Intake Flow
simpleViewerfalse
linksauto
tbstyletop
lboxtrue
diagramWidth19011581
revision9

Anchor
ChoosingACustomer
ChoosingACustomer

...

  • Use the endpoint, www.example.com/QFDAPI/v1/claim/intake/retrieveCustomers to get a list of CustomerIds and other customer details
  • The /claim/intake/retrieveCustomers endpoint also returns NameEmailAddressPhoneAddress, and SecondaryPhone
  • CustomerId is required when creating a new claim and can be used to retrieve accounts

Drawio
width
bordertrue
diagramNameChoosingACustomer
simpleViewerfalse
linksauto
tbstyletop
lboxtrue
diagramWidth611
revision1

...

  • If needed, follow Choosing a Customer to get a valid CustomerId
  • Use the endpoint, www.example.com/QFDAPI/v1/claim/intake/retrieveAccounts to get a list of AccountNumbers and other account details
  • The /claim/intake/retrieveAccounts endpoint takes in CustomerId as a parameter and the response will only return accounts for the passed in CustomerId
  • Description, OpenDate, and Balance are also returned 
  • AccountNumber is required when creating a new claim

Drawio
width
bordertrue
diagramNameChoosingAnAccount
simpleViewerfalse
linksauto
tbstyletop
lboxtrue
diagramWidth611
revision2

...

  • If needed, follow Choosing a Customer and Choosing an Account to get a valid CustomerId and AccountNumber
  • Use the endpoint, www.example.com/QFDAPI/v1/claim/intake/create to create a new claim
  • The /claim/intake/create endpoint takes in CustomerId and AccountNumber as parameters and the claim will be created for the passed in IDs
  • ClaimId is returned

Drawio
width
bordertrue
diagramNameCreatingAClaim
simpleViewerfalse
linksauto
tbstyletop
lboxtrue
diagramWidth431
revision3

...

  • After Creating A Claim, use the endpoint, www.example.com/QFDAPI/v1/claim/intake/retrieveReasons with a valid ClaimId to get the reason questionnaire for the claim
  • The returned questionnaire contains questions to display so the user can classify the type and reason for the claim. The API returns appropriate questions for that given claim
  • Using the returned questionnaire, a QuestionList of the users answered questions can be built to sent to /claim/intake/addClaimReasons. See Swaggerhub Documentation
  • Use the endpoint, www.example.com/QFDAPI/v1/claim/intake/addClaimReasons to submit the built QuestionList
  • After submitting the users answers, the next step in the intake process is Retrieving and Adding Transactions

Drawio
bordertrue
diagramNameRetrievingAndAddingClaimReasons
simpleViewerfalse
widthlinksauto
tbstyletop
lboxtrue
diagramWidth641
revision2

...

Drawio
width
bordertrue
diagramNameRetrievingAddingTransactions
simpleViewerfalse
linksauto
tbstyletop
lboxtrue
diagramWidth641
revision3

...

Drawio
bordertrue
diagramNameRetrievingSubmittingQuestionnaire
simpleViewerfalse
widthlinksauto
tbstyletop
lboxtrue
diagramWidth641
revision2

...

Drawio
bordertrue
diagramNameRetrievingAndAddingCreditTransactions
simpleViewerfalse
widthlinksauto
tbstyletop
lboxtrue
diagramWidth641
revision2

...

Drawio
bordertrue
diagramNameRetrievingAndAddingSimilarTransactions
simpleViewerfalse
widthlinksauto
tbstyletop
lboxtrue
diagramWidth641
revision2

...

Drawio
width
bordertrue
diagramNameRetrievingTransactionsOtherAccount
simpleViewerfalse
linksauto
tbstyletop
lboxtrue
diagramWidth1031
revision4

...

Drawio
bordertrue
diagramNameAddingCheckDeposits
simpleViewerfalse
widthlinksauto
tbstyletop
lboxtrue
diagramWidth410
revision2

...

Drawio
width
bordertrue
diagramNameRetrievingAddingDocRequirements
simpleViewerfalse
linksauto
tbstyletop
lboxtrue
diagramWidth641
revision2

...

  • After Retrieving and Submitting Questionnaire, use the endpoint www.example.com/QFDAPI/v1/claim/intake/retrieveCorrespondenceChannels to retrieve correspondence channels for the given claim
    • Only required and supported if client has multi-channel verification enabled
  • The /claim/intake/retrieveCorrespondenceChannels returns a CorrespondenceChannelList of correspondence channels. If isEditable is true for the defined channel, then the correspondence channel can be updated by the user
  • Use the endpoint www.example.com/QFDAPI/v1/claim/intake/verifyCorrespondenceChannels to verify or edit correspondence channels
  • The /claim/intake/verifyCorrespondenceChannels takes in a CorrespondenceChannelList of correspondence channels. 
    • If the correspondence channel is correct, then IsVerifiedCorrect must be set to true for that channel
    • If the correspondence channel needs to be changed, then IsVerifiedCorrect must be set to false, and new values provided for the channel. See Swaggerhub Documentation

Drawio
width
bordertrue
diagramNameVerifyingCorrespondenceChanels
simpleViewerfalse
linksauto
tbstyletop
lboxtrue
diagramWidth760
revision5

...

Drawio
bordertrue
diagramNameRetrievingSubmittingClaim
simpleViewerfalse
widthlinksauto
tbstyletop
lboxtrue
diagramWidth610
revision1

...

Drawio
width
bordertrue
diagramNameRetrievingConfirmation
simpleViewerfalse
linksauto
tbstyletop
lboxtrue
diagramWidth410
revision2

...