API ClaimPayments

See API Specification

ClaimPayments are complex. They are used to finalize the payments received by insurance for a claim. See Claim, Receive Claim, and Finalize Insurance Payment for more details.

ClaimPayments POST

Version Added: 22.4.8

Finalize a ClaimPayment for a single Claim. Only used for Check payments. Cannot use this method if the dental office has the preference ClaimPaymentBatchOnly set to true. Does not link Deposits or Attach EOBs.

Prior to running this method, use ClaimProcs PUT (update) to update the Status to either "Received" or "Supplemental", and finalize the InsPayAmt. ClaimProc.InsPayAmt cannot be updated when there is already a ClaimPayment attached. Then use Claims PUT (update) to update the Claim ClaimStatus to "R" (Received).

claimNum: Required. FK to Claim.ClaimNum that is receiving the payment.
CheckAmt: Required. The amount of the check. Must match the total of the ClaimProcs' InsPayAmt for all of the ClaimProcs attached to the Claim that have a ClaimPaymentNum of 0.

CheckDate: Optional. Date the check was entered into this system, not the date on the check. String in "yyyy-MM-dd" format. Default today's date.
CheckNum: Optional. The check number.
BankBranch: Optional. Bank and branch.
Note: Optional. Note for this check if needed.
ClinicNum: Optional. Default is the ClinicNum of the Claim.
CarrierName: Optional. Default is the CarrierName attached to the InsPlan that is attached to the Claim.
DateIssued: Optional. Date that the carrier issued the check. Date on the check. String in "yyyy-MM-dd" format.
PayType: Optional. Definition.DefNum where category=32. See also Definitions: Insurance Payment Types. Default is the first definition in that Category.
PayGroup: Optional. Definition.DefNum where category=40. See also Definitions: Claim Payment Groups. Default is the first definition in that Category.

Example Request:
POST /claimpayments

{
"claimNum": 3567,
"CheckAmt": "567.42"
}

or

{
"claimNum": 3567,
"CheckAmt": "567.42",
"CheckDate": "2022-10-25",
"CheckNum": "1234",
"BankBranch": "124-85425",
"Note": "Check was lost in mail, but envelope is dated appropriately.",
"ClinicNum": 3,
"CarrierName": "Great Insurance",
"DateIssued": "2022-10-20",
"PayType": 386,
"PayGroup": 394
}

Example Response:

{
"ClaimPaymentNum": 897,
"CheckDate": "10/25/2022",
"CheckAmt": "567.42",
"CheckNum": "1234",
"BankBranch": "124-85425",
"Note": "Check was lost in mail, but envelope is dated appropriately.",
"ClinicNum": 3,
"DepositNum": 0,
"CarrierName": "Great Insurance",
"DateIssued": "10/20/2022",
"IsPartial": "false",
"PayType": 386,
"payType": "Check",
"SecUserNumEntry": 0,
"SecDateEntry": "11/10/2022",
"SecDateTEdit": "11/10/2022 12:54:48",
"PayGroup": 394,
"payGroup": "Default"
}

201 Created
400 BadRequest (with explaination)
404 NotFound (with explaination)