You can transmit individual case safety reports from Vault Safety to AS2 Gateway endpoints.

What is AS2 Gateway Communication

Vault Safety supports AS2 interchange to communicate with trading partners and regulatory authorities. AS2 is a secure electronic data transmission protocol between two trading partners (gateways) through the Internet. Vault Safety can direct E2B transmissions to regulatory agencies and custom AS2 gateways.

The following graphic shows the steps that occur when Vault Safety sends an E2B transmission to a regulatory agency gateway or trading partner.

Asynchronous AS2 Transmissions Process

  1. Vault Safety generates the source E2B XML file.
  2. Vault Safety affixes a digitial signature and sends the encrypted E2B message.
  3. The message is sent to the destination gateway and ACK1 is returned to Vault Safety.
  4. Upon receipt of the message, the destination gateway sends an MDN.
  5. The destination gateway decrypts the message and receives the E2B file.
  6. The destination gateway sends the final ACK once the E2B is accepted.
  7. Vault Safety receives the final ACK and moves the Transmission to the ACK Accepted state.

Send a Gateway Transmission

To complete the ICSR Gateway Transmission, review the Transmission record and attachments to verify they are correct, and then trigger the Submit to Gateway action.

Prerequisites

  • The Transmission must be created, either as a Submission or Distribution.
  • Your Admin must have configured the Gateway Connection and Transmission Profile for the destination organization.
  • You must have permissions to manage Submissions and Distributions. Typically, this is reserved for the Distribution Manager role.

Submit to Gateway Action

Use the Submit to Gateway action to send Submissions and Distributions with a System Gateway or AS2 Gateway Connection with a Transmission Profile.

When you trigger the Submit to Gateway action, Vault automatically regenerates the E2B Transmission Document, assigns an E2B Message ID, and updates the Transmission Date field.

Depending on your Admin’s configuration, this action may be available as a user action on Transmissions or triggered automatically as part of a workflow.

Vault sends the submission to the destination AS2 Connection or Gateway configured in the corresponding Transmission Profile. Once complete, a notification appears on the Home tab under Notifications with the status of the submission.

Considerations

Be aware of the following considerations when using the Submit to Gateway action:

  1. If the Validation Status for the Submission is Hard Fail, the Submit to Gateway action will not run. Your Admin can configure the Result Status Type to Hard Fail for certain Validation Criteria.
  2. If Strict Transmission Version Enforcement is enabled in your Vault:
    • Vault will not auto-submit Follow-up Submissions before the previous Submission to the same Destination and Transmission Profile (or Destination ID for the PMDA) is ACK Accepted or Completed.
    • If the Case has a previous version with an open Transmission to the same Destination and Transmission Profile, Vault asks for confirmation before sending the new Transmission.
  3. If you use Auto-Submissions to multiple destinations that are triggered automatically as part of a workflow, your Admin can configure the Async Submit to Gateway feature to improve the performance of your Vault when sending Transmissions.

Review the Transmission Document

  1. Go to the Transmission. Find Transmissions under the relevant Case or from the Transmissions tab.
  2. Beside File select the file link. The document appears in a new page.
  3. From the download-doc menu, select Source Document. Vault downloads the XML file.
  4. When the download is complete, open the file to review the ICSR.

Regenerate the Transmission Document

If the Case or Transmission changes, regenerate the transmission document.

  1. Go to the Transmission. Find Transmissions under the relevant Case or from the Transmissions tab.
  2. Expand the All Actions menu, and then select Generate Transmission Document(s).

Result

Vault generates a new version of the document and updates the File field.

Types of Gateway Responses (ACKs and MDNs)

Every gateway transmission returns responses which indicate the success or failure of the transmission. These responses can be a Message Delivery Notification (MDN) or an Acknowledgment (ACK).

When a Vault Safety gateway transmission is sent, MDN and ACKs from the trading partner are added as Transmission Messages referenced by the outbound Transmission (Submission or Distribution). Vault populates the Attachments section of the Transmission Message record with a downloadable file based on the response type as follows:

  • MDN: A TXT file named [UUID].txt
  • ACK: An XML file named [UUID]-ACK.xml

In addition, when transmissions receive an ACK, Vault populates the ACK.B.r.2 Local Report Number in the Destination Case ID field of the associated Transmission record.

The following articles provide more information on inbound ACKs and MDNs:

See the following section for more information on the standard Transmission lifecycle states.

Transmission Lifecycle States for Gateway Transmissions

Lifecycle Stage Group Lifecycle State Description
Pending Ready Ready is the initial stage and state of a Transmission for which the Auto-Submit field was set to a value. Auto-Submissions provides more information.
Pending Pending Pending is the initial stage and state of a Transmission for which the Auto-Submit field was not set to a value. Vault assigns a task to review and approve the Transmission and ICSR E2B file.
Pending Validation Error Vault Safety found errors during the E2B XML validation process.
Pending Ready for Submission The transmission and transmission document have been reviewed and approved, and Vault has queued the transmission for sending to the destination gateway.
Sending Sending ICSR The transmission has been sent but the destination gateway has not sent an acknowledgment message yet.
Sent Sending Attachments Vault Safety is receiving an acknowledgment message from the destination gateway.
Sent Error Vault Safety could not send the transmission.
Sent MDN Received The transmission was acknowledged by the destination gateway.
Sent MDN Failure The transmission could not be delivered to, or acknowledged by, the destination gateway.
Sent E2B ACK Warning Vault Safety received the final ACK message indicating the destination gateway could not load the transmission.
Sent E2B ACK Rejected Vault Safety received the final ACK message with an error indicating the destination gateway loaded the transmission but rejected it, likely due to an issue in the E2B file.
Accepted E2B ACK Accepted Vault received the final ACK message indicating the destination gateway accepted the E2B file and the transmission is complete. Note that the final ACK may still contain data warnings in this state.