Lever een pdf, zoals de factuur, mee bij het aanmaken van een proces, of los met POST /v3/documents. Je klant ziet het document in MijnDossier. Achteraf pas je de naam of zichtbaarheid aan, of verberg je het document. Belgische ziekenhuizen sturen ook een D-form mee.
Welke manier kies je?
| Situatie | Gebruik |
|---|---|
| Je maakt het proces aan en hebt het document al | Stuur het document mee in POST /v3/collection_orders (veld document). Het wordt direct aan het proces gekoppeld. |
| Het proces bestaat al | POST /v3/documents met het procesnummer in cid. |
| Het document is er eerder dan het proces | POST /v3/documents zonder cid. Een flowstap koppelt het document later aan het proces op basis van de bestandsnaam, bijvoorbeeld het factuurnummer. Laat POM die stap inrichten. |
Een document is altijd een pdf, als base64 meegestuurd. Elk document kost 40 punten. Zie Aan de slag met de API.
Een document aanpassen of verbergen
- Met
PATCH /v3/documents/{id}wijzig je de bestandsnaam, de omschrijving of de zichtbaarheid in MijnDossier. De omschrijving is de naam die je klant ziet; maak die uniek, bijvoorbeeld "Factuur 12345". - Met
DELETE /v3/documents/{id}verberg je het document in MijnDossier en op de selfservicepagina. Een document dat al per post is verstuurd, blijft natuurlijk bij de klant. - Wil je een document in een e-mail meesturen, dan moet het zichtbaar zijn in MijnDossier.
D-form meesturen (België)
Voor Belgische ziekenhuisfacturen kun je de gegevens van de D-form aan een proces koppelen met POST /v3/collection_orders/{id}/d_form. De D-form gaat mee met de brief, zodat de patiënt de kosten bij de ziekteverzekering kan indienen.
- Je stuurt het type (
grioftxt) en de inhoud, maximaal 1 MB. - Per proces is er één D-form. Stuur je opnieuw, dan wordt de vorige overschreven.
- De gegevens worden versleuteld opgeslagen.