{"id":22504885,"url":"https://github.com/develappersgmbh/billomatnet","last_synced_at":"2025-08-03T11:32:31.733Z","repository":{"id":40887647,"uuid":"113316357","full_name":"DevelappersGmbH/BillomatNet","owner":"DevelappersGmbH","description":"C# wrapper for Billomat API","archived":false,"fork":false,"pushed_at":"2024-02-06T16:05:42.000Z","size":1429,"stargazers_count":5,"open_issues_count":107,"forks_count":5,"subscribers_count":10,"default_branch":"develop","last_synced_at":"2024-12-06T04:39:36.719Z","etag":null,"topics":["billomat","billomat-api","csharp","dotnet-standard","nuget","wrapper"],"latest_commit_sha":null,"homepage":"","language":"C#","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/DevelappersGmbH.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.MD","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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":"2017-12-06T12:56:49.000Z","updated_at":"2022-05-15T10:18:44.000Z","dependencies_parsed_at":"2024-01-09T18:02:01.981Z","dependency_job_id":"7142c7fa-4d5d-43b4-aaca-13b55e749aa0","html_url":"https://github.com/DevelappersGmbH/BillomatNet","commit_stats":null,"previous_names":["martinhey/billomatnet"],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevelappersGmbH%2FBillomatNet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevelappersGmbH%2FBillomatNet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevelappersGmbH%2FBillomatNet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevelappersGmbH%2FBillomatNet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DevelappersGmbH","download_url":"https://codeload.github.com/DevelappersGmbH/BillomatNet/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228540835,"owners_count":17934030,"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":["billomat","billomat-api","csharp","dotnet-standard","nuget","wrapper"],"created_at":"2024-12-07T00:10:25.534Z","updated_at":"2024-12-07T00:10:27.137Z","avatar_url":"https://github.com/DevelappersGmbH.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BillomatNet\n\nThis is an API client to access your data in [Billomat](https://www.billomat.com/). It is written as .NET Standard library to be used in .NET Framework projects and .NET Core projects as well. \n\n## Status\n\n### code and build\n\n![Build and Test](https://github.com/DevelappersGmbH/BillomatNet/workflows/build%20and%20test/badge.svg)\n[![Coverage Status](https://coveralls.io/repos/github/DevelappersGmbH/BillomatNet/badge.svg?branch=master)](https://coveralls.io/github/DevelappersGmbH/BillomatNet?branch=master)\n[![Code Climate maintainability](https://img.shields.io/codeclimate/maintainability/DevelappersGmbH/BillomatNet)](https://codeclimate.com/github/DevelappersGmbH/BillomatNet)\n\n### issues\n\n![GitHub issues](https://img.shields.io/github/issues/DevelappersGmbH/BillomatNet)\n\n### release\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)\n![Nuget](https://img.shields.io/nuget/v/Develappers.BillomatNet)\n[![NuGet](https://img.shields.io/nuget/dt/Develappers.BillomatNet.svg)](https://www.nuget.org/packages/Develappers.BillomatNet/)\n\n## Usage\n\n### Connect to your Billomat instance\n\nFirst of all, you need an API Key for your user. To get one, please follow the [instructions](https://www.billomat.com/api/grundlagen/authentifizierung/).\n\nBillomatNet is divided into several services, which correspond to the sections of the REST-API (e.g. InvoiceService for invoices, OfferService for offers and so on). Every service can be instanciated providing a configured HttpClient. But there's also a central entry point BillomatClient, so you just have to instanciate it with a valid configuration and access the configured service instance of your interest.\n \n*Sample 1 (querying a filtered list of customers)*\n```\nvar config = new Configuration\n{\n    ApiKey = \"your_api_key\",\n    BillomatId = \"your_billomat_id\"\n};\n\nvar billomatClient = new BillomatClient(config);\nvar service = billomatClient.Clients;\n\nvar query = new Query\u003cClient, ClientFilter\u003e()\n    .AddFilter(x =\u003e x.Name, \"GmbH\")\n    .AddSort(x =\u003e x.City, SortOrder.Ascending);\n\nvar clients = await service.GetListAsync(query, CancellationToken.None);\n```\n\nAll lists are paged. The result contains information about the current page and the total number of items available. The query object built in the sample above also allows to specify the page (if omitted, you will get the first page containing 100 items according to the API spec of Billomat).\n\n*Sample 2 (querying a customer)*\n```\nvar config = new Configuration\n{\n    ApiKey = \"your_api_key\",\n    BillomatId = \"your_billomat_id\"\n};\n\nvar billomatClient = new BillomatClient(config);\nvar service = billomatClient.Clients;\nvar client = await service.GetById(435363);\n```\n\n## Project Status\n\nThe REST-API itself contains a whole bunch of functionality. This wrapper is still under development. New functions will be added \nsuccessively. You can find detailed information about recent changes in [change log](CHANGELOG.md).\n\n## Contribution\n\nBug reports and pull requests are welcome on [GitHub](https://github.com/DevelappersGmbH/BillomatNet). Please check the [contribution guide](CONTRIBUTING.md).This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to our [code of conduct](CODE_OF_CONDUCT.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevelappersgmbh%2Fbillomatnet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevelappersgmbh%2Fbillomatnet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevelappersgmbh%2Fbillomatnet/lists"}