Ga naar inhoud

Instellingen⚓︎

Verkooporders en Voorraad

Instellingen openen van een bestaande koppeling?

Selecteer de koppeling uit de lijst en klik op achter Maak verbinding.

Verbinding⚓︎

Als dit de eerste webwinkel is die u toevoegt staan alle instellingen voor de verbinding vooringevuld.

Webshop-URL⚓︎

Voer hier de url in van uw webwinkel.

Admin API access token⚓︎

Vul hier de Admin API access token in. Zie onderstaand kader hoe deze aan te maken.

Verbinding testen⚓︎

Gebruik deze knop om de verbinding te testen.

Aanmaken Shopify API key

Login op de backoffice van uw Shopify webwinkel en klik op Apps. Klik vervolgens op Develop apps.

Klik op Create an app.

Geef de app een naam (App name), bijvoorbeeld: SnelKoppeling.eu Shopify SnelStart koppeling. Klik hierna op Create app.

Klik op Configuration en dan achter Admin API integration op Configure (of Edit).

Vink deze rechten aan:

Scope Rechten
Customers read_customers
write_customers
Draft orders read_draft_orders
write_draft_orders
Inventory write_inventory
read_inventory
Locations read_locations
Order editing write_order_edits
read_order_edits
Orders write_orders
read_orders
Product listings write_product_listings
read_product_listings
Products write_products
read_products

Webhook subscriptions: 20xx-xx (Latest)

Klik op Save

Ophalen orders / facturen⚓︎

Aantal items per call⚓︎

Haal dit aantal items per call op. Indien er meer items zijn wordt nog een call gedaan, net zo lang totdat alle items zijn opgehaald. Standaard (en maximaal) 250.

Startdatum⚓︎

Deze datum geeft aan vanaf wanneer de koppeling begint met werken. Ophalen van orders en betalingen kan niet voor deze datum liggen.

Laatste synchronisatiedatum orders/facturen⚓︎

Deze datum geeft aan wanneer voor het laatst orders zijn ingelezen. De koppeling houdt zelf deze datum bij tijdens het verwerken van orders. Wanneer er oudere orders verwerkt moeten worden kan deze datum verder in het verleden gezet worden.

Alleen orders met deze ...status ophalen⚓︎

De koppeling kan filteren op order-, betaal- en fulfillmentstatus.

Order-/factuurdatum is fulfillmentdatum⚓︎

Order-/factuurdatum is fulfillmentdatum

Wanneer deze optie is aangevinkt wordt de datum van fulfillment de orderdatum.

Orders zonder fulfillment verbergen⚓︎

Order-/factuurdatum is fulfillmentdatum

Wanneer deze optie is aangevinkt worden orders zonder fulfillment niet getoond.

SnelStart ordersjabloon⚓︎

Dit is het standaard sjabloon dat gebruikt wordt voor het aanmaken van orders in SnelStart. In de volgende stap  zijn filter in te stellen om zo het sjabloon dynamisch te bepalen, bijvoorbeeld op taal of soort klant. Deze functie is beschikbaar vanaf v23.11.22.

Orderstatus na import⚓︎

Orderstatus na import

Met deze optie kunt u de orderstatus in SnelStart direct meegeven. Standaard is dit een Order zonder afdruk. Wanneer u bijvoorbeeld voor pakbon kiest wordt de voorraad in SnelStart direct bijgewerkt.

Artikelomschrijving overnemen uit webshop⚓︎

Met deze optie wordt de omschrijving uit de webshop overgenomen in plaats van de artikelomschrijving zoals deze in SnelStart staat.

Prijzen overnemen uit SnelStart⚓︎

Prijsmaker

Met deze optie worden prijzen uitgenomen uit SnelStart. Hierbij wordt rekening gehouden met alle prijsafspraken. Wanneer deze optie aan staat worden artikelomschrijvingen ook altijd uit SnelStart opgenomen. Automatisch verwerken van betalingen is niet altijd meer mogelijk omdat er een verschil tussen webshop en SnelStart kan ontstaan.

Kostenplaats⚓︎

SnelStart inZicht

Met deze instelling kan aangegeven worden met welke kostenplaats orders opgeslagen moeten worden in SnelStart.

Recepten uitklappen⚓︎

Recepturen uitklappen

Recepturen kunnen tijdens het inlezen van orderregels automatisch worden uitgeklapt, gebruik daarvoor deze instelling.

