Inputs (Array of Accounts) inherits from EntityBase

Name	Type	Description	Mandatory	Available from version	Additional information

Name	Type	Description	Mandatory	Available from version	Additional information
BrickId	Guid	Not used.
OwnerAccountLabel	String	Label of the account
Owner	Guid	Owner of the account	True
AccountTypeKey	String	The account type key of the account. Available account types can be found in BFS admin by navigating to System Data -> Account types	True
BaseCurrencyCode	String	The base currency of the account. Available currencies can be found in BFS admin by navigating to System Data -> Currencies	True
AccountStatus	Integer	1=Open 2=Closed 4=Hidden (hidden on customer front end)	True
ExternalReference	String	External reference of the account
AllocationTemplate	Guid (Nullable)	If the account should be associated with an allocation template
RequestReference	String	An external reference that's provided by the requester. Can be used to map the returned BrickId on requesters side.
AcquisitionValueCalculationMethod	String	Determines the method to be used for calculating the acquisition value of positions within the account. Default is "Average" which sums together the value for each purchase and uses that value as the acquisition value for a sale. If nothing is entered as the input it will default to "Average". For some instances "FIFO" will be available as a selection and this will show in the back office GUI.
AccountComment	String	Comment for account		2.02
InsuranceOwner	Guid (Nullable)	InsuranceOwner for account. Only available if addon Insurance Accounts is enabled.		2.07
Insured	Guid (Nullable)	Insured for account. Only available if addon Insurance Accounts is enabled.		2.07
InsurancePayer	Guid (Nullable)	InsurancePayer for account. Only available if addon Insurance Accounts is enabled.		2.07
ContactLegalEntity	Guid (Nullable)	ContactLegalEntity for account. From version 2.09 this will be default to owner of the account.		2.07
CustomFields	Object[]	Array of CustomFields		2.09	CustomFields[]
FirstPaymentAge	Integer	The age of the person when the first payout should start		2.09
FirstPaymentDate	DateTime	First date for payout		2.09
PaymentIntervalKey	String	Interval for payouts		2.09
PaymentLength	Integer	Number of total payouts		2.09
Payouts	Integer	Number of payouts that has been processed		2.09
PayoutsLeft	Integer	Remaining number of payouts		2.09
HighWaterMark	Decimal	High water mark for account		2.12
ResellerNo	string	Customer number of the reseller that is to be associated with the account		2.14
DecisionMaker	Guid	DecisionMaker on account. DecisionMaker is a reference to a LegalEntity in BFS		2.19	Decision Maker
LockedStatusKey	String	Must be one of these values: Open, LockedAdmin, LockedPartner, LockedFront		2.23
IBAN	string	The International bank account number.		2.30
IsSubjectToContinuousInvestmentAdvice	bool	A flag that marks an account where continuous investment advice is given. This is used when reporting K-Factor values for securities firms among other things. The K-Factor Reporting App is available in our Marketplace.		2.36
CounterpartyAccountType	CounterpartyAccountType?	To be able to set CounterpartyAccountType on the account, the account type needs to be CounterpartyAccount. CounterpartyAccountType is an enum, which can be: Intermediary or Issuer.		2.38
CustodianBrickId	Guid	This is the unique id of an custodian.		2.41
DiscountGroupId	Guid	This is the id of the Discount Group if the account should belong to such Fee Management
MustCover	bool	If set to true the account will not be allowed to go into negative balance. This can be read about here and in the GUI it is called Prevent Overdraft.		in development
RemovePositionOnSettlement	bool	If set to true the external counterparty account will be zeroed out when settling, which means that there will be automatic transactions created when the settlement action is triggered which will remove the shares and the cash from the counterparty account. How to work with internal and external counterparties Only used on account type: CounterpartyAccount.		in development

Outputs

Name	Type	Description	Available from version

Name	Type	Description	Available from version
Entities	Array	All accounts in the request is returned along with each accounts BrickId, AccountNo and array of Errors per account

XML request example

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <CreateAccounts xmlns="http://tempuri.org/">
      <req>
        <Credentials>
          <UserName>yourusername</UserName>
          <Password>yourpassword</Password>
        </Credentials>
        <identify>youridentifier</identify>
        <Entities>
          <Account>
            <BrickId>00000000-0000-0000-0000-000000000000</BrickId>
            <OwnerAccountLabel>Test</OwnerAccountLabel>
            <Owner>9eefe173-8d54-4dc3-b8f7-5ac7bccdeec6</Owner>
            <AccountTypeKey>HoldingAccount</AccountTypeKey>
            <BaseCurrencyCode>SEK</BaseCurrencyCode>
            <AccountStatus xsi:nil="true" />
            <AllocationTemplate>00000000-0000-0000-0000-000000000000</AllocationTemplate>
            <ExternalReference>123456789</ExternalReference>
          </Account>
        </Entities>
      </req>
    </CreateAccounts>
  </s:Body>

Code examples

C# - Create an account in a BFS instance

//Create a new account with the CreateAccount 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 response = client.CreateAccounts(new BFSServiceReference.CreateAccountRequest()
{
    Credentials = credentials,

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

    Entities = new[]
    {
        new Account()
        {
			AccountTypeKey = "HoldingAccount",
            Owner = bnuserbrickid,
            OwnerAccountLabel = "Test",
            BaseCurrencyCode = "SEK",
            ExternalReference = "123456789",
            AccountStatus = 1,
            RequestReference = "My system reference",
            AcquisitionValueCalculationMethod = "Average",
			CustomFields=new CustomField[]
            {
                new CustomField
                {
                    FieldName = "TestField1",
                    Value = "Testvalue1"
                },
                new CustomField
                {
                    FieldName = "TestField2",
                    Value = "0.25"
                }
            }
        }
    }

});

foreach (var c in response.Entities)
{
    Console.WriteLine(c.AccountNo);
}

Blog Posts

Blog: How to create a new account for a legal entity using CreateAccounts, GetPersons and GetAccountTypes created by
Stefan Willebrand

Dec 30, 2015

BFS API