Börja gratis

Hur ställer jag in en Flex Query hos Interactive Brokers?

Du behöver två saker: en Activity Flex Query — en sparad rapport med åtta sektioner i XML — och en token för Flex Web Service som låter ett program hämta den. Båda görs på samma sida i IB-portalen på ungefär tio minuter. Nedan: menyvägen, stegen och en karta över vad varje sektion behövs till.

Uppdaterad

Vad du får till slut

En Flex Query är en rapportmall i IB-portalen: vilka sektioner, vilka fält, vilken period och vilket format. Varje fråga har ett nummer — Query ID. Flex Web Service låter ett program hämta rapporten utan inloggning; enligt IBKR Guides behöver en begäran den aktuella token och Query ID (Configure Flex Web Service, på engelska).

Båda finns på samma ställe: Performance & Reports → Flex Queries (eller Menu → Reporting → Flex Queries). Schemat visar var du klickar och vad du får.

Var allt finns i IB-portalen
Performance & Reports → Flex Queries
eller Menu → Reporting → Flex Queries
  • Activity Flex Query, ”+”
    Sections + Delivery Configuration
    8 sektioner, Models Optional, XML, Last 365 Calendar Days
    • Continue → Create
      Query ID
      rapportens nummer
  • Flex Web Service Configuration
    Flex Web Service Status → Save
    Should Expire After; Valid For IP Address — tomt
    • Generate New Token
      Token
      anslutningens nyckel

Namnen som i IBKR Guides (Client Portal). Query ID och token klistras in i PnlTrack.

Steg för steg

Stegen följer IBKR Guides Create an Activity Flex Query och Configure Flex Web Service; sektionerna och leveransinställningarna är de som PnlTracks import väntar sig.

  1. Öppna Flex Queries. Logga in i Client Portal och öppna Performance & Reports → Flex Queries (eller Menu → Reporting → Flex Queries).
  2. Skapa en Activity Flex Query. Klicka på ”+” i panelen Activity Flex Query och ge frågan valfritt namn.
  3. Välj de åtta sektionerna. Under Sections väljer du: Cash Transactions, Corporate Actions, Financial Instrument Information, Open Positions, Option Exercises, Assignments and Expirations, Realized and Unrealized Performance Summary in Base, Trades, Transfers.
  4. Slå på alla fält i varje sektion. Varje sektion öppnas i ett fönster med sina fält: markera alla och klicka på Save. För Open Positions slår du på båda detaljnivåerna — Summary och Lot.
  5. Ställ in Delivery Configuration. Models — Optional, Format — XML, Period — Last 365 Calendar Days. Låt General Configuration vara som den är.
  6. Skapa frågan och kopiera Query ID. Klicka på Continue, granska inställningarna och klicka på Create. Kopiera den nya frågans Query ID.
  7. Aktivera Flex Web Service. Öppna Flex Web Service Configuration på samma sida, markera Flex Web Service Status och klicka på Save.
  8. Skapa en token. Välj den längsta tiden i Should Expire After, lämna Valid For IP Address tomt, klicka på Generate New Token och kopiera token.
  9. Klistra in i PnlTrack. Lägg till en Interactive Brokers-anslutning med token i PnlTrack och sedan den dagliga rapporten med dess Query ID — importen startar direkt.

Vad varje sektion behövs till

Flex levererar exakt de sektioner som är valda i frågan. I våra exporter kommer en vald sektion utan data som tom, medan en sektion som inte valts saknas helt i filen — och det finns inget att bygga upp den ur i efterhand. Därför är listan kort och exakt: allt som importen läser och inget mer. En extra sektion skadar inte, men används inte. Vad varje sektion innehåller beskrivs i Activity Flex Query Reference.

De åtta sektionerna i Activity Flex Query
  1. 1Cash Transactions
    PnlTrack tar:
    utdelningar, källskatt, ränta, mäklaravgifter, insättningar och uttag
    utan den:
    inga utdelningar och ingen skatt på dem
  2. 2Corporate Actions
    PnlTrack tar:
    splittar, spin-offs, företagsköp
    utan den:
    splittar och företagsköp beaktas inte
  3. 3Financial Instrument Information
    PnlTrack tar:
    ISIN, conid, FIGI — identifiering av värdepappret
    utan den:
    värdepappret kan inte identifieras säkert; tickern räcker inte
  4. 4Open Positions
    PnlTrack tar:
    positioner och anskaffningsutgift enligt mäklaren
    utan den:
    inget att stämma av positionerna mot; korrigeringen för kapitalåterbetalning görs inte
  5. 5Option Exercises, Assignments and Expirations
    PnlTrack tar:
    lösen, tilldelning och förfall av optioner
    utan den:
    lösen och förfall syns inte
  6. 6Realized and Unrealized Performance Summary in Base
    PnlTrack tar:
    mäklarens markering om justerad anskaffningsutgift
    utan den:
    justeringar av anskaffningsutgiften syns inte
  7. 7Trades
    PnlTrack tar:
    köp och försäljningar, priser, courtage
    utan den:
    ingenting importeras
  8. 8Transfers
    PnlTrack tar:
    värdepapper som flyttas mellan konton och mäklare
    utan den:
    en försäljning av överförda aktier ser ut som en försäljning utan köp

