1.Inleiding
2.Hoe de koppeling werkt
3.Nodig: SnelStart API sleutel
Om de koppeling met je Snelstart account te leggen dien je een speciale sleutel aan te maken. Deze sleutel is een geheime sleutel waarmee de koppeling geautoriseerd is om uit je Snelstart account te lezen en bijv debiteuren en verkoopboekingen toe te voegen aan je account. Eigenlijk is de sleutel een speciaal wachtwoord voor de koppeling.
De sleutel maak je aan afhankelijk van je Snelstart administratie. Zorg er dus voor dat je controleert dat je de sleutel aanmaakt voor de administratie waarbinnen je de omzet wilt boeken.
Om de sleutel voor Snelstart aan te maken log je in op de webversie van Snelstart, https://web.snelstart.nl. Je gaat naar het menu-item koppelingen en zoekt daar op Webwinkelfacturen. Er komen nu allerlei tegels tevoorschijn voor verschillende systemen. Je zoekt de tegel voor .
Klik nu op Genereer de sleutel. Kopieer deze sleutel en sla hem op. Je dient hem straks in te voeren tijdens de installatie van de koppeling.
4.Installatie
Connectie SnelStart
Je legt de connectie met Snelstart via de sleutel die je in de vorige stap bepaald hebt. Je klikt op de rode Connect knop naast SnelStart. Je kunt de sleutel nu invullen in het popup window.
5.Day-to-day: Vanuit Booq
6.Day-to-day: Naar Snelstart
De synchronisatie van gegevens tussen en SnelStart is als volgt.
De worden in SnelStart geimporteerd als bestellingen of financiele boekingen.
Standaard staat de koppeling ingericht op het aanmaken van financiele boekingen. Deze keuze is te wijzigen in de contractinstellingen in het dashboard, tabblad Configuratie of via email bij ons aan te vragen. Voor het doorzetten naar bestellingen is het pakket InBalans of InZicht nodig. Voor doorzetten naar financiele boekingen is naast deze pakketten ook InKaart geschikt.
Bij het doorzetten van klantinformatie wordt eerst gecontroleerd of de klant al eens eerder is doorgezet. Zo ja, dan wordt deze SnelStart debiteur gebruikt als debiteur van de SnelStart transactie. Is de klant nog niet bekend, dan wordt deze toegevoegd aan SnelStart. Matching gebeurt op basis van e-mailadres. Let op: De koppeling maakt alleen debiteuren aan. De koppeling wijzigt geen debiteuren.
Verzendadres Bij de optie SnelStart bestellingen geeft de koppeling een apart verzendadres mee aan de bestelling mits het verzendadres verschilt met het factuuradres.
Indien de worden doorgezet naar SnelStart bestellingen dan controleert de koppeling eerst of de producten uit de al in SnelStart bestaan. De koppeling voegt ontbrekende producten vervolgens toe aan het boekhoudsysteem. Bestaat een product al in SnelStart dan wordt het product niet nogmaals toegevoegd.
De regels voor het matchen van producten tussen en SnelStart kun je in deze FAQ nalezen.
De standaard instelling in SnelStart voor artikelnummers is lengte 10 en alleen cijfers. Dit dient opgehoogd te worden naar lengte 25 en cijfers en letters. De reden is dat in ieder geval de dummie-producten deze ruimte nodig hebben. Zie ook de FAQ.
Let op: De producten worden alleen aangemaakt in SnelStart. Producten in SnelStart worden nooit gewijzigd.
| Benodigd pakket: InKaart, InBalans of InZicht | ||
| Naam | Voorbeeld | Opmerking |
| Factuurdatum | [orderdate] | |
| Factuurnummer | [ordernumber] | |
| Betalingstermijn | 14 dagen | Dit kan niet aangepast worden. |
| Omschrijving | Bestelnummer / Factuurnummer / Betaalmethode indien aanwezig |
|
| Factuurbedrag | Het totaalbedrag van de incl BTW. | |
| Klant | ||
| Id | [debiteurID] | SnelStart debiteur-id. |
| uri | /relaties/[debiteurID] | |
| Boekingsregel | ||
| Omschrijving | [name] | |
| Grootboekrekening | Zoals ingesteld via tab Configuratie van het dashboard. | |
| Bedrag | Bedrag excl BTW. | |
| Kostenplaats | 1 default kostenplaats per koppeling. | |
| BTWregels | ||
| BTW bedrag | [price] | |
| BTWsoort |
|
|
| Benodigd pakket: InBalans of InZicht | ||
| Naam | Voorbeeld | Opmerking |
| relatie | ||
| id | 7382g324-8f90-76b8-h999-fv4sh870c87j | SnelStart debiteur-ID. |
| uri | /relaties/7382g324-8f90-76b8-h999-fv4sh870c87j | |
| procesStatus | Order | |
| datum | 2023-03-01 | |
| verkooporderBtwIngaveModel | Exclusief | Standaard Exclusief, kan aangepast worden naar inclusief. |
| omschrijving | 890492 / iDEAL | Bestelnummer / Factuurnummer / Betaalmethode indien aanwezig |
| betalingskenmerk | 890492 |
|
| memo | ||
| regels | ||
| artikel | ||
| id | 8d76f75n-9283-9291-93m2-fv5682e34akd | |
| uri | /artikelen/8d76f75n-9283-9291-93m2-fv5682e34akd | |
| omschrijving | Digital Xbox one - wit | |
| stuksprijs | 245.45 | Eenheidsprijs excl BTW, op aanvraag incl BTW - kortingen zijn in dit bedrag verwerkt. |
| aantal | 1 | |
| totaal | 245.45 | Totaal excl BTW, op aanvraag incl BTW - kortingen zijn in dit bedrag verwerkt |
| verkoopordersjabloon | ||
| id | 8fe5j5y8-h8a1-9084-760h-98k979h4ujk4 | |
| uri | /verkoopordersjablonen/8fe5j5y8-h8a1-9084-760h-98k979h4ujk4 | |
|
De SnelStart bestellingen hebben nooit negatieve eenheidsprijzen. Bij een negatieve eenheidsprijs wordt het aantal en het bedrag met (-1) vermenigvuldigd. |
||
| Naam | Voorbeeld | Opmerking |
| artikelcode | [articlekey] | |
| Omschrijving | [productName] | |
| ArtikelOmzetgroep |
|
|
| ModifiedOn | [date] | |
| isNonActief | false | |
| Naam | Voorbeeld | Opmerking |
| relatiesoort | Klant | |
| Naam | [name] | |
| Telefoon | [Telnr] | |
| Mobiel | [Mobile] | |
| [Email] | ||
| KvKnummer | [KvK] | |
| Iban | [Bankaccount_iban] | |
| VestigingsAdres |
|
|
| correspondentieAdres | Hetzelfde als VestigingsAdres. | |
| btwNummer | [Btwnr] | |