candidhealth 1.0.0 → 1.3.0

data/lib/candidhealth/charge_capture/v_1/types/charge_capture_data.rb

@@ -1,11 +1,18 @@
 # frozen_string_literal: true
 
-require_relative "../../../diagnoses/types/diagnosis_create"
-require_relative "../../../encounters/v_4/types/intervention"
-require_relative "../../../claim_submission/v_1/types/external_claim_submission_create"
-require_relative "../../../service_lines/v_2/types/service_line_create"
-require_relative "../../../encounters/v_4/types/patient_history_category"
-require_relative "../../../billing_notes/v_2/types/billing_note_base"
+require_relative "../../../diagnoses/types/diagnosis_create_optional"
+require_relative "../../../encounters/v_4/types/clinical_note_category_create_optional"
+require_relative "../../../encounters/v_4/types/claim_supplemental_information_optional"
+require_relative "../../../encounters/v_4/types/epsdt_referral_optional"
+require_relative "../../../encounters/v_4/types/medication_optional"
+require_relative "../../../guarantor/v_1/types/guarantor_optional"
+require_relative "../../../individual/types/subscriber_create_optional"
+require_relative "../../../encounters/v_4/types/intervention_optional"
+require_relative "../../../custom_schemas/v_1/types/schema_instance_optional"
+require_relative "../../../claim_submission/v_1/types/external_claim_submission_create_optional"
+require_relative "../../../service_lines/v_2/types/service_line_create_optional"
+require_relative "../../../encounters/v_4/types/patient_history_category_optional"
+require_relative "../../../billing_notes/v_2/types/billing_note_base_optional"
 require_relative "../../../individual/types/patient_update_with_optional_address"
 require_relative "../../../service_facility/types/encounter_service_facility_update_with_optional_address"
 require_relative "../../../encounter_providers/v_2/types/rendering_provider_update_with_optional_address"
@@ -15,20 +22,13 @@ require_relative "../../../encounter_providers/v_2/types/supervising_provider_up
 require_relative "../../../encounter_providers/v_2/types/billing_provider_update_with_optional_address"
 require_relative "../../../commons/types/street_address_short_zip_optional"
 require "date"
-require_relative "../../../encounters/v_4/types/clinical_note_category_create"
 require_relative "../../../encounters/v_4/types/billable_status_type"
 require_relative "../../../encounters/v_4/types/responsible_party_type"
 require_relative "../../../encounters/v_4/types/synchronicity_type"
 require_relative "../../../commons/types/facility_type_code"
-require_relative "../../../individual/types/subscriber_create"
 require_relative "../../../encounters/v_4/types/service_authorization_exception_code"
 require_relative "../../../commons/types/delay_reason_code"
-require_relative "../../../custom_schemas/v_1/types/schema_instance"
 require_relative "../../../encounters/v_4/types/vitals_update"
-require_relative "../../../encounters/v_4/types/medication"
-require_relative "../../../guarantor/v_1/types/guarantor_update"
-require_relative "../../../encounters/v_4/types/epsdt_referral"
-require_relative "../../../encounters/v_4/types/claim_supplemental_information"
 require "ostruct"
 require "json"
 
@@ -37,26 +37,56 @@ module CandidApiClient
     module V1
       module Types
         class ChargeCaptureData
-          # @return [Array<CandidApiClient::Diagnoses::Types::DiagnosisCreate>] Ideally, this field should contain no more than 12 diagnoses. However, more
+          # @return [Array<CandidApiClient::Diagnoses::Types::DiagnosisCreateOptional>] Ideally, this field should contain no more than 12 diagnoses. However, more
           #  diagnoses
           #  may be submitted at this time, and coders will later prioritize the 12 that will
           #  be
           #  submitted to the payor.
           attr_reader :diagnoses
-          # @return [Array<CandidApiClient::Encounters::V4::Types::Intervention>]
+          # @return [Array<CandidApiClient::Encounters::V4::Types::ClinicalNoteCategoryCreateOptional>] Holds a collection of clinical observations made by healthcare providers during
+          #  patient encounters. Please note that medical records for appeals should be sent
+          #  using the Encounter Attachments API.
+          attr_reader :clinical_notes
+          # @return [Array<CandidApiClient::Encounters::V4::Types::ClaimSupplementalInformationOptional>] Refers to Loop 2300 - Segment PWK on the 837P form. No more than 10 entries are
+          #  permitted.
+          attr_reader :claim_supplemental_information
+          # @return [CandidApiClient::Encounters::V4::Types::EpsdtReferralOptional] Refers Box 24H on the CMS1500 form and Loop 2300 CRC - EPSDT Referral on the
+          #  837P form
+          attr_reader :epsdt_referral
+          # @return [Array<CandidApiClient::Encounters::V4::Types::MedicationOptional>] Existing medications that should be on the encounter.
+          #  Note all current existing medications on encounter will be overridden with this
+          #  list.
+          attr_reader :existing_medications
+          # @return [CandidApiClient::Guarantor::V1::Types::GuarantorOptional] Personal and contact info for the guarantor of the patient responsibility.
+          attr_reader :guarantor
+          # @return [CandidApiClient::Individual::Types::SubscriberCreateOptional] Contains details of the primary insurance subscriber.
+          attr_reader :subscriber_primary
+          # @return [CandidApiClient::Individual::Types::SubscriberCreateOptional] Contains details of the secondary insurance subscriber.
+          attr_reader :subscriber_secondary
+          # @return [CandidApiClient::Individual::Types::SubscriberCreateOptional] Contains details of the tertiary insurance subscriber.
+          attr_reader :subscriber_tertiary
+          # @return [Array<CandidApiClient::Encounters::V4::Types::InterventionOptional>]
           attr_reader :interventions
