1.Inleiding
2.Hoe de koppeling werkt
3.Nodig: Silvasoft sleutel
Om de koppeling met je Silvasoft account te leggen dien je een API sleutel aan te maken. Een API sleutel is een geheime sleutel waarmee de koppeling geautoriseerd is om uit je Silvasoft account te lezen en bijv debiteuren en bestellingen toe te voegen aan je account. Eigenlijk is een API sleutel een speciaal wachtwoord voor de koppeling.
Silvasoft heeft een goede uitleg hoe je de API sleutel aanmaakt, inclusief de kosten die daarbij komen kijken. Deze vind je hier: https://www.silvasoft.nl/artikel/hoe-api-activeren-silvasoft-gebruiker/. Welk contract je nodig hebt is afhankelijk van het aantal bestellingen in je winkel / webwinkel. Je kunt met een laag contract beginnen en het bij problemen omhoog brengen. Verkopen die niet worden doorgezet vanwege de limieten komen in het dashboard van de koppeling te staan, in de foutenrij. Je kunt ze daarna gewoon doorzetten, dus je raakt niets kwijt mochten de API limieten te laag zijn.
4.Installatie
Connectie Silvasoft
Je legt de connectie met Silvasoft via de gebruikersnaam en API sleutel die je in de vorige stap bepaald hebt. Je klikt op de rode Connect knop naast Silvasoft. Je kunt de gebruikersnaam en de API sleutel nu invullen in het popup window.
5.Day-to-day: Vanuit Booq
6.Day-to-day: Naar Silvasoft
De uit worden in Silvasoft geimporteerd als facturen of bestellingen.
Deze gegevens worden doorgezet naar Silvasoft:
Bij het doorzetten van klantinformatie wordt eerst gecontroleerd of de klant al eens eerder is doorgezet. Zo ja, dan wordt deze Silvasoft debiteur gebruikt als debiteur van de Silvasoft transactie. Is de klant nog niet bekend, dan wordt deze toegevoegd aan Silvasoft. Matching gebeurt op basis van e-mailadres. Let op: De koppeling maakt alleen debiteuren aan. De koppeling wijzigt geen debiteuren.
Producten die nog niet in Silvasoft staan worden aan Silvsoft toegevoegd. Zij worden toegevoegd met een prijs excl BTW en het BTW percentage zoals in de bestelling staat aangegeven. Nieuwe producten worden in de categorie Webshop gezet in Silvasoft.
Let op: De producten worden alleen aangemaakt in Silvasoft. Producten in Silvasoft worden nooit gewijzigd.
De regels voor het matchen van producten tussen en Silvasoft kun je in deze FAQ nalezen.
| Naam | Voorbeeld | Opmerking |
| CustomerNumber | 4765 | Default debiteur id. |
| AddAsDraft | false | Dit kan niet aangepast worden |
| InvoiceReference | 3894029204 | |
| InvoiceDate | 09-03-2023 | |
| InvoiceNotes | ||
| Invoice_InvoiceLine | ||
| ProductNumber | 0293498320939 | SKU product, Verzendkosten, Betaalkosten, Korting of Toeslag. |
| Quantity | 1 | Aantal |
| TaxPc | 21 | BTW percentage |
| UnitPriceExclTax | 24.75 | Eenheidsprijs excl BTW |
| SubTotalInclTax | 29.95 | Regelprijs incl BTW |
| Description | Openhaard Bio-ethanol gel | Omschrijving |
| TaxCode | 21.0% - BTW hoog Nederland | BTW code |
| LedgerAccountNumber | 8159 | Omzetrekening |
| Invoice_Address | ||
| Address_Street | Stationstraat | straat |
| Address_City | Amsterdam | stad |
| Address_PostalCode | 1000AA | postcode |
| Address_Unit | 12 | huisnummer |
| Address_Type | InvoiceAddress | Kan als waarde InvoiceAddress of ShippingAddress hebben. |
| Naam | Voorbeeld | Opmerking |
| CustomerNumber | 4765 | Default debiteur id. |
| OrderReference | 3894029204 | bestelnummer, op verzoek factuurnummer. |
| OrderDate | 09-03-2023 | Besteldatum |
| OrderNotes | ||
| order_orderline | ||
| ProductNumber | 0293498320939 | SKU product, Verzendkosten, Betaalkosten, Korting of Toeslag. |
| Quantity | 1 | Aantal |
| TaxPc | 21 | BTW percentage |
| UnitPriceExclTax | 24.75 | Eenheidsprijs excl BTW |
| SubTotalInclTax | 29.95 | Regelprijs incl BTW |
| Description | Openhaard Bio-ethanol gel | Omschrijving |
| TaxCode | 21.0% - BTW hoog Nederland | BTW code |
| LedgerAccountNumber | 8159 | Omzetrekening |
| Invoice_Address | ||
| Address_Street | Stationstraat | straat |
| Address_City | Amsterdam | stad |
| Address_PostalCode | 1000AA | postcode |
| Address_Unit | 12 | huisnummer |
| Address_Type | InvoiceAddress | Kan als waarde InvoiceAddress of ShippingAddress hebben. |
| Naam | Voorbeeld | Opmerking |
| Artikel nummer | [articleNumber] | Als er een productId wordt meegegeven. Articlenumber -> productId |
| Categorie naam | [CategoryName] | |
| CategoryCreateIfMissing | true | |
| EAN | [eannumber] | |
| Nieuwe naam | [Name] | |
| Nieuwe verkoopprijs | [priceExcl] | |
| VoorraadUpdateMode | Absolute | |
| NieuweVoorraadAantal | [stock] | |
| NieuweBTWPercentage | [BTWpercentage] | |