Skip to main content
TARGET_SYSTEM: abacus abacus-sandbox-24 Abacus is a Swiss enterprise software company providing ERP solutions for accounting, payroll, finance, and business management.

​
API Differences

This target system connects via the Abacus REST API. Some functionality may not be available in the REST API but can exist in the AbaConnect Webservices. In those cases, the AbaConnect target system may support the required endpoints. If you are unsure which target system is appropriate for your use case, please contact us.

​
Authentication

  • abacus uses OAuth
  • AbaConnect uses username + password
Because of these differences, we recommend selecting one target system and using it consistently.
Most core resources (such as contacts and projects) are available in both systems, though implementation details differ.
ReadCreateUpdateDeleteWebhook
Accounts
Async task
Bank accounts
Bills
Bill lines
Booking proposals
Contacts
Customers
Credit notes
Dimensions
Expenses
Files
Goods receipts
Goods receipt lines
Invoices
Invoice lines
Items
Journals
Journal entries
Offers
Offer lines
Open items
Payments
Payment terms
Projects
Purchase orders
Purchase order lines
Sales orders
Sales order lines
Suppliers
Tax rates
Transactions
Trial balance
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 [email protected] 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 [email protected] 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.