-          # @return [CandidApiClient::ClaimSubmission::V1::Types::ExternalClaimSubmissionCreate] ***This field is in beta.***
+          # @return [Array<CandidApiClient::CustomSchemas::V1::Types::SchemaInstanceOptional>] Key-value pairs that must adhere to a schema created via the Custom Schema API.
+          #  Multiple schema
+          #  instances cannot be created for the same schema on an encounter. Updating schema
+          #  instances utilizes PUT
+          #  semantics, so the schema instances on the encounter will be set to whatever
+          #  inputs are provided. If null
+          #  is provided as an input, then the encounter's schema instances will be cleared.
+          attr_reader :schema_instances
+          # @return [CandidApiClient::ClaimSubmission::V1::Types::ExternalClaimSubmissionCreateOptional] ***This field is in beta.***
           #  To be included for claims that have been submitted outside of Candid.
           #  Candid supports posting remits and payments to these claims and working them
           #  in-platform (e.g. editing, resubmitting).
           attr_reader :external_claim_submission
-          # @return [Array<CandidApiClient::ServiceLines::V2::Types::ServiceLineCreate>] Each service line must be linked to a diagnosis. Concretely,
+          # @return [Array<CandidApiClient::ServiceLines::V2::Types::ServiceLineCreateOptional>] Each service line must be linked to a diagnosis. Concretely,
           #  `service_line.diagnosis_pointers`must contain at least one entry which should be
           #  in bounds of the diagnoses list field.
           attr_reader :service_lines
-          # @return [Array<CandidApiClient::Encounters::V4::Types::PatientHistoryCategory>]
+          # @return [Array<CandidApiClient::Encounters::V4::Types::PatientHistoryCategoryOptional>]
           attr_reader :patient_histories
-          # @return [Array<CandidApiClient::BillingNotes::V2::Types::BillingNoteBase>] Spot to store misc, human-readable, notes about this encounter to be
+          # @return [Array<CandidApiClient::BillingNotes::V2::Types::BillingNoteBaseOptional>] Spot to store misc, human-readable, notes about this encounter to be
           #  used in the billing process.
           attr_reader :billing_notes
           # @return [CandidApiClient::Individual::Types::PatientUpdateWithOptionalAddress] Contains the identification information of the individual receiving medical
@@ -73,10 +103,9 @@ module CandidApiClient
           #  credentialing process.
           attr_reader :service_facility
           # @return [CandidApiClient::EncounterProviders::V2::Types::RenderingProviderUpdateWithOptionalAddress] The rendering provider is the practitioner -- physician, nurse practitioner,
-          #  etc. -- performing the service.
-          #  For telehealth services, the rendering provider performs the visit, asynchronous
-          #  communication, or other service. The rendering provider address should generally
-          #  be the same as the service facility address.
+          #  etc. -- performing the service. For telehealth services, the rendering provider
+          #  performs the visit, asynchronous communication, or other service. The rendering
+          #  provider address should generally be the same as the service facility address.
           attr_reader :rendering_provider
           # @return [CandidApiClient::EncounterProviders::V2::Types::InitialReferringProviderUpdateWithOptionalAddress] The second iteration of Loop ID-2310. Use code "P3 - Primary Care Provider" in
           #  this loop to
@@ -125,9 +154,6 @@ module CandidApiClient
           # @return [Array<String>] Names of tags that should be on the encounter.  Note all tags on encounter will
           #  be overridden with this list.
           attr_reader :tag_ids
-          # @return [Array<CandidApiClient::Encounters::V4::Types::ClinicalNoteCategoryCreate>] Holds a collection of clinical observations made by healthcare providers during
-          #  patient encounters.
-          attr_reader :clinical_notes
           # @return [CandidApiClient::Encounters::V4::Types::BillableStatusType] Defines if the Encounter is to be billed by Candid to the responsible_party.
           #  Examples for when this should be set to NOT_BILLABLE include if the Encounter
           #  has not occurred yet or if there is no intention of ever billing the
@@ -161,12 +187,6 @@ module CandidApiClient
           #  end_date_of_service values are the same, updating the encounter's
           #  end_date_of_service will update all service line date_of_service values.
           attr_reader :end_date_of_service
-          # @return [CandidApiClient::Individual::Types::SubscriberCreate] Contains details of the primary insurance subscriber.
-          attr_reader :subscriber_primary
-          # @return [CandidApiClient::Individual::Types::SubscriberCreate] Contains details of the secondary insurance subscriber.
-          attr_reader :subscriber_secondary
-          # @return [CandidApiClient::Individual::Types::SubscriberCreate] Contains details of the tertiary insurance subscriber.
-          attr_reader :subscriber_tertiary
           # @return [String] Defines additional information on the claim needed by the payer.
           #  Box 19 on the CMS-1500 claim form.
           attr_reader :additional_information
@@ -205,32 +225,12 @@ module CandidApiClient
           #  for billing purpose.
           #  Box 12 on the CMS-1500 claim form.
           attr_reader :patient_authorized_release
-          # @return [Array<CandidApiClient::CustomSchemas::V1::Types::SchemaInstance>] Key-value pairs that must adhere to a schema created via the Custom Schema API.
-          #  Multiple schema
-          #  instances cannot be created for the same schema on an encounter. Updating schema
-          #  instances utilizes PUT
-          #  semantics, so the schema instances on the encounter will be set to whatever
-          #  inputs are provided. If null
-          #  is provided as an input, then the encounter's schema instances will be cleared.
-          attr_reader :schema_instances
           # @return [CandidApiClient::Encounters::V4::Types::VitalsUpdate] If a vitals entity already exists for the encounter, then all values will be
           #  updated to the provided values.
           #  Otherwise, a new vitals object will be created for the encounter.
           attr_reader :vitals
-          # @return [Array<CandidApiClient::Encounters::V4::Types::Medication>] Existing medications that should be on the encounter.
-          #  Note all current existing medications on encounter will be overridden with this
-          #  list.
-          attr_reader :existing_medications
-          # @return [CandidApiClient::Guarantor::V1::Types::GuarantorUpdate] Personal and contact info for the guarantor of the patient responsibility.
-          attr_reader :guarantor
           # @return [String] Refers to REF*9F on the 837p. Value cannot be greater than 50 characters.
           attr_reader :referral_number
