Vault Safety supports receiving E2B(R2) and (R3) files from AS2 Gateway trading partners or through the Vault API.

Receiving E2B Transmissions

When Vault Safety receives an E2B Transmission, the system imports the E2B file and automatically creates an Inbox Item for each Case in the E2B file.

Vault Safety can receive single or multi-case E2B Transmissions from the following sources:

  • E2B files sent through the Vault API Receive E2B endpoint
  • Incoming AS2 Gateway Transmissions

During E2B Transmission import, Vault Safety validates the data against the Transmission Profile’s Validation Criteria. For each Transmission Profile, your Admin can configure the Validation Criteria based on the Sender.

Prerequisites

Before you can receive E2B Transmissions from a trading partner or health authority, your Admin must set your Vault up to communicate with the sender:

To validate the E2B Transmission data against sender-based validation rules, your Admin must:

E2B Receive Process

The following image shows how Vault Safety processes incoming E2B Transmissions:

Receive Gateway Transmissions Process

When Vault Safety receives an E2B Individual Case Safety Report (ICSR) from an AS2 gateway or API Transmission, the system performs the following actions:

  1. Creates an Inbound Transmission record.
  2. Adds the Transmission documents to the Library, including:
    • The E2B file
    • Narrative and translations
    • Attachments
  3. Initiates the import E2B process to create an Inbox Item from the E2B file.
  4. Performs data conformance checks on the incoming E2B(R2) or (R3).
    See the E2B Transmission Data Conformance Validations section for more information.
  5. Performs sender-based inbound validation (if enabled and configured).
    You can access the validation results for each Validation Criteria and a validation summary file in the Inbound Validation Result section of the Inbox Item.
  6. Creates the Inbox Item.
  7. Generates an ICSR acknowledgment, which is attached to the Inbound Transmission.
  8. For Gateway Transmissions, automatically returns the acknowledgment to the sender.

For E2B Import mapping, see E2B Case Import Data Mapping.

Data Conformance Validations

Before the system validates the incoming E2B file based on the configured Validation Criteria on the Transmission Profile, it performs data conformance checks.

The following table provides the list of conformance checks based on whether the Enable Sender-Based Inbound Validation setting is enabled:

Enabled NOT Enabled
For any date field, if the minimum date precision is not met, the system still imports the date. For any date field, if the minimum date precision is not met, the system does not import the field and will provide a warning.
For fields with a value and unit, if either the value field or unit field is left blank, the system imports the populated field. For fields with a value and unit, if either the value or unit field is missing, the system does not import the populated field and will provide a warning.
For any text field, if the text value exceeds the maximum length of characters, the import fails and a NACK (commit rejected or CR) is sent to the sender (if a Gateway Transmission). Same as enabled.
For any number field, if the number value falls outside the minimum-maximum range, the import fails and a NACK is sent to the sender (if a Gateway Transmission). Same as enabled.
For decimal number values, if the value exceeds the maximum number of decimal places, the import fails and a NACK is sent to the sender (if a Gateway Transmission). For decimal number values, if the value exceeds the maximum number of decimal places, the system truncates the value without providing a warning.

If the Enable Sender-Based Inbound Validation setting is enabled, the system generates a validation summary file with the failed validations and attaches it to the Inbound Validation Result section on the Inbox Item. For E2Bs that failed to import, the corresponding Inbox Item is set to the Import Error state.

Acknowledgment Generation

When an Inbox Item is imported from an E2B file, Vault Safety generates an ICH-compliant E2B ICSR acknowledgment in the same E2B format the file was received in. Vault Safety supports generating both E2B(R2) and (R3) ACKs.

For Gateway Transmissions, the system automatically returns the acknowledgment to the origin Gateway.

For API Transmissions, a separate API call (Retrieve Job Status) returns the acknowledgment.

You can also view the acknowledgment on the Inbound Transmission record, attached to the Case imported from the E2B file.

View the Acknowledgment

  1. From the Inbox, open the Inbox Item received from an E2B Transmission.
  2. Expand Inbound Transmissions.
  3. Open the Inbound Transmission, and then expand Transmission Messages.
  4. Open the Transmission Message.
    The acknowledgment file is an attachment on the Transmission Message.
  5. To view the acknowledgment, select Message Body.

Result

A window appears displaying the acknowledgment.

ACK Generation Mapping

Review the following sections to learn how Vault Safety generates E2B R3 and R2 ACKs:

E2B R3 ACK

The E2B (R3) Acknowledgment message is comprised of two sections:

  1. Message Header Section, which contains:
    • ACK.M Section ICSR Batch Acknowledgment Header
    • ACK.B section ICSR Message Acknowledgment Header (repeated for each report in the file)
  2. ACK.A Section ICSR Batch Acknowledgment Header

The following sections describe how Vault Safety maps information to populate the E2B (R3) ACK.

M.1 ICSR Message Header

E2B Data Element Name Populated Value
ACK.M.1 Acknowledgement Batch Number The GUID of the record being created.
ACK.M.2 Acknowledgement Batch Sender Identifier The value from the Destination ID (destination_transmission_id__v) field on the Inbound Transmission (transmission__v).
ACK.M.3 Acknowledgement Batch Receiver Identifier The value from the Origin ID (origin_transmission_id__v) field on the Inbound Transmission (transmission__v).
ACK.M.4 Acknowledgement Date of Batch Transmission The date and time to the second of the ACK generation.
ACK.A.1 ICSR Batch Number The value from the E2B Message ID (e2b_message_id__v) field on the Inbound Transmission (transmission__v), which is mapped from data element N.1.2 in the received E2B file.
ACK.A.2 Acknowledgement Local Message Number The message number is populated in the format {transmission__v.name__v}_{GUID}_YYYYMMDDHHMMSS
ACK.A.3 Date of ICSR Batch Transmission The value from the Transmission Date (transmission_date__v) field on the Inbound Transmission (transmission__v), which is mapped from data element N.1.5 in the received E2B file.
ACK.A.4 Transmission Acknowledgement Code An acknowledgment code is populated, based on the result of the E2B Import action.
  • AA—E2B Import Success
  • AE—E2B Import with Warnings
  • AR—E2B Failure

