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.

Contact

If you want to contact me you can reach me at j-frost+billomat-ts@a3re.net. Also feel free to open an issue if you find a bug or have a question.

License

This project uses the MIT license.