In de praktijk
In de praktijk zijn er twee hele belangrijken verschillen in aanmeldingen voor een intermediair, hieronder leggen we ze uit:
Een aanmelding initiëren: Dit gebeurt wanneer de intermediair zelf actief een zorgverlener aanmeldt op een dienst die door een zorgorganisatie is gepubliceerd. De intermediair kiest dus bewust een zorgverlener voor een openstaande dienst en verstuurt die aanmelding via de API. In dit geval is de intermediair de partij die het initiatief neemt.
Een voorgestelde aanmelding accepteren: Dit gebeurt wanneer de zorgorganisatie zelf een zorgverlener direct op een dienst plaatst. De intermediair ontvangt dan een melding van deze plaatsing — een voorgestelde aanmelding — die nog moet worden geaccepteerd. Pas na deze bevestiging wordt de aanmelding definitief goedgekeurd. Hier neemt de zorgorganisatie dus het initiatief.
API-implementatie
Bij het gebruik van GET /applications zie je verschillende statussen terugkomen. Als intermediair kun je in de praktijk via POST /applications slechts twee acties uitvoeren die invloed hebben op deze statussen.
Een aanmelding initiëren: Gebruik POST /applications met de status APPLIED. Hiermee meld je een zorgverlener actief aan op een dienst. Status van aanmelding zal daarna WAITING_FOR_PLANNING_SYSTEM zijn.
Een voorgestelde aanmelding accepteren: Doe een GET /applications om aanvragen met de status WAITING_FOR_WORKER_CONFIRMATION op te halen. Gebruik de gevonden shift- en worker-UUID’s om vervolgens een POST /applications te doen met de status APPROVED. Daarmee bevestig je het voorstel van de zorgorganisatie en wordt de plaatsing definitief. Status zal hierna APPROVED zijn.