New patient¶

Introduction¶

With this API call you register a patient in Bricks Huisarts. Keep in mind that deleting patients in Bricks Huisarts is not possible.

We advice you to place webbased registrations to the practice in a kind ‘buffer’. Do not store registration directly in Bricks Huisarts using a API call. When using a ‘buffer’ you can prevent spambots to pollute the Bricks Huisarts database.

Another advantage of using a ‘buffer’ is that an employee of the practice can act as a filter that will prevent unauthorized registrations.

Account creation for patients¶

It is not possible to create a login account for the patient using the API, accounts are created in Bricks Huisarts.

Request¶

Required

In case there is no data for Inschrijfdatum, Uitschrijfdatum and/or Overlijdensdatum sending an empty node is not allowed. In those cases please enter the following data: 0001-01-01T00:00:00

Server token needed

To send the request to the API a server token is needed.

<His_Example>
  <Identificatie xsi:type="OZB_Communicatie_Identificatie_Servertoken" Id="-1001">
    <Token>[server token]</Token>
  </Identificatie>
  ...
</His_Exmaple>

The practice code be found in the setup documentation.

Practice code needed

To successfully store data in Bricks Huisarts using the API you need to add a <OntvangerEntiteit /> to the request.

<His_Example>
  <Identificatie />
  <OntvangerEntiteit>[practice code]</OntvangerEntiteit>
  ...
</His_Exmaple>

The practice code be found in the setup documentation. In case you know the practice AGB-code this can also be used to send the request to the corresponding practice.

<?xml version="1.0" encoding="utf-16"?>
<His_NieuwePatient_Verzoek xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" Id="-1000">
  <Identificatie xsi:type="OZB_Communicatie_Identificatie_Servertoken" Id="-1001">
    <Token>[server token]</Token>
  </Identificatie>
  <OntvangerEntiteit>[practice code]</OntvangerEntiteit>
  <Administratief Id="-1000">
    <Geslacht>NHG_Geslacht_Man</Geslacht>
    <Geboortedatum>2003-02-01T00:00:00</Geboortedatum>
    <Praktijk Id="-1000">
      <Adres Id="-1000">
        <Landcode>OZB_NietGevuld</Landcode>
      </Adres>
      <Telefoonnummers />
    </Praktijk>
    <AGBArts>01021077</AGBArts>
    <Telefoonnummers>
      <OZB_Telefoonnummer Id="-1001">
        <Nummer>Telephone</Nummer>
        <TypeTelefoonNummer>OZB_NietGevuld</TypeTelefoonNummer>
      </OZB_Telefoonnummer>
    </Telefoonnummers>
    <Email>email@email.com</Email>
    <BSN>000000000</BSN>
    <Naam Id="-1000">
      <NaamGebruik>NHG_Naamgebruik_Naam_echtgenoot_gevolgd_door_eigen_naam</NaamGebruik>
      <Voornaam>First</Voornaam>
      <Voorletters>I.N.I.T</Voorletters>
      <TussenvoegselEigennaam>Adject</TussenvoegselEigennaam>
      <Eigennaam>Last name</Eigennaam>
      <TussenvoegselPartnernaam></TussenvoegselPartnernaam>
      <Partnernaam></Partnernaam>
    </Naam>
    <Geboorteplaats>Utrecht</Geboorteplaats>
    <Woonadres Id="-1001">
      <Straatnaam>Street</Straatnaam>
      <Huisnummer>10</Huisnummer>
      <Postcode>1234 PC</Postcode>
      <Plaatsnaam>City</Plaatsnaam>
      <Landcode>NHG_Land_Nederland</Landcode>
      <Land>Nederland</Land>
    </Woonadres>
    <RedenInschrijving>OZB_NietGevuld</RedenInschrijving>
    <RedenUitschrijving>OZB_NietGevuld</RedenUitschrijving>
    <Inschrijfdatum>0001-01-01T00:00:00</Inschrijfdatum>
    <Uitschrijfdatum>0001-01-01T00:00:00</Uitschrijfdatum>
    <StandaardBezorgen>false</StandaardBezorgen>
    <Zorgverleners />
    <HoofdbehandelaarId>0</HoofdbehandelaarId>
    <Woonverbandnummer>0</Woonverbandnummer>
    <IsOverleden>false</IsOverleden>
    <Overlijdensdatum>0001-01-01T00:00:00</Overlijdensdatum>
    <IsIngeschreven>false</IsIngeschreven>
    <SoortPatient>OZB_NietGevuld</SoortPatient>
    <Categorieen />
    <Metagegevens />
    <OokBekendAls />
    <Memos />
  </Administratief>
