{"id":26358281,"url":"https://github.com/spoje-net/raiffeisenbank-statement-tools","last_synced_at":"2026-03-02T19:36:04.839Z","repository":{"id":210252879,"uuid":"726113120","full_name":"Spoje-NET/raiffeisenbank-statement-tools","owner":"Spoje-NET","description":"A set of tools for downloading and subsequent operations with Raiffaissenbank bank statements","archived":false,"fork":false,"pushed_at":"2025-03-13T15:00:15.000Z","size":898,"stargazers_count":1,"open_issues_count":2,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-13T16:21:27.656Z","etag":null,"topics":["downloader","raiffeisenbank","statements"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Spoje-NET.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-12-01T15:03:23.000Z","updated_at":"2025-03-13T15:00:19.000Z","dependencies_parsed_at":null,"dependency_job_id":"d9f75a39-7234-466d-8485-ac272c60f8aa","html_url":"https://github.com/Spoje-NET/raiffeisenbank-statement-tools","commit_stats":null,"previous_names":["spoje-net/raiffeisenbank-statement-downloader"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Spoje-NET%2Fraiffeisenbank-statement-tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Spoje-NET%2Fraiffeisenbank-statement-tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Spoje-NET%2Fraiffeisenbank-statement-tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Spoje-NET%2Fraiffeisenbank-statement-tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Spoje-NET","download_url":"https://codeload.github.com/Spoje-NET/raiffeisenbank-statement-tools/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243881116,"owners_count":20362901,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["downloader","raiffeisenbank","statements"],"created_at":"2025-03-16T14:27:34.923Z","updated_at":"2026-03-02T19:36:04.831Z","avatar_url":"https://github.com/Spoje-NET.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"Raiffeisenbank Statement Tools\n==============================\n\nA set of tools for downloading and subsequent operations with Raiffaissenbank bank statements\n\n[![View raiffeisenbank-statement-downloader on GitHub](https://img.shields.io/github/stars/Spoje-NET/raiffeisenbank-statement-downloader?color=232323\u0026label=raiffeisenbank-statement-downloader\u0026logo=github\u0026labelColor=232323)](https://github.com/Spoje-NET/raiffeisenbank-statement-downloader) \n[![Author Spoje-NET](https://img.shields.io/badge/Spoje-NET-b820f9?labelColor=b820f9\u0026logo=githubsponsors\u0026logoColor=fff)](https://github.com/Spoje-NET) ![Written in PHP](https://img.shields.io/static/v1?label=\u0026message=PHP\u0026color=777BB4\u0026logo=php\u0026logoColor=FFFFFF)\n\n\nStatement Downloader\n--------------------\n\n![raiffeisenbank-statement-downloader](raiffeisenbank-statement-downloader.svg?raw=true)\n\nDownload bank statements for the required period in the required format to the specified or current folder\n\n```shell\nraiffeisenbank-statement-downloader [save/to/directory] [format] [path/to/.env]\n```\n\nExample output when EASE_LOGGER=console\n\n```\n12/01/2023 16:37:10 ⚙ ❲RaiffeisenBank Statement Downloader⦒123456789@VitexSoftware\\Raiffeisenbank\\Statementor❳ Request statements from 2023-11-30 to 2023-11-30\n12/01/2023 16:37:13 🌼 ❲RaiffeisenBank Statement Downloader⦒123@VitexSoftware\\Raiffeisenbank\\Statementor❳ 10_2023_123_3780381_CZK_2023-11-01.xml saved\n12/01/2023 16:37:13 ℹ ❲RaiffeisenBank Statement Downloader⦒123456789@VitexSoftware\\Raiffeisenbank\\Statementor❳ Download done. 1 of 1 saved\n\n```\n\nStatement mailer\n----------------\n\n![raiffeisenbank-statement-downloader](raiffeisenbank-statement-mailer.svg?raw=true)\n\nDownload bank statements for the required period in the required format and send it by email\n\n```shell\nraiffeisenbank-statement-mailer \u003crecipient@domain,[recipient1@domain,...]\u003e [format] [path/to/.env]\n```\n\nBalance Check\n-------------\n\n![raiffeisenbank-balance](raiffeisenbank-balance.svg?raw=true)\n\n```shell\nraiffeisenbank-balance --output=\"/tmp/balance.json\" [--environment=\"path/to/.env\"]\n```\n\nOptions:\n- `--output` or `-o`: Path to output file (default: stdout or RESULT_FILE from config)\n- `--environment` or `-e`: Path to .env configuration file\n\nExample output:\n\n```json\n{\n    \"numberPart2\": \"635814116\",\n    \"bankCode\": \"5500\",\n    \"currencyFolders\": [\n        {\n            \"currency\": \"CZK\",\n            \"status\": \"ACTIVE\",\n            \"balances\": [\n                {\n                    \"balanceType\": \"CLAB\",\n                    \"currency\": \"CZK\",\n                    \"value\": 5883.89\n                },\n                {\n                    \"balanceType\": \"CLBD\",\n                    \"currency\": \"CZK\",\n                    \"value\": 5883.89\n                },\n                {\n                    \"balanceType\": \"CLAV\",\n                    \"currency\": \"CZK\",\n                    \"value\": 20853.89\n                },\n                {\n                    \"balanceType\": \"BLCK\",\n                    \"currency\": \"CZK\",\n                    \"value\": 0\n                }\n            ]\n        },\n        {\n            \"currency\": \"EUR\",\n            \"status\": \"ACTIVE\",\n            \"balances\": [\n                {\n                    \"balanceType\": \"CLAB\",\n                    \"currency\": \"EUR\",\n                    \"value\": 133.76\n                },\n                {\n                    \"balanceType\": \"CLBD\",\n                    \"currency\": \"EUR\",\n                    \"value\": 133.76\n                },\n                {\n                    \"balanceType\": \"CLAV\",\n                    \"currency\": \"EUR\",\n                    \"value\": 133.76\n                },\n                {\n                    \"balanceType\": \"BLCK\",\n                    \"currency\": \"EUR\",\n                    \"value\": 0\n                }\n            ]\n        }\n    ]\n}\n```\n\nTransaction Report\n------------------\n\n![raiffeisenbank-transaction-report](raiffeisenbank-transaction-report.svg?raw=true)\n\n```shell\nraiffeisenbank-transaction-report --output=\"/tmp/transaction_report.json\" [--environment=\"path/to/.env\"]\n```\n\nOptions:\n- `--output` or `-o`: Path to output file (default: stdout or RESULT_FILE from config)\n- `--environment` or `-e`: Path to .env configuration file\n\n\u003e **Note:** The chosen `STATEMENT_LINE` must support statement frequency for `REPORT_SCOPE`\n\n### Report Format\n\nAll tools now output schema-compliant JSON reports with the following structure:\n\n```json\n{\n    \"status\": \"success\",\n    \"timestamp\": \"2024-03-31T12:00:00+00:00\",\n    \"message\": \"Operation completed successfully\",\n    \"artifacts\": {\n        \"transactions\": []\n    },\n    \"metrics\": {\n        \"in_total\": 34,\n        \"out_total\": 34,\n        \"in_sum_total\": 313035.22,\n        \"out_sum_total\": 347705.63\n    }\n}\n```\n\nExample output (legacy format):\n\n```json\n{\n    \"source\": \"000000000@VitexSoftware\\\\Raiffeisenbank\\\\Statementor\",\n    \"account\": \"000000000\",\n    \"in\": {\n        \"2024-03-06T11:17:34\": \"2904\",\n        \"2024-03-07T06:02:04\": \"19602\",\n        \"2024-03-12T11:29:04\": \"363\",\n        \"2024-03-12T12:55:05\": \"363\",\n        \"2024-03-15T10:29:36\": \"26892.25\",\n        \"2024-03-19T01:11:40\": \"1815\",\n        \"2024-03-19T05:25:52\": \"726\",\n        \"2024-03-19T15:05:42\": \"3630\",\n        \"2024-03-21T17:56:34\": \"77621.5\",\n        \"2024-03-22T06:02:01\": \"1996.5\",\n        \"2024-03-25T10:26:12\": \"2359.5\",\n        \"2024-03-25T12:52:38\": \"5989.5\",\n        \"2024-03-27T17:59:30\": \"3085.5\",\n        \"2024-02-02T11:26:26\": \"12342\",\n        \"2024-02-06T14:05:14\": \"363\",\n        \"2024-02-06T14:06:09\": \"181.5\",\n        \"2024-02-12T13:45:10\": \"1452\",\n        \"2024-02-13T01:16:16\": \"275.88\",\n        \"2024-02-13T08:13:16\": \"181.5\",\n        \"2024-02-14T11:55:21\": \"968\",\n        \"2024-02-14T15:51:04\": \"1694\",\n        \"2024-02-14T16:35:02\": \"10527\",\n        \"2024-02-15T01:25:24\": \"2178\",\n        \"2024-02-15T19:26:15\": \"1058.75\",\n        \"2024-02-15T19:26:40\": \"1270.5\",\n        \"2024-02-17T18:59:54\": \"726\",\n        \"2024-02-20T11:52:17\": \"907.5\",\n        \"2024-02-22T11:54:16\": \"2359.5\",\n        \"2024-02-25T20:27:46\": \"12069.75\",\n        \"2024-02-27T17:18:38\": \"7018\",\n        \"2024-02-29T01:32:39\": \"7199.5\"\n    },\n    \"out\": {\n        \"2024-03-01T15:09:43\": \"12000\",\n        \"2024-03-01T15:10:12\": \"16000\",\n        \"2024-03-08T11:52:50\": \"46222\",\n        \"2024-03-13T06:06:37\": \"2928\",\n        \"2024-03-15T06:16:36\": \"632\",\n        \"2024-03-15T13:37:10\": \"20000\",\n        \"2024-03-16T06:17:31\": \"399\",\n        \"2024-03-17T06:22:15\": \"2654\",\n        \"2024-03-20T06:08:20\": \"2552\",\n        \"2024-03-20T15:25:44\": \"1367\",\n        \"2024-03-25T16:56:26\": \"21222\",\n        \"2024-03-26T20:42:37\": \"2520.13\",\n        \"2024-03-26T20:55:40\": \"181.5\",\n        \"2024-03-26T20:57:12\": \"16692\",\n        \"2024-03-26T20:58:46\": \"10000\",\n        \"2024-03-26T21:00:27\": \"3375\",\n        \"2024-03-26T21:01:29\": \"6380\",\n        \"2024-03-26T21:02:10\": \"3038\",\n        \"2024-03-26T21:03:51\": \"23037\",\n        \"2024-03-26T21:04:44\": \"4200\",\n        \"2024-03-26T21:05:44\": \"17700\",\n        \"2024-03-26T21:06:34\": \"800\",\n        \"2024-03-26T21:10:06\": \"16692\",\n        \"2024-03-26T21:11:02\": \"10000\",\n        \"2024-03-26T21:11:50\": \"3375\",\n        \"2024-03-26T21:12:34\": \"6380\",\n        \"2024-03-26T21:13:12\": \"3038\",\n        \"2024-03-31T23:59:59\": \"63.55\",\n        \"2024-02-02T18:06:22\": \"20000\",\n        \"2024-02-10T01:09:24\": \"24100\",\n        \"2024-02-21T11:24:38\": \"50000\",\n        \"2024-02-29T23:59:59\": \"59.45\"\n    },\n    \"in_total\": 34,\n    \"out_total\": 34,\n    \"in_sum_total\": 313035.22000000003,\n    \"out_sum_total\": 347705.63,\n    \"from\": \"2024-02-01\",\n    \"to\": \"2024-03-31\",\n    \"iban\": \"CZ0000000000000000000000\"\n}\n```\n\nExit Codes\n----------\n\n0: success - report sent\n1: certificate file problem\n2: error saving report\n4xx: Permission Denied\n5xx: Server error\n\nConfiguration\n-------------\n\nPlease set this environment variables or specify path to .env file\n\n```env\nCERT_FILE='RAIFF_CERT.p12'\nCERT_PASS=CertPass\nXIBMCLIENTID=PwX4XXXXXXXXXXv6I\nACCOUNT_NUMBER=666666666\nACCOUNT_CURRENCY=CZK\nSTATEMENT_FORMAT=pdf | xml | MT940\nSTATEMENT_LINE=MAIN\nSTATEMENT_IMPORT_SCOPE=last_two_months\nSTATEMENTS_DIR=~/Documents/\nAPI_DEBUG=True\nAPP_DEBUG=True\nEASE_LOGGER=syslog|eventlog|console\n\n# Report file configuration (optional, applies to all tools):\nREPORT_FILE=/path/to/report.json\nRESULT_FILE=/path/to/result.json\n\n# Mailer specific:\nSTATEMENTS_TO=statement@recipient.com\nSTATEMENTS_FROM=email@address.com\nSTATEMENTS_REPLYTO=email@address.com\nSTATEMENTS_CC=email@address.com\n```\n\n\nAvailble Import Scope Values\n\n----------------------------\n\n* 'yesterday'\n* 'current_month'\n* 'last_month'\n* 'last_two_months'\n* 'previous_month'\n* 'two_months_ago'\n* 'this_year'\n* 'January'\n* 'February'\n* 'March'\n* 'April'\n* 'May'\n* 'June'\n* 'July'\n* 'August'\n* 'September'\n* 'October'\n* 'November',\n* 'December'\n\nCreated using the library [php-rbczpremiumapi](https://github.com/VitexSoftware/php-vitexsoftware-rbczpremiumapi)\n\n\nMultiFlexi\n----------\n\n**Raiffeisenbank Statement Downloader** is ready for run as [MultiFlexi](https://multiflexi.eu) application.\nSee the full list of ready-to-run applications within the MultiFlexi platform on the [application list page](https://www.multiflexi.eu/apps.php).\n\n[![MultiFlexi App](https://github.com/VitexSoftware/MultiFlexi/blob/main/doc/multiflexi-app.svg)](https://www.multiflexi.eu/apps.php)\n\nDevelopment\n-----------\n\n### Requirements\n\n- PHP 8.4 or later\n- Composer\n\n### Setup\n\n```bash\n# Install dependencies\ncomposer install\n```\n\n### Testing\n\n```bash\n# Run tests\ncomposer test\n\n# Lint code\ncomposer lint\n\n# Fix code style issues\ncomposer fix\n```\n\n### Code Quality\n\nThe project follows PSR-12 coding standards and includes:\n- PHPUnit for testing\n- PHP CS Fixer for code formatting\n- PHPStan for static analysis\n\nAll scripts must pass `php -l` syntax check before committing.\n\nInstallation\n------------\n\nThe repository with packages for Debian \u0026 Ubuntu is available:\n\n```shell\nsudo apt install lsb-release wget apt-transport-https bzip2\nwget -qO- https://repo.vitexsoftware.com/keyring.gpg | sudo tee /etc/apt/trusted.gpg.d/vitexsoftware.gpg\necho \"deb [signed-by=/etc/apt/trusted.gpg.d/vitexsoftware.gpg]  https://repo.vitexsoftware.com  $(lsb_release -sc) main\" | sudo tee /etc/apt/sources.list.d/vitexsoftware.list\nsudo apt update\nsudo apt install raiffeisenbank-statement-tools\n```\n\nSee Also\n--------\n\n* [fiobank-statement-tools](https://github.com/Spoje-NET/fiobank-statement-tools)\n* [csas-statement-tools](https://github.com/VitexSoftware/csas-statement-tools)\n\n## Exit Codes\n\nApplications in this package use the following exit codes:\n\n- `0`: Success\n- `1`: General error\n- `4`: Application-specific error\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspoje-net%2Fraiffeisenbank-statement-tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspoje-net%2Fraiffeisenbank-statement-tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspoje-net%2Fraiffeisenbank-statement-tools/lists"}