Recepten uitklappen keuze⚓︎

Recepturen uitklappen

Tijdens het invoeren van een orderregel in SnelStart van een artikel waarbij invoegen recept op keuze tijdens ingave artikelcode verschijnt er in SnelStart een popup. In de koppeling zit deze functie niet maar kan met deze instelling wel de standaard actie worden ingesteld. Indien deze optie aanstaat worden artikelen die op keuze staan ook automatisch uitgeklapt tijdens het inlezen van een orderregel.

Automatisch importeren⚓︎

Vink deze optie aan om orders automatisch te importeren.

Sjablonen⚓︎

v23.11.22

Met behulp van JSONPath-expressies zijn verschillende sjablonen te koppelen aan webshoporders. Er kan op de meeste velden van een order gefilterd worden. Gebruik de testfunctie om een order op te halen. Klik op Toon order om de order in JSON-formaat te tonen. Meer informatie over JSONPath .

Enkele voorbeelden:

Voorwaarde JSONPath
Orders in het Nederlands $.order.[?(@.customer_locale =~ /nl/i)]
Orders niet in het Nederlands $.order.[?(@.customer_locale =~ /^(?!nl)/i)]
Orders met de tag B2B $.order.[?(@.tags =~ /(:?^|, )(B2B)(:?$|, )/i)] *
Orders in het Engels en met de tag B2B $.order.[?(@.tags =~ /(:?^|, )(B2B)(:?$|, )/i && @.customer_locale =~ /en/i)] *

* In Shopify kunnen meerdere tags gekoppeld worden. Bij meerdere tags worden deze samengevoegd in een kommagescheiden lijst. De reguliere expressie houdt hier rekening mee

Nieuwe relaties⚓︎

Nieuwe of bestaande relatie

Relaties worden volgens onderstaand diagram opgezocht en eventueel aangemaakt

graph
1[SnelStart relatiecode = Shopify RelatieID] --> 2{Relatie gevonden?};
2 -->|Ja| 3[Postcode + e-mail vergelijken] --> 5{Overeenkomst?};
5 -->|Ja| 6(Gebruik bestaande relatie);
5 -->|Nee| 4;

2 -->|Nee| 4[SnelStart creditcardnummer = Shopify RelatieID] --> 7{Relatie gevonden?};
7 -->|Ja| 8(Gebruik bestaande relatie);
7 -->|Nee| 9[SnelStart postcode en email = Shopify postcode en email] --> 10{Relatie gevonden?};

10 -->|Ja| 12(Gebruik bestaande relatie);
10 -->|Nee| 11(Relatie toevoegen);

Afwijkende afleveradressen niet opslaan op stamkaart⚓︎

Afleveradres alleen op order opslaan

Relatiecode webshop overnemen⚓︎

Gebruik ID uit Shopify als relatiecode anders worden nieuwe relaties aangemaakt volgens het hoogste nummer + 1. Bij conflicten wordt altijd hoogste + 1 gebruikt.

Adresregels samenvoegen met⚓︎

Deze tekst wordt tussen adresregels geplaatst.

Factuur mailen⚓︎

Zet het vinkje factuur emailen aan in SnelStart tijdens het aanmaken van nieuwe klanten.

Ubl sturen bij factuur per mail⚓︎

Zet het vinkje UBL bestand als bijlage aan in SnelStart tijdens het aanmaken van nieuwe klanten.

Standaard betalingstermijn⚓︎

Betalingstermijn voor nieuwe klanten.

Aanmanen⚓︎

Zet de optie aanmanen, bij nieuwe klanten, op Nee, Onderneming of Consument.

Vaste relatie⚓︎

Vaste relatie

Verkooporders worden aangemaakt op deze relatie. Dit kan invloed hebben op de btwberekening binnen SnelStart. Extra controles op bedragen worden niet meer uitgevoerd.

Oorspronkelijke relatie op orderregel zetten⚓︎

Vaste relatie

Bij gebruik van een vaste relatie kan de oorspronkelijke relatie op de eerste orderregel gezet worden.

Betaal- en verzendkosten⚓︎

Geef op welke artikelen gebruikt moeten worden voor de verzend- en betaalkosten. Eventueel kunt u hiervoor dezelfde artikelen gebruiken. Wel dient per btw-tarief een artikel aanwezig te zijn in de administratie. Tijdens het importeren van orders wordt de omschrijving aangepast in de verzend- en betaalwijze met de bijbehorende kosten.

