be.ehealth.businessconnector.ehbox.v3.session

## Interface EhealthBoxServiceV3

- All Known Implementing Classes:
    EhealthBoxServiceV3Impl

      public interface EhealthBoxServiceV3

  The Business Connector for General Practitioners provides a simplified interface to access the eHealth Box by providing the following functionality:

  - Sending a message
  - Retrieve general information about the General Practitioners mailbox, such as the number of messages, the size, etc.
  - Retrieve the list of messages
  - Retrieve a complete message (including its contents)
  - Move a message to the inbox
  - Retrieve the history of a message

  Pre-Requisites:
  An active and valid eHealth-platform session (initiated via the Session Management component)

  Default impl : `EhealthBoxServiceV3Impl`

- - ### Method Summary

    All Methods Instance Methods Abstract Methods Deprecated Methods
    Modifier and Type | Method and Description
    --- | ---
    `DeleteMessageResponse` | `deleteMessage(DeleteMessageRequest request)` delete specific message.
    `DeleteOoOResponse` | `deleteOoO(DeleteOoORequest request)` delete specific OoO périod.
    `GetAllEhboxesMessagesListResponse` | `getAllEhboxesMessagesList(GetAllEhboxesMessagesListRequest request)` retrieves all messages from all mailboxes for user.
    `GetBoxInfoResponse` | `getBoxInfo(GetBoxInfoRequest getBoxInfoRequest)` To retrieve general information relation to the eHealth Box of the General Practitioner: number of messages, total size of all available messages, etc.).
    `GetFullMessageResponse` | `getFullMessage(GetFullMessageRequest request)` Retrieves the entire message from the eHealth Box based on its unique identifier.
    `GetFullMessageResponse` | `getFullMessage(MessageRequestType request)` Deprecated.
    `GetMessageAcknowledgmentsStatusResponse` | `getMessageAcknowledgmentsStatusRequest(GetMessageAcknowledgmentsStatusRequest request)` Gets the acknowlegment status.
    `GetHistoryResponse` | `getMessageHistory(GetHistoryRequest request)` With the 'Get History' operation, a messages history can be consulted.
    `GetHistoryResponse` | `getMessageHistory(MessageRequestType request)` Deprecated.
    `GetMessagesListResponse` | `getMessageList(GetMessagesListRequest request)` The �Get message List� operation retrieves the list of messages in one of the available folders (inbox, bin or sent).
    `GetOoOListResponse` | `getOoOList(GetOoOListRequest request)` get list of periods of OoO for specific user.
    `InsertOoOResponse` | `insertOoO(InsertOoORequest request)` insert Out Of Office period.
    `MoveMessageResponse` | `moveMessage(MoveMessageRequest request)` Moves a message back to the inbox.
    `SendMessageResponse` | `sendMessage(SendMessageRequest sendMessageRequest)` The �Send Message� operation allows a message to be sent to one or more recipients.

