@tasenor/common-plugins 1.9.16

package/src/LynxImport/backend/rules.json

@@ -0,0 +1,412 @@
+{
+  "rules": [
+    {
+      "name": "Deposit Correction",
+      "filter": "Type == 'Deposits & Withdrawals' and Subtype == 'Adjustment' and Amount >= 0",
+      "result": [
+        {
+          "reason": "'correction'",
+          "type": "'currency'",
+          "asset": "Currency",
+          "amount": "Amount",
+          "data": {
+            "text": "Description"
+          }
+        },
+        {
+          "reason": "'correction'",
+          "type": "'statement'",
+          "asset": "'INCOME_CORRECTION_DEPOSIT'",
+          "amount": "-Amount",
+          "data": {
+            "text": "Description"
+          }
+        }
+      ]
+    },
+    {
+      "name": "Withdrawal Correction",
+      "filter": "Type == 'Deposits & Withdrawals' and Subtype == 'Adjustment' and Amount < 0",
+      "result": [
+        {
+          "reason": "'correction'",
+          "type": "'currency'",
+          "asset": "Currency",
+          "amount": "Amount",
+          "data": {
+            "text": "Description"
+          }
+        },
+        {
+          "reason": "'correction'",
+          "type": "'statement'",
+          "asset": "'EXPENSE_CORRECTION_WITHDRAWAL'",
+          "amount": "-Amount",
+          "data": {
+            "text": "Description"
+          }
+        }
+      ]
+    },
+    {
+      "name": "Deposit",
+      "filter": "Type == 'Deposits & Withdrawals' and Amount > 0",
+      "result": [
+        {
+          "reason": "'deposit'",
+          "type": "'currency'",
+          "asset": "Currency",
+          "amount": "Amount",
+          "data": {
+            "text": "Description"
+          }
+        },
+        {
+          "reason": "'deposit'",
+          "type": "'external'",
+          "asset": "Currency",
+          "amount": "-Amount",
+          "data": {
+            "text": "Description"
+          }
+        }
+      ]
+    },
+    {
+      "name": "Withdrawal",
+      "filter": "Type == 'Deposits & Withdrawals' and Amount < 0",
+      "result": [
+        {
+          "reason": "'withdrawal'",
+          "type": "'currency'",
+          "asset": "Currency",
+          "amount": "Amount",
+          "data": {
+            "text": "Description"
+          }
+        },
+        {
+          "reason": "'withdrawal'",
+          "type": "'external'",
+          "asset": "Currency",
+          "amount": "-Amount",
+          "data": {
+            "text": "Description"
+          }
+        }
+      ]
+    },
+    {
+      "name": "Interest Expenses",
+      "filter": "Type == 'Interest'",
+      "result": [
+        {
+          "reason": "'expense'",
+          "type": "'currency'",
+          "asset": "Currency",
+          "amount": "Amount",
+          "data": {
+            "text": "Description",
+            "notes": ["Currency", "Month", "Year"]
+          }
+        },
+        {
+          "reason": "'expense'",
+          "type": "'statement'",
+          "asset": "'INTEREST_EXPENSE'",
+          "amount": "-Amount",
+          "data": {
+            "text": "Description",
+            "notes": ["Currency", "Month", "Year"]
+          }
+        }
+      ]
+    },
+    {
+      "name": "Forex",
+      "filter": "Type == 'Trades' and str($('Asset Category')) == 'Forex'",
+      "result": [
+        {
+          "reason": "'forex'",
+          "type": "'currency'",
+          "asset": "config.currency",
+          "amount": "Quantity",
+          "data": {
+            "rates": "rates(Currency, 1 / $('T. Price'))",
+            "notes": ["join(config.currency, '⟷', round(1 / $('T. Price'), 3), 'x', Currency)"]
+          }
+        },
+        {
+          "reason": "'forex'",
+          "type": "'currency'",
+          "asset": "Currency",
+          "amount": "null",
+          "data": {
+            "rates": "rates(Currency, 1 / $('T. Price'))",
+            "notes": ["join(config.currency, '⟷', round(1 / $('T. Price'), 3), 'x', Currency)"]
+          }
+        },
+        {
+          "reason": "'fee'",
+          "type": "'currency'",
+          "asset": "config.currency",
+          "amount": "-$('Comm in Currency')",
+          "data": {
+            "rates": "rates(Currency, 1 / $('T. Price'))",
+            "notes": ["join(config.currency, '⟷', round(1 / $('T. Price'), 3), 'x', Currency)"]
+          }
+        },
+        {
+          "if": "cents($('MTM in Currency')) > 0",
+          "reason": "'income'",
+          "type": "'statement'",
+          "asset": "'TRADE_PROFIT_CURRENCY'",
+          "data": {
+            "currency": "config.currency",
+            "currencyValue": "-$('MTM in Currency') * 100",
+            "rates": "rates(Currency, 1 / $('T. Price'))",
+            "notes": ["join(config.currency, '⟷', round(1 / $('T. Price'), 3), 'x', Currency)"]
+          }
+        },
+        {
+          "if": "cents($('MTM in Currency')) < 0",
+          "reason": "'expense'",
+          "type": "'statement'",
+          "asset": "'TRADE_LOSS_CURRENCY'",
+          "data": {
+            "currency": "config.currency",
+            "currencyValue": "-$('MTM in Currency') * 100",
+            "rates": "rates(Currency, 1 / $('T. Price'))"
+          }
+        }
+      ]
+    },
+    {
+      "name": "Stock Buy",
+      "filter": "Type == 'Trades' and str($('Asset Category')) == 'Stocks' and Quantity > 0",
+      "result": [
+        {
+          "reason": "'trade'",
+          "type": "'currency'",
+          "asset": "Currency",
+          "amount": "Proceeds"
+        },
+        {
+          "reason": "'trade'",
+          "type": "'stock'",
+          "asset": "Symbol",
+          "amount": "Quantity"
+        },
+        {
+          "if": "cents($('Comm/Fee'))",
+          "reason": "'fee'",
+          "type": "'currency'",
+          "asset": "Currency",
+          "amount": "-$('Comm/Fee')"
+        }
+      ]
+    },
+    {
+      "name": "Stock Sell",
+      "filter": "Type == 'Trades' and str($('Asset Category')) == 'Stocks' and Quantity <= 0",
+      "result": [
+        {
+          "reason": "'trade'",
+          "type": "'currency'",
+          "asset": "Currency",
+          "amount": "Proceeds"
+        },
+        {
+          "reason": "'trade'",
+          "type": "'stock'",
+          "asset": "Symbol",
+          "amount": "Quantity"
+        },
+        {
+          "if": "cents($('Comm/Fee'))",
+          "reason": "'fee'",
+          "type": "'currency'",
+          "asset": "Currency",
+          "amount": "-$('Comm/Fee')"
+        }
+      ]
+    },
+    {
+      "name": "Withholding Tax Correction",
+      "filter": "Type == 'Withholding Tax' and Subtype == 'Adjustment'",
+      "result": [
+        {
+          "reason": "'tax'",
+          "type": "'statement'",
+          "asset": "'WITHHOLDING_TAX'",
+          "data": {
+            "text": "Description",
+            "currency": "Currency",
+            "currencyValue": "-Amount * 100",
+            "notes": ["Ticker", "Date"]
+          }
+        },
+        {
+          "reason": "'correction'",
+          "type": "'statement'",
+          "asset": "'INCOME_CORRECTION_WITHHOLDING_TAX'",
+          "data": {
+            "text": "Description",
+            "currency": "Currency",
+            "currencyValue": "Amount * 100",
+            "notes": ["Ticker", "Date"]
+          }
+        }
+      ]
+    },
+    {
+      "name": "Withholding Tax",
+      "filter": "Type == 'Withholding Tax'",
+      "result": [
+        {
+          "reason": "'tax'",
+          "type": "'statement'",
+          "asset": "'WITHHOLDING_TAX'",
+          "data": {
+            "text": "Description",
+            "currency": "Currency",
+            "currencyValue": "-Amount * 100"
+          }
+        }
+      ]
+    },
+    {
+      "name": "Dividend",
+      "filter": "Type == 'Dividends'",
+      "result": [
+        {
+          "reason": "'dividend'",
+          "type": "'currency'",
+          "asset": "Currency",
+          "amount": "null",
+          "data": {
+            "notes": ["PerAsset ? times(round(Amount / PerAsset), PerAsset) : ''"],
+            "text": "Description"
+          }
+        },
+        {
+          "reason": "'income'",
+          "type": "'statement'",
+          "asset": "'LISTED_CASH_DIVIDEND'",
+          "data": {
+            "notes": ["PerAsset ? times(round(Amount / PerAsset), PerAsset) : ''"],
+            "text": "Description",
+            "currency": "Currency",
+            "currencyValue": "-Amount * 100",
+            "asset": "Ticker"
+          }
+        }
+      ]
+    },
+    {
+      "name": "Splits",
+      "filter": "Type == 'Corporate Actions' and Action == 'Split'",
+      "result": [
+        {
+          "reason": "'trade'",
+          "type": "'stock'",
+          "asset": "Ticker",
+          "amount": "Quantity",
+          "value": "Value * 100",
+          "data": {
+            "text": "Description",
+            "notes": ["'split'"]
+          }
+        }
+      ]
+    },
+    {
+      "name": "Renamings",
+      "filter": "Type == 'Corporate Actions' and Action == 'Renaming'",
+      "result": [
+        {
+          "reason": "'trade'",
+          "type": "'stock'",
+          "asset": "Quantity < 0 ? Ticker : TickerInText",
+          "amount": "Quantity",
+          "value": "Value * 100",
+          "data": {
+            "text": "Description",
+            "notes": ["'renaming'"]
+          }
+        }
+      ]
+    },
+    {
+      "name": "Spinoffs",
+      "filter": "Type == 'Corporate Actions' and Action == 'Spinoff'",
+      "result": [
+        {
+          "reason": "'trade'",
+          "type": "'stock'",
+          "asset": "Ticker",
+          "amount": "0",
+          "value": "0",
+          "data": {
+            "text": "Description",
+            "currency": "Currency",
+            "notes": ["'spinoff'"]
+          }
+        },
+        {
+          "reason": "'trade'",
+          "type": "'stock'",
+          "asset": "TickerInText",
+          "amount": "Quantity",
+          "value": "Value",
+          "data": {
+            "text": "Description",
+            "currency": "Currency",
+            "notes": ["'spinoff'"]
+          }
+        }
+      ]
+    },
+    {
+      "name": "Merge actions",
+      "filter": "Type == 'Corporate Actions' and Action == 'Merged'",
+      "result": [
+        {
+          "reason": "'trade'",
+          "type": "'stock'",
+          "asset": "TickerInText",
+          "amount": "Quantity",
+          "value": "Value * 100",
+          "data": {
+            "text": "Description",
+            "notes": ["'converted'"]
+          }
+        }
+      ]
+    },
+    {
+      "name": "Inactivity Fees",
+      "filter": "Type == 'Fees'",
+      "result": [
+        {
+          "reason": "'expense'",
+          "type": "'currency'",
+          "asset": "Currency",
+          "amount": "Amount",
+          "data": {
+            "text": "ucfirst(lower(Description))"
+          }
+        },
+        {
+          "reason": "'expense'",
+          "type": "'statement'",
+          "asset": "'STOCK_BROKER_INACTIVITY_FEE'",
+          "amount": "null",
+          "data": {
+            "text": "ucfirst(lower(Description))"
+          }
+        }
+      ]
+    }
+  ]
+}

