Best Practices voor Yuki Koppeling in Magento 2

✅ Test altijd met één enkele factuur voordat u automatisering inschakelt
✅ Importeer grootboekrekeningen vanuit Yuki voordat u de grootboekinstellingen configureert
✅ Koppel alle belastingregels in Tax Rate Mapping voordat u live gaat
✅ Schakel Debug Mode in tijdens de initiële configuratie
✅ Maak in Yuki een passende BTW-code aan voor elk OSS-land
✅ Gebruik het factuurtype "definitief" voor productie, "concept" voor testen

❌ Schakel automatisering niet in zonder eerst de grootboek- en belastingconfiguratie te voltooien
❌ Sla de stap Tax Rate Mapping niet over
❌ Laat Debug Mode niet ingeschakeld staan in productie
❌ Vergeet niet om OSS BTW-codes aan te maken in Yuki voordat u OSS-landen inschakelt

Gebruik: Één winkel, alleen verkopen aan Nederlandse klanten, met de standaard BTW-tarieven van 21% en 9%.

Configuratie:

Verbinding:

• Één verbinding, één Yuki-administratie
• Factuurtype: definitief

Grootboekrekeningen:

• Product: Omzetrekening (bijv. 8000)
• Verzending: Omzetrekening (bijv. 8000)

Tax Rate Mapping:

• NL BTW 21% → Hoog
• NL BTW 9% → Laag

OSS:

• Uitgeschakeld

Resultaat: Alle facturen worden automatisch gesynchroniseerd naar Yuki met de juiste Nederlandse BTW-codes.

Gebruik: Nederlandse webshop die verkoopt aan consumenten in de hele EU, met gebruikmaking van de One Stop Shop (OSS) BTW-regeling.

Configuratie:

Verbinding:

• Zelfde als Scenario 1, plus OSS ingeschakeld

OSS-instellingen:

• OSS: Ingeschakeld
• OSS Countries: selecteer alle EU-landen waarnaar u actief verkoopt

In Yuki (vóór het inschakelen van OSS):

• Maak per OSS-land een BTW-code aan van type 40, met het lokale BTW-tarief van dat land

Tax Rate Mapping:

• Koppel elk EU-bestemmingslandtarief aan de bijbehorende BTW-code

Resultaat: Binnenlandse bestellingen gebruiken de standaard Hoog/Laag-codes. EU B2C-bestellingen gebruiken automatisch VATType 40 met de juiste landcode, passend bij de BTW-codes die u in Yuki heeft aangemaakt.

Tip: Gebruik de knop Import Info nadat u nieuwe BTW-codes in Yuki heeft toegevoegd — hiermee worden de beschikbare BTW-codes in Magento vernieuwd.

Gebruik: Meerdere store views of websites, elk gekoppeld aan een aparte Yuki-administratie.

Configuratie:

Per store view:

• Schakel de verbinding afzonderlijk in per store view
• Gebruik een andere API-sleutel per winkel, of dezelfde sleutel met een andere geselecteerde administratie
• Configureer grootboekrekeningen per store view
• Pas de factuuromschrijvingen per store aan indien nodig (bijv. inclusief winkelnaam)

Resultaat: Elke store view synchroniseert onafhankelijk naar zijn eigen Yuki-administratie. Bestellingen van winkel A verschijnen niet in administratie B.

Gebruik: Verkopen aan zakelijke klanten binnen de EU met BTW-verlegging (intracommunautaire levering).

Configuratie:

Belastingregels:

• Stel Magento-belastingregels in voor 0% EU BTW-verlegging

Tax Rate Mapping:

• EU BTW-verlegging → ExportBinnenEU

Algemene instellingen:

• EU No Tax Fallback: ExportBinnenEU

OSS:

• Niet nodig voor B2B

Resultaat: B2B EU-facturen worden gesynchroniseerd naar Yuki met de ICP BTW-code (VATType 7 / ExportBinnenEU). Er is geen OSS-configuratie nodig voor zakelijke transacties.

Waarom dit fout gaat: Yuki geeft een API-fout wanneer de module een factuur probeert in te sturen met een VATType 40-code die niet bestaat in uw administratie.

Juiste aanpak: Maak de BTW-code eerst aan in Yuki (type 40, juist percentage, juist land), klik daarna op Import Info in Magento, en schakel het OSS-land vervolgens pas in.

Waarom dit fout gaat: De grootboek-dropdowns zijn leeg als u nog niet heeft geïmporteerd vanuit Yuki. U slaat dan op zonder geselecteerde rekening, wat synchronisatiefouten veroorzaakt.

Juiste aanpak: Verbind uw API-sleutel, klik op Import Info, sla op, en configureer daarna pas de grootboekrekeningen.

Waarom dit fout gaat: Zonder expliciete koppelingen vallen facturen terug op de standaard belastingklasse, die mogelijk niet overeenkomt met de juiste Yuki BTW-code. Dit levert stilzwijgend onjuiste BTW-aangiftes op.

Juiste aanpak: Koppel elke belastingregel die u in Magento gebruikt aan de bijbehorende Yuki BTW-code, voordat u automatisering inschakelt.

Waarom dit fout gaat: Conceptfacturen worden niet gefinaliseerd in Yuki. Ze verschijnen niet in BTW-rapportages en vereisen handmatige verwerking.

Juiste aanpak: Gebruik definitief voor productie. Gebruik concept alleen tijdens de initiële testfase, wanneer u facturen in Yuki wilt controleren voordat ze worden vastgelegd.