Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Fund Instructions are structured according to ISO 20022

Filter inputs

NameTypeDescriptionMandatoryAvailable from version
BrickIdsGuid[]
 
The BFS-id of the fund instruction 
 
2.02.20160429
ExecutionInterfaceIdGuid[]
 
The BFS-id of the associated Execution Interface 
 
2.02.20160429
PhysicalDeliveryIndicatorbool
 
Physical delivery of assets is not available for most execution interfaces and will be false for Execution Interface NFM / Allfunds at all times 
 
2.02.20160429
FundInstructionNosstring[]
 
The instruction number of the fund instruction 
 
2.02.20160429
StatusKeysstring[]

The status of the instruction: NEW, READY, STOP, SENT, SENTERROR, ACK, NACK, EXECUTED, SETTLED, CANCELED, ERROR, FINISHED

 
  ExternalFundBatchOrdersstring[]   Instruments
2.02.20160429
ExternalFundBatchOrderIdsGuid[]The BFS-id of external fund batch orders to use in the filter 2.02.20160429
InstrumentIdsGuid[]The BFS-id of the instruments to use in the filter 2.02.20160429
RequestedNAVCurrencyIdsGuid[]
 
The BFS-id of the currencies to use in the filter 
 RequestedNAVCurrencys
2.02.20160429
RequestedSettlementCurrencyIdsGuid[]The BFS-id of the currencies to use in the filter 2.02.20160429
CreatedDateFromDateTimeWhen used, both from date and to date should be provided in the request  2.02.20160506
CreatedDateToDateTime 
RequestedSettlementCurrencysGuid[]
2.02.20160506
     

Response rows (Array) inherits from EntityBase

NameTypeDescriptionAvailable from version
BrickIdGuid
   
The BFS-id of the fund instruction2.02.20160429
ExecutionInterfaceIdGuid
  
The BFS-id of the Execution Interface2.02.20160429
PhysicalDeliveryIndicatorbool
  
Physical delivery of assets is not available for most execution interfaces and will be false for Execution Interface NFM / Allfunds at all times2.02.20160429
FundInstructionNostring
 InstrumentGuid  
The instruction number of the fund instruction2.02.20160429
StatusKeystring
  ExternalFundBatchOrderGuid  RequestedNAVCurrencyGuid  
The status of the instruction: NEW, READY, STOP, SENT, SENTERROR, ACK, NACK, EXECUTED, SETTLED, CANCELED, ERROR, FINISHED2.02.20160429
ExternalFundBatchOrderIdGuidThe BFS-id of the associated external fund batch order2.02.20160429
InstrumentIdGuidThe BFS-id of the instrument2.02.20160429
InstructionTypeKeystring
   
The type of instruction: SUBSCRIPTION, REDEMPTION2.02.20160429
RequestedNAVCurrencyIdGuidThe BFS-id of the currency for the NAV2.02.20160429
RequestedSettlementCurrencyGuid
  
The BFS-id of the currency for the Settlement2.02.20160429
CashAmountdecimal
 
The cash amount of the fund instruction2.02.20160429

Code examples

Code Block
languagec#
themeRDark
titleC# - GetFundInstructions
linenumberstrue
collapsetrue
//Use the GetFundInstructions method 
var client = new BFSServiceReference.bfsapiSoapClient();

var credentials = new BFSServiceReference.Credentials()
{
    UserName = bfsusername, //Username of administrative user in your instance of BFS
    Password = bfspassword, //Password of the administrative user in your instance of BFS
};

var instructions = client.GetFundInstructions(new BFSServiceReference.GetFundInstructionRequest()
{
    Credentials = credentials,

    identify = bfsidentifier, //Identifier is a unique token for your instance of BFS

    Args = new BFSServiceReference.GetFundInstructionArgs()
    {
        BrickIds = new []
        {
			
            new Guid("ea3f658e-28f7-46b9-a45e-99b0f2e1a1ff"), 
        }
    },
    Fields = new BFSServiceReference.GetFundInstructionFields()
    {
        BrickId = true,        
        ExecutionInterfaceId = true,
        PhysicalDeliveryIndicator = true,
        FundInstructionNo = true,
        StatusKey = true,
        ExternalFundBatchOrderExternalFundBatchOrderId = true,
        InstrumentInstrumentId = true,
        InstructionTypeKey = true,
        RequestedNAVCurrencyRequestedNAVCurrencyId = true,
        RequestedSettlementCurrencyRequestedSettlementCurrencyId = true,
        CashAmount = true
    },
});

foreach (var c in instructions.Result)
{
    Console.WriteLine(c.BrickId + ", " 
        + c.ExecutionInterfaceId + ", "
        + c.PhysicalDeliveryIndicator + ", "
        + c.FundInstructionNo + ", "
        + c.StatusKey + ", "
        + c.ExternalFundBatchOrderExternalFundBatchOrderId + ", "
        + c.InstrumentInstrumentId + ", "
        + c.InstructionTypeKey + ", " 
        + c.RequestedNAVCurrencyRequestedNAVCurrencyId + ", "
        + c.RequestedSettlementCurrencyRequestedSettlementCurrencyId + ", " 
        + c.CashAmount);
}

...