Configuratiegids voor Yuki Boekhoudkoppeling

Enabled

Schakelt de volledige accounting module in of uit. Zet dit op Ja om de koppeling te activeren.

Standaard: Nee

Batch Size

Het maximale aantal items dat per cron-uitvoering wordt gesynchroniseerd.

Validatie: 1–500 Standaard: 50

Alleen zichtbaar wanneer Enabled op Ja staat.

Start Date

Datum waarvoor geen data gesynchroniseerd wordt. Alle facturen en creditnota's aangemaakt vóór deze datum worden overgeslagen bij synchronisatie.

Aanbevolen instelling: Stel de begindatum van het lopende boekjaar in.

Alleen zichtbaar wanneer Enabled op Ja staat.

Auto add invoices and creditmemos

Wanneer ingesteld op Ja worden alle nieuwe facturen en creditnota's automatisch ingepland voor synchronisatie zodra ze worden aangemaakt in Magento.

Standaard: Ja Aanbevolen: Ja

Auto add customers

Wanneer ingesteld op Ja worden alle nieuwe klanten automatisch ingepland voor synchronisatie.

Standaard: Ja Aanbevolen: Ja

Prefix Creditmemo

Voegt een prefix toe aan creditnota-nummers zodat deze onderscheidbaar zijn van factuurnummers in Yuki.

Standaard: Ja Aanbevolen: Ja

Creditmemo Prefix

De te gebruiken prefix voor creditnota-nummers. Alleen zichtbaar wanneer Prefix Creditmemo op Ja staat.

Standaard: C Voorbeeld: Een creditnota met nummer 2024000123 wordt gesynchroniseerd als C2024000123.

Prefix Invoice

Voegt een prefix toe aan factuurnummers. Nuttig wanneer meerdere storeview-instanties dezelfde factuurreeks gebruiken.

Standaard: Nee

Invoice Prefix

De te gebruiken prefix voor factuurnummers. Alleen zichtbaar wanneer Prefix Invoice op Ja staat.

OSS Country Source

Bepaalt welk adres wordt gebruikt voor het vaststellen van het OSS-land bij een bestelling.

Standaard: Shipping Address Aanbevolen: Shipping Address

Customer Sync Logic

Bepaalt hoe Magento-klanten worden aangemaakt in Yuki.

Standaard: Default

Let op 1: Als de uniekheidscontrole mislukt, wordt er een nieuwe klant aangemaakt, omdat country_id en vat_number invloed hebben op BTW-tarieven. Let op 2: Gastklanten volgen dezelfde logica, maar gebruiken sales_order_address_id in plaats van billing_address_id. Tip: Deze instelling kan per klant worden overschreven via de optie "Accounting Sync Logic" op de klant-bewerkpagina.

Force Base Currency Usage

Dwingt het gebruik van de basisvaluta van de winkel bij synchronisatie naar Yuki, ongeacht de valuta van de bestelling.

Standaard: Nee Aanbevolen: Alleen inschakelen wanneer u meerdere valuta's gebruikt over verschillende storeview-instanties.

Add Removal option

Voegt verwijderopties toe aan de grids voor gesynchroniseerde facturen en creditnota's.

Standaard: Nee Waarschuwing: Gebruik deze optie met zorg.

Module Status

Schakelt de Yuki-koppeling specifiek in of uit, onafhankelijk van de algemene accounting module.

Standaard: Nee

Synchronization

Bepaalt hoe vaak de cron-taak wordt uitgevoerd voor het synchroniseren van data naar Yuki.

Aanbevolen: Elke 15 minuten

Alleen zichtbaar wanneer Module Status op Ja staat.

Enabled

Schakelt de verbinding met Yuki in of uit. Deze instelling kan worden geconfigureerd op default-, website- of storeview-niveau, zodat u per winkel een andere Yuki-administratie kunt gebruiken.

API Key

De API-sleutel voor authenticatie met de Yuki API. Het veld is versleuteld (obscured) en wordt beveiligd opgeslagen.

Waar te vinden: Yuki webapplicatie → Accountinstellingen → API-sleutel

Het veld is zichtbaar op default-, website- en storeview-niveau.

Administration

Selecteer de Yuki-administratie waarnaar facturen gesynchroniseerd worden. De dropdown wordt gevuld nadat u op de knop Check Credentials heeft geklikt en de API-sleutel geldig is.

Let op: Dit veld is alleen beschikbaar op default scope. Per website of storeview wordt de administratie overgeërfd van de default scope.

Check Credentials (knop)

Verifieert de ingevoerde API-sleutel en laadt de beschikbare administraties uit uw Yuki-account. Klik op deze knop na het invullen van de API-sleutel.

Na een succesvolle verificatie wordt het dropdown-menu Administration gevuld.

Import Info (knop)

Importeert grootboekrekeningen en BTW-codes vanuit de geselecteerde Yuki-administratie naar Magento. Na het importeren worden de dropdown-menu's in de sectie Ledger Accounts gevuld met uw Yuki-rekeningen.

Voer eerst Check Credentials en Save Config uit voordat u op Import Info klikt.