- - ### Method Detail

    - #### sendMessage

          SendMessageResponse sendMessage(SendMessageRequest sendMessageRequest)
                                   throws ConnectorException

      The �Send Message� operation allows a message to be sent to one or more recipients. The sender has to be option to:

      - Provide one or more recipients (parameter �destinationContexts� provided as part of the request)
      - Send the new message in reply of an existing message to all original recipients, including the sender (parameter �messageIdForReplyToAll� provided as part of the request)
      - Send the new message in reply of an existing message to the original sender (parameter 'messageIdForReply' provided as part of the request)
      Only one of the above parameters can be present.
      Parameters:
        `sendMessageRequest` -
      Returns:
        Response containing an id, the status and the publication ID.
      Throws:
        `ConnectorException`

    - #### getBoxInfo

          GetBoxInfoResponse getBoxInfo(GetBoxInfoRequest getBoxInfoRequest)
                                 throws ConnectorException

      To retrieve general information relation to the eHealth Box of the General Practitioner: number of messages, total size of all available messages, etc.).

      Parameters:
        `getBoxInfoRequest` -
      Returns:
        Details about the inbox.
      Throws:
        `ConnectorException`

    - #### getMessageList

          GetMessagesListResponse getMessageList(GetMessagesListRequest request)
                                          throws ConnectorException

      The �Get message List� operation retrieves the list of messages in one of the available folders (inbox, bin or sent). The result contains a list of available messages, but only with partial information. To retrieve the entire message contents, the 'Get Full Message' operation must be invoked.

      Parameters:
        `request` - Indicates the folder for which the list of messages is returned (inbox, bin, sent).
      Returns:
        A list of Messages for the specified folder.
      Throws:
        `ConnectorException`

    - #### getFullMessage

          @Deprecated
          GetFullMessageResponse getFullMessage(MessageRequestType request)
                                                      throws ConnectorException

      Deprecated.

      Retrieves the entire message from the eHealth Box based on its unique identifier. Typically, first a list of new messages is retrieved via the 'Get Message List' operation and afterwards the individual message is claimed via this operation.

      Parameters:
        `request` - The message id.
      Returns:
        Information about the Sender and Message.
      Throws:
        `ConnectorException`

    - #### getFullMessage

          GetFullMessageResponse getFullMessage(GetFullMessageRequest request)
                                         throws ConnectorException

      Retrieves the entire message from the eHealth Box based on its unique identifier. Typically, first a list of new messages is retrieved via the 'Get Message List' operation and afterwards the individual message is claimed via this operation.

      Parameters:
        `request` - The message id.
      Returns:
        Information about the Sender and Message.
      Throws:
        `ConnectorException`

    - #### moveMessage

          MoveMessageResponse moveMessage(MoveMessageRequest request)
                                   throws ConnectorException

      Moves a message back to the inbox. The unique message identifier must be provided as input parameter.

      Parameters:
        `request` - The message id.
      Returns:
        Status of the operation.
      Throws:
        `ConnectorException`

    - #### getMessageHistory

          @Deprecated
          GetHistoryResponse getMessageHistory(MessageRequestType request)
                                                     throws ConnectorException

      Deprecated.

      With the 'Get History' operation, a messages history can be consulted.

      Parameters:
        `request` - The message id.
      Returns:
        List of MessageId from the older message versions.
      Throws:
        `ConnectorException`

    - #### getMessageHistory

          GetHistoryResponse getMessageHistory(GetHistoryRequest request)
                                        throws ConnectorException

      With the 'Get History' operation, a messages history can be consulted.

      Parameters:
        `request` - The message id.
      Returns:
        List of MessageId from the older message versions.
      Throws:
        `ConnectorException`

    - #### getMessageAcknowledgmentsStatusRequest

          GetMessageAcknowledgmentsStatusResponse getMessageAcknowledgmentsStatusRequest(GetMessageAcknowledgmentsStatusRequest request)
                                                                                  throws ConnectorException

      Gets the acknowlegment status.

      Parameters:
        `request` - the message id.
      Returns:
        The acknowledgement status.
      Throws:
        `ConnectorException`

    - #### deleteMessage

          DeleteMessageResponse deleteMessage(DeleteMessageRequest request)
                                       throws ConnectorException

      delete specific message.

      Parameters:
        `request` - the message id
      Returns:
        status in DeleteMessageResponse
      Throws:
        `ConnectorException`

    - #### insertOoO

          InsertOoOResponse insertOoO(InsertOoORequest request)
                               throws ConnectorException

      insert Out Of Office period.

      Parameters:
        `request` - user and period of OoO
      Returns:
        status in InsertOoOResponse
      Throws:
        `ConnectorException`

    - #### getOoOList

          GetOoOListResponse getOoOList(GetOoOListRequest request)
                                 throws ConnectorException

      get list of periods of OoO for specific user.

      Parameters:
        `request` - user id
      Returns:
        list of OoO in GetOoOListResponse
      Throws:
        `ConnectorException`

    - #### deleteOoO

          DeleteOoOResponse deleteOoO(DeleteOoORequest request)
                               throws ConnectorException

      delete specific OoO périod.

      Parameters:
        `request` - period OoO id
      Returns:
        status in DeleteOoOResponse
      Throws:
        `ConnectorException`

    - #### getAllEhboxesMessagesList

          GetAllEhboxesMessagesListResponse getAllEhboxesMessagesList(GetAllEhboxesMessagesListRequest request)
                                                               throws ConnectorException

      retrieves all messages from all mailboxes for user.
      Parameters:
        `request` -
      Returns:
      Throws:
        `TechnicalConnectorException`
        `EhboxBusinessConnectorException`
        `SessionManagementException`
        `ConnectorException`

Connector Packaging PERSPHYSICIAN 4.8.6 API
Copyright © {inceptionYear}-2026 eHealth. All Rights Reserved.