-          # @return [CandidApiClient::Encounters::V4::Types::EpsdtReferral] Refers Box 24H on the CMS1500 form and Loop 2300 CRC - EPSDT Referral on the
-          #  837P form
-          attr_reader :epsdt_referral
-          # @return [Array<CandidApiClient::Encounters::V4::Types::ClaimSupplementalInformation>] Refers to Loop 2300 - Segment PWK on the 837P form. No more than 10 entries are
-          #  permitted.
-          attr_reader :claim_supplemental_information
           # @return [String] When Medicaid is billed as the secondary payer the Carrier Code is used to
           #  identify the primary payer. This is required for certain states.
           attr_reader :secondary_payer_carrier_code
@@ -242,21 +242,42 @@ module CandidApiClient
 
           OMIT = Object.new
 
-          # @param diagnoses [Array<CandidApiClient::Diagnoses::Types::DiagnosisCreate>] Ideally, this field should contain no more than 12 diagnoses. However, more
+          # @param diagnoses [Array<CandidApiClient::Diagnoses::Types::DiagnosisCreateOptional>] Ideally, this field should contain no more than 12 diagnoses. However, more
           #  diagnoses
           #  may be submitted at this time, and coders will later prioritize the 12 that will
           #  be
           #  submitted to the payor.
-          # @param interventions [Array<CandidApiClient::Encounters::V4::Types::Intervention>]
-          # @param external_claim_submission [CandidApiClient::ClaimSubmission::V1::Types::ExternalClaimSubmissionCreate] ***This field is in beta.***
+          # @param clinical_notes [Array<CandidApiClient::Encounters::V4::Types::ClinicalNoteCategoryCreateOptional>] Holds a collection of clinical observations made by healthcare providers during
+          #  patient encounters. Please note that medical records for appeals should be sent
+          #  using the Encounter Attachments API.
+          # @param claim_supplemental_information [Array<CandidApiClient::Encounters::V4::Types::ClaimSupplementalInformationOptional>] Refers to Loop 2300 - Segment PWK on the 837P form. No more than 10 entries are
+          #  permitted.
+          # @param epsdt_referral [CandidApiClient::Encounters::V4::Types::EpsdtReferralOptional] Refers Box 24H on the CMS1500 form and Loop 2300 CRC - EPSDT Referral on the
+          #  837P form
+          # @param existing_medications [Array<CandidApiClient::Encounters::V4::Types::MedicationOptional>] Existing medications that should be on the encounter.
+          #  Note all current existing medications on encounter will be overridden with this
+          #  list.
+          # @param guarantor [CandidApiClient::Guarantor::V1::Types::GuarantorOptional] Personal and contact info for the guarantor of the patient responsibility.
+          # @param subscriber_primary [CandidApiClient::Individual::Types::SubscriberCreateOptional] Contains details of the primary insurance subscriber.
+          # @param subscriber_secondary [CandidApiClient::Individual::Types::SubscriberCreateOptional] Contains details of the secondary insurance subscriber.
+          # @param subscriber_tertiary [CandidApiClient::Individual::Types::SubscriberCreateOptional] Contains details of the tertiary insurance subscriber.
+          # @param interventions [Array<CandidApiClient::Encounters::V4::Types::InterventionOptional>]
+          # @param schema_instances [Array<CandidApiClient::CustomSchemas::V1::Types::SchemaInstanceOptional>] Key-value pairs that must adhere to a schema created via the Custom Schema API.
+          #  Multiple schema
+          #  instances cannot be created for the same schema on an encounter. Updating schema
+          #  instances utilizes PUT
+          #  semantics, so the schema instances on the encounter will be set to whatever
+          #  inputs are provided. If null
+          #  is provided as an input, then the encounter's schema instances will be cleared.
+          # @param external_claim_submission [CandidApiClient::ClaimSubmission::V1::Types::ExternalClaimSubmissionCreateOptional] ***This field is in beta.***
           #  To be included for claims that have been submitted outside of Candid.
           #  Candid supports posting remits and payments to these claims and working them
           #  in-platform (e.g. editing, resubmitting).
-          # @param service_lines [Array<CandidApiClient::ServiceLines::V2::Types::ServiceLineCreate>] Each service line must be linked to a diagnosis. Concretely,
+          # @param service_lines [Array<CandidApiClient::ServiceLines::V2::Types::ServiceLineCreateOptional>] Each service line must be linked to a diagnosis. Concretely,
           #  `service_line.diagnosis_pointers`must contain at least one entry which should be
           #  in bounds of the diagnoses list field.
-          # @param patient_histories [Array<CandidApiClient::Encounters::V4::Types::PatientHistoryCategory>]
-          # @param billing_notes [Array<CandidApiClient::BillingNotes::V2::Types::BillingNoteBase>] Spot to store misc, human-readable, notes about this encounter to be
+          # @param patient_histories [Array<CandidApiClient::Encounters::V4::Types::PatientHistoryCategoryOptional>]
+          # @param billing_notes [Array<CandidApiClient::BillingNotes::V2::Types::BillingNoteBaseOptional>] Spot to store misc, human-readable, notes about this encounter to be
           #  used in the billing process.
           # @param patient [CandidApiClient::Individual::Types::PatientUpdateWithOptionalAddress] Contains the identification information of the individual receiving medical
           #  services.
@@ -270,10 +291,9 @@ module CandidApiClient
           #  address listed on claims must match what was provided to the payer during the
           #  credentialing process.
           # @param rendering_provider [CandidApiClient::EncounterProviders::V2::Types::RenderingProviderUpdateWithOptionalAddress] The rendering provider is the practitioner -- physician, nurse practitioner,
