Bunni

Learn how to connect and configure Bunni for automated invoice generation.

Bunni is a modern cloud accounting solution designed for freelancers and small businesses in the Netherlands. This guide covers both connecting your Bunni account and configuring it for optimal order processing and financial management.

Before You Start

Prerequisites

Active Bunni subscription
Admin access to your Bunni account
Completed settings configuration
Connected BrickLink and/or BrickOwl stores

What You'll Need

API Key - API authentication token from Bunni
Company Name - Your company identifier in Bunni (from your Bunni URL)

Part 1: Connecting Bunni

Step 1: Obtain API Credentials

Log into your Bunni account
Navigate to: Menu → API
Generate a new API Key
- Click on "Create new API key"
- Important: Select the following permissions:
  - Categories (read access)
  - Contacts (read and write access)
  - Invoice Designs (read access)
  - Invoices (read and write access)
  - Tax Rates (read access)
- Copy the generated token immediately
- Keep it secure and confidential
Find your Company Name in your Bunni URL:
- Your Bunni URL looks like: mijn.bunni.nl/administratie/{company_name}
- For example: mijn.bunni.nl/administratie/mijnbedrijf
- The company name in this case would be: mijnbedrijf

Step 2: Configure Connection

Navigate to: /home/accounting/connect
Select "Bunni" from the package dropdown
Enter your credentials:
- API Key: Your API authentication token
- Company Name (Bedrijfsnaam): Your company identifier from the Bunni URL
Click "Connect to Bunni" to verify credentials and save the connection

Part 2: Configuring Bunni Settings

After successfully connecting Bunni, you'll need to configure how orders are processed and mapped to your accounting system.

General Settings

Invoice Design (Template):

Select which Bunni invoice template to use for generated invoices
Templates control the layout, design, and branding of your invoices
Choose from available templates in your Bunni account

Invoice Description:

Default description text that appears on invoices
Common examples: "Order", "LEGO Parts Order", "Product Sales"
This text appears as introduction/header text on the invoice
Placeholders: You can use the following placeholders for dynamic content:
- {order_number} - Automatically replaced with the order number including source prefix (e.g., "BL 123456" or "BO 789012")
- {payment_method} - Automatically replaced with the payment method used (e.g., "PayPal" or "Stripe")
- Example: "Order {order_number} - {payment_method}" becomes "Order BL 123456 - PayPal"

Tax Settings

Configure tax rates for different transaction types. These settings apply to all line items based on transaction type and customer location.

Normal Tax Rate:

Used for regular transactions (products, shipping, and handling fees)
Applies to both domestic and EU sales
Example: 21% Dutch VAT for standard sales

Margin Tax Rate:

Used specifically for margin scheme items (second-hand goods)
Applies to both domestic and EU margin sales
Example: 0% or special margin scheme rate

Export Tax Rate:

Used for all sales outside the EU (exports)
Applies to all line item types (products, margin, shipping, handling)
Typically 0% VAT

Category Mapping

Bunni uses categories (revenue accounts) to properly classify transactions. You'll need to map different transaction types to appropriate categories based on customer location.

Product Line Items

Description:

Customize the description for product line items
Example: "LEGO Parts", "Product Sales"

Category Mapping: Maps to categories based on customer location:

Domestic Category: Revenue account for sales within the Netherlands
EU Category: Revenue account for sales to other EU countries
Export Category: Revenue account for sales outside the EU

Tax Rate: Uses "Normal Tax Rate" from Tax Settings

Margin Scheme Line Items

Description:

Customize the description for margin scheme items
Example: "Second-hand LEGO (Margin Scheme)"

Category Mapping: For margin scheme goods (typically second-hand products):

Domestic Category: Revenue account for domestic margin sales
EU Category: Revenue account for EU margin sales
Export Category: Revenue account for export margin sales

Tax Rate: Uses "Margin Tax Rate" from Tax Settings

Shipping Line Items

Description:

Customize the description for shipping costs
Example: "Shipping Costs", "Delivery Fee"

Category Mapping:

Single category for all shipping income

Tax Rate: Uses "Normal Tax Rate" or "Export Tax Rate" from Tax Settings based on customer location

Handling Fees Line Items

Description:

Customize the description for handling fees
Example: "Order Processing Fee", "Handling Costs"

Category Mapping:

Single category for all handling fee income

Tax Rate: Uses "Normal Tax Rate" or "Export Tax Rate" from Tax Settings based on customer location

Invoice Line Item Structure

