canvas 0.42.0__py3-none-any.whl → 0.44.0__py3-none-any.whl

canvas_sdk/v1/data/patient_consent.py

@@ -0,0 +1,92 @@
+from django.db import models
+
+
+class PatientConsentRejectionCoding(models.Model):
+    """Patient Consent Rejection Coding."""
+
+    class Meta:
+        managed = False
+        db_table = "canvas_sdk_data_api_patientconsentrejectioncoding_001"
+
+    dbid = models.BigIntegerField(primary_key=True)
+    system = models.CharField()
+    version = models.CharField()
+    code = models.CharField()
+    display = models.CharField()
+    user_selected = models.BooleanField()
+
+
+class PatientConsentExpirationRule(models.TextChoices):
+    """PatientConsentExpirationRule."""
+
+    NEVER = "never", "Never"
+    IN_ONE_YEAR = "in_one_year", "In one year"
+    END_OF_YEAR = "end_of_year", "End of year"
+
+
+class PatientConsentCoding(models.Model):
+    """Patient Consent Coding."""
+
+    class Meta:
+        managed = False
+        db_table = "canvas_sdk_data_api_patientconsentcoding_001"
+
+    dbid = models.BigIntegerField(primary_key=True)
+    system = models.CharField()
+    version = models.CharField()
+    code = models.CharField()
+    display = models.CharField()
+    user_selected = models.BooleanField()
+    expiration_rule = models.CharField(choices=PatientConsentExpirationRule, max_length=255)
+    is_mandatory = models.BooleanField()
+    is_proof_required = models.BooleanField()
+    show_in_patient_portal = models.BooleanField()
+    summary = models.TextField()
+
+
+class PatientConsentStatus(models.TextChoices):
+    """PatientConsentStatus."""
+
+    ACCEPTED = "accepted", "Accepted"
+    ACCEPTED_VIA_PORTAL = (
+        "accepted_via_patient_portal",
+        "Accepted Via Patient Portal",
+    )
+    REJECTED = "rejected", "Rejected"
+    REJECTED_VIA_PORTAL = "rejected_via_patient_portal", "Rejected Via Patient Portal"
+
+
+class PatientConsent(models.Model):
+    """Patient Consent."""
+
+    class Meta:
+        managed = False
+        db_table = "canvas_sdk_data_api_patientconsent_001"
+
+    id = models.UUIDField()
+    dbid = models.BigIntegerField(primary_key=True)
+    patient = models.ForeignKey(
+        "v1.Patient", on_delete=models.DO_NOTHING, related_name="patient_consent"
+    )
+    category = models.ForeignKey(
+        "v1.PatientConsentCoding",
+        on_delete=models.DO_NOTHING,
+        related_name="patient_consent",
+    )
+    state = models.CharField(choices=PatientConsentStatus, max_length=255)
+    effective_date = models.DateField()
+    expired_date = models.DateField()
+    rejection_reason = models.ForeignKey(
+        "v1.PatientConsentRejectionCoding",
+        on_delete=models.DO_NOTHING,
+        null=True,
+        related_name="patient_consents",
+    )
+    originator = models.ForeignKey("v1.CanvasUser", on_delete=models.DO_NOTHING, related_name="+")
+
+
+__exports__ = (
+    "PatientConsent",
+    "PatientConsentCoding",
+    "PatientConsentRejectionCoding",
+)

canvas_sdk/v1/data/payment_collection.py

@@ -0,0 +1,35 @@
+from django.db import models
+
+
+class PostingMethods(models.TextChoices):
+    """PostingMethods."""
+
+    CASH = "cash", "Cash"
+    CHECK = "check", "Check"
+    CARD = "card", "Card"
+    OTHER = "other", "Other"
+
+
+class PaymentCollection(models.Model):
+    """Stores the total collected amount and the payment method."""
+
+    class Meta:
+        managed = False
+        db_table = "canvas_sdk_data_quality_and_revenue_paymentcollection_001"
+
+    id = models.UUIDField()
+    dbid = models.BigIntegerField(primary_key=True)
+    total_collected = models.DecimalField(max_digits=8, decimal_places=2)
+    method = models.CharField(choices=PostingMethods.choices)
+
+    check_number = models.CharField()
+    check_date = models.DateField()
+    deposit_date = models.DateField()
+
+    description = models.TextField()
+
+    created = models.DateTimeField()
+    modified = models.DateTimeField()
+
+
+__exports__ = ("PaymentCollection", "PostingMethods")

