Sent from sell-side to buy-side, sell-side to 3rd-party or 3rd-party to buy-side, the Allocation Report (Claim) provides account breakdown of an order or set of orders plus any additional follow-up front-office information developed post-trade during the trade allocation, matching and calculation phase. In versions of FIX prior to version 4.4, this functionality was provided through the Allocation message. Depending on the needs of the market and the timing of "confirmed" status, the role of Allocation Report can be taken over in whole or in part by the Confirmation <35=AK> message.
Note the response to the Allocation Report message is the Allocation Report Ack <35=AT> message. In versions of FIX prior to version 4.4, the Allocation ACK served this purpose.
An Allocation Report message can be submitted with AllocReportType (794) of
Settlement instructions are supported on the Allocation Report message to allow the Respondent (sell-side party or carry firm) to send an override of its own instructions to the Initiator.
General guidelines applicable to this message:
The allocation message contains repeating fields for each order, sub-account and individual execution. The repeating fields are shown in the message definition below in typeface Bold-Italic and indented with the → symbol. The field's relative position within the repeating group in the message is important. For example, each instance of allocation must be in the order as shown in the message definition below.
Tag | Name | Type | Required | Description |
---|---|---|---|---|
Component | ||||
755 | String | Unique identifier for this message | ||
70 | String | |||
71 | Char Enum | I.e. New, Cancel, Replace | ||
795 | String | Required for AllocTransType = Replace or Cancel | ||
796 | Int Enum | Required for AllocTransType = Replace or Cancel Gives the reason for replacing or cancelling the allocation report | ||
793 | String | Optional second identifier for this allocation instruction (need not be unique) | ||
794 | Int Enum | Specifies the purpose or type of Allocation Report message | ||
87 | Int Enum | |||
88 | Int Enum | Required for AllocStatus = 1 (rejected) | ||
72 | String | Required for AllocTransType = Replace or Cancel | ||
808 | Int Enum | Required if AllocReportType = 8 (Request to Intermediary) Indicates status that is requested to be transmitted to counterparty by the intermediary (i.e. clearing house) | ||
196 | String | Can be used to link two different Allocation messages (each with unique AllocID) together, i.e. for F/X "Netting" or "Swaps" | ||
197 | Int Enum | Can be used to link two different Allocation messages and identifies the type of link. Required if AllocLinkID is specified | ||
466 | String | |||
857 | Int Enum | How the orders being booked and allocated by this message are identified, i.e. by explicit definition in the NoOrders group or not | ||
Component | Number of orders to be combined for allocation. If order(s) were manually delivered set to 1 (one). Required when AllocNoOrdersType = 1 | |||
Component | Number of individual execution repeating group entries to follow. Absence of this field means that no individual execution entries are included. Primarily used to support step-outs | |||
570 | Boolean Enum | |||
700 | Boolean | |||
574 | String Enum | |||
54 | Char Enum | |||
Component | The set of "Instrument" (symbology) fields defined in "Common Components of Application Messages" | |||
Component | The set of "InstrumentExtension" fields defined in "Common Components of Application Messages" | |||
Component | The set of "FinancingDetails" fields defined in "Common Components of Application Messages" | |||
Component | ||||
Component | ||||
53 | Quantity | Total quantity (e.g. number of shares) allocated to all accounts, or that is Ready-To-Book | ||
854 | Int Enum | |||
30 | Exchange | Market of the executions | ||
229 | LocalMktDate | |||
336 | String | |||
625 | String | |||
423 | Int Enum | |||
6 | Price | For F/X orders, should be the "all-in" rate (spot rate adjusted for forward points) | ||
860 | Price | |||
Component | The set of "SpreadOrBenchmarkCurveData" fields defined in "Common Components of Application Messages" | |||
15 | Currency | Currency of AvgPx. Should be the currency of the local market or exchange where the trade was conducted | ||
74 | Int | If absent, the default precision arranged by the broker/institution is used | ||
Component | The set of "Parties" (firm identification) fields defined in "Common Components of Application Messages" | |||
75 | LocalMktDate | |||
60 | UTCTimestamp | Date/time when allocation is generated | ||
63 | Char Enum | |||
64 | LocalMktDate | Takes precedence over SettlType value and conditionally required/omitted for specific SettlType values | ||
775 | Int Enum | Method for booking. Used to provide notification that this is to be booked out as an OTC derivative (e.g. CFD or similar). If absent, regular booking is used | ||
381 | Amount | Expressed in same currency as AvgPx. Sum of (AllocQty * AllocAvgPx or AllocPrice) | ||
238 | Amount | |||
237 | Amount | |||
118 | Amount | Expressed in same currency as AvgPx. Sum of AllocNetMoney | ||
77 | Char Enum | |||
754 | Boolean | Indicates if Allocation has been automatically accepted on behalf of the Carry Firm by the Clearing House | ||
58 | String | |||
354 | Length | Must be set if EncodedText field is specified and must immediately precede it | ||
355 | Data | Encoded (non-ASCII characters) representation of the Text field in the encoded format specified via the MessageEncoding field | ||
157 | Int | Applicable for Convertible Bonds and fixed income | ||
158 | Percentage | Applicable for Convertible Bonds and fixed income | ||
159 | Amount | Sum of AllocAccruedInterestAmt within repeating group | ||
540 | Amount | (Deprecated) use AccruedInterestAmt Sum of AccruedInterestAmt within repeating group | ||
738 | Amount | |||
920 | Amount | For repurchase agreements the accrued interest on termination | ||
921 | Amount | For repurchase agreements the start (dirty) cash consideration | ||
922 | Amount | For repurchase agreements the end (dirty) cash consideration | ||
650 | Boolean Enum | |||
Component | ||||
Component | ||||
892 | Int | Indicates total number of allocation groups (used to support fragmentation). Must equal the sum of all NoAllocs values across all message fragments making up this allocation instruction. Only required where message has been fragmented | ||
893 | Boolean Enum | Whether this is the last fragment in a sequence of message fragments. Only required where message has been fragmented | ||
Component | Indicates number of allocation groups to follow. Not required for AllocTransType=Cancel Not required for AllocReportType= "Warehouse recap" | |||
Component |