billomat-ts

billomat-ts is a library that allows TypeScript developers to connect to the popular online accounting software Billomat.

There's realistic mock data for the client, client property value, confirmations and invoice data types in Billomat's API. It follows that those data types are most likely to work as expected. All other data types are likely to work well though. If you want to contribute, please read our contributing guidelines.

Prerequisites

Before you begin, ensure you have met the following requirements:

• You have installed the latest version of node and npm
• You have read Billomat's own documentation about their API
• You have authentication information ready. You'll likely want to configure an app inside of Billomat. Make sure you have the base url to your Billomat instance, and an API key. If you go ahead an configure an app, you can also pass your app secret and app id into billomat-ts.

Installing billomat-ts

To install billomat-ts, simply run:

npm install billomat-ts

Using billomat-ts

For information on how to use billomat-ts, have a look at this example:

import { Billomat, getBillomatApiClient } from 'billomat-ts';
import { readFileSync } from 'fs';

const config = JSON.parse(readFileSync('config.json', 'utf-8'));
const billomat = getBillomatApiClient(config);

billomat.clients
    .list()
    .then((clients: Billomat.Client[]) =>
        clients.map((client: Billomat.Client) => client.name).map((name) => console.log(name))
    )
    .catch(console.error);

billomat-ts currently supports list, get, create, and edit operations on all known data types. The list functions accept query arguments, etc. In case these methods don't satisfy your requirements, you can instead use the raw method to perform your own requests.

Rate Limits

The Billomat-API has very strict rate limits that limit the number of requests in a specific time range. The current status of the rate limit counters and when this limit will be resetted will automatically be extracted & kept for each request. The statistics can be accessed accessed as attributes of the billomat api client:

| Attribute | Description | |---|---| | rateLimitStatistics.lastResponseAt | Date of the last response (this is where the statistics originated) | | rateLimitStatistics.limitRemaining | Number of remaining requests | | rateLimitStatistics.limitResetAt | Date, when the rate limit will be reset |

Please note: The rate limit statistics are only available after the first request.

Contact

If you want to contact me you can reach me at [email protected]. Also feel free to open an issue if you find a bug or have a question.

License

This project uses the MIT license.