canvas_sdk/v1/data/payor_specific_charge.py

@@ -0,0 +1,28 @@
+from django.db import models
+
+
+class PayorSpecificCharge(models.Model):
+    """Payor Specific Charge."""
+
+    class Meta:
+        managed = False
+        db_table = "canvas_sdk_data_quality_and_revenue_payorspecificcharge_001"
+
+    dbid = models.BigIntegerField(primary_key=True)
+    transactor = models.ForeignKey(
+        "v1.Transactor", related_name="specific_charges", on_delete=models.DO_NOTHING
+    )
+    # uncomment this when ChargeDescriptionMaster is added to data module
+    # charge = models.ForeignKey(
+    #     "v1.ChargeDescriptionMaster",
+    #     related_name="transactor_charges",
+    #     on_delete=models.DO_NOTHING,
+    # )
+
+    charge_amount = models.DecimalField()
+    effective_date = models.DateField()
+    end_date = models.DateField()
+    part_of_capitated_set = models.BooleanField()
+
+
+__exports__ = ("PayorSpecificCharge",)

canvas_sdk/v1/data/posting.py

@@ -0,0 +1,225 @@
+from decimal import Decimal
+from typing import Self
+
+from django.db import models
+
+from canvas_sdk.v1.data.utils import quantize
+
+
+class PostingQuerySet(models.QuerySet):
+    """A queryset for CoveragePosting objects."""
+
+    def active(self) -> Self:
+        """Return a queryset that filters for active postings."""
+        return self.filter(entered_in_error__isnull=True)
+
+
+class BasePosting(models.Model):
+    """
+    Base model to aggregate multiple line item transactions on a claim.
+    """
+
+    class Meta:
+        managed = False
+        db_table = "canvas_sdk_data_quality_and_revenue_baseposting_001"
+
+    objects = PostingQuerySet.as_manager()
+
+    dbid = models.BigIntegerField(primary_key=True)
+    corrected_posting = models.ForeignKey(
+        "v1.BasePosting", related_name="correction_postings", on_delete=models.PROTECT, null=True
+    )
+
+    claim = models.ForeignKey("v1.Claim", related_name="postings", on_delete=models.PROTECT)
+    payment_collection = models.ForeignKey(
+        "v1.PaymentCollection", related_name="postings", null=True, on_delete=models.PROTECT
+    )
+
+    description = models.TextField(default="")
+
+    entered_in_error = models.ForeignKey(
+        "v1.CanvasUser", on_delete=models.PROTECT, null=True, blank=True
+    )
+
+    created = models.DateTimeField()
+    modified = models.DateTimeField()
+
+    @property
+    def paid_amount(self) -> Decimal:
+        """Returns the total amount paid for this posting."""
+        return quantize(sum(lip.amount for lip in self.newlineitempayments.all()))
+
+    @property
+    def contractual_adjusted_amount(self) -> Decimal:
+        """Returns the total amount of contractual adjustments for this posting."""
+        return quantize(
+            sum(lia.amount for lia in self.newlineitemadjustments.all() if lia.write_off)
+        )
+
+    @property
+    def non_write_off_adjusted_amount(self) -> Decimal | int:
+        """Returns the total amount of non-write-off adjustments for this posting."""
+        return sum(lia.amount for lia in self.newlineitemadjustments.all() if not lia.write_off)
+
+    @property
+    def transferred_amount(self) -> Decimal:
+        """Returns the total amount transferred for this posting."""
+        return quantize(sum(lit.amount for lit in self.lineitemtransfers.all()))
+
+    @property
+    def transferred_to_patient_amount(self) -> Decimal | int:
+        """Returns the total amount transferred to the patient."""
+        transfers = [trans for trans in self.lineitemtransfers.all() if trans.transfer_to_patient]
+        return sum(lit.amount for lit in transfers)
+
+    @property
+    def transferred_to_coverage_amount(self) -> Decimal | int:
+        """Returns the total amount transferred to another coverage."""
+        transfers = [trans for trans in self.lineitemtransfers.all() if trans.transfer_to]
+        return sum(lit.amount for lit in transfers)
+
+    @property
+    def adjusted_and_transferred_amount(self) -> Decimal:
+        """Returns the charges amount per claim for a patient posting."""
+        return self.contractual_adjusted_amount + self.transferred_amount
+
+    @property
+    def posted_amount(self) -> Decimal:
+        """Property to compute how much was posted with this posting: sums all payments and write-off adjustments."""
+        return self.paid_amount + self.contractual_adjusted_amount + self.transferred_amount
+
+
+class CoveragePosting(BasePosting):
+    """Represents an insurance payment/adjustment on a claim level."""
+
+    class Meta:
+        managed = False
+        db_table = "canvas_sdk_data_quality_and_revenue_coverageposting_001"
+
+    remittance = models.ForeignKey(
+        "v1.BaseRemittanceAdvice", related_name="postings", on_delete=models.PROTECT, null=True
+    )
+    claim_coverage = models.ForeignKey(
+        "v1.ClaimCoverage", related_name="postings", on_delete=models.PROTECT
+    )
+
+    crossover_carrier = models.CharField()
+    crossover_id = models.CharField()
+    payer_icn = models.CharField()
+    position_in_era = models.PositiveIntegerField()
+
+
+class PatientPosting(BasePosting):
+    """A model that represents a patient payment/adjustment on a claim level."""
+
+    class Meta:
+        managed = False
+        db_table = "canvas_sdk_data_quality_and_revenue_patientposting_001"
+
+    claim_patient = models.ForeignKey(
+        "v1.ClaimPatient", related_name="postings", on_delete=models.PROTECT
+    )
+    patient_payment = models.ForeignKey(
+        "v1.BulkPatientPosting", related_name="postings", on_delete=models.PROTECT, null=True
+    )
+
+    copay = models.ForeignKey(
+        "v1.BulkPatientPosting", related_name="copays", on_delete=models.PROTECT, null=True
+    )
+
+    @property
+    def discounted_amount(self) -> Decimal:
+        """Returns the discounted amount per claim for a patient bulk posting."""
+        if not self.patient_payment or not self.patient_payment.discount:
+            return Decimal("0")
+
+        discount = self.patient_payment.discount
+        return quantize(
+            sum(
+                lia.amount
+                for lia in self.newlineitemadjustments.all()
+                if (
+                    lia.write_off
+                    and (lia.group, lia.code)
+                    == (discount.adjustment_group, discount.adjustment_code)
+                )
+            )
+        )
+
+    @property
+    def charges_amount(self) -> Decimal:
+        """Returns the charges amount per claim for a patient posting."""
+        return self.discounted_amount + self.paid_amount
+
+
+class AbstractBulkPosting(models.Model):
+    """Patient and Insurance bulk posting shared columns."""
+
+    class Meta:
+        abstract = True
+
+    id = models.UUIDField()
+    dbid = models.BigIntegerField(primary_key=True)
+
+    payment_collection = models.OneToOneField(
+        "v1.PaymentCollection", related_name="%(class)s", on_delete=models.PROTECT
+    )
+
+    total_paid = models.DecimalField(max_digits=8, decimal_places=2)
+
+    created = models.DateTimeField()
+    modified = models.DateTimeField()
+
+
+class BulkPatientPosting(AbstractBulkPosting):
+    """Model to aggregate bulk patient payments on multiple claims."""
+
+    class Meta:
+        managed = False
+        db_table = "canvas_sdk_data_quality_and_revenue_bulkpatientposting_001"
+
+    discount = models.ForeignKey(
+        "v1.Discount", related_name="patient_postings", null=True, on_delete=models.SET_NULL
+    )
+    payer = models.ForeignKey("v1.Patient", related_name="payments", on_delete=models.PROTECT)
+
+    @property
+    def total_posted_amount(self) -> Decimal:
+        """Property to compute how much was posted with all associated postings."""
+        postings = self.postings.active()
+        return quantize(sum(posting.posted_amount for posting in postings))
+
+    @property
+    def discounted_amount(self) -> Decimal:
+        """Returns the sum of discounted amounts for every posting created with this collection."""
+        postings = self.postings.active()
+        return quantize(sum(posting.discounted_amount for posting in postings))
+
+
+class BaseRemittanceAdvice(AbstractBulkPosting):
+    """Manual and Electronic Shared columns."""
+
+    class Meta:
+        managed = False
+        db_table = "canvas_sdk_data_quality_and_revenue_baseremittanceadvice_001"
+
+    transactor = models.ForeignKey(
+        "v1.Transactor", related_name="remits", null=True, on_delete=models.PROTECT
+    )
+
+    era_id = models.CharField(max_length=255, null=True, blank=True, db_index=True)
+
+    @property
+    def total_posted_amount(self) -> Decimal:
+        """Property to compute how much was posted with all associated postings."""
+        postings = self.postings.active()
+        return quantize(sum(posting.posted_amount for posting in postings))
+
+
+__exports__ = (
+    "BasePosting",
+    "CoveragePosting",
+    "PatientPosting",
+    "BulkPatientPosting",
+    "BaseRemittanceAdvice",
+)