package/src/NordeaImport/backend/NordeaHandler.ts

@@ -0,0 +1,44 @@
+import { NO_SEGMENT, SegmentId, TextFileLine } from '@dataplug/tasenor-common'
+import { ProcessFile, TransactionImportHandler } from '@dataplug/tasenor-common-node'
+
+/**
+ * Import implementation for Nordea CSV format.
+ */
+export class NordeaHandler extends TransactionImportHandler {
+
+  constructor() {
+    super('NordeaImport')
+
+    this.importOptions = {
+      parser: 'csv',
+      numericFields: ['Määrä'],
+      requiredFields: ['Viesti'],
+      insignificantFields: ['Arvopäivä', 'Maksupäivä', 'Maksajan viite', 'Kirjauspäivä', 'Tapahtuma', 'Kuitti', 'BIC'],
+      textField: 'Viesti',
+      totalAmountField: 'Määrä',
+      csv: {
+        trimLines: true,
+        cutFromBeginning: 2,
+        useFirstLineHeadings: true,
+        columnSeparator: '\t'
+      }
+    }
+  }
+
+  canHandle(file: ProcessFile): boolean {
+    return file.firstLineMatch(/^Tilinumero\tFI\d+$/) && file.thirdLineMatch(/^Kirjauspäivä\tArvopäivä\tMaksupäivä\tMäärä\tSaaja\/Maksaja\tTilinumero\tBIC\tTapahtuma\tViite\tMaksajan viite\tViesti\tKortinnumero\tKuitti$/)
+  }
+
+  segmentId(line: TextFileLine): SegmentId | typeof NO_SEGMENT {
+    return line.columns ? this.hash(line) : NO_SEGMENT
+  }
+
+  time(line: TextFileLine): Date | undefined {
+    const match = /(\d+)\.(\d+)\.(\d+)/.exec(line.columns['Maksupäivä'])
+    if (match) {
+      const stamp = match[3] + '-' + match[2] + '-' + match[1] + 'T12:00:00.000Z'
+      return new Date(stamp)
+    }
+    return undefined
+  }
+}

