> ## Documentation Index
> Fetch the complete documentation index at: https://docs.monk.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Rillet

> Monk integration with Rillet accounting and ERP

# Rillet

Monk connects directly to the [Rillet Accounting API](https://docs.api.rillet.com)
v4 over HTTPS. The integration supports Rillet organizations with multiple
subsidiaries and multi-currency receivables.

## Supported entities

| Monk entity       | Rillet entity   |
| ----------------- | --------------- |
| Customer          | Customer        |
| Customer contacts | Customer emails |
| Invoice           | Invoice         |
| Invoice line      | Invoice item    |
| Payment           | Invoice payment |
| Credit memo       | Credit memo     |
| Product / item    | Product         |
| Chart of accounts | Account         |
| Subsidiary        | Subsidiary      |

## Authentication

* A Rillet organization API key is generated in **Organization Settings → API
  Keys** and pasted into Monk.
* Monk stores the key encrypted and sends it as a `Bearer` token on every
  request.
* If the key is revoked or expired, the connection health banner prompts for a
  replacement key.

## Multi-entity, currency, and parent-child

* **Subsidiaries:** A Rillet organization can contain multiple subsidiaries.
  During setup you select the subsidiary that maps to the current Monk
  organization. Customers and products are organization-wide; invoices,
  payments, and credit memos are scoped to the selected subsidiary.
* **Currency:** Invoice and payment amounts retain their original ISO currency
  and exchange rate. Monk does not perform FX conversion; payments are applied
  in the invoice currency.
* **Customer hierarchy:** Rillet does not expose a customer parent/child field,
  so Monk treats all customers as top-level accounts.

## Configuration options

* **Subsidiary selection:** pick the Rillet subsidiary to associate with this
  Monk org.
* **Payment account:** choose the Rillet GL account used for payment
  transactions.
* **Historical cutover date:** limit how far back Monk imports invoices and
  payments.
* **Auto-import:** enable or disable automatic import of new Rillet invoices and
  customers.

## Sync and reliability

* Incremental, cursor-based sync using `updated.gt` timestamps.
* Periodic full-snapshot reconciliation catches deleted Rillet customers,
  invoices, and credit memos.
* Product records are periodically reconciled with a full snapshot because they
  do not carry a modification timestamp.
* All monetary values use Rillet's decimal-string amounts to preserve precision.

## Frequently asked questions

**Do I need to install anything in Rillet?**
No. Rillet is a hosted REST API; the only prerequisite is an organization API
key.

**Can one Monk org sync more than one Rillet subsidiary?**
One Monk org connects to one subsidiary. Connect additional Monk orgs to sync
additional subsidiaries and use Monk's org hierarchy for roll-up.

**What happens if a payment is deleted in Rillet?**
Deletion restores the invoice balance. Monk reconciles the removed payment and
reopens the invoice to its prior state.