Gebruik nettoprijzen bij kortingen⚓︎

Vink deze optie aan om geen kortingspercentages te gebruiken maar nettoprijzen. Daarnaast kan aangegeven worden om eventuele kortingen toe te voegen aan de artikelomschrijving op de orderregel. Tijdens importeren kan afgeweken worden van deze instelling.

Artikelomzetgroepen⚓︎

Artikelen die niet in SnelStart voorkomen kunnen automatisch worden aangemaakt. Geef aan welke artikelomzetgroep gebruik moet worden hiervoor. Wanneer nieuwe artikelen worden aangemaakt krijgt u de keuze om af te wijken van deze standaard groepen. Per btw-tarief dient een groep aanwezig te zijn.

Betalingen (algemeen)⚓︎

Betalingen kunnen automatisch verwerkt worden in de boekhouding. Betaalde facturen worden afgeboekt via tussenrekeningen. U kunt eventueel per betaalwijze een aparte tussenrekening instellen. De vuistregel is hierbij dat per geldstroom een tussenrekening moet zijn. iDEAL- en creditcardbetalingen worden direct door de betaalprovider uitbetaald terwijl PayPal door PayPal zelf wordt uitbetaald (op uw PayPal-rekening). U maakt dan twee tussenrekeningen aan.

Door gebruik van deze functie regelt de koppeling dat de facturen, zodra deze in SnelStart worden aangemaakt, als betaald gemarkeerd worden. Vervolgens is het tijdens het verwerken van de uitbetalingen door uw betaalprovider op uw bankrekening niet meer nodig om uit te zoeken waarop de betaling betrekking heeft.

Per (betaalde) factuur maakt de koppeling deze boeking:

Factuurnummer Omschrijving Grootboek Debet Credit
430087 WEBSHOP ORD26354 Tussenrekening Mollie 230,43 0,00
430087 WEBSHOP ORD26354 Dagboek debiteuren 0,00 230,43

De uitbetaling in uw bankdagboek verwerkt u als volgt:

Factuurnummer Omschrijving Grootboek Debet Credit
Uitbetaling Mollie Tussenrekening Mollie 0,00 229,86

De kostenfactuur van uw betaalprovider verwerkt u in het inkoopdagboek en kunt u daarna via een memoriaalboeking betalen via de tussenrekening:

Factuurnummer Omschrijving Grootboek Debet Credit
982363456 Factuur Mollie Tussenrekening Mollie 0,00 0,57
982363456 Factuur Mollie Dagboek crediteuren 0,57 0,00

Na verwerking van de kostenfactuur is het saldo van de tussenrekening weer € 0,00.

Automatisch afboeken betalingen⚓︎

Vink deze instelling aan om betaalde facturen standaard af te boeken. Per betaalwijze kan eventueel afgeweken worden van deze instelling.

Afboeken op order⚓︎

Verkooporders en Voorraad     Niet beschikbaar voor online administraties

Wanneer de administratie lokaal of op een eigen SQL-server staat kunnen betalingen direct aan orders gekoppeld worden. Vink daarvoor deze optie aan.

Laatste synchronisatiedatum betalingen⚓︎

De peildatum geeft aan wanneer voor het laatst betalingen zijn ingelezen. De koppeling houdt zelf deze peildatum bij tijdens het verwerken van betalingen. Wanneer er oudere betalingen verwerkt moeten worden kan deze peildatum verder in het verleden gezet worden.

Memoriaalrekening afboeken webshopbetalingen⚓︎

Boekingen worden gemaakt in deze memoriaalrekening. Maak een nieuw dagboek aan voor de verwerking van betalingen. Zie daarvoor: SnelStart Kennisplein: Een nieuw dagboek aanmaken . Gebruik voor het aanmaken van een memoriaaldagboek grootboekfunctie 7: Dagboek memoriaal.

Door een extra dagboek aan te maken lopen de automatische boekingen niet door de reguliere memoriaalboekingen.

Standaard tussenrekening⚓︎

Betaalwijzen die niet herkend worden, worden op deze tussenrekening geboekt. Maak hiervoor een extra grootboekrekening aan met functie 0: diversen of 110: tussenrekening betalingen. Zie daarvoor: SnelStart Kennisplein: Grootboekrekeningen 

