Maple Integration

Integrating Maple with Sphere enables: a) seamless data imports (limited functionality as of now as we only sync products), and b) real-time tax calculation on Maple invoices.

This guide walks you through generating an API key in Maple and connecting it to Sphere for a smooth, secure integration. It also explains how to configure the Sphere Tax API in Maple to ensure precise tax calculations.

Part 1: Configure Data Synchronization from Maple to Sphere

Note: Currently, Sphere does not support importing invoices or credit notes from Maple. At this time, we only import products to enable tax calculation. Our team is actively working on adding full transaction import support, and we appreciate your patience as we build this feature. We’ll share updates as soon as transaction imports become available.

Follow the steps below to get started:

1. In your Sphere account, click on the Connect button on the Maple tile.

1. In a new window, open your Maple Dashboard and navigate to the Integrations tab from the left-hand menu. Locate the Sphere App and click Install.

1. Click the Connect Account button.

1. Copy the required values — Company ID and Maple API Key — from Maple and paste them into Sphere. Then, click Next to continue.

1. You’re all set! Once the connection is successful, data will start importing, and your products will appear in Sphere shortly thereafter.

Part 2: Configure Sphere Tax API Key for Tax Calculation

1. Click the "Edit" button on the Maple integration card to make changes.

1. This will open a modal displaying the integration details. Click "Generate API Key" to create a new key.

1. Follow the steps to create a new API key. Make sure to store the newly generated key securely, as you won’t be able to view it again later.

1. Then, in Maple, paste the newly generated API key into the field and click Update. Your integration is now complete.

1. Ensure all your 'Subscribed Regions' in Sphere have 'Tax Calculations' settings switched to Yes (see video here on how to ensure this is done).

Set up a connection between your Maple test account and Sphere

You’ll need to request the Maple team to create a test account for you, which can then be connected to your Sphere test account.

Note: Before proceeding, check with your Sphere representative to ensure your test account is properly configured and ready for testing.