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.

URL van webshop⚓︎

Voer hier de url in die verwijst naar de api van uw webwinkel, standaard volgt de url dit formaat: https://hostname.tld/rest/default/V1/.

Autorisatie⚓︎

Autorisatie verloopt via ofwel een extra beheerderslogin of via een integration. Zie onderstaand kader hoe deze aan te maken.

Verbinden met webwinkel(s)⚓︎

Geef op met welke webwinkel u wilt verbinden.

Verbinding testen⚓︎

Gebruik deze knop om de verbinding te testen.

Aanmaken Magento API key

Aanmaken extra beheerder⚓︎

Maak een extra beheerder aan en geef deze onderstaande rechten:

  • Sales
    • Operations
      • Orders
        • Actions
          • View
          • Comment
      • Invoices
      • Credit memos
  • Catalog
    • Inventory
      • Products
      • Categories
  • Stores
    • Settings
      • All Stores
      • Configuration
        • Inventory Section
    • Attributes
      • Attribute Set

In het programma geeft u de gebruikersnaam en wachtwoord op van dit extra beheerdersaccount om verbinding te maken met de webshop.

Aanmaken integration⚓︎

Indien het niet mogelijk is om een extra beheerder aan te maken, maak dan een integration aan met bovenstaande rechten. Vul in het programma dan alle vier de tokens in om verbinding te kunnen maken met de webshop.

Waarschuwing

Indien u gebruik maakt van een integration kan deze als onveilig worden gemarkeerd door Magento. Aangeraden wordt dan ook om altijd een extra beheerder aan te maken.

Gegevens voor licentie⚓︎

​Verstrek de BaseUrl aan SnelKoppeling.eu zodat de licentie kan worden aangemaakt (standaard volgens dit formaat: https://hostname.tld/rest/default/V1/).

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 of tot aan het maximale aantal calls. Verlaag bij timeouts. Standaard 100.

Maximaal aantal calls per opdracht⚓︎

Het maximale aantal calls dat per opdracht mag worden gedaan. Standaard 10. Bij standaard instellingen worden er 100 × 10 = 1.000 items opgehaald. Verhoog deze waarde als dit niet toereikend is.

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.

Ordernummers van / tot en met⚓︎

Alleen deze ordernummerrange wordt opgehaald

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 met factuuradres in Nederland $.order.[?(@.billing_address.country_id =~ /nl/i)]
Orders niet met factuuradres niet in Nederland $.order.[?(@.billing_address.country_id =~ /^(?!nl)/i)]
Orders met via store met ID = 1 $.order.[?(@.store_id == 1)]

Nieuwe relaties⚓︎

Nieuwe of bestaande relatie

Relaties worden volgens onderstaand diagram opgezocht en eventueel aangemaakt

graph
1[SnelStart relatiecode = Magento 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 = Magento RelatieID] --> 7{Relatie gevonden?};
7 -->|Ja| 8(Gebruik bestaande relatie);
7 -->|Nee| 9[SnelStart postcode en email = Magento 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 Magento 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.

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 Magento 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⚓︎

SKU =⚓︎

SKU uit webwinkel wordt gekoppeld aan dit veld in SnelStart. Standaard wordt deze gekoppeld aan de artikelcode (fldArtikelcode) in SnelStart. SKU moet uniek zijn in SnelStart.

Attribuutset⚓︎

Artikelexport

Gebruik bij aanmaken van nieuwe artikelen dit attribuutset.

Prijzen inclusief btw in catalogus⚓︎

Prijzen synchroniseren / Artikelexport

Geef aan of de artikelen inclusief btw staan in de catalogus van Magento

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 / Artikelexport

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 Magento).

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.

2024-03-28