Configuration Guide for Yuki Connection

Turns the accounting module on or off. When disabled, no invoices or credit memos will be queued or synced, regardless of any other settings.

Only invoices and credit memos created on or after this date will be synced to Yuki. Anything before this date is ignored.

When to use:

• You're going live mid-month and don't want to import historical orders
• You're migrating from another accounting integration and want a clean cutoff

When enabled, every new Magento invoice or credit memo is automatically added to the sync queue as soon as it's created. When disabled, you have to push them manually from the admin grids.

When to use:

• Enable this in most setups — it's the main automation you want
• Disable if you need to review invoices before they're sent to Yuki

When enabled, new customers are automatically synced to Yuki when an invoice is processed. This keeps your Yuki customer list up to date without manual intervention.

Adds a prefix to the credit memo number when it's sent to Yuki. Useful when you need to distinguish credit memos from invoices in Yuki's document list.

The actual prefix string to prepend to credit memo numbers (for example: C). Only applies when Prefix Credit Memo is enabled. The result would look like C1000001.

Same concept as the credit memo prefix, but for invoices.

The prefix string to use for invoices when Prefix Invoice is enabled.

Controls which address data is used when syncing a customer record to Yuki.

When to use:

• Use Address if your customers frequently order with different billing details per order
• Use Customer if you want a consistent address tied to the customer account

When enabled, all amounts are sent to Yuki in the store's base currency, regardless of the currency the customer used at checkout.

When to use:

• Enable this if your Yuki administration is set up in a single currency (usually EUR) and you don't want multi-currency amounts flowing in
• Leave disabled if you operate in multiple currencies and want Yuki to handle conversion

Turns the Yuki integration on or off. This controls whether Yuki-specific processing (API communication, ledger mapping, etc.) is active.

Sets how often the cron job runs to push queued invoices and credit memos to Yuki.

This field only appears when Enabled is set to Yes.

Enables the connection for the current scope (default, website, or store view). You can have the integration active for some websites and not others.

Your Yuki API key, stored encrypted. You'll find this in your Yuki account under Settings → API.

Tip: After entering your API key, always click Check Credentials to verify it works before saving.

Once your credentials are verified, this dropdown lists the Yuki administrations available under your API key. Select the administration you want invoices synced into.

This field is only populated after a successful credentials check and is only available at the default scope — not per website or store view.

A button that validates your API key and loads the list of available administrations into the Administration dropdown. Run this after entering or updating your API key.

Imports ledger accounts and tax codes from your Yuki administration into Magento. This populates the dropdowns in the Ledger Accounts section and the Tax Rate Mapping grid.

Tip: Run this before configuring ledger accounts. Without it, all ledger dropdowns will be empty.

The default ledger for product line items. This applies to all products unless overridden at the product level in the catalog.

Recommended: 80000 or your primary revenue ledger.

The ledger for shipping cost line items on invoices.

The ledger for order adjustment amounts (positive or negative adjustments applied to an order total).

The ledger for payment surcharges — for example, fees added by a payment method.

Invoice Type

Controls whether invoices are created in Yuki as definitief (processed/final) or concept (draft).

Recommended: definitief for fully automated setups.

Payment Method

The payment method label to attach to invoices in Yuki. Defaults to Online.

Payment Days

The number of days from the invoice date that payment is due. This sets the due date on the invoice in Yuki.

Recommended: 14 days is the default and works for most setups. Adjust to match your actual payment terms.

Invoice Description

The description line added to each invoice in Yuki. Supports the following placeholders:

Default: Invoice #{invoice_number} for order #{order_number}

Credit Memo Description

Same as invoice description, but for credit memos. Uses the same placeholders plus:

Default: Creditmemo #{creditmemo_number} for order #{order_number}

Enable OSS

Enables automatic VAT type 40 handling for B2C orders shipped to EU countries. This is required if your store falls under the EU One Stop Shop VAT scheme.

When to use:

• Your store sells to B2C customers in EU countries outside the Netherlands
• You're registered for OSS and need to report VAT per destination country

Important: For each EU country you enable, you must also create a matching BTW tax code with type 40 in Yuki (one per country).

OSS Countries

A multiselect of EU countries (Netherlands excluded) for which OSS VAT handling is applied. Only visible when Enable OSS is set to Yes.

Select all countries where you sell B2C and want Yuki to apply the destination country VAT rate via type 40.

Enable Advanced Ledger Mapping

When enabled, you can map specific product attribute values to specific Yuki ledger accounts. This is useful when different product types should go to different revenue ledgers in Yuki.

Mapping

A dynamic table where you define the mapping rules. Each row maps a product attribute value (e.g., a product type or category) to a specific ledger account.

Only visible when Enable Advanced Ledger Mapping is set to Yes.

These fallback tax codes are used when Magento's tax rate cannot be matched in the Tax Rate Mapping grid. This can happen after data migrations, imports, or when a new tax rule hasn't been mapped yet.

Tip: These are safety nets, not the primary mapping. Set up your Tax Rate Mapping grid properly — these only kick in when nothing else matches.

With Tax

Fallback Yuki tax code for taxed line items (e.g., standard Dutch VAT).

Default: Hoog

No Tax

Fallback for domestic (NL) line items with no tax — for example, exempt goods.

Default: Exempt

EU No Tax

Fallback for intra-EU B2B sales (ICP/ICL) where no VAT is charged.

Default: ExportBinnenEU

No EU No Tax

Fallback for sales outside the EU with no VAT applied.

Default: ExportBuitenEU

When enabled, all API requests and responses between Magento and Yuki are written to a log file. Error logging is always active regardless of this setting.

Log files:

• var/log/yuki-debug.log — API request/response details (only when debug mode is on)
• var/log/yuki-error.log — Errors and warnings (always logged)

When to use:

• Enable temporarily when troubleshooting sync issues
• Disable in production once everything is working — the logs can get large on busy stores

A diagnostic button that runs a series of checks on the module configuration and connection. Use this to quickly verify that everything is set up correctly after initial configuration or after making changes.