{"id":13879887,"url":"https://github.com/badboy/badbill","last_synced_at":"2025-07-16T16:30:28.321Z","repository":{"id":4749413,"uuid":"5899212","full_name":"badboy/badbill","owner":"badboy","description":"A client for the Billomat API","archived":true,"fork":false,"pushed_at":"2015-01-15T15:57:47.000Z","size":316,"stargazers_count":3,"open_issues_count":0,"forks_count":2,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-07-14T03:54:11.146Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://rubydoc.info/github/badboy/badbill/master/frames","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/badboy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2012-09-21T09:17:23.000Z","updated_at":"2023-01-28T21:06:08.000Z","dependencies_parsed_at":"2022-08-18T00:05:23.634Z","dependency_job_id":null,"html_url":"https://github.com/badboy/badbill","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/badboy/badbill","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/badboy%2Fbadbill","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/badboy%2Fbadbill/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/badboy%2Fbadbill/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/badboy%2Fbadbill/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/badboy","download_url":"https://codeload.github.com/badboy/badbill/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/badboy%2Fbadbill/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265524594,"owners_count":23782007,"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-08-06T08:02:37.668Z","updated_at":"2025-07-16T16:30:27.967Z","avatar_url":"https://github.com/badboy.png","language":"Ruby","funding_links":[],"categories":["Ruby"],"sub_categories":[],"readme":"BadBill - Billomat API Client\n===================\n\n(developed for internal use at [rrbone](http://www.rrbone.net))\n\nSimple but working API client for the [Billomat API][apidocu].\n\nSee the [API documentation][apidocu] for full documentation of all resources.\n\n## Features\n\n* Fast and easy access to all resources the API provides\n  (not all resources are Ruby classes, yet)\n* Full documentation.\n* Test coverage as best as I can.\n* Production-ready (it's for a job project).\n\n## What's working right now\n\nThe basic BadBill class allows access to all resources. It includes no syntactic sugar to work with, instead it just returns the data as a hash. This works for basic usage.\n\nThe following resources are currently implemented as its own class:\n\n* [clients](http://www.billomat.com/en/api/clients/) (`BadBill::Client`)\n* [invoices](http://www.billomat.com/en/api/invoices/) (`BadBill::Invoice`)\n* [invoice-payments](http://www.billomat.com/en/api/invoices/payments/) (`BadBill::InvoicePayment`)\n* [invoice-items](http://www.billomat.com/en/api/invoices/items/) (`BadBill::InvoiceItem`)\n* [invoice-comments](http://www.billomat.com/en/api/invoices/comments) (`BadBill::InvoiceComment`)\n* [recurring](http://www.billomat.com/en/api/recurrings/) (`BadBill::Recurring`)\n\nImplementing new resources is easy. Pull Requests for others are welcome.\n\n## Requirements\n\n* [yajl-ruby](https://github.com/brianmario/yajl-ruby)\n* [faraday](https://github.com/technoweenie/faraday)\n* [faraday_middleware](https://github.com/pengwynn/faraday_middleware)\n* [hashie](https://github.com/intridea/hashie)\n\n## Installation\n\nBadBill is just a `gem install badbill` away. Get an API key for the Billomat API on your profile page.\n\n## Examples\n\n### Basic Usage\n\n    bill = BadBill.new \"billo\", \"18e40e14\"\n    # =\u003e #\u003cBadBill:0x00000001319d30 ...\u003e\n    bill.get 'settings'\n    # =\u003e {\"settings\"=\u003e\n    #   {\"invoice_intro\"=\u003e\"\",\n    #    \"invoice_note\"=\u003e\"\",\n    #    ...}}\n    bill.put 'settings', settings: { invoice_intro: \"Intro\" }\n    # =\u003e {\"settings\"=\u003e\n    #   {\"invoice_intro\"=\u003e\"Intro\",\n    #    \"invoice_note\"=\u003e\"\",\n    #    ...}}\n\n### Using defined resource classes\n\n    BadBill.new \"billo\", \"18e40e14\"\n\n    BadBill::Invoice.all\n    # =\u003e [#\u003cBadBill::Invoice:0x000000024caf98 @id=\"1\" @data={...}\u003e], ...]\n\n    invoice = BadBill::Invoice.find(1)\n    invoice.pdf\n    # =\u003e {\"id\"=\u003e\"1\",\n    #     \"created\"=\u003e\"2012-09-17T13:58:42+02:00\",\n    #     \"invoice_id\"=\u003e\"322791\",\n    #     \"filename\"=\u003e\"Invoice 322791.pdf\",\n    #     \"mimetype\"=\u003e\"application/pdf\",\n    #     \"filesize\"=\u003e\"90811\",\n    #     \"base64file\"=\u003e\"JVBERi0xLjM...\"}\n    invoice.delete\n    # =\u003e true\n\n    BadBill::Invoice.create client_id: 1, date: \"2012-09-18\", note: \"Thank you for your order\", ...\n\n## Documentation\n\nDocumentation is online at [rubydoc.info](http://rubydoc.info/github/badboy/badbill/master/frames).\n\nGenerate locale documentation with `rake doc` ([yard](http://yardoc.org/) required).\nRequired Parameters and possible values won't be documentated here. See the [API documentation][apidocu] for that.\n\n## Contribute\n\nSee [CONTRIBUTING.md](/badboy/badbill/blob/master/CONTRIBUTING.md) for info.\n\n## License\n\nSee [LICENSE](/badboy/badbill/blob/master/LICENSE) for info.\n\n[apidocu]: http://www.billomat.com/en/api/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbadboy%2Fbadbill","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbadboy%2Fbadbill","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbadboy%2Fbadbill/lists"}