-          #  etc. -- performing the service.
-          #  For telehealth services, the rendering provider performs the visit, asynchronous
-          #  communication, or other service. The rendering provider address should generally
-          #  be the same as the service facility address.
+          #  etc. -- performing the service. For telehealth services, the rendering provider
+          #  performs the visit, asynchronous communication, or other service. The rendering
+          #  provider address should generally be the same as the service facility address.
           # @param initial_referring_provider [CandidApiClient::EncounterProviders::V2::Types::InitialReferringProviderUpdateWithOptionalAddress] The second iteration of Loop ID-2310. Use code "P3 - Primary Care Provider" in
           #  this loop to
           #  indicate the initial referral from the primary care provider or whatever
@@ -311,8 +331,6 @@ module CandidApiClient
           #  date_of_service values.
           # @param tag_ids [Array<String>] Names of tags that should be on the encounter.  Note all tags on encounter will
           #  be overridden with this list.
-          # @param clinical_notes [Array<CandidApiClient::Encounters::V4::Types::ClinicalNoteCategoryCreate>] Holds a collection of clinical observations made by healthcare providers during
-          #  patient encounters.
           # @param billable_status [CandidApiClient::Encounters::V4::Types::BillableStatusType] Defines if the Encounter is to be billed by Candid to the responsible_party.
           #  Examples for when this should be set to NOT_BILLABLE include if the Encounter
           #  has not occurred yet or if there is no intention of ever billing the
@@ -339,9 +357,6 @@ module CandidApiClient
           #  encounter's end_date_of_service will fail. If all service line
           #  end_date_of_service values are the same, updating the encounter's
           #  end_date_of_service will update all service line date_of_service values.
-          # @param subscriber_primary [CandidApiClient::Individual::Types::SubscriberCreate] Contains details of the primary insurance subscriber.
-          # @param subscriber_secondary [CandidApiClient::Individual::Types::SubscriberCreate] Contains details of the secondary insurance subscriber.
-          # @param subscriber_tertiary [CandidApiClient::Individual::Types::SubscriberCreate] Contains details of the tertiary insurance subscriber.
           # @param additional_information [String] Defines additional information on the claim needed by the payer.
           #  Box 19 on the CMS-1500 claim form.
           # @param service_authorization_exception_code [CandidApiClient::Encounters::V4::Types::ServiceAuthorizationExceptionCode] 837p Loop2300 REF*4N
@@ -372,33 +387,27 @@ module CandidApiClient
           # @param patient_authorized_release [Boolean] Whether this patient has authorized the release of medical information
           #  for billing purpose.
           #  Box 12 on the CMS-1500 claim form.
-          # @param schema_instances [Array<CandidApiClient::CustomSchemas::V1::Types::SchemaInstance>] Key-value pairs that must adhere to a schema created via the Custom Schema API.
-          #  Multiple schema
-          #  instances cannot be created for the same schema on an encounter. Updating schema
-          #  instances utilizes PUT
-          #  semantics, so the schema instances on the encounter will be set to whatever
-          #  inputs are provided. If null
-          #  is provided as an input, then the encounter's schema instances will be cleared.
           # @param vitals [CandidApiClient::Encounters::V4::Types::VitalsUpdate] If a vitals entity already exists for the encounter, then all values will be
           #  updated to the provided values.
           #  Otherwise, a new vitals object will be created for the encounter.
-          # @param existing_medications [Array<CandidApiClient::Encounters::V4::Types::Medication>] Existing medications that should be on the encounter.
-          #  Note all current existing medications on encounter will be overridden with this
-          #  list.
-          # @param guarantor [CandidApiClient::Guarantor::V1::Types::GuarantorUpdate] Personal and contact info for the guarantor of the patient responsibility.
           # @param referral_number [String] Refers to REF*9F on the 837p. Value cannot be greater than 50 characters.
-          # @param epsdt_referral [CandidApiClient::Encounters::V4::Types::EpsdtReferral] Refers Box 24H on the CMS1500 form and Loop 2300 CRC - EPSDT Referral on the
-          #  837P form
-          # @param claim_supplemental_information [Array<CandidApiClient::Encounters::V4::Types::ClaimSupplementalInformation>] Refers to Loop 2300 - Segment PWK on the 837P form. No more than 10 entries are
-          #  permitted.
           # @param secondary_payer_carrier_code [String] When Medicaid is billed as the secondary payer the Carrier Code is used to
           #  identify the primary payer. This is required for certain states.
           # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
           # @return [CandidApiClient::ChargeCapture::V1::Types::ChargeCaptureData]
-          def initialize(diagnoses: OMIT, interventions: OMIT, external_claim_submission: OMIT, service_lines: OMIT,
-                         patient_histories: OMIT, billing_notes: OMIT, patient: OMIT, service_facility: OMIT, rendering_provider: OMIT, initial_referring_provider: OMIT, referring_provider: OMIT, supervising_provider: OMIT, billing_provider: OMIT, pay_to_address: OMIT, benefits_assigned_to_provider: OMIT, prior_authorization_number: OMIT, external_id: OMIT, date_of_service: OMIT, tag_ids: OMIT, clinical_notes: OMIT, billable_status: OMIT, responsible_party: OMIT, provider_accepts_assignment: OMIT, synchronicity: OMIT, place_of_service_code: OMIT, appointment_type: OMIT, end_date_of_service: OMIT, subscriber_primary: OMIT, subscriber_secondary: OMIT, subscriber_tertiary: OMIT, additional_information: OMIT, service_authorization_exception_code: OMIT, admission_date: OMIT, discharge_date: OMIT, onset_of_current_illness_or_symptom_date: OMIT, last_menstrual_period_date: OMIT, delay_reason_code: OMIT, patient_authorized_release: OMIT, schema_instances: OMIT, vitals: OMIT, existing_medications: OMIT, guarantor: OMIT, referral_number: OMIT, epsdt_referral: OMIT, claim_supplemental_information: OMIT, secondary_payer_carrier_code: OMIT, additional_properties: nil)
+          def initialize(diagnoses: OMIT, clinical_notes: OMIT, claim_supplemental_information: OMIT,
+                         epsdt_referral: OMIT, existing_medications: OMIT, guarantor: OMIT, subscriber_primary: OMIT, subscriber_secondary: OMIT, subscriber_tertiary: OMIT, interventions: OMIT, schema_instances: OMIT, external_claim_submission: OMIT, service_lines: OMIT, patient_histories: OMIT, billing_notes: OMIT, patient: OMIT, service_facility: OMIT, rendering_provider: OMIT, initial_referring_provider: OMIT, referring_provider: OMIT, supervising_provider: OMIT, billing_provider: OMIT, pay_to_address: OMIT, benefits_assigned_to_provider: OMIT, prior_authorization_number: OMIT, external_id: OMIT, date_of_service: OMIT, tag_ids: OMIT, billable_status: OMIT, responsible_party: OMIT, provider_accepts_assignment: OMIT, synchronicity: OMIT, place_of_service_code: OMIT, appointment_type: OMIT, end_date_of_service: OMIT, additional_information: OMIT, service_authorization_exception_code: OMIT, admission_date: OMIT, discharge_date: OMIT, onset_of_current_illness_or_symptom_date: OMIT, last_menstrual_period_date: OMIT, delay_reason_code: OMIT, patient_authorized_release: OMIT, vitals: OMIT, referral_number: OMIT, secondary_payer_carrier_code: OMIT, additional_properties: nil)
             @diagnoses = diagnoses if diagnoses != OMIT
