# Rillet Integration

Integrating Rillet with Sphere enables a.) seamless transaction data import and b.) live tax calculation within Rillet invoices.  

This guide provides step-by-step instructions on generating an API key in Rillet, linking it to Sphere for a secure integration. 

It also covers configuring the Sphere Tax API within Rillet to ensure accurate tax calculations.

### Part 1: Configure Data Synchronization from Rillet to Sphere

**Prerequisite:**\
**Note:** Rillet authenticates API requests using API keys. To get started, reach out to the Rillet team to enable access. Once enabled, you can create and manage your API keys from the [Organization Settings](https://app.rillet.io/settings/api-access) page.

1. In your Sphere account, select the Rillet tile and click the “**Connect**” button.

<figure><img src="/files/piHZf20Wt18mKTydgskF" alt=""><figcaption></figcaption></figure>

2. A modal will appear — click the **“Get Started”** button to proceed.

<figure><img src="/files/7U4jhi0tN83oYJwfp7v3" alt=""><figcaption></figcaption></figure>

3. Go to <https://app.rillet.io/settings/api-access> to access your Rillet API settings. From there, you can generate a new API key. Make sure to save the key securely, as you'll need it in later steps.

<figure><img src="/files/xdNObsweoPhm8K57Q8JO" alt=""><figcaption></figcaption></figure>

4. Go back to the Sphere app, paste the Rillet API key, and click **Next**.

<figure><img src="/files/8IufXjC2o6uHKpkXigol" alt=""><figcaption></figcaption></figure>

5. Select the Rillet subsidiary you want to associate with your Sphere organization

<figure><img src="/files/DYPBGwTh8JhFWfBHfOoJ" alt=""><figcaption></figcaption></figure>

6. Copy the **Rillet webhook URL** from the screen below

<figure><img src="/files/Ty8uDqxN9T15Z0ahiJFt" alt=""><figcaption></figcaption></figure>

7. In Rillet, navigate to **Webhooks** and click the '**Create webhook**\` button.
   1. Paste the URL from Step 6 and to the URL field
   2. Under Entity, select:
      1. **Invoice:** Created, Updated, Deleted, Payment Updated
      2. **Credit Memo:** Created, Updated, Deleted, Payment Updated&#x20;
   3. Click '**Create**'

<figure><img src="/files/MhcTApPsWSeGJ1ngdCTG" alt=""><figcaption></figcaption></figure>

8. Find the Webhook you just configured, and copy the '**Signing token**' into the **Rillet webook secret** field in the Sphere integration (in the page in Step 6)

<figure><img src="/files/HM1b6gFFtEOudMAGpn7g" alt=""><figcaption></figcaption></figure>

9. You’re all set! If the connection is successful, data will begin importing, and after some time, your products will appear in **Sphere**.

<figure><img src="/files/b966i9pFsTGLY9AfGU0s" alt=""><figcaption></figcaption></figure>

### Tax Calculation in Rillet

1. Ensure all your 'Subscribed Regions' in Sphere have 'Tax Calculations' settings switched to Yes (see video [here](https://www.loom.com/share/6254e72b130c44808a59513046ee60ea?sid=463c87f3-0683-4622-a479-0f960620d332) on how to ensure this is done).

<figure><img src="/files/eaylOrVkAY1p4RxyrvoK" alt=""><figcaption></figcaption></figure>

2. You can go ahead and create an invoice in Rillet for that region. After saving your changes, taxes will be added to the invoice by Sphere through an asynchronous process. This might take some time, so they may not appear immediately.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.getsphere.com/features/integrations/prebuilt-connectors/rillet-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.