Each order creates an invoice with separate line items for different revenue types:

Example: Dutch business selling to German customer (EU):

Order: €120 (products) + €10 (margin) + €5 (shipping) + €2 (handling)

Bunni Invoice Line Items:
1. Products: €120.00 → Product Category (EU) → Normal Tax Rate (21%)
2. Margin: €10.00 → Margin Category (EU) → Margin Tax Rate (0%)
3. Shipping: €5.00 → Shipping Category → Normal Tax Rate (21%)
4. Handling: €2.00 → Handling Category → Normal Tax Rate (21%)

Total: €137.00 + VAT

Example: Same business selling to US customer (Export):

All line items use Export categories and Export Tax Rate (0%):
1. Products: €120.00 → Product Category (Export) → Export Tax Rate (0%)
2. Margin: €10.00 → Margin Category (Export) → Export Tax Rate (0%)
3. Shipping: €5.00 → Shipping Category → Export Tax Rate (0%)
4. Handling: €2.00 → Handling Category → Export Tax Rate (0%)

Total: €137.00 (no VAT)

Tax Configuration Guidelines

Netherlands Business Example:

Normal Tax Rate: 21% BTW (for products, shipping, handling on domestic and EU sales)
Margin Tax Rate: 0% or special margin scheme rate (for margin scheme items)
Export Tax Rate: 0% (for all items to non-EU customers)

Customer Management

BrickInvoice automatically manages customers (contacts) in your Bunni system:

Customer Creation: New contacts are automatically created based on order data
Customer Updates: Existing contact information is updated when needed
Address Information: Billing and shipping addresses are mapped from order data

Part 3: Invoice Features

Automatic Invoice Creation

When orders are synchronized:

Customer Sync: Customer data (contact) is created or updated in Bunni
Invoice Generation: Invoice is created with proper line item structure
Category Assignment: Each line item is assigned the appropriate category
Tax Application: Correct tax rates are applied based on customer location
Invoice URL: Direct link to the invoice in Bunni is generated

Invoice Status

Invoices are created with the status from your Bunni settings
Invoice numbers are automatically generated by Bunni

Manual Synchronization

You can manually synchronize orders through the system, useful for:

Orders that failed automatic synchronization
Testing your Bunni configuration
One-time synchronization of specific orders

Troubleshooting

Configuration Issues

"Categories Not Loading"

Check connection: Verify Bunni is still connected
Refresh: Try refreshing the configuration page
API access: Ensure your API token has permission to read categories

"Tax Rates Not Loading"

Check connection: Verify Bunni is still connected
Active rates: Only active tax rates are shown
Refresh: Try refreshing the configuration page

"Invoice Creation Failed"

Permissions: Ensure your API token can create invoices and contacts
Required fields: Check if all required configuration fields are filled
Invoice design: Verify the selected invoice design exists

Best Practices

Tax Configuration

Scenario 1: EU VAT Compliance (Netherlands)

Normal Tax Rate: 21% (applied to products, shipping, and handling for domestic and EU sales)
Margin Tax Rate: 0% or special margin scheme rate (for second-hand goods)
Export Tax Rate: 0% (for all items to non-EU customers)

Scenario 2: Export-Only Business

Normal Tax Rate: Your domestic rate (21% for any domestic/EU sales)
Margin Tax Rate: Appropriate margin scheme rate
Export Tax Rate: 0% (most of your customers will use this rate)

Category Organization

Recommended Category Structure:

Separate categories for domestic, EU, and export sales
Dedicated categories for margin scheme sales
Clear naming conventions (e.g., "8000 - Domestic Sales", "8010 - EU Sales")
Separate categories for shipping and handling fees

Data Quality

Customer Information:

Ensure complete customer names and addresses in store orders
Review duplicate contact handling in Bunni
Keep customer information up to date for accurate invoicing

Order Data:

Verify all order amounts are correct before synchronization
Check that shipping and handling fees are properly calculated
Review margin calculations for accuracy

Next Steps

After configuring Bunni:

Test integration - Process a few test orders to verify everything works
Verify invoices - Check that invoices are created correctly in Bunni
Review categories - Ensure revenue is properly categorized
Check tax rates - Verify correct VAT is applied based on customer location
Set up automation - Enable accounting schedule for automatic processing

Support

If you encounter issues with the Bunni integration:

Check the connection status in BrickInvoice
Verify your Bunni API token and company name
Review your category and tax rate configuration
Check Bunni API logs for detailed error messages
Contact support with specific error details if needed