Abacus
TARGET_SYSTEM: abacus abacus-sandbox-24
Abacus is a Swiss enterprise software company providing ERP solutions for accounting, payroll, finance, and business management.
| Read | Create | Update | ||
|---|---|---|---|---|
| Accounts | ⌛ | ⌛ | ⌛ | |
| Async task | ⌛ | ⌛ | ⌛ | |
| Bills | ⌛ | ⌛ | ⌛ | |
| Contacts | ✅ | ✅ | ✅ | |
| Customers | ✅ | ✅ | ⌛ | |
| Credit notes | ⌛ | ⌛ | ⌛ | |
| Expenses | ⌛ | ⌛ | ⌛ | |
| Files | ⌛ | ⌛ | ⌛ | |
| Invoices | ⌛ | ⌛ | ⌛ | |
| Invoice lines | ⌛ | ⌛ | ⌛ | |
| Items | ⌛ | ⌛ | ⌛ | |
| Journal entries | ⌛ | ⌛ | ⌛ | |
| Offers | ⌛ | ⌛ | ⌛ | |
| Offer lines | ⌛ | ⌛ | ⌛ | |
| Projects | ✅ | ✅ | ⌛ | |
| Sales Orders | ✅ | ✅ | ⌛ | |
| Sales Orders Lines | ✅ | ⌛ | ⌛ | |
| Suppliers | ⌛ | ⌛ | ⌛ | |
| Tracking categories | ⌛ | ⌛ | ⌛ | |
| Transactions | ⌛ | ⌛ | ⌛ | |
| Vendor credits | ⌛ | ⌛ | ⌛ |
✅ = Endpoint available
⌛ = Endpoint in progress
❌ = Endpoint not supported by abacus
How to connect to Abacus
To allow your customers to link your application with their Abacus account, you need to set up a user-dependent service user in Abacus.
The Base URL for Abacus depends on the server configuration and can vary based on whether Abacus is installed locally by the user or hosted via a subscription.
To authenticate, you must provide the correct Base URL by including it as the baseUrl query parameter in the GET /auth/TARGET_SYSTEM request.
For the Abacus sandbox v2024, this is pre-configured.
When targeting Abacus endpoints, it is essential to include the environmentName query parameter.
You can obtain this value by using the GET Environments endpoint available under the Authentication section.
Prerequisites
Before you begin, make sure you have the following:
- An abacus instance with administrator permissions.
- For production environments, the user must have permissions to access the mandant-provisioning API.
If you don’t have an Abacus instance, you can contact their team at rest-api@abacus.ch to request a sandbox instance.
Set Up a Service User in Abacus
Follow the instructions in the video under the Authorization Code Grant section of the Abacus Authentication Guide.
Set the login redirect URL to: https://api.maesn.dev/auth/callback/{abacus-version}
Replace {abacus-version} with the appropriate version of Abacus you are integrating with.
If you are using the Abacus sandbox, you must contact rest-api@abacus.ch to set up your user-dependent service user.
Configure Your Integration in the Maesn API
Finally, set up your API tenant with your application’s details. Contact your maesn representative to provide the following information:
- Application (Client) ID of your application
- For sandbox environments, also include the mandant ID.
If you are not sure who your technical contact is, do not hesitate to reach out to us.