TARGET_SYSTEM: abacus abacus-sandbox-24 Abacus is a Swiss enterprise software company providing ERP solutions for accounting, payroll, finance, and business management.
ReadCreateUpdateDelete
Accounts
Async task
Bank accounts
Bills
Booking proposals
Contacts
Customers
Credit notes
Dimensions
Expenses
Files
Goods receipts
Goods receipt lines
Invoices
Invoice lines
Items
Journals
Journal entries
Offers
Offer lines
Payments
Payment terms
Projects
Purchase orders
Purchase order lines
Sales orders
Sales order lines
Suppliers
Tax rates
Transactions
Units
Users
Vendor credits
= Supported by Maesn
= Not supported by Maesn at this time
= 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.
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.