Betalingsverschil maximaal⚓︎

Er kunnen kleine verschillen ontstaan tussen de bedragen in Shopify en SnelStart. De voornaamste reden hiervan de methodiek die achter de berekening van btw zit. Kleine verschillen kunnen direct afgeboekt worden, geef hier het maximale verschil in.

Grootboekrekening afrondingsverschillen⚓︎

Boekhouden Basis en Boekhouden Plus

Bij verschillen wordt deze grootboekrekening (met functie 0 diversen of 102 betalingskorting) gebruikt.

Grootboekrekening betalingsverschillen⚓︎

Bij verschillen wordt deze grootboekrekening (met functie 0 diversen of 102 betalingskorting) gebruikt.

Betalingen (per betaalprovider)⚓︎

Klik op Betaalwijzen ophalen om de betaalwijzen uit de webshop automatisch in te lezen, geef Ja op de vraag of filters uitgevoerd moeten worden (dat voorkomt dubbele regels).

In de kolom Omschrijving staat de omschrijving van de betaalwijze, deze wordt bijvoorbeeld op de verkooporder afgedrukt.

Instellingen worden via de ingestelde filters gekoppeld aan de betaalwijzen. De volgende jokertekens worden ondersteund in de filter: * en ?. Gebruik bijvoorbeeld Mollie* om alle Mollie-betalingen op dezelfde rekening af te boeken. Filters zijn hoofdletterongevoelig. Geavanceerde filters nodig? Begin dan met R: en gebruik reguliere expressies. Het gebruik van reguliere expressies valt buiten de scope van de documentatie.

Filters worden getoetst op volgorde van de ranking, van laag naar hoog.

In de kolom A wordt aangegeven of en hoe een betaalwijze verwerkt moet worden:

Niet afboeken
Afboeken volgens standaard instelling (vorige stap, Afboeken betalingen)
Afboeken op ingestelde tussenrekening

In de kolom M wordt aangegeven of niet-betaalde orders/facturen moeten worden gemarkeerd.

Artikelexport⚓︎

Prijzen updaten⚓︎

Prijzen synchroniseren

Gewijzigde prijzen bijwerken in webwinkel.

Extra artikelveld t.b.v. prijsupdates⚓︎

Prijzen synchroniseren

Uitsluitend artikelen waar dit extra veld is aangevinkt worden naar de webshop verzonden. Indien hier niets wordt ingevuld worden alle artikelen naar de webshop verzonden.

Extra artikelveld t.b.v. verkoopprijs⚓︎

Prijzen synchroniseren

Dit veld bepaalt de verkoopprijs die naar de webshop wordt verzonden. Dit kan het standaard verkoopprijs-veld zijn of een extra veld.

Extra artikelveld percentage opslag/korting⚓︎

Prijzen synchroniseren en korting/opslag

Geef een extra veld waarin opslag- of kortingspercentage staat voor prijzen die naar de webwinkel gaan. Beide velden kunnen gebruikt worden, wanneer beide gevuld zijn voor een bepaald artikel worden deze ook beide toegepast.

Extra artikelveld t.b.v. aanmaken artikelen⚓︎

Artikelexport

Uitsluitend artikelen waar dit veld is aangevinkt worden naar de webshop verzonden. Indien hier niet wordt ingevuld worden alle artikelen naar de webshop verzonden.

Standaard collectie⚓︎

Artikelexport

Artikelen worden aangemaakt in deze collecties. Per btwtarief moet er een collectie zijn aangemaakt (in Shopify).

Voorraad automatisch bijwerken⚓︎

Automatische voorraadsynchronisatie

Voorraad wordt alleen automatisch gesynchroniseerd als ook orders automatisch worden ingelezen. Gebruik in combinatie met orderstatus na import.

Extra artikelveld t.b.v. voorraadsynchronisatiefilter⚓︎

Uitsluitend de voorraad van artikelen waar dit veld is aangevinkt wordt naar de webshop verzonden. Indien hier niet wordt ingevuld wordt voorraad van alle artikelen naar de webshop verzonden.

Voorraadlocatie⚓︎

Voorraad van deze locatie wordt bijgewerkt

Laatste update voorraad⚓︎

Datum wanneer de voorraad voor het laatst is bijgewerkt, bij een volgende synchronisatie worden alleen mutaties sinds deze datum meegenomen.

2023-12-22