{"id":15355053,"url":"https://github.com/capaj/adisepo-xml-generator","last_synced_at":"2025-04-06T13:44:24.944Z","repository":{"id":41867230,"uuid":"237851378","full_name":"capaj/adisepo-xml-generator","owner":"capaj","description":"simple CLI tool for submitting Czech financial tax forms","archived":false,"fork":false,"pushed_at":"2022-12-10T16:53:06.000Z","size":135,"stargazers_count":1,"open_issues_count":3,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-12T19:48:47.319Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/capaj.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-02-02T23:16:12.000Z","updated_at":"2022-04-25T19:55:44.000Z","dependencies_parsed_at":"2023-01-26T06:45:09.761Z","dependency_job_id":null,"html_url":"https://github.com/capaj/adisepo-xml-generator","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/capaj%2Fadisepo-xml-generator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/capaj%2Fadisepo-xml-generator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/capaj%2Fadisepo-xml-generator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/capaj%2Fadisepo-xml-generator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/capaj","download_url":"https://codeload.github.com/capaj/adisepo-xml-generator/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247492466,"owners_count":20947541,"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":[],"created_at":"2024-10-01T12:22:16.676Z","updated_at":"2025-04-06T13:44:24.925Z","avatar_url":"https://github.com/capaj.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# adisepo-xml-generator\n\n## Use case and Motivation\n\nIn Czech republic being a contractor requires you to submit 3 complex forms every month/quarter. It's a lot of manual chores, so I wanted to automate this boring task with a crude CLI tool hacked together in one day.\n\nNote that this only makes sense to use if you have a very simple invoicing-just a few invoices per month to a foreign country with reverse charge to a single company. For more complex scenarios you might be able to modify the scripts to fit your use case, but don't expect it to work out of the box.\n\nI am using fakturoid for my invoices, so the script that gets the total for the last X invoices hit's their API with one request.\n\n## How to use\n\nObviously clone and install node modules. Then there are two commands you can run:\n\n- `quarterly` - this invokes fakturoid API with values in input.yaml and gets you a total for the last X invoices. Then it generates XML files same as if you would invoke it yourself\n\n- `generate` - creates XML files that you need to submit to your tax office\n\nSo if you want to use this, you want to start by duplicating `sample-input.yaml` as `input.yaml` and filling out a few values for your last quarter.\nThen just use `generate` and submit the resulting XMLs on [adis](https://adisepo.mfcr.cz/adistc/adis/idpr_epo/epo2/uvod/vstup_expert.faces). Just make sure to recheck the values. This software is untested, provided as-is.\n\n## FAQ\n\n### Why not just use fakturoid or idoklad to get your XMLs?\n\nThese only offer exporting XMLs when you pay for them. I only have one or two invoices per month and it feels weird paying for a service that I barely use when a simple script like this provides almost the same kind of convenience with a free fakturoid account.\n\n### Future plans\n\nI am tempted to add `submit` command which would use puppeteer to submit the xml files for you on adisepo that the whole submission happens without leaving the terminal.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcapaj%2Fadisepo-xml-generator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcapaj%2Fadisepo-xml-generator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcapaj%2Fadisepo-xml-generator/lists"}