Exakt det som PnlTracks import läser; samma lista finns i appens onboarding.

Varför Models är Optional och inte All

Models i Delivery Configuration har två värden, Optional och All (enligt IBKR Guides). Med All varnar IB-portalen på en rad för att sektioner och fält för realiserat resultat stängs av när modeller ingår. IBKR Guides nämner inte detta — varningen syns bara i själva portalen.

Vad det innebär i praktiken kontrollerade vi med två exporter av samma konto: med All hade Open Positions anskaffningsutgiften (Cost Basis Price, Cost Basis Money) noll och Realized and Unrealized Performance Summary in Base var tom. Nollan betyder här ”fältet avstängt”, inte ”aktierna var gratis”, och PnlTrack registrerar den inte som fakta. Med Optional är samma fält ifyllda och stämmer med kontots CSV-utdrag.

Models i Delivery Configuration
Models
  • Optional
    Resultat- och anskaffningsfält ifyllda
    positioner med anskaffningsutgift, sammanställning per värdepapper
  • All
    Resultatfält avstängda
    Open Positions med noll i anskaffningsutgift, sammanställningen tom

Bygger på två av våra exporter av samma konto med en halvtimmes mellanrum.

Perioden och historik äldre än ett år

Last 365 Calendar Days är ett av de Period-alternativ som IBKR Guides räknar upp. Med det ger varje daglig körning det senaste året: nya affärer kommer med, och PnlTrack dubblerar inte de som redan importerats.

Historik äldre än ett år hämtas inte via Flex. Till PnlTrack laddar du upp den som Activity Statement-utdrag i CSV, ett per år — appen har en egen steg-för-steg-anvisning för det. En Flex-fil i XML kan inte laddas upp för hand; den kommer bara via token.

Affärer samma dag — om du vill

Activity Flex Query uppdateras en gång per dygn. Vill du se affärerna snabbare kan du lägga till en andra rapport i PnlTrack — en Trade Confirmation Flex Query, som skapas på samma Flex Queries-sida (panelen Trade Confirmation Flex Query, ”+”) med en enda sektion och formatet XML. Den använder samma token; bara dess Query ID behövs. PnlTrack hämtar den ungefär var 30:e minut.

Om något inte stämmer

  • Token slutade fungera. En token har en giltighetstid (enligt IBKR Guides som standard 6 timmar, därför väljer man en längre). Skapa en ny och byt nyckeln i PnlTrack. Tänk på att en ny token gör den gamla ogiltig — om ett annat program använder samma IB-inloggning behöver det också den nya.
  • En adress står i Valid For IP Address. Då fungerar token bara från den adressen, och PnlTracks servrar kan inte använda den. Lämna fältet tomt.
  • Inga positioner, överföringar eller värdepapperskoder. Troligen saknas en sektion i frågan. Om Open Positions, Realized and Unrealized Performance Summary in Base, Transfers eller Financial Instrument Information saknas säger PnlTrack till efter importen — öppna frågan hos IB, välj sektionen och spara.
  • Positionerna har anskaffningsutgiften noll. Kontrollera Models: det ska vara Optional.

Vad du gör med de importerade affärerna i deklarationen tas upp i Interactive Brokers och skattedeklarationen i Finland.

Vanliga frågor

Är det säkert att lämna ut en token för Flex Web Service?
Token används tillsammans med Query ID för att begära Flex-rapporter — så beskriver IBKR Guides den. Ditt IB-lösenord lämnar du inte ut. Du kan byta token när som helst: enligt IBKR Guides gör en ny token den gamla ogiltig.
Hur länge gäller en token?
Enligt IBKR Guides väljer du tiden i Should Expire After, och standard är 6 timmar. För en daglig import väljer du den längsta tiden; när den gått ut skapar du en ny token och byter nyckeln i PnlTrack.
Varför Models = Optional?
Med All stänger IB-portalen av fälten för realiserat resultat, och i våra exporter kom positionerna med anskaffningsutgiften noll. Med Optional är fälten ifyllda.
Kan jag importera mer än ett års historik?
Flex-frågan för PnlTrack ställs in på Last 365 Calendar Days. Äldre historik laddas upp som Activity Statement-utdrag i CSV, ett per år; överlappande perioder gör inget — PnlTrack tar bort dubbletter.

Källor

Uppgifterna om beskattning och valutakurser i guiden bygger på de här källorna.

  1. IBKR Guides: Create an Activity Flex Query (Client Portal, på engelska) — menyväg, sektioner, Delivery Configuration: Models, Format, Period
  2. IBKR Guides: Configure Flex Web Service (Client Portal, på engelska) — aktivering, tokens giltighetstid och IP, en ny token gör den gamla ogiltig
  3. IBKR Reporting Reference: Activity Flex Query Reference (på engelska) — vad varje sektion innehåller
  4. IBKR Reporting Reference: Open Positions (på engelska) — nivåerna Summary och Lot, anskaffningsutgift
  5. IBKR Reporting Reference: Trades (på engelska) — detaljnivåer för affärer
  6. IBKR Reporting Reference: Transfers (ACATS, Internal) (på engelska) — överföringar av positioner mellan mäklare

Det här är allmän information, inte skatte- eller investeringsrådgivning. Kontrollera din egen situation i Skatteförvaltningens anvisningar eller med en expert.