canvas_sdk/v1/data/protocol_override.py

@@ -48,8 +48,12 @@ class ProtocolOverride(models.Model):
     created = models.DateTimeField()
     modified = models.DateTimeField()
     deleted = models.BooleanField()
-    committer = models.ForeignKey("v1.CanvasUser", on_delete=models.DO_NOTHING, null=True)
-    entered_in_error = models.ForeignKey("v1.CanvasUser", on_delete=models.DO_NOTHING, null=True)
+    committer = models.ForeignKey(
+        "v1.CanvasUser", on_delete=models.DO_NOTHING, null=True, related_name="+"
+    )
+    entered_in_error = models.ForeignKey(
+        "v1.CanvasUser", on_delete=models.DO_NOTHING, null=True, related_name="+"
+    )
     patient = models.ForeignKey(
         "v1.Patient", on_delete=models.DO_NOTHING, related_name="protocol_overrides", null=True
     )

canvas_sdk/v1/data/questionnaire.py

@@ -148,8 +148,12 @@ class Interview(models.Model):
     id = models.UUIDField()
     dbid = models.BigIntegerField(primary_key=True)
     deleted = models.BooleanField()
-    committer = models.ForeignKey("v1.CanvasUser", on_delete=models.DO_NOTHING, null=True)
-    entered_in_error = models.ForeignKey("v1.CanvasUser", on_delete=models.DO_NOTHING, null=True)
+    committer = models.ForeignKey(
+        "v1.CanvasUser", on_delete=models.DO_NOTHING, null=True, related_name="+"
+    )
+    entered_in_error = models.ForeignKey(
+        "v1.CanvasUser", on_delete=models.DO_NOTHING, null=True, related_name="+"
+    )
     status = models.CharField()
     name = models.CharField()
     language_id = models.BigIntegerField()

