Minimax
Connect Minimax and set up how your orders become invoices there.
Minimax is cloud accounting software, used mostly in Slovenia and other Balkan countries. This page covers connecting your Minimax account to BrickInvoice and setting up how your orders end up there.
Table of Contents
- Before you start
- Connecting Minimax
- Configuring Minimax
- How orders end up in Minimax
- Troubleshooting
- Disconnecting Minimax
- Tips for your setup
- Next steps
- Support
Before you start
You need:
- a Minimax subscription, with admin access to your Minimax account
- your settings filled in
- your BrickLink or Brick Owl store connected
- a username and password for external applications. These are not your normal Minimax login.
- your organization ID, a number such as 234895
- the Items you want on your invoices created in Minimax (see Tips for your setup)
Connecting Minimax
Create a login for external applications
Minimax gives external applications their own username and password, separate from your normal login. The Minimax help article on external application credentials shows how to create them.
Find your organization ID
Your organization ID is the number of your organization in Minimax. The Minimax help article on finding your organization ID shows where to find it.
Connect
- Go to Accounting → Connect (
/home/accounting/connect). - Choose Minimax under Accounting package.
- Fill in the username and password for external applications, and your organization ID.
- Click Test connection. BrickInvoice shows whether the test succeeded.
- Click Save connection. This button only becomes active after a successful test.
BrickInvoice encrypts your login before storing it, never shares it, and only uses it to talk to Minimax. If you think someone else knows it, create a new one in Minimax.
Configuring Minimax
Go to Accounting → Configuration to choose how your orders are booked.
General settings
Make invoice final has two choices. With No, draft (can be edited), invoices are created as drafts that you can still edit in Minimax before you issue them. With Yes, issued (cannot be changed), they are issued straight away and cannot be changed.
Invoice template is the template Minimax uses for the layout of your invoices. Delivery note template is the template for delivery notes. Create both in Minimax first, then choose them here.
Document reference is the reference text on the invoice. You can use 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
"{source} order {order_number}" becomes "BrickLink order 123456". For more detail, try {source} #{order_number} ({payment_method}).
Items include VAT (Article 83) tells BrickInvoice whether the prices of your Items in Minimax include VAT. It has to match how your Items are set up in Minimax (see Minimax help: Article 83). If it does not match, your invoice totals come out wrong.
- Off (the default): your Item prices exclude VAT. BrickInvoice sends the amount without VAT and Minimax adds the VAT. If rounding makes the total differ from the order, BrickInvoice adds a small extra line to correct it.
- On: your Item prices include VAT. BrickInvoice sends the order amount as it is.
To check, open an Item in Minimax and see whether its price field says incl. or excl. VAT.
BrickInvoice always uses the VAT rate set on the Item in Minimax and never calculates or changes it. The one exception: an order shipped outside the EU always gets 0% VAT, whatever the Item says.
Differentiate BrickLink and Brick Owl: tick this to choose separate Items for BrickLink and Brick Owl orders. See Platform differentiation.
Customer sync options
- Sync email addresses: adds the buyer's email address to the customer's contact in Minimax. Turn it on if you send invoices from Minimax. Leave it off if you would rather not keep buyers' email addresses in your accounting.
- Update existing contacts: when on, an existing customer is updated with the data from the new order. When off, existing customers are never changed.
Items per line
Each order becomes an invoice with a line for each kind of revenue. Minimax puts Items on the invoice lines, so you choose an Item from your Minimax account for each kind of line and region. Each card also has an optional Description field for the text on its lines, with the same placeholders as the document reference. "Order {order_number} from {source}" becomes "Order 123456 from BrickLink".
Product line items, for goods with normal VAT:
- Domestic product item: customers in your country, such as Slovenia
- EU product item: customers in other EU countries
- Export product item: customers outside the EU
Margin scheme line items, for second-hand goods under the margin scheme, have Domestic margin item, EU margin item and Export margin item. Their VAT rate is usually 0%.
Shipping line items:
- Shipping item: shipping within your country and the EU, at your normal VAT rate
- Export shipping item: shipping outside the EU, at 0% VAT. You only see it if your business is in the EU.
Other line items (handling fees):
- Handling fees item: handling fees for customers in your country and the EU, at your normal VAT rate
- Export handling fees item: handling fees for customers outside the EU, at 0% VAT. This one is optional: without it, BrickInvoice uses the Handling fees item.
How orders end up in Minimax
Customers
BrickInvoice looks for an existing customer by a customer code made from the buyer's username and store. If there is none, it creates one, with the billing address and its country code. An existing customer is updated when their data changes, unless you turned off Update existing contacts.
Invoices
For each order BrickInvoice creates an invoice with a line for each kind of revenue. With Yes, issued (cannot be changed) the invoice is issued straight away.
Minimax numbers invoices per year, such as 2026-13, following your own numbering. BrickInvoice copies that number back for your records, and keeps a link to each invoice so you can open it in Minimax straight from BrickInvoice.
Troubleshooting
Connecting fails
- Check your username, password and organization ID.
- Use the login for external applications, not your normal Minimax login.
- Check your internet connection and Minimax's service status.
Your login is refused
Your login for external applications may need to be created again in Minimax. Also check that your Minimax subscription is active and that the organization ID belongs to your account.
Items do not load
Check that Minimax is still connected and that you created Items in Minimax. Then reload the configuration page.
Templates do not load
Check that you have invoice and delivery note templates in Minimax, and that they are of the right type: IR for invoices, DO for delivery notes.
An invoice is not created
Check that every required Item is chosen in the configuration and that each Item has a valid VAT rate in Minimax. A missing name or address on the order can also stop the invoice.
Disconnecting Minimax
- Go to Accounting → Connect.
- Click Disconnect Minimax.
- Click Yes, disconnect in the dialog.
BrickInvoice removes the connection and your stored login, and clears your accounting configuration, so after reconnecting you set it up again. Invoices and customers already in Minimax stay where they are. To use a new login without losing your settings, use Change connection instead. See Changing or disconnecting your package.
Tips for your setup
VAT for a Slovenian business
Normal sales in Slovenia carry 22% DDV. Sales to the EU also carry 22%, or are reverse charged when the buyer is a business. Export sales outside the EU and goods under the margin scheme use 0%.
Items in Minimax
Create the Items in Minimax before you configure BrickInvoice, one for each kind of line and region, each with the right VAT rate. Clear names such as "LEGO Parts - Domestic 22%" make them easy to find in BrickInvoice and in your reports. For example:
Items in Minimax: ├── LEGO Parts - Domestic (22% VAT) ├── LEGO Parts - EU (22% VAT) ├── LEGO Parts - Export (0% VAT) ├── Margin - Domestic (0% Margin) ├── Margin - EU (0% Margin) ├── Margin - Export (0% Margin) ├── Shipping (22% VAT) ├── Shipping - Export (0% VAT) ├── Handling Fees (22% VAT) └── Handling Fees - Export (0% VAT)
Next steps
- Sync a few orders as drafts and check the invoices in Minimax.
- Check that each line has the right VAT for the customer's country.
- Turn on the accounting schedule so new orders sync on their own.
Support
If something goes wrong with Minimax, reach us through the contact form.