The SEND command is used to return a response to the AS2 client program.
The SEND command internally uses the Disposition-Notification-To and the Disposition-Notification-Options received from the client program to help in automatic creation of a response.
If a synchronous receipt was requested, a receipt must be sent.
If an asynchronous receipt was requested, a basic 200 OK response is sent.
The list argument will be returned with the following keywords and values:
Keyword | Description |
|---|---|
MESSAGEID | Message-Id of the receipt sent. |
SUBJECT | Subject on the receipt. |
FROM | From value on the receipt. |
DATE | Date on the receipt. |
Syntax:
Command | Keyword | Value | Developer notes |
|---|---|---|---|
SEND | RESPONSE | *DEFAULT | Mandatory. The type of response is automatically determined from the client request. Either basic, receipt or signed receipt is returned. |
*OK | This will send a basic OK (200 HTTP response). This response should only be used if an asynchronous receipt was requested. | ||
*ERROR | Send an error receipt. | ||
FROM | value | Optional. From. | |
SUBJECT | value | Optional. Subject. | |
TEXT | value | Optional. Text. | |
PROCESSED | value | Optional. Default value is "processed". | |
MODIFER | value | Optional. Default value is blank or "error" for response *ERROR. | |
MESSAGEID | value | Optional. Complete transaction message id. The Message-Id is normally generated. | |
RECEIPTMICALG | *SHA1 | Optional. Receipt MIC algorithm. The default value is *SHA1. |
The RECEIVER keyword value is used to create the following receipt information.
receipt.from.{receiver} = email address
receipt.from = email address
receipt.subject.{receiver} = subject
receipt.subject = subject
messageid.prefix.{recipient} = company identifier
messageid.prefix. = company identifierHuman readable text is obtained from files using a properties file selection hierarchy.
receipt.message.{receiver} = system/receipt-message.txt
receipt.message = system/receipt-message.txt
receipt.text.{receiver} = system/receipt-text.txt
receipt.text = system/receipt-text.txt
receipt.error.{receiver} = system/receipt-error.txt
receipt.error = system/receipt-error.txtThe receipt.message contains the human readable component of the receipt.
The receipt.text contains the text that is sent as the body content in a 200 OK basic response. It is sent as content type text/plain.
The receipt.error contains the human readable component of the error receipt.
The following special merge labels are supported in the receipt.text, receipt.message and receipt.error files:
%%COMPANYFROM%%
%%COMPANYTO%%
%%DATE%%
%%SUBJECT%%
%%TEXT%%
Sample receipt.message file content:
The message sent to recipient <%%COMPANYTO%%> on %%DATE%% with subject "%%SUBJECT%%" has been received.
Sample receipt.text file content:
Data from <%%COMPANYFROM%%> has been received by <%%COMPANYTO%%>
Sample receipt.error file content:
The message sent to recipient <%%COMPANYTO%%> on %%DATE%% with subject "%%SUBJECT%%" contain