+            @clinical_notes = clinical_notes if clinical_notes != OMIT
+            @claim_supplemental_information = claim_supplemental_information if claim_supplemental_information != OMIT
+            @epsdt_referral = epsdt_referral if epsdt_referral != OMIT
+            @existing_medications = existing_medications if existing_medications != OMIT
+            @guarantor = guarantor if guarantor != OMIT
+            @subscriber_primary = subscriber_primary if subscriber_primary != OMIT
+            @subscriber_secondary = subscriber_secondary if subscriber_secondary != OMIT
+            @subscriber_tertiary = subscriber_tertiary if subscriber_tertiary != OMIT
             @interventions = interventions if interventions != OMIT
+            @schema_instances = schema_instances if schema_instances != OMIT
             @external_claim_submission = external_claim_submission if external_claim_submission != OMIT
             @service_lines = service_lines if service_lines != OMIT
             @patient_histories = patient_histories if patient_histories != OMIT
@@ -416,7 +425,6 @@ module CandidApiClient
             @external_id = external_id if external_id != OMIT
             @date_of_service = date_of_service if date_of_service != OMIT
             @tag_ids = tag_ids if tag_ids != OMIT
-            @clinical_notes = clinical_notes if clinical_notes != OMIT
             @billable_status = billable_status if billable_status != OMIT
             @responsible_party = responsible_party if responsible_party != OMIT
             @provider_accepts_assignment = provider_accepts_assignment if provider_accepts_assignment != OMIT
@@ -424,9 +432,6 @@ module CandidApiClient
             @place_of_service_code = place_of_service_code if place_of_service_code != OMIT
             @appointment_type = appointment_type if appointment_type != OMIT
             @end_date_of_service = end_date_of_service if end_date_of_service != OMIT
-            @subscriber_primary = subscriber_primary if subscriber_primary != OMIT
-            @subscriber_secondary = subscriber_secondary if subscriber_secondary != OMIT
-            @subscriber_tertiary = subscriber_tertiary if subscriber_tertiary != OMIT
             @additional_information = additional_information if additional_information != OMIT
             if service_authorization_exception_code != OMIT
               @service_authorization_exception_code = service_authorization_exception_code
@@ -439,18 +444,22 @@ module CandidApiClient
             @last_menstrual_period_date = last_menstrual_period_date if last_menstrual_period_date != OMIT
             @delay_reason_code = delay_reason_code if delay_reason_code != OMIT
             @patient_authorized_release = patient_authorized_release if patient_authorized_release != OMIT
-            @schema_instances = schema_instances if schema_instances != OMIT
             @vitals = vitals if vitals != OMIT
-            @existing_medications = existing_medications if existing_medications != OMIT
-            @guarantor = guarantor if guarantor != OMIT
             @referral_number = referral_number if referral_number != OMIT
-            @epsdt_referral = epsdt_referral if epsdt_referral != OMIT
-            @claim_supplemental_information = claim_supplemental_information if claim_supplemental_information != OMIT
             @secondary_payer_carrier_code = secondary_payer_carrier_code if secondary_payer_carrier_code != OMIT
             @additional_properties = additional_properties
             @_field_set = {
               "diagnoses": diagnoses,
+              "clinical_notes": clinical_notes,
+              "claim_supplemental_information": claim_supplemental_information,
+              "epsdt_referral": epsdt_referral,
+              "existing_medications": existing_medications,
+              "guarantor": guarantor,
+              "subscriber_primary": subscriber_primary,
+              "subscriber_secondary": subscriber_secondary,
+              "subscriber_tertiary": subscriber_tertiary,
               "interventions": interventions,
+              "schema_instances": schema_instances,
               "external_claim_submission": external_claim_submission,
               "service_lines": service_lines,
               "patient_histories": patient_histories,
@@ -468,7 +477,6 @@ module CandidApiClient
               "external_id": external_id,
               "date_of_service": date_of_service,
               "tag_ids": tag_ids,
-              "clinical_notes": clinical_notes,
               "billable_status": billable_status,
               "responsible_party": responsible_party,
               "provider_accepts_assignment": provider_accepts_assignment,
@@ -476,9 +484,6 @@ module CandidApiClient
               "place_of_service_code": place_of_service_code,
               "appointment_type": appointment_type,
               "end_date_of_service": end_date_of_service,
-              "subscriber_primary": subscriber_primary,
-              "subscriber_secondary": subscriber_secondary,
-              "subscriber_tertiary": subscriber_tertiary,
               "additional_information": additional_information,
               "service_authorization_exception_code": service_authorization_exception_code,
               "admission_date": admission_date,
@@ -487,13 +492,8 @@ module CandidApiClient
               "last_menstrual_period_date": last_menstrual_period_date,
               "delay_reason_code": delay_reason_code,
               "patient_authorized_release": patient_authorized_release,
-              "schema_instances": schema_instances,
               "vitals": vitals,
-              "existing_medications": existing_medications,
-              "guarantor": guarantor,
               "referral_number": referral_number,
-              "epsdt_referral": epsdt_referral,
-              "claim_supplemental_information": claim_supplemental_information,
               "secondary_payer_carrier_code": secondary_payer_carrier_code
             }.reject do |_k, v|
               v == OMIT