package/src/NordeaImport/backend/index.ts

@@ -0,0 +1,24 @@
+import { ImportPlugin } from '@dataplug/tasenor-common-node'
+import { PluginCode, Version } from '@dataplug/tasenor-common'
+import { NordeaHandler } from './NordeaHandler'
+
+class NordeaImportPlugin extends ImportPlugin {
+
+  constructor() {
+    super(new NordeaHandler())
+
+    this.code = 'NordeaImport' as PluginCode
+    this.title = 'Import for Nordea'
+    this.version = '1.0.27' as Version
+    this.icon = '<svg xmlns="http://www.w3.org/2000/svg" height="24px" viewBox="0 0 24 24" width="24px" fill="#000000"><path d="M0 0h24v24H0V0z" fill="none"/><path d="M5 6.99h3V14h2V6.99h3L9 3zM14 10v7.01h-3L15 21l4-3.99h-3V10z"/></svg>'
+    this.releaseDate = '2022-10-24'
+    this.use = 'backend'
+    this.type = 'import'
+    this.description = 'Import plugin for importing transaction data in CSV format provided by Nordea bank.'
+
+    this.languages = this.getLanguages()
+  }
+
+}
+
+export default NordeaImportPlugin

package/src/NordeaImport/backend/rules.json

@@ -0,0 +1,4 @@
+{
+  "rules": [
+  ]
+}

