For the complete documentation index, see llms.txt. This page is also available as Markdown.

ReceiveAndValidateMdn

Task to receive and validate MDN receipts for sent AS3 messages

Task version: 1.0.0

Required Frends version: 5.7+

Required .NET version: 8.0

Compatible Agents: Crossplatform

Task Parameters

Name
Description

RemoteMdnPath : String

Path to the MDN file on the FTP server to be retrieved and verified.

Default: - Example: mdn/mdn-60f3099a-1a5c-470d-9d46-0d2778906a6e@localhost.txt

OriginalContentMic : String

The locally computed MIC of the original sent message, used to verify file integrity.

Default: - Example: 7v7F+fQbH4lD8bKGJTbXzWWcUlI=, sha256

MdnOptions : String

The MDN options string from the original sent message, describing the requested signature algorithm.

Default: - Example: signed-receipt-protocol=optional, pkcs7-signature; signed-receipt-micalg=optional, sha256

Name
Description

FtpHost : String

FTP server host name or IP address for the AS3 connection.

Default: - Example: ftp.example.com

FtpPort : Int32

FTP server port.

Default: 21 Example: 21

FtpUser : String

Username for FTP authentication.

Default: - Example: myFtpUser

🗝FtpPassword : String

Password for FTP authentication.

Default: - Example: myFtpPassword123

UsePassiveFtp : Boolean

Defines whether to use Passive mode for the FTP data connection.

Default: True Example: true

PartnerCertificatePath : String

Path to the trading partner's public certificate file in .pem format, used to verify the MDN signature.

Default: - Example: C:\Document\partner_cert.pem

Name
Description

LogDirectory : String

Directory path where AS3 communication logs will be stored. Leave empty to disable logging.

The caller is responsible for log rotation and cleanup of files in this directory.

Default: - Example: C:\Logs\AS3

DeleteMdnAfterVerification : Boolean

If true, the MDN file will be deleted from the FTP server after successful verification.

Default: False Example: false

RetryCount : Int32

Number of times to retry retrieving the MDN file from the FTP server if it is not yet available.

Set to 0 to disable retries.

Default: 0 Example: 3

RetryIntervalSeconds : Int32

Time in seconds to wait between retry attempts when the MDN file is not yet available on the FTP server.

Default: 30 Example: 30

ThrowErrorOnFailure : Boolean

Whether to throw an error on failure.

Default: True Example: true

ErrorMessageOnFailure : String

Overrides the error message on failure.

Default: - Example: Custom error message

Task Result

Name
Description

Success : Boolean

Indicates if the task completed successfully. Example: true

OriginalMessageId : String

The Message-ID of the original AS3 message confirmed by the MDN. Example: 60f3099a-1a5c-470d-9d46-0d2778906a6e@localhost

Disposition : String

The Disposition value extracted from the MDN, indicating whether the message was processed successfully by the trading partner. Example: automatic-action/MDN-sent-automatically; processed

IsProcessed : Boolean

Indicates whether the trading partner confirmed successful processing of the original message. Example: true

Error : Error

Error that occurred during task execution. Example: object { string Message, Exception AdditionalInfo }

Error.Message : String

Summary of the error. Example: Unable to find MDN.

Error.AdditionalInfo : Exception

Additional information about the error. Example: object { Exception AdditionalInfo }

Task Changelog

Changelog for Task Frends.As3.ReceiveAndValidateMdn.

[1.0.0] - 2026-08-07

Added

  • Initial implementation

Last updated

Was this helpful?