zoo-api/schemas/PatIdentity.yaml

bsn:
  $ref: 'pat-BSN.yaml'
name:
  $ref: 'pat-Name.yaml'
gender:
  description: |-
    Patient's gender. `M` = male, `V` = female, `O` = other/unknown.
    
    Follows [NHG-table-4](https://referentiemodel.nhg.org/sites/default/files/NHG-Tabel%204-Geslacht-versie-5-Inkijkexemplaar_1.pdf).    
  type: string
  example: V
  enum:
    - M
    - V
    - O
dob:
  $ref: 'pat-DOB.yaml'
category:
  description: |-
    The status of the patient's registration within this practice.
    
    As per [NHG-table-5](https://referentiemodel.nhg.org/sites/default/files/NHG-Tabel%205-Categorie%20pati%C3%ABnt-versie-5-Inkijkexemplaar_1.pdf).
    
    The commonly used status letters are:
    * `V` = Standard patient, part of the GP's population (dutch: _vast_).
    * `T` = Temporary patient (likely do _not_ treat as part of GP's population).
    * `P` = Opportunity patient (dutch: _passant_ - patient is not signed up with this GP. For example: tourist).    
  type: string
  example: V
doctor:
  description: |-
    If known, the AGB code of the primary care GP (dutch: _Inschrijf arts_).
    
    Value 0 indicates this HIS or practice doesn't assign patients to individual GPs,
    or this information isn't known.    
  type: number
  example: 1051234
address:
  description: Patient's address (where they live). If not known, this property will not be in the response.
  type: object
  properties:
    street:
      description: Full name of the street, excluding house number.
      type: string
      example: Lange Geer
    housenumber:
      description: |-
        Just the house number; 0 if unknown or in the exotic case where no house number exists. This does
        not include any addendums such as 'A' or 'room 15'. Guaranteed to be non-negative, and at most 5 digits.        
      type: integer
      example: 4
    housenumber_suffix:
      description: |-
        The string that follows the numeric part of the address house number.
        
        For example, `"A"`, or `"k22"`. Most addresses don't have one.        
      type: string
      example: A
      default: ""
    postcode:
      description: The post code, in `1234AB` format. If not known, blank.
      type: string
      example: 2611PV
    city:
      description: The city or town.
      type: string
      example: Delft
contact:
  type: object
  properties:
    tel:
      description: |-
        Patient's phone number(s).
        
        By convention, the mobile number, if available, is always listed first.
        
        Phone numbers are always in international format (they start with a `+` symbol).
        If no phone numbers are available or patient has no phone, an empty list is returned.        
      type: array
      example: ["+31612345678", "+31701234567"]
      items:
        type: string
    email:
      description: |-
        Patient's email address(es); first one returned is indicated as preferred.
        
        If no emails are known or available, or patient has no email, an empty list is returned.        
      type: array
      items:
        type: string
      example: ["info@zorgoporde.nl"]
insurance:
  description: |-
    Info about where the patient is insured.
    
    If patient is not insured, this field will not be present.
    
    Only the main insurance used for reimbursement of GP costs will be returned, if any such insurance exists.    
  type: object
  properties:
    policy_number:
      description: |-
        Patient's insurance registration number (dutch: _polisnummer_).
        
        In theory can contain alphanumeric characters but no insurer does that as far as we know.
        
        _if_ the value is fully numeric, any leading zeroes will be stripped.
        
        We suggest this number is parsed and stored as a string; they can be longer than the limits of
        32-bit/64-bit numbers and therefore exceed JSON's limits on numeric values.        
      type: string
      example: 123456789012345
    uzovi:
      $ref: 'insurer-Uzovi.yaml'
patid:
  $ref: 'pat-patId.yaml'
patUnid:
  $ref: 'pat-patUnid.yaml'
startDate:
  type: string
  format: date
  description: |-
    Date patient joined the practice (dutch: _inschrijf datum_).
    
    In rare cases, a patient joined so long ago, this date is no longer known. In this case,
    a sentinel value of `"1900-01-01"` is sent which is presumed to result in the desired behaviour
    (which is to consider this patient as part of this practice's population regardless of how far
    back you want to go).    
  example: 1994-08-20
endDate:
  type: string
  format: date
  description: |-
        If present, patient has exited the practice on this date. (dutch: _uitschrijf datum_).
  default: ""
endReason:
  description: |-
    Reason patient left the practice (dutch: _reden vertrek_).
    
    This property is never present if `endDate` isn't present. Otherwise, this value _might_ contain
    a non-blank letter as per [NHG-table-9](https://referentiemodel.nhg.org/sites/default/files/NHG-Tabel%209-Reden%20vertrek-versie-5-Inkijkexemplaar_1.pdf):
    
    * `A` = To other practice
    * `V` = Moved
    * `O` = died
    * `T` = Temporary
    * `I` = Care home / institution
    * `Q` = unknown
    * `X` = Other    
  type: string
  default: ""
careprograms:
  type: object
  properties:
    principal:
      description: |-
        A list of keys (strings) describing which care programs this patient
        is actively receiving (they have been diagnosed or marked for inclusion in
        the program, _and_ they are marked as receiving this care via the GP (not a specialist),
        _and_ they are marked as being actively enrolled in a chronic care program for it).
        
        A program is considered _principal_ (in contrast to _auxiliary_) if no other program
        the patient is actively participating in supersedes it (even partially).
        
        The list of possible care program values can change; we advise treating this value as
        a plain string and not an enum hardcoded in your codebase.
        
        Note that careprogram inclusion depends on a GP practice's processes; if Zorg op Orde
        has not been informed about these, no care programs will be reported.
        
        Currently, the set of possible values is
          - dm
          - copd
          - astma
          - hvz
          - vvr
          - ouderenzorg
          - atriumfibrilleren
          - hartfalen
          - dermatoscopie
          - fractuurpreventie
          - ecg        
      type: array
      items:
        type: string
      example: ["dm", "copd"]
    auxiliary:
      description: |-
        Just like _principal_, except, all programs listed here are incompletely applied
        because another program the patient participates in covers some or all of the care
        implied by this program, and this program is treated as the auxiliary one.        
      type: array
      items:
        type: string
      example: ["vvr"]