@rentablo/pdf-import

Tresor-Import - The File Import of Tresor One

This is the PDF and PP-CSV Import used on rentablo.de.

Supported Brokers

All brokers supported by tresor-import are listed in the documentation.

Installation

npm install @rentablo/pdf-import

Usage

import getActivities from '@rentablo/pdf-import';

async fileHandler() {
  const results = await Promise.all(Array.from(this.$refs.myFiles.files).map(getActivities));
  results.forEach(result => {
    console.log(result);
  });
}

The function getActivities returns an objects with the following fields:

Name	Description
file	The file name of the input file.
activities	List of activities which was parsed from the input file. The activity object is broken down here.
status	The status code which contains the information about the reason why no activities was found. For Details see the status table.
successful	The simple way to check if at least one activity was found and the status code is equals zero.

The status field can contains one of the following values, described here.

How to calculate the amount

To understand the amount calculation please read the amount documentation here (in German).

Contribute

To contribute:

• fork the repo
• install and start npm i && npm start
• open the logged URL, usually http://localhost:5000, in your browser
• Import a PDF. Content is shown in your Javascript console
• Write a parser in src/brokers to parse that content - see src/brokers/comdirect.js for inspiration
• Add and run all tests npm t
• Create a Pull Request

Licensing

Usage of this codebase is permitted according to the GNU Affero General Public License v3 (AGPL-3.0).

HERE'S AN INCOMPLETE SUMMARY. READ THE FULL LICENSE BEFORE USING.

• You are permitted to:
  • Use this codebase in any way you want including commercially
  • Modify and distribute the codebase in any way you want
• You MUST:
  • Respect the copyright which is held by the maintainers of this project
  • Disclose all changes you made to the code and also publish any code directly based on this code
  • Give attribution to the original maintainers when using this project (especially when used commercially)
• You can not
  • Sublicense this codebase
  • Expect any liability, warranty or similar by the original maintainers. However, we want to improve this project as much as possible so feedback is heard!

See also the following image, taken from TL;DR Legal.