get:
  operationId: customerBasicGet
  tags:
    - Customer management
  summary: Basic info
  parameters:
    - name: agb
      in: query
      description: |-
        AGB of the practice for which basic info is requested.
        If the requesting entity is a single GP practice, this parameter can be omitted.
      schema:
        $ref: ../schemas/agb.yaml
  responses:
    '200':
      description: Basic information of a practice.
      content:
        application/json:
          schema:
            type: object
            properties:
              practice:
                type: object
                properties:
                  name:
                    type: string
                  officialName:
                    type: string
                  practiceAgb:
                    description: The AGB of the practice, if the customer in the response is a practice, otherwise omitted. One of practiceAgb or institutionAgb is always present.
                    $ref: ../schemas/agb.yaml
                  institutionAgb:
                    description: The AGB of the institution, if the customer is a care group or other institute, otherwise omitted. One of practiceAgb or institutionAgb is always present.
                    $ref: ../schemas/agb.yaml
                  gpis:
                    $ref: ../schemas/GPIS.yaml
                  doctors:
                    description: AGBs of the doctors working in the practice.
                    type: array
                    items:
                      $ref: '../schemas/PatIdentity.yaml#/doctor'
                  address:
                    type: object
                    properties:
                      address1:
                        type: string
                        description: The first line of the practice postal address (street name and house number, generally).
                      postcode:
                        $ref: ../schemas/postcode.yaml
                      city:
                        $ref: ../schemas/city.yaml
                  contact:
                    type: object
                    properties:
                      tel:
                        type: string
                      email:
                        type: string
                  dataProcessing:
                    type: object
                    properties:
                      controllers:
                        description: A list of personnel responsible for the data. Usually the practice owner.
                        type: array
                        items:
                          type: string
                      agreement:
                        example: If set, the signer and date of the data processing agreement between the controller (responsible general practitioner) and processor (Zorg op Orde).
                        type: object
                        properties:
                          signedBy:
                            description: Full name of the signer.
                            type: string
                          signedOn:
                            description: Date of signing the data processing agreement.
                            example: 20160501T1344
                            $ref: ../schemas/date.yaml
                required:
                  - name
                  - officialName
    '400':
      description: If the specified customer is not a practice but some other entity, e.g. a care group.
    '401':
      $ref: '../zoo-api.yaml/#/components/responses/NoAuth'
    '403':
      $ref: '../zoo-api.yaml/#/components/responses/NoAccess'
post:
  operationId: customerBasicPost
  tags:
    - Customer management
  summary: Basic info
  description: Only certain properties of a practice can be updated. After updating the same response is outputted as when using GET.
  parameters:
    - name: agb
      in: query
      description: |-
        AGB of the practice for which basic info is requested.
        If the requesting entity is a single GP practice, this parameter can be omitted.
      schema:
        $ref: ../schemas/agb.yaml
  requestBody:
    description: |-
      When authorized as a practice the address and contact data can be changed.
      Currently, if authorized as a care group, no properties can be changed.
      
      Properties can be omitted if you do not want to change them. `address1` and `postcode` cannot be set to empty.
    content:
      'application/x-www-form-urlencoded':
        schema:
          type: object
          properties:
            address1:
              type: string
              description: The first line of the practice postal address (street name and house number, generally).
            postcode:
              description: Any valid Dutch postcode, with or without whitespacing and in lower- or uppercase.
              $ref: ../schemas/postcode.yaml
            city:
              $ref: ../schemas/city.yaml
            tel:
              description: A Dutch phone number of 10 digits. Additional dashes and spacing are removed before validating.
              type: string
            email:
              type: string
              format: email
  responses: 
    $ref: '#/get/responses'