Journal (add data)

Before you start

To access this API method you need to be logged in to the Bricks Switchboard. Each request needs to contain:

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.

Request

You can add data to the patient journal with the following request:

<?xml version='1.0' encoding='UTF-8'?>
<His_VoegJournaalToe_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>
  <PatientId>0</PatientId>
  <ContactId>[contact ID]</ContactId>
  <Journaal Id="-1000">
    <Contacten>
      <His_Contact Id="-1000">
        <Contacttype>OZB_NietGevuld</Contacttype>
        <Datum>0001-01-01T00:00:00</Datum>
        <ZorgverlenerId>0</ZorgverlenerId>
        <Deelcontacten>
          <HIS_Deelcontact Id="-1000">
            <EpisodeId>0</EpisodeId>
            <Deelcontactregels>
              <His_Deelcontactregel xsi:type="His_CorrespondentieUit" Id="-1000">
                <DatumTijd>0001-01-01T00:00:00</DatumTijd>
                <IsAttentie>false</IsAttentie>
                <IsVoorgeschiedenis>false</IsVoorgeschiedenis>
                <SOEP>OZB_NietGevuld</SOEP>
                <RegelNummer>0</RegelNummer>
                <Samenvatting>[summary of document]</Samenvatting>
                <Specialisme>OZB_NietGevuld</Specialisme>
                <Document Id="-1000">
                  <Deeldocumenten>
                    <OZB_Deeldocument Id="-1000">
                      <MimeType>OZB_NietGevuld</MimeType>
                      <BestandBase64>[base64 encoded file content]</BestandBase64>
                      <BestandsNaam>[filename.extension]</BestandsNaam>
                    </OZB_Deeldocument>
                  </Deeldocumenten>
                </Document>
              </His_Deelcontactregel>
            </Deelcontactregels>
          </HIS_Deelcontact>
        </Deelcontacten>
      </His_Contact>
    </Contacten>
    <Allergieen></Allergieen>
    <Contraindicaties></Contraindicaties>
    <Episodes></Episodes>
    <WikiPaginas></WikiPaginas>
  </Journaal>
</His_VoegJournaalToe_Verzoek>

Add document to the patient journal

The following data needs to be added to the XML to add a document to the journal of a patient:

Node

Comment

<ContactId />

The contact where the document will be visible. The ContactId is received by initial request to external protal.

<Samenvatting />

Summary of the document.

<BestandBase64 />

Base64 encoded string of document content.

<BestandsNaam />

Filename with the correct document extension.

Response

<?xml version="1.0" encoding="utf-16"?>
<His_VoegJournaalToe_Antwoord xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" Id="-1002">
  <CommunicatieStatus>OZB_Communicatie_Status_Verzoek_is_geslaagd</CommunicatieStatus>
  <StatusTekst />
  <Transactiestatus>OZB_NietGevuld</Transactiestatus>
</His_VoegJournaalToe_Antwoord>

Last update: 29-01-2024