Model Validation

Entity Settings are set per Entity and not per user to customize the program to the specific needs of the Practice. The entity settings will determine how functions are set up and work per entity.

The purpose of the Model Validation is to select the required field to display for each screen in the system. All the fields that are marked as 'Required' in the Model Validation that is not completed on the relevant screens will block the user to save the changes on the specific screen. If the field is not marked as required the user won't need to complete it on the relevant screen in the system.

  • Log In to the GoodX WebApp using your GoodX username and password.
  • The Main Diary screen will open.



  • From the Diary screen, click on the Settings button in the top right corner.


  • The Settings screen will open. 
    • Click on Entity Settings.


  • Click on the Model Validation Panel.


  • The Model Validation Panel will expand.


  • The information of the settings will be divided into columns:
      • Field: These are the different functions or options on the screens in the system that you can make a required field on that specific screen.
      • Description: The description will explain what the function/option is.
      • Required: Tick the box to make this field a required field or leave blank.
  • A BillingSettings object: These options when ticked, will make the billing of macro's and clinical procedures a required field on the billing screen.


    • macros: Billing Macros: This is a set of stock items, procedures and/or consultations that are always used for a specific treatment.
    • clinical_procedures: Clinical Procedures- macros are used in the General Examination Event to make Billing more convenient.

  • A booking object: A field that relates to the booking.


    • debtor_json: This option will block the user from saving the booking when a debtor is not selected. The debtor is the required field/object.
  • A Debtor object on a Booking: These are the required fields available on the Booking Screen for a Debtor (Main Member of the file). If these fields are marked as required in the fields below, they will need to be completed or the user will be blocked from saving the booking.


    • debtor_title: The title of the Main member or the person responsible for the account.
    • debtor_initials: The initials of the  Main member or the person responsible for the account.
    • debtor_idtype: The type of document used as identification, for example, South African ID or Passport.
    • debtor_idnumber: The identification number associated with the ID type.
    • debtor_filenumber: The file number that has been allocated to the debtor's hardcopy file.
    • debtor_gender: The gender of the main member or the person responsible for the account, whether male /female. 
    • debtor_email: An email address, where electronic mail can be sent to the main member or the person responsible for the account.
    • debtor_ma_number: A medical aid number of the main member or the person responsible for the account.
    • debtor_ma_optionname: A medical aid option name of the main member or the person responsible for the account.
    • debtor_ma_schemename: A medical aid scheme name of the main member or the person responsible for the account.
    • debtor_address1: Street Name/Complex Name and number associated with the physical address of the main member or the person responsible for the account.
    • debtor_address2:  Suburb /City associated with the physical address of the main member or the person responsible for the account.
    • debtor_address3: Province /Country associated with the physical address of the main member or the person responsible for the account.
    • debtor_postcode: A postal code associated with the physical address of the main member or the person responsible for the account.
    • debtor_postaladdress1:  Street Name/Complex Name and number / PO BOX Number associated with the postal address of the main member or the person responsible for the account.
    • debtor_postaladdress2: Suburb associated with the postal address of the main member or the person responsible for the account.
    • debtor_postaladdress3: Province/Country associated with the postal address of the main member or the person responsible for the account.
    • debtor_postalpostcode: The postal code associated with the postal address of the main member or the person responsible for the account.
    • debtor_referring_doc_main_id: Referring doctor of the main member or the person responsible for the account.
    • debtor_treating_doctor_main_id: The main Treating Doctor of the debtor, the practitioner with who the debtor usually consults.
    • debtor_type: The type of debtor, Normal (Medical Aid), Private or IOD.
    • iod_injury_date: The date that the injury on duty took place.
    • iod_injury_description: A brief description of what transpired, regarding the injury on duty.

  • A Patient object on a Booking: These are the required fields available on the Booking Screen for a Patient (Dependant on the file). If these fields are marked as required in the fields below, they will need to be completed or the user will be blocked from saving the booking.


    • patient_nickname: The name that the dependant/patient is known as. 
    • patient_initials: The initials of a dependant/patient.
    • patient_title: The title of a dependant/patient.
    • patient_idtype: The type of document used as identification by the dependant/patient, for example, South African ID or Passport.
    • patient_idnumber: The identification number associated with the ID type of the dependant/patient.
    • patient_gender: The gender, whether male /female that is associated with the dependant/patient.
    • patient_email: An email address, where electronic mail can be sent of the dependant/patient.
    • patient_cellnr: A cellphone number of the dependant/patient.
    • patient_landlinenr: A telephone number associated with a landline of the dependant/patient.
    • patient_worknr: A telephone number associated with the work of the dependant/patient.
    • patient_dateofbirth: The date of birth of the dependant/patient.

  • A booking type object: These are the required fields available on the booking screen for a booking type. 


    • Duration: The duration can be a required field and will block the user from saving the booking if the duration is not completed. 
  • A clinical procedure object: These are the required fields available on the booking screen for a clinical procedure object.


    • uid: Api Resource UID, validation of internal fields
    • disabled: Whether or not this procedure is disabled. 
  • A Debtor object: These are the required fields available on the Debtor account screen (for the Main Member of the file when creating a new Debtor on the system).



    • debtor_title:  The title of the Main member or the person responsible for the account.
    • debtor_initials: The initials of the  Main member or the person responsible for the account.
    • debtor_idtype: The type of document used as identification, for example, South African ID or Passport.
    • debtor_filenumber: The file number that has been allocated to the debtor's hardcopy file.
    • debtor_idnumber: The identification number associated with the ID type of the main member or the person responsible for the account.
    • debtor_gender: The gender of the main member or the person responsible for the account, whether male /female. 
    • debtor_email: An email address, where electronic mail can be sent to the main member or the person responsible for the account.
    • debtor_cellnr: A cellphone number of the main member or the person responsible for the account.
    • debtor_address1: An address line associated with the physical address of the main member or the person responsible for the account.
    • debtor_address2: An address line associated with the physical address of the main member or the person responsible for the account.
    • debtor_address3: An address line associated with the physical address of the main member or the person responsible for the account.
    • debtor_postcode: A postal code associated with the physical address of the main member or the person responsible for the account.
    • debtor_postaladdress1: An address line associated with the postal address of the main member or the person responsible for the account.
    • debtor_postaladdress2: An address line associated with the postal address of the main member or the person responsible for the account. 
    • debtor_postaladdress3:An address line associated with the postal address of the main member or the person responsible for the account.
    • debtor_postalpostcode: The postal code associated with the address of the main member or the person responsible for the account.
    • debtor_referring_doc_main_id: Referring doctor of the main member or the person responsible for the account.
    • debtor_type: The type of debtor, Normal (Medical Aid), Private or IOD.
    • iod_injury_date: The date that the injury on duty took place.
    • iod_injury_description: A brief description of what transpired, regarding the injury on duty.

  • A Diary object: These are required fields available on the Diary screen for a specific object.

    • booking_types: The Booking Types are to indicate to the practitioner what the patient is coming to the practice for. It is also according to colour, to make it easier to distinguish the difference between the different booking types.
    • settings: diary settings. 
  • An Entity object: These are the required fields available on the Entity screen for a specific object.

