1.Inleiding
Dit is de handleiding voor de koppeling tussen MollieShop en Jortt.
Omdat de omzet via de betaalinformatie direct in het boekhoudsysteem van de ondernemer komen bespaart deze tijd op de financiële administratie.
- Deze koppeling is een financiële koppeling. Het is geen logistieke koppeling. De koppeling is niet geschikt voor het bijwerken van klanten in Jortt, het printen van pakbonnen of het synchroniseren van producten/voorraad.
- Deze koppeling vervangt niet het werk van de boekhouder. Deze koppeling bespaart tijd omdat je niet meer hoeft over te tikken. De boekhouder is nog steeds nodig voor advies, kennis en controle.
Tip: Andere klanten met deze koppeling hebben veel gehad aan de tips in de FAQ voor MollieShop en in de FAQ voor Jortt.
Het installeren van de koppeling begint met het aanmelden voor een proefperiode, via onze koppelingen-pagina. Na aanmelding, ontvang je een e-mail met daarin een installatie-url en inloggegevens. Met deze installatie-url, start je de installatie van de koppeling.
De installatie is voltooid als beide bolletjes van de verbinding op groen staan, en de instellingen in tabblad Configuratie ingevuld en opgeslagen zijn.
Er is een proefperiode van 30 dagen.
Wil je nog een koppeling installeren, dan kan dat op dezelfde manier. Zorg er wel voor dat je uit het dashboard van koppeling bent uitgelogd, en start de nieuwe installatie bij voorkeur in een incognito browser.
Aan het einde van de proefperiode danwel abonnementsperiode, wordt de koppeling niet automatisch verlengd. Het aanbod voor een 1-jarig abonnement danwel verlenging ervan, ontvang je aan het einde van deze periode per e-mail. Je kunt de verlenging bevestigen door gebruik te maken van de betaallink in die mail.
Wil je tussentijds de koppeling beeindigen? Dat kan via het dashboard, tabblad Profiel>>Koppeling opzeggen.
2.Hoe de koppeling werkt
De koppeling haalt ieder uur de betalingen op uit MollieShop en zet deze klaar om doorgezet te worden naar Jortt.
Lees meer Hoe de koppeling werkt .... Lees minder Hoe de koppeling werkt ....
Aan het begin van de verwerking van een betaling wordt gecontroleerd of de betaling niet al eerder als factuur in Jortt is geplaatst.
Het doorzetten van een MollieShop betaling naar Jortt gebeurt in twee stappen:
- Er wordt gekeken of de klant al in Jortt aanwezig is. Zo nee dan wordt de klant aangemaakt. Matching gebeurt op emailadres.
- De Jortt factuur wordt aangemaakt en doorgezet.
Nadat de betaling is doorgestuurd en een succesmelding van Jortt is ontvangen wordt de betaling als afgehandeld aangemerkt. De MollieShop bestelling verschijnt bij tab Rapportage op het dashboard.
Geeft Jortt een foutmelding terug bij het verwerken van de betaling dan verschijnt de betaling bij tab Fouten op het dashboard. Via de gele knop Meer info is meer informatie over het probleem te vinden. Via de rode knop Meld probleem kan de betaling met alle noodzakelijke gegevens heel gemakkelijk bij ons aangemeld worden nadat je zelf het probleem hebt proberen op te lossen. Is het probleem opgelost dan kan in sommige situaties de betalingen opnieuw worden doorgezet met de blauwe Verwerk knop.
Gegevens
Informatie over de gegevens die doorgezet worden is te vinden in de sectie Day-to-day: Naar Jortt verderop in de handleiding.
3.Nodig: Mollie authenticatie
De authenticatie met Mollie verloopt via OAuth. Dat betekent dat je bij de configuratie van de koppeling inlogt op Mollie en de koppeling autorisatie geeft gegevens uit jullie account te lezen. Gebruik voor het inloggen het Mollie-account van de owner. Anders lukt het de koppeling niet om alle informatie uit Mollie op te halen.
4.Installatie
Controleer na de installatie, mbv deze FAQ, of de koppeling werkt.
Het installeren van de koppeling begint met het aanmelden voor een proefperiode, via onze koppelingen-pagina. Na aanmelding, ontvang je een e-mail met daarin een installatie-url en inloggegevens. Met deze installatie-url, start je de installatie van de koppeling.
Lees meer Installatie .... Lees minder Installatie ....
Authenticatie webwinkel
De authenticatie met de webwinkel loopt via OAuth. Zorg dat je bent uitgelogd bij je webwinkel voordat je de connectie legt. Je klikt nu op de rode Connect knop. Er verschijnt automatisch een inlogscherm voor de MollieShop webwinkel. Als je inlogt krijg je een scherm waarin gevraagd wordt of je de connectie toestaat. Als je dit bevestigt dan wordt de connectie gelegd.
Wil je op een later moment de connectie opnieuw wil leggen dan kan dat altijd door op de Connect knop te klikken.
Connectie Jortt
De authenticatie met Jortt loopt via OAuth. Zorg dat je bent uitgelogd bij Jortt voordat je de connectie start. Je klikt nu op de rode Connect knop. Er verschijnt automatisch een inlogscherm voor je Jortt account. Als je inlogt krijg je een scherm waarin gevraagd wordt of je de connectie toestaat. Als je dit bevestigt dan wordt de connectie met Jortt gelegd.
Wil je op een later moment de connectie opnieuw wil leggen dan kan dat door op de Connect knop te klikken.
Binnen een MollieShop account kunnen meerdere webwinkels aanwezig zijn. Je kunt hier instellen voor welke webwinkel je de koppeling wilt maken.
Status doorzetten
Je kunt aangeven bij welke statussen betalingen moeten worden doorgezet naar Jortt. Je kunt meerdere statussen aanvinken. De koppeling zal betalingen nooit dubbel doorzetten. De koppeling is daartegen beveiligd.
Aan een factuur kun je ene handelsnaam meegeven. Op basis van deze handelsnaam hangt Jortt het juiste sjabloon aan de factuur.
Bij het inrichten van de BTW tarieven en de grootboekrekeningen wordt een link gelegd tussen de BTW tarieven in de webwinkel en de BTW codes en omzetrekeningen in Jortt. Aanpassen kan altijd door op de blauwe 'Wijzigen' knop te klikken, en via de drop-down boxjes een keuze te maken. NB: in onderstaande afbeelding worden grootboeknummers getoond. Dit is enkel ter illustratie. Bij Jortt koppelingen toont hier een naam.
Standaard worden alle EU landen in de lijst getoond. Je hoeft alleen de landen te configureren waaraan je verkoopt, en -indien van toepassing- ICP en Internationaal.
De koppeling toont de standaard BTW tarieven voor Europa. Je kunt het BTW percentage waarmee je verkoopt - linker kolom - aanpassen. Bijvoorbeeld: Standaard staan verkopen naar Duitsland op 21%, maar verkoop jij in de webwinkel met 19% dan kun je dat in de linker kolom aanpassen. Intracommunautaire (ICP) en internationale leveringen
De optie Intracommunautaire prestaties / ICP is voor zakelijke leveringen binnen de EU. Deze verkopen brengen 0% BTW in rekening. Een BTW nummer van de kant is verplicht. De optie Internationaal gaat over leveringen buiten de EU. De koppeling verwacht voor deze verkopen 0% BTW, anders kunnen de verkopen niet doorgezet worden. Voor zowel ICP als internationale leveringen kunnen aparte BTW codes en grootboekrekeningen ingesteld worden.
Zijn de BTW instellingen gedaan en opgeslagen dan zul je altijd de ingestelde BTW tarieven zien. Wil je opnieuw beginnen dan kun je de grijze knop 'BTW instellingen verwijderen' gebruiken. Dan worden je huidige instellingen verwijderd en kun je opnieuw beginnen.
Je kunt hier een relatie leggen tussen de betaalmethoden in de webwinkel en een vaste debiteur uit je Jortt administratie. Betalingen met een betaalmethode uit de lijst worden dan altijd onder deze debiteur geboekt. Er worden in dat geval geen nieuwe debiteuren aangemaakt.
Let op: Het instellen van vaste debiteuren kan niet voor ICP betalingen. Bij een ICP betaling moet een geldig BTW nummer worden doorgezet. Daarom wordt er voor een ICP betaling altijd een debiteur aangemaakt in Jortt.
5.Day-to-day: Vanuit MollieShop
In deze sectie laten we zien hoe we de betalingen ophalen uit MollieShop.
Uitwerking veldniveau bestellingen op basis van betalingen
| Hieronder een uitwerking op veld-niveau bij het ophalen van betalingen. | |
| Naam veld | Waarden uit MollieShop bestelling |
| Bestel-identifier | [id] |
| Bestelnummer | [orderNumber] |
| Datum | [createdAt] |
| Besteldatum | [date_created] |
| Status bestelling | [status] |
| Betaalmethode | [paymentMethod] |
| Totaal BTW bestelling incl korting | [totalTaxAmount] |
| Besteltotaal incl BTW en korting | [totalPrice] | Besteltotaal excl BTW met korting | [totalPrice] - [totalTaxAmount] |
| Totaal BTW bestelling zonder korting | [totalTaxAmount] - [discountTaxAmount] |
| Besteltotaal incl BTW | [price][total] |
| Land levering | [shippingAddress][country] indien gevuld, anders [paymentAddress][country] |
| Aanduiding ICP | De koppeling bepaalt als volgt of het om een ICP bestelling gaat:
|
| Aanduiding Internationaal | De koppeling bepaalt als volgt of het om een internationale bestelling gaat:
|
| Voor het uitlezen van de bestelregels pakt de koppeling het veld [orderlines]. In MollieShop hebben bestelregels verschillende types. Deze worden aangeduid met het veld [type]. Voor de bestelregels gaat het om type article of type [custom]. | ||
| Naam veld | Waarden uit MollieShop bestelregel | |
| Aantal | [quantity] | |
| Omschrijving | [title], let op, MollieShop werkt met een raar streepje. Dit streepje wordt vervangen door een normaal streepje. | |
| BTW percentage | [taxPercentage], indien kleiner dan 1 dan wordt het BTW percentage met 100 vermenigvuldigd. Als het veld taxPercentage niet in de regel bestaat dan wordt het BTW percentage [totalTaxAmount] / ([totalPrice] - [totalTaxAmount]. Ook dit percentage wordt met 100 vermenigvuldigd. | |
| BTW bedrag in regel | [totalTaxAmount] | |
| Regelbedrag incl BTW | [totalPrice] | |
| Regelbedrag excl BTW | [totalPrice] - [totalTaxAmount] | |
| Eenheidsbedragen | De regelbedragen delen door het aantal | |
| BTW code en rekeningen Jortt | Deze worden bepaald aan de hand van de instellingen, het BTW percentage en het leveringsland. Hier wordt ook in meegenomen of het een ICP of internationale bestelling is. | |
| Naam veld | Waarden uit MollieShop klant |
| Klant |
Algemeen
|
| Het factuuradres staat in veld [paymentAddress] en het verzendadres in veld [shippingAddress]. De inhoud van deze velden is steeds gelijk, dus die beschrijven we niet apart. | |
| Adres |
Adres-velden
|
6.Day-to-day: Naar Jortt
De betalingen uit MollieShop worden in Jortt geĂŻmporteerd als facturen.
De Jortt factuur heeft twee soorten status-indicatoren.
- Betaalstatus: Dit loopt via het veld payment_method. Dit veld kan de waarden hebben already_paid (als de verkoop betaald is), pay_later (anders) of direct_debet. Je kunt dit aanvragen via webcare@webwinkelfacturen.nl ovv de licentiesleutel. Wij zullen dit dan aanpassen in jullie contract-instellingen. Je kunt altijd de status already_paid doorzetten of juist altijd de status pay_later. Het is zelfs mogelijk om voor Jortt plus gebruikers die een Mollie integratie hebben de betaalstatus op direct_debit te zetten.
- Verzendstatus: Dit loopt via het veld send_method. De default-waarde is self. De factuur wordt dan niet naar de klant verstuurd en krijgt status open. We kunnen de factuur ook als concept doorzetten. In dat geval voegen we een contractinstelling blocksend toe. Met die extra instelling wordt het veld send_method niet meegegeven in de Jortt factuur. Het is ook mogelijk om de waarde van send_method op email te zetten. De Jortt factuur zal dan altijd via de email naar de klant verstuurd worden.
1. Bij doorzetten individuele betalingen
Bij het doorzetten van klantinformatie wordt eerst gecontroleerd of de klant al eens eerder is doorgezet. Zo ja, dan wordt deze Jortt debiteur gebruikt als debiteur van de Jortt transactie. Is de klant nog niet bekend, dan wordt deze toegevoegd aan Jortt. Matching gebeurt op basis van e-mailadres.
Let op: De koppeling maakt alleen debiteuren aan. De koppeling wijzigt geen debiteuren.
2. Bij doorzetten dagfactuur
Voor het aanmaken van de Jortt factuur is een Jortt debiteur nodig. Neem contact op met webcare@webwinkelfacturen.nl om het emailadres van de factuur door te geven. Wij zorgen dan dat deze wordt ingesteld.
De koppeling maakt de factuur aan in Jortt. De factuur zal niet automatisch verstuurd worden vanuit Jortt. We kunnen dit aanpassen, zodat de factuur wel automatisch wordt verstuurd. Neem contact met ons op via webcare@webwinkelfacturen.nl als jullie hiervan gebruik willen maken.
Uitwerking veldniveau Jortt
| Naam | Voorbeeld | Opmerking |
| customer_id | f7fb9873-89gv-3vhd-7hg7-89f0e877c78k | Customer-id uit Jortt. |
| invoice_date | 2023-02-27 | besteldatum |
| net_amounts | 1 | |
| send_method | self (handmatig) | Kan op verzoek op email worden gezet of leeg worden gelaten. Als de sendmethod leeg is krijgt de factuur status concept in Jortt. |
| reference | 2020 | bestelnummer |
| payment_method | already_paid |
pay_later of already_paid, al naar gelang de betaalstatus in de webwinkel. Dit kan op verzoek op alwayspaid worden gezet of op de Mollie betaallink. |
| tradename_id | 5h064j87-2k56-7689-g9n7-8gh4skn90284 | Factuursjabloon |
| line_items | ||
| description | Premium Customerservice | Omschrijving |
| units | 1 | aantal |
| amount_per_unit | 89 | Eenheidsprijs |
| value | 89 | |
| currency | EUR | Valuta |
| vat | 0 | BTW |
| ledger_account_id | 9fd87hy0-8h5n-5g5v-3k72-0939h98k67k2 | Categorie - zoals ingesteld op het dashboard. |
| Naam | Voorbeeld | Opmerking |
| is_private | false | Standaard false, als customer_name ontbreekt dan true. |
| customer_name | [voornaam][achternaam] | Als [voornaam][achternaam] niet is meegegeven, dan wordt er NN ingevuld. |
| Straat | [adres] | |
| postcode | [zipcode] | |
| stad | [city] | |
| Landcode | [Isocountry] | |
| first_name | [voornaam] | |
| last_name | [achternaam] | |
| [telefoonnummer] | [telnr] | |
| [email] | ||
| Btwnummer | [btwnr] | Wordt meegegeven als het veldt niet leeg is. |
7.Support
Lees meer Support .... Lees minder Support ....
Uitleg tabs dashboard
Op het Dashboard >> Rapportage zie je welke betalingen uit je MollieShop webwinkel, per wanneer, zijn doorgezet naar Jortt.Wat als betalingen missen in Jortt
Als betalingen ontbreken in Jortt adviseren we je de volgende stappen te doorlopen:- Log in op het dashboard: https://uwkoppeling.webwinkelfacturen.nl. De gebruikersnaam en het wachtwoord staan in de registratie email.
- Ga naar tab Fouten en kijk of de betaling daar staat. Het kan zijn dat je de zoekperiode moet aanpassen als de
betaling van een eerdere maand is. Als je de betaling in dit overzicht vindt:
- Bekijk de foutcode en controleer of je die zelf op kunt lossen.
- Zo ja los het probleem op en klik op de blauwe knop Verwerk om de betaling opnieuw aan te bieden.
- Zo nee gebruik de rode knop Meld probleem om een ticket bij ons aan te maken.
- Let op bij meerdere fouten hoe je maar 1 of 2 keer een ticket aan te maken. Wij zien vanzelf de andere problemen.
- Ga naar tab Rapportage en kijk of de betaling daar staat. Zo ja dan staat daar vaak een identifier van Jortt bij (in het paarse deel van het overzicht) waarmee je de betaling kunt zoeken.
- Ga naar tab Open en kijk of de betaling daar staat.
- Mocht je er niet uitkomen, dan kun je altijd via de groene Vraag het ons knop een ticket bij ons aanmaken.