Claim

Introduction #

This module defines the data models used to manage healthcare claim workflows.

Basic usage #

To retrieve a claim by its identifier:

from canvas_sdk.v1.data.claim import Claim

claim = Claim.objects.get(id="9d2e0f58-338b-11ec-8d3d-0242ac130003")

Filtering #

# Active claims only
active_claims = Claim.objects.active()

Attributes #

Claim #

Represents a complete healthcare claim.

Field NameType
idUUID
dbidInteger
noteNote
installment_planInstallmentPlan
current_queueClaimQueue
current_coverageClaimCoverage
accept_assignBoolean
auto_accidentBoolean
auto_accident_stateString
employment_relatedBoolean
other_accidentBoolean
accident_codeString
illness_dateDate
remote_batch_idString
remote_file_idString
prior_authString
narrativeString
account_numberString
snoozed_untilDate
patient_balanceDecimal
aggregate_coverage_balanceDecimal
createdDateTime
modifiedDateTime

Computed Properties:

  • total_charges: Total charges for active line items
  • total_paid: Sum of paid amounts from postings
  • total_adjusted: Sum of adjustments and transfers
  • balance: Remaining balance (coverage + patient)
  • total_patient_paid: Paid amount by the patient
  • total_payer_paid: Paid amount by coverages

ClaimLineItem #

Represents individual billed procedures or services tied to a claim.

Field NameType
dbidInteger
billing_line_itemBillingLineItem
claimClaim
statusClaimLineItemStatus
chargeDecimal
from_dateString
thru_dateString
narrativeString
ndc_codeString
ndc_dosageString
ndc_measureString
place_of_servicePracticeLocationPOS
proc_codeString
displayString
remote_chg_idString
unitsInteger
epsdtString
family_planningFamilyPlanningOptions
createdDateTime
modifiedDateTime

ClaimCoverage #

Links a claim to a specific insurance coverage.

Field NameType
dbidInteger
claimClaim
coverageCoverage
activeBoolean
payer_nameString
payer_idString
payer_typecodeString
payer_orderClaimPayerOrder
payer_addr1String
payer_addr2String
payer_cityString
payer_stateString
payer_zipString
payer_plan_typeClaimTypeCode
coverage_typeCoverageType
subscriber_employerString
subscriber_groupString
subscriber_numberString
subscriber_planString
subscriber_dobString
subscriber_first_nameString
subscriber_last_nameString
subscriber_middle_nameString
subscriber_phoneString
subscriber_sexPersonSex
subscriber_addr1String
subscriber_addr2String
subscriber_cityString
subscriber_stateString
subscriber_zipString
subscriber_countryString
patient_relationship_to_subscriberCoverageRelationshipCode
pay_to_addr1String
pay_to_addr2String
pay_to_cityString
pay_to_stateString
pay_to_zipString
resubmission_codeString
payer_icnString
createdDateTime
modifiedDateTime

ClaimQueue #

Defines the metadata for claim queues used in revenue workflows.

Field NameType
dbidInteger
queue_sort_orderingInteger
nameString
display_nameString
descriptionString
show_in_revenueBoolean
visible_columnsArray[ClaimQueueColumns]
createdDateTime
modifiedDateTime

ClaimPatient #

Captures patient-level data related to a specific claim.

Field NameType
dbidInteger
claimClaim
photoString
dobString
first_nameString
last_nameString
middle_nameString
phoneString
sexPersonSex
ssnString
addr1String
addr2String
cityString
stateString
zipString
countryString
createdDateTime
modifiedDateTime

InstallmentPlan #

Represents a payment plan between a patient and provider.

Field NameType
creatorCanvasUser
patientPatient
total_amountDecimal
statusInstallmentPlanStatus
expected_payoff_dateDate
created_atDateTime
updated_atDateTime

Enumeration types #

ClaimLineItemStatus #

ValueLabel
activeActive
removedRemoved

LineItemCodes #

Value
COPAY
UNLINKED

FamilyPlanningOptions #

ValueLabel
YYes
NNo

ClaimLineItemStatus #

ValueLabel
activeActive
removedRemoved

LineItemCodes #

Value
COPAY
UNLINKED

FamilyPlanningOptions #

ValueLabel
YYes
NNo

ClaimPayerOrder #

ValueLabel
PrimaryPrimary
SecondarySecondary
TertiaryTertiary
QuaternaryQuaternary
QuinaryQuinary

ClaimTypeCode #

CodeDescription
12Working Aged (Age 65 or older)
13End-Stage Renal Disease
14No-fault
15Workers Compensation
41Black Lung
42Veterans Administration
43Disabled (Under Age 65)
47Other Liability Insurance is primary
””No Typecode necessary

ClaimQueueColumns #

ValueLabel
NoteTypeNote type
ClaimIDClaim ID
DateOfServiceDate of service
PatientPatient
ActiveInsuranceActive insurance
InsuranceBalanceInsurance balance
PatientBalancePatient balance
DaysInQueueDays in queue
ProviderProvider
GuarantorGuarantor
LatestRemitLatest remit
LastInvoicedLast invoiced
SnoozedUntilSnoozed until
LabelsLabels

ClaimQueues #

ValueLabel
1Appointment
2NeedsClinicianReview
3NeedsCodingReview
4QueuedForSubmission
5FiledAwaitingResponse
6RejectedNeedsReview
7AdjudicatedOpenBalance
8PatientBalance
9ZeroBalance
10Trash

InstallmentPlanStatus #

ValueLabel
activeActive
completedCompleted
cancelledCancelled