extra: Extra Settings.

  • An OnlineConfig object: These are the required fields available on the myGC Configuration screen for a specific object or feature.


    • features: Grandcentral features 
  • An invoice line object: These are the required fields available on the Billing screen for the Invoice lines while billing. If the Diagnosis or price is marked as required the user won't be able to bill a line without a diagnosis code or a price per line item. 


    • diagnosis: ICD10 Code (diagnosis). 
    • price: The line item price. 

  • A Patient object: These are the required fields available on the Debtor account screen for the Patient (Dependant on the Debtor file when creating a new Patient on the system).


    • Patient_nickname: The name that the dependant/patient is known as.
    • Patient_initials: The initials of a dependant/patient.
    • patient_idtype: The type of document used as identification by the dependant/patient, for example, South African ID or Passport.
    • patient_idnumber: The identification number associated with the ID type of the dependant/patient.
    • patient_email: An email address, where electronic mail can be sent of the dependant/patient.
    • patient_cellnr: A cellphone number of the dependant/patient.
    • patient_landlinenr: A telephone number associated with a landline.  
    • patient_worknr: A telephone number associated with a landline of the dependant/patient.
    • patient_dateofbirth: The date of birth of the dependant/patient.
  • A Setting object: These are the required fields available on the Settings screen for billing settings, diary settings or entity settings for a specific object.


    • billing_settings: settings associated with billing. 
    • diaries_settings: settings associated with diaries.  
    • entity_settings: settings associated with each entity. 

  • Click on Close to exit the Settings screen without saving.


                            • Click on Save to save the new Settings.


                            Last modified: Friday, 11 June 2021, 1:54 PM