AllocationInstructionAck (MsgType = P, FIXML = AllocInstrctnAck)

In versions of FIX prior to version 4.4, this message was known as the Allocation ACK message.

The Allocation Instruction Ack (P) message is used to acknowledge the receipt of and provide status for an Allocation Instruction (J) message.

For an Allocation Instruction Ack (P) message with AllocStatus (87) of 'Accepted' in response to an Allocation Instruction (J) with AllocType (626) of Calculated, it is recommended that the MatchStatus (573) field be used to denote whether any financial details provided in the Calculated Allocation Instruction (J) were matched by the Respondent. If a match takes place and succeeds, then the match status will be '0-Compared and affirmed'. If the match takes place and fails, or no match takes place, then the match status will be '1-Uncompared or unaffirmed'.

AllocStatus value	Description
3 = received, not yet processed	Used to acknowledge receipt of an Allocation Instruction message. This should always be followed by a second Allocation Instruction Ack of status 0, 1 or 2 as follows or an Allocation Report message.
0 = accepted	The Allocation Instruction has been validated and processed successfully.
1 = block level reject	The entire Allocation Instruction has been rejected. The AllocRejCode (88) field must be populated when performing a block level reject; this gives the reason for rejecting the Allocation Instruction.
2 = account level reject	The Allocation Instruction has been validated and one or more of the AllocAccount details in the NoAllocs repeating group has failed validation (e.g. account not found). In this case, it is possible (though not mandatory) to include a list of the AllocAccount details that failed validation together with reject reasons.

Tag	Field Name	FIXML	Req'd	Comments
<Standard Message Header>			Y	MsgType = P
70	AllocID	@AllocID	Y	Encoded (non-ASCII characters) representation of the Text (58) field in the encoded format specified via the MessageEncoding (347) field.
2758	AllocRequestID	@ReqID	N	May be used to link to a previously submitted AllocationInstructionAlertRequest(35=DU) message.
<Instrument>			N
<Parties>			N	Same as TrdRegTimestamp(769). Used in a multi-sided message to indicate relevant trade-side timestamp.
793	SecondaryAllocID	@AllocID2	N	Optional second identifier for the allocation instruction being acknowledged (need not be unique)
1730	AllocGroupID	@GrpID	N	Group identifier assigned by the clearinghouse
1728	FirmGroupID	@FirmGrpID	N	Firm assigned entity identifier for the allocation
1731	AvgPxGroupID	@AvgPxGrpID	N	Firm designated group identifier for average pricing
75	TradeDate	@TrdDt	N	Indicates date of trading day. Absence of this field indicates current day (expressed in local time at place of trade).
60	TransactTime	@TxnTm	N	Date/Time Allocation Instruction Ack generated
87	AllocStatus	@Stat	Y	Denotes the status of the allocation instruction; received (but not yet processed), rejected (at block or account level) or accepted (and processed).
88	AllocRejCode	@RejCode	C	Required for AllocStatus = 1 ( block level reject) and for AllocStatus 2 (account level reject) if the individual accounts and reject reasons are not provided in this message
626	AllocType	@AllocType	N	Describes the specific type or purpose of an Allocation message (i.e. "Buyside Calculated") (see Volume : "Glossary" for value definitions) * SOME VALUES HAVE BEEN REPLACED - See "Replaced Features and Supported Approach" *
808	AllocIntermedReqType	@IntermedReqTyp	C	Required if AllocType = 8 (Request to Intermediary) Indicates status that is requested to be transmitted to counterparty by the intermediary (i.e. clearing house)
573	MatchStatus	@MtchStat	C	Denotes whether the financial details provided on the Allocation Instruction were successfully matched.
58	Text	@Txt	N	Can include explanation for AllocRejCode = 7 (other)
354	EncodedTextLen	@EncTxtLen	C	Must be set if EncodedText(355) field is specified and must immediately precede it.
355	EncodedText	@EncTxt	C	Encoded (non-ASCII characters) representation of the Text(58) field in the encoded format specified via the MessageEncoding(347) field.
1328	RejectText	@RejTxt	N	Identifies the reason for rejection.
1664	EncodedRejectTextLen	@EncRejTxtLen	N	Must be set if EncodedRejectText(1665) field is specified and must immediately precede it.
1665	EncodedRejectText	@EncRejTxt	N	Encoded (non-ASCII characters) representation of the RejectText(1328) field in the encoded format specified via the MessageEncoding(347) field.
<RegulatoryTradeIDGrp>			N	Trade side of payout payer.
<AllocAckGrp>			N	This repeating group is optionally used for messages with AllocStatus = 2 (account level reject) to provide details of the individual accounts that caused the rejection, together with reject reasons. This group should not be populated when AllocStatus has any other value. Indicates number of allocation groups to follow.
<Standard Message Trailer>			Y