1

Authorize end user

Your user must first authorize your application to access their accounting service (e.g., Xero, Lexoffice, Sevdesk) via the respective authentication mechanism (e.g., OAuth2, API key) through maesn Connect.

2

Import items

Fetch the relevant items from your customer’s ERP system using the GET /items endpoint.

3

Reconcile contacts

Match the items imported from your customer’s ERP platform with any existing items in your application, using relevant fields like itemId, itemNumber and gtin. Update items with newer information from the ERP system if available and resolve conflicting information.

4

Export contacts

Use the POST /items endpoint to create items that exist in your application, but not in your customer’s ERP platform. Use PUT /items or PATCH /items to update items in your customer’s ERP system if your application has more recent information on an item.

5

Keep your data fresh

After fetching item data initially, you should make sure to keep your customer’s product data up to date by regularly retrieving data through the GET /items endpoint. The lastModified query parameter can be utilized on all our GET endpoints to save you the hassle of creating deltas to detect change. See our guide to keeping data fresh for more information!