@@ -509,29 +509,75 @@ module CandidApiClient
             parsed_json = JSON.parse(json_object)
             diagnoses = parsed_json["diagnoses"]&.map do |item|
               item = item.to_json
-              CandidApiClient::Diagnoses::Types::DiagnosisCreate.from_json(json_object: item)
+              CandidApiClient::Diagnoses::Types::DiagnosisCreateOptional.from_json(json_object: item)
+            end
+            clinical_notes = parsed_json["clinical_notes"]&.map do |item|
+              item = item.to_json
+              CandidApiClient::Encounters::V4::Types::ClinicalNoteCategoryCreateOptional.from_json(json_object: item)
+            end
+            claim_supplemental_information = parsed_json["claim_supplemental_information"]&.map do |item|
+              item = item.to_json
+              CandidApiClient::Encounters::V4::Types::ClaimSupplementalInformationOptional.from_json(json_object: item)
+            end
+            if parsed_json["epsdt_referral"].nil?
+              epsdt_referral = nil
+            else
+              epsdt_referral = parsed_json["epsdt_referral"].to_json
+              epsdt_referral = CandidApiClient::Encounters::V4::Types::EpsdtReferralOptional.from_json(json_object: epsdt_referral)
+            end
+            existing_medications = parsed_json["existing_medications"]&.map do |item|
+              item = item.to_json
+              CandidApiClient::Encounters::V4::Types::MedicationOptional.from_json(json_object: item)
+            end
+            if parsed_json["guarantor"].nil?
+              guarantor = nil
+            else
+              guarantor = parsed_json["guarantor"].to_json
+              guarantor = CandidApiClient::Guarantor::V1::Types::GuarantorOptional.from_json(json_object: guarantor)
+            end
+            if parsed_json["subscriber_primary"].nil?
+              subscriber_primary = nil
+            else
+              subscriber_primary = parsed_json["subscriber_primary"].to_json
+              subscriber_primary = CandidApiClient::Individual::Types::SubscriberCreateOptional.from_json(json_object: subscriber_primary)
+            end
+            if parsed_json["subscriber_secondary"].nil?
+              subscriber_secondary = nil
+            else
+              subscriber_secondary = parsed_json["subscriber_secondary"].to_json
+              subscriber_secondary = CandidApiClient::Individual::Types::SubscriberCreateOptional.from_json(json_object: subscriber_secondary)
+            end
+            if parsed_json["subscriber_tertiary"].nil?
+              subscriber_tertiary = nil
+            else
+              subscriber_tertiary = parsed_json["subscriber_tertiary"].to_json
+              subscriber_tertiary = CandidApiClient::Individual::Types::SubscriberCreateOptional.from_json(json_object: subscriber_tertiary)
             end
             interventions = parsed_json["interventions"]&.map do |item|
               item = item.to_json
-              CandidApiClient::Encounters::V4::Types::Intervention.from_json(json_object: item)
+              CandidApiClient::Encounters::V4::Types::InterventionOptional.from_json(json_object: item)
+            end
+            schema_instances = parsed_json["schema_instances"]&.map do |item|
+              item = item.to_json
+              CandidApiClient::CustomSchemas::V1::Types::SchemaInstanceOptional.from_json(json_object: item)
             end
             if parsed_json["external_claim_submission"].nil?
               external_claim_submission = nil
             else
               external_claim_submission = parsed_json["external_claim_submission"].to_json
-              external_claim_submission = CandidApiClient::ClaimSubmission::V1::Types::ExternalClaimSubmissionCreate.from_json(json_object: external_claim_submission)
+              external_claim_submission = CandidApiClient::ClaimSubmission::V1::Types::ExternalClaimSubmissionCreateOptional.from_json(json_object: external_claim_submission)
             end
             service_lines = parsed_json["service_lines"]&.map do |item|
               item = item.to_json
-              CandidApiClient::ServiceLines::V2::Types::ServiceLineCreate.from_json(json_object: item)
+              CandidApiClient::ServiceLines::V2::Types::ServiceLineCreateOptional.from_json(json_object: item)
             end
             patient_histories = parsed_json["patient_histories"]&.map do |item|
               item = item.to_json
-              CandidApiClient::Encounters::V4::Types::PatientHistoryCategory.from_json(json_object: item)
+              CandidApiClient::Encounters::V4::Types::PatientHistoryCategoryOptional.from_json(json_object: item)
             end
             billing_notes = parsed_json["billing_notes"]&.map do |item|
               item = item.to_json
-              CandidApiClient::BillingNotes::V2::Types::BillingNoteBase.from_json(json_object: item)
+              CandidApiClient::BillingNotes::V2::Types::BillingNoteBaseOptional.from_json(json_object: item)
             end
             if parsed_json["patient"].nil?
               patient = nil
@@ -586,10 +632,6 @@ module CandidApiClient
             external_id = struct["external_id"]
             date_of_service = (Date.parse(parsed_json["date_of_service"]) unless parsed_json["date_of_service"].nil?)
             tag_ids = struct["tag_ids"]
-            clinical_notes = parsed_json["clinical_notes"]&.map do |item|
-              item = item.to_json
-              CandidApiClient::Encounters::V4::Types::ClinicalNoteCategoryCreate.from_json(json_object: item)
-            end
             billable_status = struct["billable_status"]
             responsible_party = struct["responsible_party"]
             provider_accepts_assignment = struct["provider_accepts_assignment"]
@@ -599,24 +641,6 @@ module CandidApiClient
             end_date_of_service = unless parsed_json["end_date_of_service"].nil?
                                     Date.parse(parsed_json["end_date_of_service"])
                                   end
