TARGET_SYSTEM: abacus-23 abacus-24 abacus-25 abacus-sandbox-23 abacus-sandbox-24 abacus-sandbox-25

Abacus is a Swiss enterprise software company providing ERP solutions for accounting, payroll, finance, and business management.

ReadCreateUpdate
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.

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.

1

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.

2

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.

3

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 via support@maesn.com, but do not enter your client credentials directly in the email. That’s not safe!