If the Sender-Based Inbound Validations feature is enabled, an acknowledgment code is populated based on the result of the data conformance and sender-based Validation Criteria checks, and not on the E2B import status.

ACK.A.5 Batch Validation Error If ACK.A.4 is Warning (02) or Failure (03), this element contains the error message.

ACK.B.r ICH ICSR Message Acknowledgement Header

E2B Data Element Name Populated Value
ACK.B.r.1 ICSR Message Number If the inbound E2B file has a Wordlwide UID (C.1.8.1) that matches the Inbox Item UID, this value is mapped from the Inbox Item Worldwide UID (wwuid__v) field. Otherwise, this is mapped from the Case Identifier (name__v) of the Case Identifier (case_identifier__v) where (source__v == case_contact__v.organization__v of type Sender)
ACK.B.r.2 Local Report Number The Name (name__v) of the Inbox Item imported from the E2B file.
ACK.B.r.3 ICSR Message ACK Receiver Identifies the organization that submitted the ICH ICSR message. The value from the Origin ID (origin_transmission_id__v) field on the Inbound Transmission (transmission__v).
ACK.B.r.4 ICSR Message ACK Sender Identifies the organization that received the ICH ICSR message. The value from the Destination ID (destination_transmission_id__v) field on the Inbound Transmission (transmission__v).
ACK.B.r.5 Date of ICSR Message Creation The date the ICSR message was created.
ACK.B.r.6 Acknowledgment Code for a ICSR Message An acknowledgment code is populated, based on the result of the E2B Import action.
  • CA—E2B Import Success or Success with Warnings
  • CR—E2B Failure

If the Sender-Based Inbound Validations feature is enabled, an acknowledgment code is populated based on the result of the data conformance and sender-based Validation Criteria checks, and not on the E2B import status.

ACK.B.r.7 Error / Warning Message or Comment More details about the E2B import warning or failure from ACK.B.r.6, to a limit of 250 characters.

E2B R2 ACK

The E2B (R2) Acknowledgment message is comprised of two sections:

  1. Message Header Section
  2. Acknowledgment Section, which contains:
    • Message Acknowledgment
    • Report Acknowledgment (repeated for each report in the file)

The following sections describe how Vault Safety maps information to populate the E2B (R2) ACK.

M.1 ICSR Message Header

E2B Data Element Name Populated Value
M.1.1 Message Type Populated with ichicsrack
M.1.2 Message Format Version Populated with 1.1
M.1.3 Message Format Release Populated with 1.0
M.1.4 Message Number The GUID of the ACK message.
M.1.5 Message Sender Identifier The value from the Destination ID (destination_transmission_id__v) field on the Inbound Transmission (transmission__v).
M.1.6 Message Receiver Identifier The value from the Origin ID (origin_transmission_id__v) field on the Inbound Transmission (transmission__v).
M.1.7 Message Date The date and time to the second of the ACK generation.

A.1 Message Acknowledgement

E2B Data Element Name Populated Value
A.1.1 ICSR Message Number The value from the E2B Message ID (e2b_message_id__v) field on the Inbound Transmission (transmission__v), which is mapped from data element N.1.2 in the received E2B file.
A.1.5b ICSR Message Date The value from the Transmission Date (transmission_date__v) field on the Inbound Transmission (transmission__v), which is mapped from data element N.1.5 in the received E2B file.
A.1.6 Transmission Acknowledgement Code An acknowledgment code is populated, based on the result of the E2B Import action.
  • 01—All reports loaded into the database
  • 02—ICSR Error, not all reports loaded into the database, check section B for errors
  • 03—SGML parsing error, no data extracted
A.1.7 Parsing Error Message If A.1.6 is 03, then this element is populated with "Message cannot be parsed."

B.1 Report Acknowledgement

E2B Data Element Name Populated Value
B.1.1 Safety Report ID If the inbound E2B file has a Wordlwide UID (C.1.8.1) that matches the Inbox Item UID, this value is mapped from the Inbox Item Worldwide UID (wwuid__v) field. Otherwise, this is mapped from the Case Identifier (name__v) of the Case Identifier (case_identifier__v) where (source__v == case_contact__v.organization__v of type Sender)
B.1.3 Local Report Number The Name (name__v) of the Inbox Item imported from the E2B file.
B.1.4 Regulatory Authority's Case Report Number The value from the Worldwide UID (wwuid__v) field on the Inbox Item, which is mapped from data element A.1.10.1 in the received E2B file. This element is displayed if the Inbound Transmission.First Sender = Regulatory (the file was sent from a regulatory authority).
B.1.5 Other Sender's Case Report Number This is mapped from the data element A.1.10.2 in the received E2B file. This element is displayed if the Inbound Transmission.First Sender = Other (the file was sent from a non-regulatory sender).
B.1.7 Date of Receipt of the Most Recent Information This is mapped from the data element A.1.7 in the received E2B file.
B.1.8 Acknowledgment Code for a Report An acknowledgement code is populated, based on the result of the individual ICSR import.
  • 01—Report Loaded Successfully
  • 02—Report Not Loaded
B.1.9 Error Message or Comment More details about the specific E2B import warnings or failures encountered, to a limit of 250 characters.