Yuki
Connect Yuki and set up how your orders become draft invoices there.
Yuki is Dutch online accounting software. This page covers connecting your Yuki domain to BrickInvoice and setting up how your orders end up there.
Table of Contents
Before you start
You need:
- a Yuki subscription, with admin access to your Yuki domain
- your settings filled in
- your BrickLink or Brick Owl store connected
- a Yuki access key from the web services settings of your domain (see below)
Connecting Yuki
Create an access key
- Log in to the Yuki Portal.
- Go to Settings → Integrations → Webservices.
- Click the plus (+) button at the top to create a new key.
- Under permissions, choose Selected web services (Geselecteerde webservices) and turn on Financial (Financieel), Sales (Verkoop) and Contacts (Relaties).
- Copy the access key. You paste it into BrickInvoice in the next step.

Do not forget Contacts (Relaties). Contacts (read-only) (Relaties (alleen lezen)) is not enough, because BrickInvoice creates your customers as contacts in Yuki. The connection test only checks the access key, so it succeeds without this permission. The problem shows up later, when the first order syncs.
Connect
- Go to Accounting → Connect (
/home/accounting/connect). - Choose Yuki under Accounting package.
- Paste the access key into the field.
- Click Test connection to check the key.
- Click Save connection.
Behind the scenes BrickInvoice exchanges the access key for a temporary session, and renews that session itself. You only ever give it the access key.
Configuring Yuki
Go to Accounting → Configuration to choose how your orders are booked.
General settings
Domain is the Yuki domain where BrickInvoice looks up and creates contacts. If your account has more than one, choose the right one.
Company is the Yuki company (administration) your invoices go to. BrickInvoice also loads its ledger scheme. You need both a domain and a company.
Invoice subject is the subject of your invoices, such as Verkoopfactuur {order_number}. It takes placeholders.
Differentiate BrickLink and Brick Owl: tick this to choose separate ledger accounts for BrickLink and Brick Owl orders. See Platform differentiation.
Contact sync options
- Sync email addresses: adds the buyer's email address to the contact in Yuki. Leave it off if you would rather not keep buyers' email addresses in your accounting.
- Update existing contacts: when on, an existing contact is updated when its data changes. When off, existing contacts are never changed.
Ledger accounts per line
Each order becomes an invoice with a separate line for each kind of revenue. Each line gets the code of a ledger account (GL account) from your company's ledger scheme. The lists only show sales accounts that are turned on in Yuki.
Product line items, for goods with normal VAT, has three accounts chosen by where the customer lives:
- Domestic GL account: sales within your country
- EU GL account: sales to other EU countries
- Export GL account: sales outside the EU
Margin scheme line items, for goods under the margin scheme (0% VAT), has the same three: Domestic margin GL account, EU margin GL account and Export margin GL account.
Shipping line items and Other line items (handling fees) each have one account for everything: Shipping GL account and Handling fees GL account.
Line descriptions
Each card has a Description field for the text on its lines.
Placeholders
The subject and the line descriptions take these placeholders:
{order_number}: the order number, such as 123456{source}: the store, BrickLink or Brick Owl{payment_method}: the payment method, such as PayPal
"Products from {source} order {order_number}" becomes "Products from BrickLink order 123456".
How orders end up in Yuki
VAT
The VAT percentage of each line comes from the order, so it always matches what your customer paid. BrickInvoice picks the Yuki VAT type from it:
- margin lines: margin scheme, 0% VAT
- export outside the EU: export, 0% VAT
- OSS on: OSS, with the rate of the customer's country from the order
- everything else: the standard high rate
OSS follows the I use OSS for cross-border EU sales setting under Settings → Tax & business. The Yuki configuration has no separate switch for it.
Contacts
BrickInvoice matches contacts by a code made from the order: BL_<buyer_name> for BrickLink, BO_<customer_username> for Brick Owl.
Draft invoices
BrickInvoice always creates invoices in Yuki as a draft (concept). Yuki does not process them or email them to the customer, so you can check each invoice in Yuki before you finalize it.
Troubleshooting
Ledger accounts do not load
Ledger accounts load per company, so choose a company first. Also check that Yuki is still connected, then reload the configuration page. Only sales accounts that are turned on appear, so check that the account is active in Yuki.
The connection fails
Check that the access key is correct and still valid in Yuki, and that web services are turned on for your Yuki domain.
"A server-side error has occurred"
Yuki reports this when the access key may not create contacts. In Yuki, open the access key under Settings → Integrations → Webservices and turn on Contacts (Relaties), as in Create an access key. Then sync the failed orders again.
Next steps
- Sync a few orders and check the draft invoices in Yuki.
- Check that your Yuki reports show the amounts you expect.
- Turn on the accounting schedule so new orders sync on their own.