</His_NieuwePatient_Verzoek>

Response¶

<?xml version="1.0" encoding="utf-16"?>
<His_NieuwePatient_Antwoord xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" Id="-1000">
   <CommunicatieStatus>OZB_Communicatie_Status_Verzoek_is_geslaagd</CommunicatieStatus>
   <StatusTekst>Patient is toegevoegd.</StatusTekst>
   <ObjectId>157645</ObjectId>
</His_NieuwePatient_Antwoord>

<ObjectId /> is het patiëntnummer van de zojuist aangemaakte patiënt.

Waarden¶

<Geslacht /> opties¶

Waarde	Uitleg
NHG_Geslacht_Man	Man
NHG_Geslacht_Vrouw	Vrouw
NHG_Geslacht_Onbekend	Onbekend
NHG_Geslacht_Niet_gespecificeerd	Niet gespecificeerd

<TypeTelefoonNummer /> opties¶

Waarde	Uitleg
OZB_TypeTelefoonNummer_Vaste_lijn	Vaste lijn
OZB_TypeTelefoonNummer_Fax	Fax
OZB_TypeTelefoonNummer_Mobiel	Mobiel
OZB_TypeTelefoonNummer_Vrije_tekst	Vrije tekst

<NaamGebruik /> opties¶

Waarde	Uitleg
NHG_Naamgebruik_Eigen_naam	Eigen naam
NHG_Naamgebruik_Naam_echtgenoot	Naam echtgenoot
NHG_Naamgebruik_Naam_echtgenoot_gevolgd_door_eigen_naam	Naam echtgenoot gevolgd door eigen naam
NHG_Naamgebruik_Eigen_naam_gevolgd_door_naam_echtgenoot	Eigen naam gevolgd door naam echtgenoot
NHG_Naamgebruik_Pseudoniem	Pseudoniem

<RedenInschrijving />¶

Waarde	Uitleg
NHG_RedenInschrijving_Van_andere_arts	Van andere arts
NHG_RedenInschrijving_Verhuizing	Verhuizing
NHG_RedenInschrijving_Geboorte	Geboorte
NHG_RedenInschrijving_Tijdelijk_uit_andere_praktijk	Tijdelijk uit andere praktijk
NHG_RedenInschrijving_Huwelijk	Huwelijk
NHG_RedenInschrijving_Her_inschrijving_na_tijdelijk_afwezig	Her-inschrijving na tijdelijk afwezig
NHG_RedenInschrijving_Onbekend	Onbekend
NHG_RedenInschrijving_Overig	Overig

<RedenUitschrijving />¶

Waarde	Uitleg
NHG_RedenUitschrijving_Naar_andere_arts	Naar andere arts
NHG_RedenUitschrijving_Verhuizing	Verhuizing
NHG_RedenUitschrijving_Overleden	Overleden
NHG_RedenUitschrijving_Tijdelijk_buiten_praktijk	Tijdelijk buiten praktijk
NHG_RedenUitschrijving_Militaire_dienst	Militaire dienst
NHG_RedenUitschrijving_Verpleeghuis_inrichting	Verpleeghuis/inrichting
NHG_RedenUitschrijving_Onbekend	Onbekend
NHG_RedenUitschrijving_Overig	Overig

<SoortPatient />¶

Waarde	Uitleg
NHG_SoortPatient_Vastepatient	Vastepatiënt
NHG_SoortPatient_Tijdelijke	Tijdelijke
NHG_SoortPatient_Bedrijfpatient	Bedrijfpatiënt
NHG_SoortPatient_Waarneempatient	Waarneempatiënt
NHG_SoortPatient_Passant	Passant
NHG_SoortPatient_Onbekend	Onbekend
NHG_SoortPatient_Overig	Overig

Last update: 29-01-2024