Prerequisites
You need to have a valid Rillet account, an API key issued from Rillet, and admin rights on Hyperline.Setup
1
In Hyperline, navigate to the Settings > Integrations page
2
Click Connect on the Rillet card
3
Paste your Rillet API key
Hyperline uses the API key to authenticate every call to your Rillet account. You can revoke the key from Rillet at any time.
4
Map your invoicing entities to Rillet subsidiaries
On the Settings > Integrations > Rillet page, link each Hyperline invoicing entity to a Rillet subsidiary. The subsidiary drives the currency, accounts and tax codes available in the rest of the configuration.
5
6
That's it!
Your Hyperline account is ready to send invoices, credit notes, payments and contracts to Rillet.
Settings
You can configure the following options on the Settings > Integrations > Rillet page:- Invoicing entity mapping: per-entity table linking each Hyperline invoicing entity to a Rillet subsidiary. You must map a subsidiary for each entity that issues invoices. Invoice push fails for any entity without a mapping.
- Revenue recognition mode: see Revenue recognition mode below.
- Bank account: cash account used to post payments in Rillet. Required when Full accounting sync is selected. The list is pulled from your Rillet chart of accounts.
- Sync subscriptions as contracts: when enabled, Hyperline pushes each subscription to Rillet as a contract so Rillet can schedule revenue automatically. See Contract sync.
Revenue recognition mode
Hyperline can push invoices to Rillet in two different ways:- Revenue recognition only (default): Hyperline sends invoices so Rillet can recognize revenue. Rillet automatically settles payments on its side, so payments are not pushed from Hyperline.
- Full accounting sync: Hyperline sends invoices and the matching payments to Rillet, including accounts receivable tracking. Requires a bank account to be configured.
The mode applies to both invoices and credit notes.
Mapping
Customers
To link an existing Rillet customer to a Hyperline customer, open the Hyperline customer page, click Edit in the Integrations section, and paste the Rillet customer ID. For bulk linking during initial onboarding, contact our support team or use this API endpoint. If a Hyperline customer is not linked to any Rillet customer, the behavior depends on the Customer sync mode configured in Settings:- no synchronization: you must link the customer manually before any invoice can be pushed; otherwise the invoice push fails.
- from Hyperline to Rillet: the customer is automatically created in Rillet the first time it is needed (typically on the first invoice push).
Products
You must map every invoice line item to a Rillet product. For each product in Hyperline, go to the Accounting section of the product page and enter the corresponding Rillet product identifier in the Product code field. If a line item is missing a product mapping, the invoice push fails with a clear error listing the affected products so you can fix the mapping and retry.Tax codes
Tax codes are configured at the invoicing entity level. Set up tax codes with automatic computation in the tax settings of the relevant invoicing entity. Tax codes are then resolved according to what is configured in Hyperline and pushed to Rillet on each invoice line.Synchronization
When you connect your Rillet account, Hyperline automatically sends invoices, credit notes, customers, payments and (optionally) contracts with their complete details.By default, only data created after the connection date is synced. To push older data, please contact our support team.
Customer synchronization
Hyperline supports 2 modes of synchronization for customers:- no synchronization: customers are not automatically created. You must link them manually before any invoice can be pushed.
- from Hyperline to Rillet: customers created in Hyperline are automatically created in Rillet with their details.
Invoice and credit note synchronization
Invoices and credit notes are pushed as native Rillet invoices and credit memos. Updates made to an invoice in Hyperline are propagated to the matching Rillet record automatically.Payment synchronization
In Revenue recognition only mode, payments are not pushed to Rillet. Rillet automatically marks invoices as settled on its side once they are recognized. In Full accounting sync mode, Hyperline supports a per-payment-method sync setting (card, SEPA / ACH / BACS direct debit, bank transfer, Apple Pay, Google Pay, Stripe Link, external, other). Each can be set independently to:- no synchronization: payments are not synchronized.
- from Hyperline to Rillet: payments settled in Hyperline are pushed to Rillet against the corresponding invoice using the configured bank account.
Contract sync
When Sync subscriptions as contracts is enabled, Hyperline pushes each Hyperline subscription to Rillet as a contract. Rillet uses the contract to schedule revenue recognition automatically over the subscription term. Contracts are kept in sync as the subscription evolves: changes are pushed as updates, and when a subscription is cancelled the matching Rillet contract is ended on the cancellation date.Synchronization rules
You can open the shared rule form from Settings > Integrations > Rillet > Synchronisation rules. Rillet invoice and credit memo lines use the mapped Rillet product. A Revenue account selected in this form does not override that product’s revenue account. Configure revenue accounts through your Rillet products:- In Rillet, check the revenue account assigned to each product you want to invoice.
- In Hyperline, open the product’s Accounting section and enter its Rillet product identifier in Product code.
- Check that the invoicing entity is mapped to the correct Rillet subsidiary, then synchronize an invoice and review its product mappings in Rillet.
Example 💡
To separate subscription and onboarding revenue, configure two Rillet products with the appropriate revenue accounts and map each Hyperline product to its corresponding Rillet product.