package/src/NordnetImport/backend/NordnetHandler.ts

@@ -0,0 +1,78 @@
+import { ImportStateText, NO_SEGMENT, SegmentId, TextFileLine } from '@dataplug/tasenor-common'
+import { NotImplemented, Process, ProcessFile, TransactionImportHandler } from '@dataplug/tasenor-common-node'
+
+/**
+ * Import implementation for Coinbase CSV format.
+ */
+export class NordnetHandler extends TransactionImportHandler {
+
+  constructor() {
+    super('NordnetImport')
+    this.importOptions = {
+      parser: 'csv',
+      numericFields: ['Summa', 'Kurssi', 'Määrä', 'Kokonaiskulut'],
+      requiredFields: [],
+      textField: 'Tapahtumatyyppi',
+      totalAmountField: 'Summa',
+      csv: { useFirstLineHeadings: true, columnSeparator: '\t' }
+    }
+  }
+
+  canHandle(file: ProcessFile): boolean {
+    return file.firstLineMatch(/^\s*Id\tKirjausp.iv.\sKauppap.iv.\sMaksup.iv./)
+  }
+
+  segmentId(line: TextFileLine): SegmentId | typeof NO_SEGMENT {
+    if (['LAINAKORKO'].includes(line.columns.Tapahtumatyyppi)) {
+      return super.segmentId(line, ['Salkku', 'Summa', 'Saldo', 'Maksupäivä', 'Kauppapäivä', 'Kirjauspäivä', 'Valuutta', 'Vaihtokurssi'])
+    }
+    if (line.columns.Vahvistusnumero) {
+      return line.columns.Vahvistusnumero
+    }
+    throw new NotImplemented(`Importer does not yet recognize ${JSON.stringify(line.columns)}.`)
+    // return NO_SEGMENT
+  }
+
+  time(line: TextFileLine): Date | undefined {
+    return line.columns['Kirjauspäivä'] ? new Date(line.columns['Kirjauspäivä']) : undefined
+  }
+
+  /**
+   * Convert typical punctuations to parseable number and return numeric value.
+   * @param s
+   */
+  num(str: string): number {
+    return parseFloat(str.replace(',', '.').replace(/ /g, ''))
+  }
+
+  async segmentation(process: Process, state: ImportStateText<'initial'>, files: ProcessFile[]): Promise<ImportStateText<'segmented'>> {
+
+    const result = await this.segmentationCSV(process, state, files)
+
+    // Fix missing currencies.
+    for (const fileName of Object.keys(result.files)) {
+      const file = result.files[fileName]
+      for (let n = 0; n < file.lines.length; n++) {
+        const { columns } = file.lines[n]
+
+        if (columns.Valuutta === '') {
+          if (columns.Valuuttakurssi === '1' || columns.Vaihtokurssi === '1') {
+            columns.Valuutta = process.config.currency as string
+          }
+          if (columns.Tapahtumatyyppi === 'OSINKO') {
+            const match = / ([A-Z]{3})\/OSAKE$/.exec(columns.Tapahtumateksti)
+            if (match) {
+              columns.Valuutta = match[1]
+            }
+          }
+        }
+
+        if (columns.Kokonaiskulut && !columns['Kokonaiskulut Valuutta']) {
+          columns['Kokonaiskulut Valuutta'] = columns.Valuutta
+        }
+      }
+    }
+
+    return this.segmentationPostProcess(result)
+  }
+}

package/src/NordnetImport/backend/index.ts

@@ -0,0 +1,24 @@
+import { ImportPlugin } from '@dataplug/tasenor-common-node'
+import { PluginCode, Version } from '@dataplug/tasenor-common'
+import { NordnetHandler } from './NordnetHandler'
+
+class NordnetImportPlugin extends ImportPlugin {
+
+  constructor() {
+    super(new NordnetHandler())
+
+    this.code = 'NordnetImport' as PluginCode
+    this.title = 'Import for Nordnet'
+    this.version = '1.0.48' as Version
+    this.icon = '<svg xmlns="http://www.w3.org/2000/svg" height="24px" viewBox="0 0 24 24" width="24px" fill="#000000"><path d="M0 0h24v24H0V0z" fill="none"/><path d="M5 6.99h3V14h2V6.99h3L9 3zM14 10v7.01h-3L15 21l4-3.99h-3V10z"/></svg>'
+    this.releaseDate = '2023-05-31'
+    this.use = 'backend'
+    this.type = 'import'
+    this.description = 'Import plugin for importing transaction data in CSV format provided by Nordnet.'
+
+    this.languages = this.getLanguages()
+  }
+
+}
+
+export default NordnetImportPlugin