-            if parsed_json["subscriber_primary"].nil?
-              subscriber_primary = nil
-            else
-              subscriber_primary = parsed_json["subscriber_primary"].to_json
-              subscriber_primary = CandidApiClient::Individual::Types::SubscriberCreate.from_json(json_object: subscriber_primary)
-            end
-            if parsed_json["subscriber_secondary"].nil?
-              subscriber_secondary = nil
-            else
-              subscriber_secondary = parsed_json["subscriber_secondary"].to_json
-              subscriber_secondary = CandidApiClient::Individual::Types::SubscriberCreate.from_json(json_object: subscriber_secondary)
-            end
-            if parsed_json["subscriber_tertiary"].nil?
-              subscriber_tertiary = nil
-            else
-              subscriber_tertiary = parsed_json["subscriber_tertiary"].to_json
-              subscriber_tertiary = CandidApiClient::Individual::Types::SubscriberCreate.from_json(json_object: subscriber_tertiary)
-            end
             additional_information = struct["additional_information"]
             service_authorization_exception_code = struct["service_authorization_exception_code"]
             admission_date = (Date.parse(parsed_json["admission_date"]) unless parsed_json["admission_date"].nil?)
@@ -629,41 +653,26 @@ module CandidApiClient
                                          end
             delay_reason_code = struct["delay_reason_code"]
             patient_authorized_release = struct["patient_authorized_release"]
-            schema_instances = parsed_json["schema_instances"]&.map do |item|
-              item = item.to_json
-              CandidApiClient::CustomSchemas::V1::Types::SchemaInstance.from_json(json_object: item)
-            end
             if parsed_json["vitals"].nil?
               vitals = nil
             else
               vitals = parsed_json["vitals"].to_json
               vitals = CandidApiClient::Encounters::V4::Types::VitalsUpdate.from_json(json_object: vitals)
             end
-            existing_medications = parsed_json["existing_medications"]&.map do |item|
-              item = item.to_json
-              CandidApiClient::Encounters::V4::Types::Medication.from_json(json_object: item)
-            end
-            if parsed_json["guarantor"].nil?
-              guarantor = nil
-            else
-              guarantor = parsed_json["guarantor"].to_json
-              guarantor = CandidApiClient::Guarantor::V1::Types::GuarantorUpdate.from_json(json_object: guarantor)
-            end
             referral_number = struct["referral_number"]
-            if parsed_json["epsdt_referral"].nil?
-              epsdt_referral = nil
-            else
-              epsdt_referral = parsed_json["epsdt_referral"].to_json
-              epsdt_referral = CandidApiClient::Encounters::V4::Types::EpsdtReferral.from_json(json_object: epsdt_referral)
-            end
-            claim_supplemental_information = parsed_json["claim_supplemental_information"]&.map do |item|
-              item = item.to_json
-              CandidApiClient::Encounters::V4::Types::ClaimSupplementalInformation.from_json(json_object: item)
-            end
             secondary_payer_carrier_code = struct["secondary_payer_carrier_code"]
             new(
               diagnoses: diagnoses,
+              clinical_notes: clinical_notes,
+              claim_supplemental_information: claim_supplemental_information,
+              epsdt_referral: epsdt_referral,
+              existing_medications: existing_medications,
+              guarantor: guarantor,
+              subscriber_primary: subscriber_primary,
+              subscriber_secondary: subscriber_secondary,
+              subscriber_tertiary: subscriber_tertiary,
               interventions: interventions,
+              schema_instances: schema_instances,
               external_claim_submission: external_claim_submission,
               service_lines: service_lines,
               patient_histories: patient_histories,
@@ -681,7 +690,6 @@ module CandidApiClient
               external_id: external_id,
               date_of_service: date_of_service,
               tag_ids: tag_ids,
-              clinical_notes: clinical_notes,
               billable_status: billable_status,
               responsible_party: responsible_party,
               provider_accepts_assignment: provider_accepts_assignment,
@@ -689,9 +697,6 @@ module CandidApiClient
               place_of_service_code: place_of_service_code,
               appointment_type: appointment_type,
               end_date_of_service: end_date_of_service,
-              subscriber_primary: subscriber_primary,
-              subscriber_secondary: subscriber_secondary,
-              subscriber_tertiary: subscriber_tertiary,
               additional_information: additional_information,
               service_authorization_exception_code: service_authorization_exception_code,
               admission_date: admission_date,
@@ -700,13 +705,8 @@ module CandidApiClient
               last_menstrual_period_date: last_menstrual_period_date,
               delay_reason_code: delay_reason_code,
               patient_authorized_release: patient_authorized_release,
-              schema_instances: schema_instances,
               vitals: vitals,
-              existing_medications: existing_medications,
-              guarantor: guarantor,
               referral_number: referral_number,
-              epsdt_referral: epsdt_referral,
-              claim_supplemental_information: claim_supplemental_information,
               secondary_payer_carrier_code: secondary_payer_carrier_code,
               additional_properties: struct
             )
@@ -727,8 +727,17 @@ module CandidApiClient
           # @return [Void]
           def self.validate_raw(obj:)
             obj.diagnoses&.is_a?(Array) != false || raise("Passed value for field obj.diagnoses is not the expected type, validation failed.")
+            obj.clinical_notes&.is_a?(Array) != false || raise("Passed value for field obj.clinical_notes is not the expected type, validation failed.")
+            obj.claim_supplemental_information&.is_a?(Array) != false || raise("Passed value for field obj.claim_supplemental_information is not the expected type, validation failed.")
+            obj.epsdt_referral.nil? || CandidApiClient::Encounters::V4::Types::EpsdtReferralOptional.validate_raw(obj: obj.epsdt_referral)
+            obj.existing_medications&.is_a?(Array) != false || raise("Passed value for field obj.existing_medications is not the expected type, validation failed.")
+            obj.guarantor.nil? || CandidApiClient::Guarantor::V1::Types::GuarantorOptional.validate_raw(obj: obj.guarantor)
+            obj.subscriber_primary.nil? || CandidApiClient::Individual::Types::SubscriberCreateOptional.validate_raw(obj: obj.subscriber_primary)
+            obj.subscriber_secondary.nil? || CandidApiClient::Individual::Types::SubscriberCreateOptional.validate_raw(obj: obj.subscriber_secondary)
+            obj.subscriber_tertiary.nil? || CandidApiClient::Individual::Types::SubscriberCreateOptional.validate_raw(obj: obj.subscriber_tertiary)
             obj.interventions&.is_a?(Array) != false || raise("Passed value for field obj.interventions is not the expected type, validation failed.")
