{"id":16299708,"url":"https://github.com/hongaar/motorrijtuigenbelasting","last_synced_at":"2025-03-20T05:30:53.334Z","repository":{"id":65403271,"uuid":"591277407","full_name":"hongaar/motorrijtuigenbelasting","owner":"hongaar","description":"🚗 Motorrijtuigenbelasting (MRB) berekenen in JavaScript","archived":false,"fork":false,"pushed_at":"2024-08-19T01:40:16.000Z","size":2592,"stargazers_count":5,"open_issues_count":7,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-28T23:20:09.507Z","etag":null,"topics":["belastingdienst","betalennaargebruik","cli","motorrijtuigenbelasting","mrb","rekeningrijden","tax","typescript","wegenbelasting"],"latest_commit_sha":null,"homepage":"https://autokosten.tools","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hongaar.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","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-01-20T11:11:25.000Z","updated_at":"2024-05-20T01:24:06.000Z","dependencies_parsed_at":"2023-12-24T08:25:40.226Z","dependency_job_id":"cb8c556b-ae26-40a2-9421-bf547e922436","html_url":"https://github.com/hongaar/motorrijtuigenbelasting","commit_stats":null,"previous_names":[],"tags_count":29,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hongaar%2Fmotorrijtuigenbelasting","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hongaar%2Fmotorrijtuigenbelasting/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hongaar%2Fmotorrijtuigenbelasting/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hongaar%2Fmotorrijtuigenbelasting/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hongaar","download_url":"https://codeload.github.com/hongaar/motorrijtuigenbelasting/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244056404,"owners_count":20390719,"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":["belastingdienst","betalennaargebruik","cli","motorrijtuigenbelasting","mrb","rekeningrijden","tax","typescript","wegenbelasting"],"created_at":"2024-10-10T20:49:13.273Z","updated_at":"2025-03-20T05:30:52.601Z","avatar_url":"https://github.com/hongaar.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# motorrijtuigenbelasting [![npm](https://img.shields.io/npm/v/@motorrijtuigenbelasting/cli)](https://www.npmjs.com/package/@motorrijtuigenbelasting/cli)\n\n**Calculate Dutch car tax (motorrijtuigenbelasting) in JavaScript**\n\n\u003e **Note**: **in development**\n\u003e\n\u003e This module is in development. The implemented rules are tested and verified,\n\u003e but quite some rules are not implemented yet. [Contributions](#contributing)\n\u003e are very welcome!\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://autokosten.tools\"\u003e\u003cimg src=\"autokosten.tools.png\" alt=\"autokosten.tools\" /\u003e\u003c/a\u003e\u003cbr/\u003e\n  Visit \u003ca href=\"https://autokosten.tools\"\u003eautokosten.tools\u003c/a\u003e to calculate Dutch\n  car tax.\n\u003c/p\u003e\n\n---\n\n## Table of contents\n\n\u003c!-- START doctoc generated TOC please keep comment here to allow auto update --\u003e\n\u003c!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE --\u003e\n\n- [CLI](#cli)\n  - [Usage](#usage)\n- [SDK](#sdk)\n  - [Installation](#installation)\n  - [Usage](#usage-1)\n- [Contributing](#contributing)\n  - [Implementation status](#implementation-status)\n  - [Development](#development)\n  - [Devcontainer](#devcontainer)\n  - [Credits](#credits)\n\n\u003c!-- END doctoc generated TOC please keep comment here to allow auto update --\u003e\n\n# CLI\n\n## Usage\n\nIn the examples below, we use [`yarn dlx`](https://yarnpkg.com/cli/dlx) to run\nthe CLI. You can also use [`npx`](https://docs.npmjs.com/cli/v9/commands/npx),\nit should work exactly the same.\n\nExample with manual input:\n\n```bash\nyarn dlx @motorrijtuigenbelasting/cli \\\n  --vehicle-type Personenauto \\\n  --weight 1051 \\\n  --propulsion-type Benzine \\\n  --co2-emission 86 \\\n  --province Utrecht\n```\n\nExample with vehicle ID (kenteken) as input:\n\n```bash\nexport RDW_APP_TOKEN=foo\nyarn dlx @motorrijtuigenbelasting/cli \\\n  --vehicle-id S-212-PK\n  --province Utrecht\n```\n\nExample output:\n\n![Example CLI output](cli.png)\n\n\u003e **Note**: App token can be obtained after registering at the\n\u003e [RDW open data portal](https://opendata.rdw.nl/signup).\n\n# SDK\n\n## Installation\n\n```bash\nyarn|npm add @motorrijtuigenbelasting/core @motorrijtuigenbelasting/mrb2023\n```\n\n\u003e **Note**: When you want to use a different revision of the car tax law, use\n\u003e the corresponding package. See elsewhere in this README to see a list of\n\u003e supported revisions.\n\n## Usage\n\n```js\nimport {\n  PropulsionType,\n  Province,\n  run,\n  VehicleType,\n} from \"@motorrijtuigenbelasting/core\";\nimport mrb2023 from \"@motorrijtuigenbelasting/mrb2023\";\n\nconst params = {\n  vehicleType: VehicleType.Personenauto,\n  weight: 1051,\n  propulsions: [{ type: PropulsionType.Benzine, co2Emission: 86 }],\n  province: Province.Utrecht,\n};\n\nconst results = run(mrb2023, params);\n\nconsole.log({ results });\n```\n\nTo obtain params from the RDW from a vehicle ID (kenteken), use the\n`@motorrijtuigenbelasting/rdw` package:\n\n```js\nimport { fetchRdwData, getParamsFromRdw } from \"@motorrijtuigenbelasting/rdw\";\n\nconst vehicleId = \"S-212-PK\";\nconst rdwAppToken = \"foo\";\n\nconst rdwData = await fetchRdwData(vehicleId, rdwAppToken);\nconst params = rdwDataToParams(rdwData);\n```\n\n# Contributing\n\nContributions are very welcome!\n\n## Implementation status\n\n- [x] CLI\n- [ ] MRB2023\n  - [x] Personenauto\n    - [x] Propulsion types\n    - [x] Provinces\n    - [x] Low emission\n    - [x] No emission\n  - [x] Bestelauto particulier\n    - [x] Propulsion types\n    - [x] Particulate matter surtax\n    - [x] No emission\n  - [ ] Bestelauto gehandicapte\n  - [ ] Bestelauto ondernemer\n    - [x] Propulsion types\n    - [x] Particulate matter surtax\n    - [x] No emission\n  - [ ] Motor\n  - [ ] Aanhangwagen/oplegger\n  - [x] Kampeerauto\n    - [x] Propulsion types\n    - [x] Rented for business purposes\n    - [x] Particulate matter surtax\n    - [x] No emission\n  - [ ] Caravan, vouwwagen of woonwagen\n  - [ ] Autobus\n  - [ ] Rijdende winkel\n  - [ ] Handelaarskenteken\n  - [ ] Vrachtauto\n- [ ] Convert RDW data\n  - [ ] Vehicle type (incomplete)\n  - [x] Weight\n  - [x] Propulsion types\n  - [ ] Particulate matter surtax (incomplete)\n- [ ] Betalennaargebruik package\n- [ ] Emit warning when there is a known discrepancy between the model and the\n      official calculator\n\nSee [TODO.md](TODO.md) for known problems which need fixing and general todos.\n\n## Development\n\nTo run the `@motorrijtuigenbelasting/cli` package from source, run:\n\n```bash\ncd packages/cli\nyarn start\n```\n\n## Devcontainer\n\nA devcontainer configuration is included in this repo to\n[get started quickly](https://code.visualstudio.com/docs/remote/containers#_quick-start-open-an-existing-folder-in-a-container).\n\n## Credits\n\n©️ Copyright 2023 [Joram van den Boezem](https://joram.dev)  \n♻️ Licensed under the [MIT license](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhongaar%2Fmotorrijtuigenbelasting","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhongaar%2Fmotorrijtuigenbelasting","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhongaar%2Fmotorrijtuigenbelasting/lists"}