{"id":18858554,"url":"https://github.com/billbeeio/billbee-csharp-sdk","last_synced_at":"2025-07-18T10:08:55.006Z","repository":{"id":37697577,"uuid":"116789864","full_name":"billbeeio/billbee-csharp-sdk","owner":"billbeeio","description":"The Billbee API SDK for .Net","archived":false,"fork":false,"pushed_at":"2024-02-26T21:57:11.000Z","size":384,"stargazers_count":11,"open_issues_count":3,"forks_count":4,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-14T12:12:53.350Z","etag":null,"topics":["api","billbee","billbee-api","csharp","dotnet","ecommerce"],"latest_commit_sha":null,"homepage":null,"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/billbeeio.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-01-09T08:45:01.000Z","updated_at":"2024-09-18T12:53:13.000Z","dependencies_parsed_at":"2024-11-08T04:14:02.336Z","dependency_job_id":null,"html_url":"https://github.com/billbeeio/billbee-csharp-sdk","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/billbeeio%2Fbillbee-csharp-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/billbeeio%2Fbillbee-csharp-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/billbeeio%2Fbillbee-csharp-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/billbeeio%2Fbillbee-csharp-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/billbeeio","download_url":"https://codeload.github.com/billbeeio/billbee-csharp-sdk/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248877959,"owners_count":21176244,"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":["api","billbee","billbee-api","csharp","dotnet","ecommerce"],"created_at":"2024-11-08T04:13:57.675Z","updated_at":"2025-04-14T12:13:00.373Z","avatar_url":"https://github.com/billbeeio.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Logo](https://app.billbee.io/static/billbee/img/logo.png)](https://www.billbee.io)\n\n# Billbee API\nWith this package you can implement the official Billbee API in your C# application.\n\n## Prerequisites\n- For accessing the Billbee API you need an API Key.\nTo get an API key, send a mail to [support@billbee.de](mailto:support@billbee.de) and send us a short note about what you are building.\n- The API module must be activated in the account ([https://app.billbee.io/app_v2/settings/api/general](https://app.billbee.io/app_v2/settings/api/general))\n\n## Install\nDownload this package and decompress the solution to a place of your choice.\nIf you don't want to compile by yourself, feel free, to use our NuGet package.\n```Bash\nPM\u003e Install-Package Billbee.Api.Client -Version 2.4.2\n```\n\n## Official API Documentation\n[https://app.billbee.io/swagger/ui/index](https://app.billbee.io/swagger/ui/index)\n\n## Usage\n\nSimply open the solution in your Visual Studio or other C# IDE.\n\nThen open the Billbee.Api.Client.Demo project and take a look at the examples in Program.cs\n\n## Demo\n\n### Initialization\n\n```csharp\n// Creating an individual logger, that implements ILogger\nILogger logger = new Logger();\n\n// Creating new instance of ApiClient           \nApiClient client = new ApiClient(logger: logger);\n\n// Enter your api key here. If you don't have an api key. Please contact support@billbee.de with a description on what you would like to do, to get one.\nclient.Configuration.ApiKey = \"\";\n// Enter the username of your main account here.\nclient.Configuration.Username = \"\";\n// Enter the password of your api here.\nclient.Configuration.Password = \"\";\n\n// Test the configuration\nif (client.TestConfiguration())\n{\n\tlogger.LogMsg(\"Api test successful\", LogSeverity.Info);\n}\nelse\n{\n\tlogger.LogMsg(\"Api test failed. Please control your configuration\", LogSeverity.Error);\n}\n```\n\n### Demo Calls\n```csharp\n// Getting events for this account\nvar events = client.Events.GetEvents();\n\n// Getting my shipping providers\nvar shippingProvider = client.Shipment.GetShippingProvider();\n\n// Doing some stock manipulations\nConsole.WriteLine(\"Please enter one SKU of an article to update it's stock. Be aware, that these changes are permanent, so better use a demo article. Leave blank to skip.\");\nvar sku = Console.ReadLine();\nif (!string.IsNullOrWhiteSpace(sku))\n{\n    var updateStockCodeResult = client.Products.UpdateStockCode(new Billbee.Api.Client.Model.UpdateStockCode { Sku = sku, StockCode = \"Testlager\" });\n    var updateStockResult = client.Products.UpdateStock(new Billbee.Api.Client.Model.UpdateStock { Sku = sku, NewQuantity = 15, Reason = \"Change due to api tests.\" });\n    var updateStockMultipleResult = client.Products.UpdateStockMultiple(new List\u003cBillbee.Api.Client.Model.UpdateStock\u003e { new Billbee.Api.Client.Model.UpdateStock { Sku = sku, NewQuantity = 15 }, new Billbee.Api.Client.Model.UpdateStock { Sku = \"4712\", NewQuantity = 23 } });\n}\n\n// Requesting the urls of the terms and conditions for the usage of billbee.\nvar termsAndConditions = client.AutomaticProvision.TermsInfo();\n\n// Getting a list of all orders with order state 'confirmed'\nvar orders = client.Orders.GetOrderList(page: 1, pageSize: 20, orderStateId: new List\u003cint\u003e { 2 });\n// var x = client.Orders.GetInvoiceList();\n\n// Example to create a new order. Please create a complete order object for usage.\n// var createOrderResult = client.Orders.PostNewOrder(new Billbee.Api.Client.Model.Order() { });\n\nConsole.WriteLine(\"Please enter one order number for further test manipulations. Be aware, that these changes are permanent. Please use an demo order. Leave blank to skip.\");\nvar orderId = Console.ReadLine();\nint orderIdInt;\nif (!string.IsNullOrWhiteSpace(orderId) \u0026\u0026 int.TryParse(orderId, out orderIdInt))\n{\n    // Remove all old tags and add the given ones.\n    var updateTagsResult = client.Orders.UpdateTags(new List\u003cstring\u003e() { \"Test C\", \"Test D\" }, orderIdInt);\n\n    // Add new tags.\n    var addTagsResult = client.Orders.AddTags(new List\u003cstring\u003e() { \"Test A\", \"Test B\" }, orderIdInt);\n\n    // Add a shipment to an order. Please fill in the following and uncomment. the last line.\n    string shippingId = \"0815\";\n    int providerId = 0;\n    int productId = 0;\n    // client.Orders.AddShipment(new OrderShipment { Comment = \"Test\", OrderId = orderIdInt, ShippingId = shippingId, ShippingProviderId = providerId, ShippingProviderProductId = productId });\n\n    // Getting documents\n    var deliveryNoteResult = client.Orders.CreateDeliveryNote(orderIdInt, true);\n    var invoiceResult = client.Orders.CreateInvoice(orderIdInt, true);\n}\n```\n\n## Contributing\nFeel free to fork the repository and create pull-requests\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbillbeeio%2Fbillbee-csharp-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbillbeeio%2Fbillbee-csharp-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbillbeeio%2Fbillbee-csharp-sdk/lists"}