You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
zoo-api/paths/customer_basic.yaml

138 lines
5.6 KiB
YAML

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
gpisMethod:
description: The current GPIS type and how medical dossiers are transferred to Zorg op Orde.
example: HealthConnected (automatische koppeling)
lastImport:
$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).
example: Dorpsstraat 1
postcode:
$ref: ../schemas/postcode.yaml
city:
$ref: ../schemas/city.yaml
contact:
type: object
properties:
tel:
type: string
example: "0612345678"
email:
type: string
example: "M.Dobbelsteen@zorgoporde.nl"
dataProcessing:
type: object
properties:
controllers:
description: A list of personnel responsible for the data. Usually the practice owner.
type: array
example: ["Mien Dobbelsteen", "Lydie van der Ploeg"]
items:
type: string
agreement:
type: object
properties:
signedBy:
description: Full name of the signer.
type: string
example: Lydie van der Ploeg
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':
description: |-
User is not allowed to access this API endpoint, or,
the practice identified by the `agb` parameter does not have a relationship with the
user (for example, they do not belong to your care group).
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'