canvas_sdk/v1/data/user.py

@@ -11,6 +11,8 @@ class CanvasUser(models.Model):
     dbid = models.BigIntegerField(db_column="dbid", primary_key=True)
     email = models.EmailField(db_column="email")
     phone_number = models.CharField(db_column="phone_number", max_length=255)
+    last_invite_date_time = models.DateTimeField()
+    is_portal_registered = models.BooleanField()
 
 
 __exports__ = ("CanvasUser",)

canvas_sdk/v1/data/utils.py

@@ -0,0 +1,10 @@
+from collections.abc import Sequence
+from decimal import Decimal
+
+
+def quantize(deci: Decimal | float | str | tuple[int, Sequence[int], int]) -> Decimal:
+    """Rounds a Decimal value to two decimal places."""
+    return Decimal(deci).quantize(Decimal(".01"))
+
+
+__exports__ = ()

protobufs/canvas_generated/messages/effects.proto

@@ -269,8 +269,14 @@ enum EffectType {
   UPDATE_USER = 5000;
 
   CREATE_NOTE = 6000;
+  UPDATE_NOTE = 6013;
+
   CREATE_APPOINTMENT = 6001;
+  UPDATE_APPOINTMENT = 6014;
+  CANCEL_APPOINTMENT = 6015;
   CREATE_SCHEDULE_EVENT = 6002;
+  UPDATE_SCHEDULE_EVENT = 6016;
+  DELETE_SCHEDULE_EVENT = 6017;
 
   CREATE_PATIENT = 6003;
 
@@ -281,6 +287,7 @@ enum EffectType {
 
   PATIENT_METADATA__CREATE_ADDITIONAL_FIELDS = 6010;
   UPSERT_PATIENT_METADATA = 6011;
+  CREATE_PATIENT_EXTERNAL_IDENTIFIER = 6012;
 }
 
 message Effect {