https://github.com/osiegmar/billomat4j
Java Software Development Kit for the billomat[API]
https://github.com/osiegmar/billomat4j
billomat development-kit java
Last synced: 5 months ago
JSON representation
Java Software Development Kit for the billomat[API]
- Host: GitHub
- URL: https://github.com/osiegmar/billomat4j
- Owner: osiegmar
- License: lgpl-3.0
- Archived: true
- Created: 2012-11-04T17:19:21.000Z (over 13 years ago)
- Default Branch: master
- Last Pushed: 2023-08-05T18:32:23.000Z (almost 3 years ago)
- Last Synced: 2025-10-17T06:59:52.862Z (7 months ago)
- Topics: billomat, development-kit, java
- Language: Java
- Size: 1.17 MB
- Stars: 5
- Watchers: 5
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Billomat4J
[](https://github.com/osiegmar/billomat4j/actions/workflows/gradle.yml)
[](https://javadoc.io/doc/de.siegmar/billomat4j)
[](https://search.maven.org/artifact/de.siegmar/billomat4j)
Java Software Development Kit for the [Billomat API](https://www.billomat.com/api/).
> :hand: Due to the unversioned Billomat API, the regular breaking changes, the lack of a changelog,
> ongoing documentation errors and the ignorant support team, the active development and maintenance
> of this project has been stopped.
## Requirements
- Java 11
- Jackson JSON Processor
- SLF4J
## Example
This example fetches all paid invoices for the last 30 days and prints them out.
This file is also part of this project - see [Example.java](src/integrationTest/java/integrationtest/Example.java)
```java
BillomatConfiguration billomatConfiguration = new BillomatConfiguration();
billomatConfiguration.setBillomatId("");
billomatConfiguration.setApiKey("");
InvoiceService invoiceService = new InvoiceServiceImpl(billomatConfiguration);
System.out.println("Paid invoices for the last 30 days:");
InvoiceFilter invoiceFilter = new InvoiceFilter()
.byFrom(LocalDate.now().minusDays(30))
.byTo(LocalDate.now())
.byStatus(InvoiceStatus.PAID);
for (Invoice invoice : invoiceService.findInvoices(invoiceFilter)) {
System.out.println("Invoice " + invoice.getInvoiceNumber() + ": " + invoice.getTotalNet());
}
```
## Testing
**WARNING**: Do not run the integration tests with your regular Billomat account.
The tests will wipe out all your invoices, clients and so on.
Ask the Billomat-Team for a dedicated Test-User!
Create a file `src/integrationTest/resources/billomat.properties` with this content:
```
billomatId =
billomatApiKey =
billomatAppId = # OPTIONAL
billomatAppSecret = # OPTIONAL
email =
```
The email address is required for sending test documents (like invoices).
Run the integration test suite by invoking:
```
./gradlew integrationTest
```