-            obj.external_claim_submission.nil? || CandidApiClient::ClaimSubmission::V1::Types::ExternalClaimSubmissionCreate.validate_raw(obj: obj.external_claim_submission)
+            obj.schema_instances&.is_a?(Array) != false || raise("Passed value for field obj.schema_instances is not the expected type, validation failed.")
+            obj.external_claim_submission.nil? || CandidApiClient::ClaimSubmission::V1::Types::ExternalClaimSubmissionCreateOptional.validate_raw(obj: obj.external_claim_submission)
             obj.service_lines&.is_a?(Array) != false || raise("Passed value for field obj.service_lines is not the expected type, validation failed.")
             obj.patient_histories&.is_a?(Array) != false || raise("Passed value for field obj.patient_histories is not the expected type, validation failed.")
             obj.billing_notes&.is_a?(Array) != false || raise("Passed value for field obj.billing_notes is not the expected type, validation failed.")
@@ -745,7 +754,6 @@ module CandidApiClient
             obj.external_id&.is_a?(String) != false || raise("Passed value for field obj.external_id is not the expected type, validation failed.")
             obj.date_of_service&.is_a?(Date) != false || raise("Passed value for field obj.date_of_service is not the expected type, validation failed.")
             obj.tag_ids&.is_a?(Array) != false || raise("Passed value for field obj.tag_ids is not the expected type, validation failed.")
-            obj.clinical_notes&.is_a?(Array) != false || raise("Passed value for field obj.clinical_notes is not the expected type, validation failed.")
             obj.billable_status&.is_a?(CandidApiClient::Encounters::V4::Types::BillableStatusType) != false || raise("Passed value for field obj.billable_status is not the expected type, validation failed.")
             obj.responsible_party&.is_a?(CandidApiClient::Encounters::V4::Types::ResponsiblePartyType) != false || raise("Passed value for field obj.responsible_party is not the expected type, validation failed.")
             obj.provider_accepts_assignment&.is_a?(Boolean) != false || raise("Passed value for field obj.provider_accepts_assignment is not the expected type, validation failed.")
@@ -753,9 +761,6 @@ module CandidApiClient
             obj.place_of_service_code&.is_a?(CandidApiClient::Commons::Types::FacilityTypeCode) != false || raise("Passed value for field obj.place_of_service_code is not the expected type, validation failed.")
             obj.appointment_type&.is_a?(String) != false || raise("Passed value for field obj.appointment_type is not the expected type, validation failed.")
             obj.end_date_of_service&.is_a?(Date) != false || raise("Passed value for field obj.end_date_of_service is not the expected type, validation failed.")
-            obj.subscriber_primary.nil? || CandidApiClient::Individual::Types::SubscriberCreate.validate_raw(obj: obj.subscriber_primary)
-            obj.subscriber_secondary.nil? || CandidApiClient::Individual::Types::SubscriberCreate.validate_raw(obj: obj.subscriber_secondary)
-            obj.subscriber_tertiary.nil? || CandidApiClient::Individual::Types::SubscriberCreate.validate_raw(obj: obj.subscriber_tertiary)
             obj.additional_information&.is_a?(String) != false || raise("Passed value for field obj.additional_information is not the expected type, validation failed.")
             obj.service_authorization_exception_code&.is_a?(CandidApiClient::Encounters::V4::Types::ServiceAuthorizationExceptionCode) != false || raise("Passed value for field obj.service_authorization_exception_code is not the expected type, validation failed.")
             obj.admission_date&.is_a?(Date) != false || raise("Passed value for field obj.admission_date is not the expected type, validation failed.")
@@ -764,13 +769,8 @@ module CandidApiClient
             obj.last_menstrual_period_date&.is_a?(Date) != false || raise("Passed value for field obj.last_menstrual_period_date is not the expected type, validation failed.")
             obj.delay_reason_code&.is_a?(CandidApiClient::Commons::Types::DelayReasonCode) != false || raise("Passed value for field obj.delay_reason_code is not the expected type, validation failed.")
             obj.patient_authorized_release&.is_a?(Boolean) != false || raise("Passed value for field obj.patient_authorized_release is not the expected type, validation failed.")
-            obj.schema_instances&.is_a?(Array) != false || raise("Passed value for field obj.schema_instances is not the expected type, validation failed.")
             obj.vitals.nil? || CandidApiClient::Encounters::V4::Types::VitalsUpdate.validate_raw(obj: obj.vitals)
-            obj.existing_medications&.is_a?(Array) != false || raise("Passed value for field obj.existing_medications is not the expected type, validation failed.")
-            obj.guarantor.nil? || CandidApiClient::Guarantor::V1::Types::GuarantorUpdate.validate_raw(obj: obj.guarantor)
             obj.referral_number&.is_a?(String) != false || raise("Passed value for field obj.referral_number is not the expected type, validation failed.")
-            obj.epsdt_referral.nil? || CandidApiClient::Encounters::V4::Types::EpsdtReferral.validate_raw(obj: obj.epsdt_referral)
-            obj.claim_supplemental_information&.is_a?(Array) != false || raise("Passed value for field obj.claim_supplemental_information is not the expected type, validation failed.")
             obj.secondary_payer_carrier_code&.is_a?(String) != false || raise("Passed value for field obj.secondary_payer_carrier_code is not the expected type, validation failed.")
           end
         end