CREATE

The CREATE command is used to create an AS3 transaction or receipt.

Syntax:

Command	Keyword	Value	Developer notes
CREATE	OBJECT	*TRANSACTION	Optional. Default. Create transaction
	RECIPIENT	value	Mandatory. The identity that that will receive the receipt. This value is used in resource file lookups. Value is made up of 2 components separated by a colon, a name component and an optional private keystore password component. Example: ACME:mypassword
	SUBJECT	value	Optional. Subject.
	RECEIPTTO	value	Optional. Receipt delivery.
		*NONE	No receipt delivery.
	RECEIPTSIGNED	*YES	Optional. Signed Receipt
		*NO	Default.
	FILE	value	Mandatory. File containing EDI content.
	NAME	value	Optional. Name of file. Default is to use the FILE name.
	CONTENT	value	Mandatory. Content type.
		*XML	application/xml
		*EDIFACT	application/edifact
		*X12	application/x12
	SIGNED	*YES	Optional. Sign content.
		*NO	Default.
	ENCRYPTED	*YES	Optional Encrypt content.
		*NO	Default.
	COMPRESSED	*YES	Optional. Compress content.
		*NO	Default.
	MESSAGEID	value	Optional.

 

 

The RECIPIENT keyword value is used to obtain the signing key file, password, signing certificate and encryption certificates using a selection hierarchy of entries from the properties file.

     keystore.{recipient}= pki/filename

     keystore = pki/filename

     keystore.password.{recipient} = password

     keystore.password = password

     certificate.{recipient} = pki/filename

     certificate = pki/filename

     encryption.certificates.{recipient} = pki/filename, pki/filename, pki/filename

     as3-to.{recipient} = companyto

     as3-from.{recipient} = companyfrom

     as3-from = companyfrom

     subject.{recipient} = subject

     subject = subject

     receipt.to.{recipient}=receipt to

     receipt.to=receipt to

     receipt.signed.{recipient}=*yes | *no

     receipt.signed=*yes | *no

     messageid.suffix.{recipient} = company identifier

     messageid.suffix. = company identifier

     signed.algorithm.{recipient} = *MD5 | *SHA1 | *SHA256 | *SHA384 | *SHA512

     signed.algorithm = *MD5 | *SHA1 | *SHA256 | *SHA384 | *SHA512

     encryption.algorithm.{recipient} = *DES3 | *AES128 | *AES192 | *AES256

     encryption.algorithm = *DES3 | *AES128 | *AES192 | *AES256

Syntax:

Command	Keyword	Value	Developer notes
CREATE	OBJECT	*RECEIPT	Mandatory. Create receipt.
	RECIPIENT	value	Mandatory. The identity that receives the transaction. This value is used in resource file lookups. Value is made up of 2 components separated by a colon, a name component and an optional private keystore password component. Example: ACME:mypassword
	RECEIPTMIC	value	Mandatory. Original Message MIC.
	RECEIPTMESSAGEID	value	Mandatory. Original Message Id.
	RECEIPTSUBJECT	value	Mandatory. Original Message Subject.
	PROCESSED	value	Optional. Default is "processed".
	MODIFIER	value	Optional. Default is blank.
	AS3TO	value	Optional. AS3-To.
	AS3FROM	value	Optional. AS3-From.
	SUBJECT	value	Optional. Receipt subject.
	TEXT	value	Optional. Text.
	MESSAGEID	value	Optional.
	SIGNED	*YES	Optional. Sign receipt.
		*NO	Default.

 

 

The RECIPIENT keyword value is used to obtain the signing key file, password and singing certificate using a selection hierarchy of entries from the properties file.

The keystore and certificates are only used when the receipt needs to be signed.

     keystore.{recipient}= pki/filename

     keystore = pki/filename

     keystore.password.{recipient} = password

     keystore.password = password

     certificate.{recipient} = pki/filename

     certificate = pki/filename

     as3-to.{recipient} = companyto

     as3-from.{recipient} = companyfrom

     as3-from = companyfrom

     subject.{recipient} = subject

     subject = subject

     receipt.to.{recipient}=receipt to

     receipt.to=receipt to

     messageid.suffix.{recipient} = company identifier

     messageid.suffix. = company identifier

     signed.algorithm.{recipient} = *MD5 | *SHA1 | *SHA256 | *SHA384 | *SHA512

     signed.algorithm = *MD5 | *SHA1 | *SHA256 | *SHA384 | *SHA512

 

Human readable text is obtained from a file using a properties file selection hierarchy.

    receipt.message.{recipient} = system/receipt-message.txt

    receipt.message = system/receipt-message.txt

 

The receipt.message contains the human readable component of the receipt.

The following special merge labels are supported in the receipt.message file:

%%COMPANYFROM%%
%%COMPANYTO%%
%%DATE%%
%%SUBJECT%%
%%TEXT%%

 

Sample receipt.message file content:

The message sent to recipient <%%COMPANYTO%%> on %%DATE%% with subject "%%SUBJECT%%" has been received.