FAK integratie
Integratie met FAK software
Met de FAK-koppeling kan Online Ambacht automatisch producten en omzetgegevens ophalen uit je FAK omgeving.
In dit artikel:
Koppeling instellen
Het instellen van de koppeling met FAK software is eenvoudig. Hiervoor moet eerst een aanvraag worden gedaan bij Online Ambacht.
Dit kan via:
- Chat
- Telefonisch
Na je aanvraag ontvang je van Online Ambacht:
- Een emailadres
- Een wachtwoord
Met deze gegevens maak je een gebruiker aan in het FAK dashboard.
- Ga naar admin.myfak.online en log in met het account waarmee je alle rechten hebt.
- Ga in de menubalk naar "Administratie" -> "Gebruikers"
- Klik op "Nieuw"
- Vul de volgende gegevens in (zie afbeelding voor voorbeeld):
A. Weergavenaam -> "OnlineAmbacht koppeling"
B. Voornaam -> "Online"
C. Achternaam -> "Ambacht"
D. E-mail -> [Het door Online Ambacht aangeleverde emailadres]
E. Wachtwoord -> [Het door Online Ambacht aangeleverde wachtwoord]
F. Rechten bij Backoffice -> 'Mederwerker'
G. Vink 'Productbeheer' en 'Rapportages' aan.
H. Rechten bij Terminal/Kassa -> 'Geen rechten'
- Druk op "Opslaan" links onderin
Synchronisatie frequentie
Online Ambacht synchroniseert automatisch gegevens uit FAK.
De frequentie is:
Producten synchronisatie
Elke 2 uur worden alle producten in de kassa gecontroleerd en bijgewerkt.
Omzet synchronisatie
De omzet per product wordt dagelijks bijgewerkt.
Werking koppeling
Online Ambacht koppelt met:
- Productgegevens (assortiment)
- Omzetgegevens
Hieronder wordt uitgelegd hoe deze koppeling werkt.
Koppeling assortiment
Online Ambacht gebruikt de aangemaakte gebruiker in FAK om in te loggen in jouw FAK omgeving.
De servers van Online Ambacht loggen in via het reguliere portal:
admin.myfak.online/login/login.php
Wanneer het inloggen succesvol is:
- worden de cookies opgeslagen
- wordt een productlijst gedownload
Afhankelijk van het type kassasysteem gebeurt dit via:
Bij FAK kassa's
admin.myfak.online/products/prijslijst.php
(let op: zonder warengroepen)
Bij niet FAK kassa's
admin.myfak.online/products/prijslijst.php?retail_scales=true&include_hidden=true
De servers van Online Ambacht downloaden hiermee een Excelbestand met:
- PLU
- Productnaam
- BTW
- Eenheid
- Prijs
- (bij niet-FAK kassa’s ook de warengroep)
Deze gegevens worden vervolgens vergeleken met alle producten in het Online Ambacht systeem.
Alle wijzigingen worden 1-op-1 overgenomen.
Online Ambacht gebruikt de aangemaakt gebruiker in FAK om in te loggen in jouw FAK omgeving. Hierbij maken de servers van OnlineAmbacht gebruik van het reguliere inlog portal op admin.myfak.online/login/login.php. Wanneer inlog succesvol is worden de cookies opgeslagen en worden afhankelijk van of je gebruikt maakt van FAK kassa's de volgende downloads gedaan.
Bij FAK kassa's -> admin.myfak.online/products/prijslijst.php (let op dit is zonder warengroepen)
Bij niet FAK kassa's -> admin.myfak.online/products/prijslijst.php?retail_scales=true&include_hidden=true
De online ambacht servers downloaden hiermee een excelsheet met daarop plu, naam, btw, eenheid en prijs. (en bij niet FAK kassa's ook de warengroep). Deze worden vergeleken met alle producten in het OnlineAmbacht systeem en de wijzigingen worden 1 op 1 overgenomen.
Koppeling omzet
Ook voor omzetgegevens gebruikt Online Ambacht de aangemaakte FAK gebruiker om in te loggen.
De login verloopt via:
admin.myfak.online/login/login.php
Na een succesvolle login worden de cookies opgeslagen en wordt de omzet opgehaald.
Online Ambacht haalt altijd de omzet van de huidige week op.
Aantal bonnen (Digi kassa's)
Voor Digi kassa's wordt de volgende pagina gebruikt:
admin.myfak.online/retail_reports/dashboard.php
Met onderstaande instellingen wordt het aantal bonnen opgehaald:
'settings' => [
'report' => [
'base_type' => 'receipt',
'report_type_product' => 'dashboard',
'from' => $startDateParsed,
'to' => $endDateParsed,
'affiliate' => $affiliateId, #winkel id
'multi' => [
'from' => [
$startDateParsed,
$startDateParsed,
$startDateParsed,
$startDateParsed,
$startDateParsed,
''
],
'to' => [
$endDateParsed,
$endDateParsed,
$endDateParsed,
$endDateParsed,
$endDateParsed,
''
],
],
'sales_rep' => -1,
'maingroup' => -1,
'type_filter' => -1,
'plufrom' => '',
'pluto' => '',
'includePackingSlip' => 'false',
],
'retail_reports' => [
'sort_sales_reps' => 'naam',
'direction_sales_reps' => 'ASC',
'sort_hour' => 'tijd',
'direction_hour' => 'ASC',
'sort_dag' => 'omzet',
'direction_dag' => 'ASC',
'sort_week' => 'tijd',
'direction_week' => 'ASC',
'sort_products' => 'omzet',
'direction_products' => 'DESC',
'sort_maingroup' => 'naam',
'direction_maingroup' => 'ASC',
],
]
Omzet per product (Digi kassa's)
Voor omzet per product wordt de volgende pagina gebruikt:
admin.myfak.online/retail_reports/receipt_lines/products.php
Met onderstaande instellingen worden de productgegevens uit de rapportagetabel gelezen:
'settings' => [
'report' => [
'base_type' => 'product',
'report_type_product' => 'receipt_lines/products',
'from' => $startDateParsed,
'to' => $endDateParsed,
'affiliate' => $affiliateId, #winkel Id
'multi' => [
'from' => [
$startDateParsed,
$startDateParsed,
$startDateParsed,
$startDateParsed,
$startDateParsed,
''
],
'to' => [
$endDateParsed,
$endDateParsed,
$endDateParsed,
$endDateParsed,
$endDateParsed,
''
],
],
'sales_rep' => -1,
'maingroup' => -1,
'type_filter' => -1,
'plufrom' => '',
'pluto' => '',
'includePackingSlip' => 'false',
],
'retail_reports' => [
'sort_sales_reps' => 'naam',
'direction_sales_reps' => 'ASC',
'sort_hour' => 'tijd',
'direction_hour' => 'ASC',
'sort_dag' => 'omzet',
'direction_dag' => 'ASC',
'sort_week' => 'tijd',
'direction_week' => 'ASC',
'sort_products' => 'omzet',
'direction_products' => 'DESC',
'sort_maingroup' => 'naam',
'direction_maingroup' => 'ASC',
],
]
Veelgestelde vragen
Worden wijzigingen in Online Ambacht ook teruggestuurd naar FAK?
Nee.
Online Ambacht kopieert 1-op-1 het artikelbestand uit FAK.
Dat betekent:
- Aanpassingen in Online Ambacht worden niet teruggeschreven naar FAK.
- Bij een synchronisatie worden wijzigingen in Online Ambacht overschreven door de gegevens uit FAK.
De bron van waarheid blijft altijd FAK.
Bijgewerkt op: 09/04/2026
Dankuwel!