Skip to main content
TARGET_SYSTEM: abaconnect AbaConnect is a service to connect to module extensions in Abacus, such as Ababau, commonly used in the construction industry.

​
API Differences

This target system uses the AbaConnect Webservices, which expose certain endpoints not available in the Abacus REST API. Depending on your use case, some functionality may only exist in the AbaConnect webservices, especially when working with the Ababau extension. If you are unsure which target system best fits your requirements, feel free to contact us.

​
Authentication

  • abaconnect uses username + password
  • abacus uses OAuth
Given these differences, we recommend working with one target system consistently rather than mixing both.
Many core resources (such as contacts and projects) are available through both integrations.

​
AbaConnect Restrictions

The abaconnect target system has several important limitations to be aware of:
  • Asynchronous operations:
    Many endpoints (especially POST requests) are processed asynchronously. If the request is not completed immediately, the API returns a taskId. You must poll /asyncTask/{taskId} to retrieve the final status and the resulting data (if any). Learn more about async tasks here.
  • Single active request limitation:
    The AbaConnect webservices allow only one running request at a time. Always ensure the previous request has fully completed (via the async task endpoint) before issuing a new one, or you will receive an error.
  • Integration user session restrictions:
    The user account used for the integration must not be used anywhere else (including the Abacus UI). Logging in with the same user elsewhere will invalidate the session and stop the integration. We strongly recommend creating a dedicated service account specifically for the integration.
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 Abaonnect

​
How to Connect to AbaConnect

AbaConnect uses username-based authentication. The user must provide the following values:
  • username: The Abacus username.
  • password: The corresponding password.
  • baseUrl: The base URL of the Abacus environment.
    This depends on the customer’s server setup (local installation or hosted subscription).
    Example: https://{AbacusInstance}.demo.abacus.ch
  • mandant: The mandant (client) to operate on. This functions similarly to an environment identifier.
1

Prerequisites

Before you begin, make sure you have:
  • An Abacus instance with the Ababau extension enabled.
If you do not have an Abacus instance, you can request a sandbox environment by contacting [email protected].
2

maesn Connect setup

Open the authentication flow in maesn Connect and enter your username, password, baseUrl, and mandant into the provided fields. Select Submit. If all values are valid, the connection will be established and you will see a success message.Your Abacus account is now connected!