Opmerking: Gebruik eerst de knop Import Info in de sectie Connection om grootboekrekeningen te importeren vanuit Yuki. Pas daarna worden de dropdown-menu's hieronder gevuld.

Product

De standaard grootboekrekening voor product-regelitems in facturen. Deze instelling kan worden overschreven op productniveau via een productattribuut.

Standaard: 80000

Shipping

De grootboekrekening voor verzendkosten.

Standaard: 80000

Adjustment Fee

De grootboekrekening voor orderaanpassingen (adjustment fees).

Standaard: 80000

Payment/Extra Fee

De grootboekrekening voor betalingstoeslagen en extra kosten.

Standaard: 80000

Invoice Settings (Factuurinstellingen)

Invoice Type

Bepaalt of facturen in Yuki worden aangemaakt als definitief (verwerkt) of als concept (ontwerp).

Standaard: definitief

Payment Method

De betalingsmethode die wordt ingesteld op gesynchroniseerde facturen in Yuki.

Standaard: Online

Payment Days

Het aantal dagen na de factuurdatum voor de vervaldatum. Geldig bereik: 0–365 dagen.

Standaard: 14

Voorbeelden:

• 0 — Factuur direct vervallen
• 14 — Vervaldatum 14 dagen na factuurdatum
• 30 — Vervaldatum 30 dagen na factuurdatum

Descriptions (Omschrijvingen)

Invoice Description

De omschrijving die wordt meegegeven aan facturen in Yuki. Gebruik placeholders om dynamische waarden in te voegen.

Beschikbare placeholders:

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

Voorbeeld configuratie:

Invoice #{invoice_number} for order #{order_number}

Creditmemo Description

De omschrijving die wordt meegegeven aan creditnota's in Yuki. Gebruik placeholders om dynamische waarden in te voegen.

Beschikbare placeholders:

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

Voorbeeld configuratie:

Creditmemo #{creditmemo_number} for order #{order_number}

One Stop Shop (OSS)

Enable OSS

Schakelt automatische toepassing van OSS BTW-code (VATType 40) in voor B2C-bestellingen die worden verzonden naar geselecteerde EU-landen.

Standaard: Nee

Wanneer OSS is ingeschakeld, wordt VATType 40 automatisch toegepast op in aanmerking komende bestellingen. Zorg dat u in Yuki een overeenkomend BTW-tarief met type 40 heeft aangemaakt voor elk geselecteerd land.

OSS Countries

Multiselect met EU-landen (exclusief Nederland) waarvoor de OSS-regels van toepassing zijn.

Alleen zichtbaar wanneer Enable OSS op Ja staat.

Vereiste actie in Yuki: Voor elk geselecteerd land moet er een bijpassend BTW-tarief met type 40 bestaan in uw Yuki-administratie. Zonder dit bijpassende BTW-tarief zal de synchronisatie mislukken voor bestellingen naar dat land.

Advanced Ledgers (Geavanceerde Grootboekrekeningen)

Enable Advanced Ledger Mapping

Schakelt geavanceerde grootboekrekening-mapping in op basis van productattribuutwaarden.

Standaard: Nee

Mapping

Een dynamische tabel voor het koppelen van productattribuutwaarden aan specifieke grootboekrekeningen. Alleen zichtbaar wanneer Enable Advanced Ledger Mapping op Ja staat.

Gebruik deze tabel om bepaalde productcategorieën, typen of andere attribuutwaarden aan een andere grootboekrekening toe te wijzen dan de standaard productrekening.

Default Tax Classes (Standaard BTW-klassen — Terugval)

Deze BTW-klassen worden uitsluitend gebruikt als terugval wanneer de Tax Rate Mapping geen overeenkomst kan vinden voor het belastingtarief op een bestelling. Dit kan voorkomen na migraties, orderimports of ontbrekende koppelingen in de Tax Rate Mapping configuratie.

Configureer de Tax Rate Mapping via Accounting → Configuratie → Tax Rate Mapping voor de primaire BTW-koppeling.

With Tax

Terugval BTW-code voor bestellingen met belasting (belaste regelitems).

Standaard: Hoog

No Tax

Terugval BTW-code voor bestellingen zonder belasting, voor Nederlandse adressen.

Standaard: Exempt

EU No Tax

Terugval BTW-code voor ICP/ICL-bestellingen (bestellingen binnen de EU met BTW-vrijstelling, ook wel intracommunautaire leveringen).

Standaard: ExportBinnenEU

No EU No Tax

Terugval BTW-code voor bestellingen buiten de EU zonder belasting.

Standaard: ExportBuitenEU

Debug Mode

Schakelt uitgebreide logging in van API-verzoeken en -antwoorden naar een debug log-bestand. Foutmeldingen worden altijd gelogd, ongeacht deze instelling.

Standaard: Nee

Log-bestandslocaties:

Schakel debug mode uit in productieomgevingen zodra het probleem is opgelost, om schijfruimte te besparen.

Self Test (knop)

Voert een reeks diagnostische controles uit op de Yuki-koppeling. Gebruik deze knop om snel te verifiëren of de module correct is geconfigureerd en de verbinding met Yuki functioneert.