De koppeling
1. Informatie
Handleiding voor de resellers?
...
In deze handleiding beschrijven we de stappen om de Yokoy - Twinfield koppeling in te stellen, te activeren en te wijzigen. Het laatste hoofdstuk besteden we aan de tips & FAQ en tref je tevens de oplossing voor de meest voorkomende foutmeldingen aan.
Enkele voordelen van de koppeling:
Importeert volledig automatisch Yokoy transacties richting Twinfield;
Synchroniseert volledig automatisch leveranciers, tags en grootboekrekening van Twinfield richting Yokoy;
Mutaties worden dagelijks (in de nacht) geïmporteerd;
Ondersteuning in meerdere valuta en kan tevens ingericht worden op basis van de bedrijfsvaluta;
Deze koppeling is gecertificeerd door Twinfield, en te vinden in de Appstore - klik hier voor meer informatie!
YOKOY STAAT HIER NOG NIET BIJ! https://databrydge.nl/twinfield/ Aan BART / Mindmasters vragen dit aan te passen + in the appstore Twinfield is Yokoy ook nog niet zichtbaar.insight pagina waar de error messages zichtbaar zijn
Het Databrydge platform is online beschikbaar;
De volgende zaken zijn belangrijk om te weten, alvorens de koppeling ingesteld wordt:
Het ERP-systeem (Twinfield) is het basissysteem voor alle data. De koppeling van Databrydge volgt de logica van Yokoy om de data te synchroniseren tussen de verschillende software pakketten.
We zullen dit nader toelichting aan de hand van een voorbeeld: Het is in Yokoy niet mogelijk om een leveranciers aan te maken of een bankrekeningnummer te wijzigen. De koppeling zal daardoor dit soort informatie ook niet updaten in Twinfield.Op het moment dat er in Yokoy handmatig een instelling wijzigt en dit niet in het Databrydge platform aangepast wordt, dan zal de koppeling de aangepaste data weer terugzetten naar de informatie die in de koppeling beschikbaar is.
We zullen dit nader toelichting aan de hand van een voorbeeld: In de koppeling dient ingesteld te worden welke kostenplaats uit Twinfield gemapd wordt aan de cost object in Yokoy. In Yokoy kan handmatig de ERP-code van de cost object gewijzigd worden. Zodra de wijziging niet in het Databrydge platform wordt doorgevoerd, zal de koppeling de handmatige wijziging weer aanpassen naar de informatie die in de koppeling beschikbaar is.Het Databrydge platform is zo ingesteld dat op het moment dat er xxxxxx minuten geen actieve handelingen worden verricht. VRAGEN BARRA
De declaraties en inkoopfacturen die betaald zijn via een Yokoy Card, worden automatisch afgeletterd in Twinfield. → Aan Gerard vragen
De handleiding bestaat uit de volgende onderdelen:
2. Kosten
De kosten voor deze koppeling zijn opgebouwd uit
3. Aanmelden voor de koppeling
Om je aan te melden voor de koppeling gebruik je ons aanmeldformulier. Je kunt het formulier vinden via deze link:
Instellen van de koppeling
Info |
---|
Vóórdat u begint met het instellen van deze koppeling, is het belangrijk dat er aan de volgende voorwaarden wordt voldaan:
|
4. Instellingen Yokoy
Om ervoor te zorgen dat de koppeling de Yokoy transacties mag ophalen, dient er in Yokoy een aparte gebruiker aangemaakt te worden. Vervolgens dient dit account toegang te krijgen tot de Developer User rechten.
Note |
---|
LET OP: Aan het einde van deze stap hebben we een Developer User aangemaakt (die bestaat uit twee codes, de Client-ID en Client-Secret). Deze dienen goed bewaard te worden, zodat deze later ingegeven kunnen worden in het Databrydge platform. |
Aanmaken van de koppelings-user in Yokoy
Wij adviseren om een aparte user aan te maken in Yokoy waarmee de koppeling richting Databrydge gelegd wordt.
Note |
---|
LET OP: Indien de koppeling gelegd wordt met een gebruikersaccount van een medewerker en dit account wordt stopgezet in Yokoy (omdat de medewerker bijvoorbeeld uit dienst gaat), zal de koppeling ook stoppen met data uit te wisselen met het Databrydge platform. |
Open de betreffende omgeving in Yokoy en open in het menu het tabblad HR / User management / Klik op: + Add user (Rechts bovenin, donkerblauwe knop)
PRINTSCREEN TOEVOEGEN HR ADD USER (V4)
De volgende velden dienen ingevuld te worden, de overige velden mogen leeg blijven:
Company: Selecteer de administratie hoofdadministratie;
First Name: “Databrydge”
Last Name: “Connection”
Email: [uniek en het liefst een algemeen mailadres binnen de organisatie]
LET OP: Indien je in Yokoy ook gebruik maakt van een testomgeving (en daar ook een koppeling mee wilt leggen), dan is het verstandig om voor het testaccount een afgeleid emailadres te gebruiken, aangezien binnen het gehele Yokoy systeem, maar 1x hetzelfde mailadres gebruikt kan worden. Dit mailadres kan bijvoorbeeld uitbereid worden met +1 voor het @, bijvoorbeeld: emailadres support@databrydge.com zou dan worden support+1@databrydge.com. De activeringsmail komt gewoon aan op het originele mailadres support@databrydge.com, maar de gebruikersnaam is vervolgens support+1@databrydge.com. OPMERKING BART: wellicht generieke emailadres adviseren
Employee account (ERP): Vul hier een willekeurig getal of tekst in, het is niet toegestaan om dit veld leeg te laten.
Line manager: Selecteer een willekeurige line manager, het is niet toegestaan om dit veld leeg te laten.
My approval limit: Vul hier een extreem hoog bedrag in, zodat de koppeling de boeking doorzet, zoals bijvoorbeeld “99999999”
...
Klik op: Active and invite.
Het Databrydge account in Yokoy dient vervolgens toegang te krijgen tot de “Developer users” rechten in Yokoy:
Open in het menu het tabblad Admin / Tool Admin / Developer Users: Selecteer het Databrydge account dat zojuist aangemaakt is.
...
Klik op: Save.
Het Databrydge account in Yokoy dient ook toegang te krijgen tot verschillende onderdelen in het menu Admin om data van Twinfield aan te kunnen leveren in Yokoy:
Open in het menu het tabblad Admin / Finance/HR roles / Klik op: + Add new role
PRINTSCREEN TOEVOEGEN FINANCE HR ROLES → ADD NEW ROLE (V4)
Vul de volgende gegevens in:
Employee: Selecteer het Databrydge account dat zojuist aangemaakt is;
Roles: Vink de volgende rollen aan:
Human resources (HR), zodat de koppeling bevoegd is om gebruikers op te halen uit Yokoy;
Finance, zodat de koppeling bevoegd is om de financiële instellingen aan te passen in Yokoy;
Set up: Open het drop-down menu en vink de volgende gegevens aan:
Transaction settings, indien er gebruik gemaakt wordt van de Yokoy Pay module;
Category setup, indien er gebruik gemaakt wordt van de Yokoy Expense module;
Company cards, indien er gebruik gemaakt wordt van de Yokoy Pay module;
Cost object setup;
Integrations;
Company settings;
VAT / tax rate setup;
Suppliers, indien er gebruik gemaakt wordt van de Yokoy Invoice module;
Categories (Supplier invoices), indien er gebruik gemaakt wordt van de Yokoy Invoice module;
Invoice settings, indien er gebruik gemaakt wordt van de Yokoy Invoice module;
Note |
---|
Sommige gegevens hoeven enkel aangevinkt te worden, indien de betreffende module wordt gebruikt, anders mogen deze gegevens uitgevinkt blijven. |
PRINTSCREEN TOEVOEGEN FINANCE HR ROLES → SET UP (V4)
Klik op: Activate
De koppelings-user is nu volledige aanmaakt in Yokoy. Dit account kan nu geactiveerd worden.
Activeren van de koppelings-user in Yokoy
In de tussentijd is de activeringsmail voor het nieuwe account binnen gekomen op het ingevulde emailadres.
Open de mail en klik op: Activate account;
Doorloop de stappen in Yokoy om het account te activeren;
Zodra het account is geactiveerd, dienen de credentials gegenereerd te worden. Deze dienen tijdens het instellen van de koppeling op het platform van Databrydge ingevuld te worden.
Open in het menu het tabblad Admin / Developers
PRINTSCREEN TOEVOEGEN GENERATE CREDENTIALS V5
Rechts bovenin staat de Yokoy organization ID die dient straks beide ingevuld te worden bij het instellen van de koppeling.
Kopieer de Yokoy organization ID en sla deze ergens veilig op;
Klik vervolgens in hetzelfde scherm op: + Generate credentials
Klik op: Generate OAuth credentials en vervolgens op: Generate credentials;
PRINTSCREEN TOEVOEGEN GENERATE OAUTH CREDENTIALS V5
Vul de API Credentials name in: “Databrydge” en klik op: Next;
PRINTSCREEN TOEVOEGEN API CREDENTIALS NAME V5
Het volgende scherm toont de client ID en de client secret (samen vormen die de credentials van het account) en die dienen straks beide ingevuld te worden bij het instellen van de koppeling.
Kopieer de client ID en sla deze ergens veilig op;
Kopieer de client secret en sla deze ergens veilig op;
Note |
---|
LET OP: De Client ID en Client secret worden maar EENMALIG getoond. Sla deze goed op, voordat er verder gegaan wordt met de stappen in de handleiding. |
PRINTSCREEN TOEVOEGEN API CREDENTIALS GENERATED V5
Vink de checkbox aan bij “I’ve copied and saved this information somewhere safe” en klik op: Close
De koppelings-user is nu volledig geactiveerd in Yokoy.
Info |
---|
|
Info |
---|
|
Yokoy Invoice Export instellen
Yokoy wijzigt de status van de Yokoy Expenses en Yokoy Pay transacties automatisch naar “Exported”, wanneer de data is geëxporteerd richting het ERP systeem. Bij Yokoy Invoices werkt dat niet zo en daarvoor is het nodig de exportfaciliteit van Yokoy te activeren.
Info |
---|
Deze export instellingen hoeven enkel ingericht te worden, indien er gebruik gemaakt wordt van de Yokoy Invoice module. |
De Yokoy Invoice Export kan via de volgende stappen geactiveerd worden:
Open in het menu het tabblad Admin / Integrations / Tabblad: Invoice export / Start wizard
PRINTSCREEN TOEVOEGEN INTEGRATIONS INVOICE EXPORT - START WIZARD V5
Vul de volgende gegevens in:
Export name: “Databrydge”;
Choose document type: Open het drop-down menu en selecteer “All Suppliers Invoices”
PRINTSCREEN TOEVOEGEN INTEGRATIONS INVOICE EXPORT - START WIZARD 2 V5
Klik op: Next;
Vul de volgende gegevens in:
ERP: Open het drop-down menu en selecteer “Yokoy Standard Export (API)”
PRINTSCREEN TOEVOEGEN INTEGRATIONS INVOICE EXPORT - START WIZARD 3 V5
Klik op: Next;
Vul de volgende gegevens in:
Reporting Currency: Open het drop-down menu en selecteer de gewenste export valuta;
Original currency: Selecteer deze optie indien de invoices geëxporteerd dienen te worden in de bronvaluta van de factuur;
Convert to company currency: Selecteer deze optie indien de invoices geëxporteerd dienen te worden in de valuta die ingestelde is voor deze administratie.
Data: Vink alle gegevens aan
PRINTSCREEN TOEVOEGEN INTEGRATIONS INVOICE EXPORT - START WIZARD 4 V5
Klik op: Next;
In de volgende twee schermen wordt de volgende melding getoond: “Export setup: To enable SFTP connection, first finish configuring the facility”. Deze meldingen mogen voor waar aangenomen worden.
Klik 2x op: Next;
In het volgende scherm wordt de volgende melding getoond: “There is no applicable authentication for the selected system”. Deze melding mag voor waar aangenomen worden.
Klik op: Active;
Het volgende scherm toont de Yokoy Invoice export ID. Tijdens het instellen van de koppeling op het platform van Databrydge, dient het Yokoy Invoice export ID ingevuld worden.
Kopieer de Yokoy Invoice export ID en sla deze ergens veilig op;
PRINTSCREEN TOEVOEGEN INTEGRATIONS INVOICE EXPORT - START WIZARD 5 V5
Klik op: Active;
Info |
---|
Wanneer in een eerder stadium van de implementatie van Yokoy de Yokoy Invoice Export als in is geactiveerd, kan het ID-nummer teruggevonden worden via:
|
De koppelings-user is nu volledig geactiveerd in Yokoy inclusief de rechten tot het exporteren van Yokoy Invoices. Het is het beste om nu uit te loggen uit Yokoy als de koppelings-user voordat de vervolgstappen van de handleiding worden doorlopen.
Aanmaken van cost objects in Yokoy
De benodigde cost objects dienen aangemaakt te zijn in Yokoy. Voor het aanmaken van de cost objects in Yokoy, verwijzen we je graag door naar de website van Yokoy: https://yokoy.atlassian.net/wiki/spaces/Documentation/pages/300318837/Set+up+cost+objects
Aanmaken van expense categories in Yokoy
De benodigde expense categories dienen aangemaakt te zijn in Yokoy. Voor het aanmaken van de expense categories in Yokoy, verwijzen we je graag door naar de website van Yokoy: https://yokoy.atlassian.net/wiki/spaces/Documentation/pages/296485080/Expense+categories
Info |
---|
De expense categories dienen voor de koppeling enkel ingericht te worden, indien er gebruik gemaakt wordt van de Yokoy Expense module. |
Aanmaken van BTW-codes in Yokoy
De benodigde BTW-codes dienen aangemaakts te zijn in Yokoy. Voor het aanmaken van de BTW-codes in Yokoy, verwijzen we je graag door naar de website van Yokoy: https://yokoy.atlassian.net/wiki/spaces/Documentation/pages/289964033/Configure+tax+rates
Aanmaken van users in Yokoy
In de koppeling dienen de users uit Yokoy gekoppeld te worden aan de crediteuren uit Twinfield. De benodigde users dienen aangemaakt te zijn in Yokoy. Voor het aanmaken van de users in Yokoy, verwijzen we je graag door naar de website van Yokoy: https://yokoy.atlassian.net/wiki/spaces/Documentation/pages/1008074779/User+management
Info |
---|
De users dienen voor de koppeling enkel ingericht te worden, indien er gebruik gemaakt wordt van de Yokoy Expense module. |
Automatische synchronisatie naar Yokoy
De volgende data kan automatisch gesynchroniseerd worden van Twinfield richting Yokoy, zodra dit aangegeven wordt in de koppeling. Deze hoeven niet eerst aangemaakt te worden in Yokoy.
Tags: In de koppeling kan worden ingesteld dat de projecten in Twinfield gesynchroniseerd dienen te worden als tags richting Yokoy.
Info |
---|
De tags dienen voor de koppeling enkel ingericht te worden, indien er binnen Yokoy ook gebruik gemaakt gaat worden van tags. De optie “Enable Tags” dient voor de koppeling wel geactiveerd te zijn binnen Yokoy, voordat de data doorgezet kan worden. Voor meer informatie over het aanzetten van de tags in Yokoy, verwijzen we je graag door naar de website van Yokoy: https://yokoy.atlassian.net/wiki/spaces/Documentation/pages/296484964/Tags |
Invoice categories: In de koppeling kan worden ingesteld welke grootboekrekeningen uit Twinfield (1. Balansrekeningen, 2. Winst- en verliesrekeningen of 3. Beide, zowel Balansrekeningen als Winst- en verliesrekeningen) gesynchroniseerd dienen te worden als invoice categories richting Yokoy. Deze hoeven niet eerst aangemaakt te worden in Yokoy.
Info |
---|
De invoice categories dienen voor de koppeling enkel ingericht te worden, indien er gebruik gemaakt wordt van de Yokoy Invoice module. |
Suppliers: In de koppeling kan worden ingesteld dat de crediteuren in Twinfield gesynchroniseerd dienen te worden als suppliers richting Yokoy.
Info |
---|
De suppliers dienen voor de koppeling enkel ingericht te worden, indien er gebruik gemaakt wordt van de Yokoy Invoice module. |
Hiermee zijn de instellingen in Yokoy klaar. Vervolgens dienen er ook een aantal instellingen in Twinfield verricht te worden.
5. Instellingen in Twinfield
Voor de instellingen in Twinfield is een basiskennis van Twinfield en/of boekhouden gewenst. We gaan er ook van uit dat de basisinrichting, zoals bijvoorbeeld het rekeningschema, in Twinfield gereed.
Aanmaken van de koppelings-user in Twinfield
Wij adviseren om een aparte user aan te maken in Twinfield waarmee de koppeling richting Databrydge gelegd wordt.
Note |
---|
LET OP: Indien de koppeling gelegd wordt met een gebruikersaccount van een medewerker en dit account wordt stopgezet in Twinfield (omdat de medewerker bijvoorbeeld uit dienst gaat), zal de koppeling ook stoppen met data uit te wisselen met het Databrydge platform. |
Voor het aanmaken van de een gebruiker in Twinfield, verwijzen we je graag door naar de website van Twinfield: Beheer gebruikers - Een nieuwe gebruiker aanmaken
Note |
---|
LET OP: Het is aan te raden om een account aan te maken met minimaal Level 2 (of een afgeleide van level 2 / of een level met meer rechten). Dit in verband met de rechten en rollen voor o.a. het beheren van de administratie in Twinfield, zoals bijvoorbeeld het aanmaken van projecten en valuta koersen. |
Aanmaken van grootboekrekening(en) in Twinfield
De volgende Grootboekrekeningen dienen aangemaakt te worden in Twinfield:
Een Winst- en verliesrekening voor de fooien en restbedragen. Wij adviseren deze de volgende naam te geven: “Yokoy Expense - Tips and remaining amounts”
Info |
---|
Deze grootboekrekening hoeft enkel ingericht te worden, indien er gebruik gemaakt wordt van de Yokoy Expense Module. |
Een Balansrekening voor de Yokoy Pay transacties. Wij adviseren deze de volgende naam te geven: “Yokoy Card Transactions”;
Info |
---|
Deze grootboekrekening hoeft enkel ingericht te worden, indien er gebruik gemaakt wordt van de Yokoy Pay Module. |
Een Winst- en verliesrekening voor de afrondingsverschillen. Wij adviseren deze de volgende naam te geven: “Yokoy Invoice - Rounding difference”
Info |
---|
Deze grootboekrekening hoeft enkel ingericht te worden, indien er gebruik gemaakt wordt van de Yokoy Invoice Module. |
Voor het aanmaken van de Grootboekrekeningen in Twinfield, verwijzen we je graag door naar de website van Twinfield: Grootboek - Grootboekrekening toevoegen of wijzigen
Aanmaken van dagboek(en) in Twinfield
De volgende Dagboeken dienen aangemaakt te worden in Twinfield:
Inkoopdagboek: “Yokoy Expense”
Info |
---|
Dit dagboek hoeft enkel ingericht te worden, indien er gebruik gemaakt wordt van de Yokoy Expense Module. |
Memoriaal dagboek: “Yokoy Card Transactions”
Info |
---|
Dit dagboek hoeft enkel ingericht te worden, indien er gebruik gemaakt wordt van de Yokoy Pay Module. |
Inkoopdagboek: “Yokoy Invoices” → Indien er gebruik gemaakt wordt van de Yokoy Invoice Module;
Info |
---|
Dit dagboek hoeft enkel ingericht te worden, indien er gebruik gemaakt wordt van de Yokoy Invoice Module. |
Voor het aanmaken van de dagboeken in Twinfield, verwijzen we je graag door naar de website van Twinfield: Dagboeken - Instellen dagboeken
Aanmaken van kostenplaatsen in Twinfield
De benodigde kostenplaatsen dienen aangemaakt te worden in Twinfield. Voor het aanmaken van de Kostenplaatsen in Twinfield, verwijzen we je graag door naar de website van Twinfield: Dimensies - Kostenplaats aanmaken
Aanmaken van crediteuren in Twinfield
De medewerkers dienen aangemaakt te worden als crediteuren in Twinfield. Voor het aanmaken van de crediteuren in Twinfield, verwijzen we je graag door naar de website van Twinfield: Crediteuren en debiteuren - Crediteuren aanmaken
Info |
---|
Het aanmaken van de medewerkers als crediteuren hoeft enkel ingericht te worden, indien er gebruik gemaakt wordt van de Yokoy Expense Module. |
Aanmaken van vreemde valuta in Twinfield
In Yokoy bestaan er twee manier om data te exporteren in combinatie met valuta’s
Het exporteren van de bedragen in de bedrijfsvaluta;
Het exporteren van de bedragen in de bronvaluta (hiermee bedoelen we de valuta die op de bon of de factuur staat vermeld).
De instellingen in Twinfield met betrekking tot de vreemde valuta is ook afhankelijk van deze opties.
Indien gekozen wordt voor het exporteren van de bedragen in de bedrijfsvaluta, hoeft er in Twinfield niets extra ingesteld te worden;
Indien gekozen wordt voor het exporteren van de bedragen in de bronvaluta, dienen de benodigde vreemde valuta’s ook aanwezig te zijn in Twinfield.
Voor het aanmaken van de crediteuren in Twinfield, verwijzen we je graag door naar de website van Twinfield: Vreemde valuta
Hiermee zijn de instellingen in Twinfield compleet en kan de koppeling op het Databrydge platform ingesteld worden.
6. Instellingen in Databrydge
De meeste instellingen in het Databrydge platform kunnen op een later moment nog worden gewijzigd. Echter het veranderen van de organisatie, de software pakketten en de authenticatie van de software pakketten / credentials, is helaas niet mogelijk. Indien die toch gewijzigd dienen te worden, dient de huidige koppeling stopgezet te worden en dient er een volledig nieuwe koppeling ingericht worden.
Inloggen op het platform
Ga naar de website: https://app.databrydge.com/sign-in
Log in met het emailadres en wachtwoord (de activatielink is per mail toegestuurd)
De startpagina van het Databrydge platform wordt getoond:
...
Instellen van de organisatie en de software pakketten
Klik op: ONBOARDING
Het volgende scherm wordt geopend:
...
Vul de volgende gegevens in:
Connection name: Vul de naam van de koppeling in: [Administratienaam] - Yokoy - Twinfield - [Test / Prod];
Synchronisation start date: Vul de datum in vanaf welke boekdatum de koppeling de data van Yokoy naar Twinfield dient over te zetten. [JJJJ-MM-DD]
Note |
---|
LET OP: Dat de juiste datum ingevuld wordt. Aanpassingen achteraf zijn enkel mogelijk in de backend door een developer. De kosten die hiervoor in rekening gebracht worden bedraagt € 75,- excl. BTW. |
Reseller: Selecteer de naam van de betreffende Reseller (de organisatie die de koppeling instelt);
Organisation: Selecteer de naam van de betreffende eindklant;
Package to connect: Selecteer eerst Yokoy en vervolgens Twinfield,
Klik op: NEXT
Authenticatie van Yokoy
De koppeling van Databrydge dient toegang te krijgen tot Yokoy, middels het instellen van de credentials.
Het volgende scherm wordt geopend:
PRINTSCREEN YOKOY TWINFIELD (V3)
Klik op: Yokoy / Credential
Selecteer bij Credential: Create new credential;
Selecteer bij Credential type “Yokoy”
Info |
---|
Indien er een tweede koppeling ingesteld wordt voor dezelfde Yokoy omgeving, is het niet nodig om de credential opnieuw aan te maken. Dan kan er bij stap 1 gekozen worden voor die betreffende credentail i.p.v. te kiezen voor “Create new credential”. |
Het scherm wordt vervolgens uitgebreid naar:
PRINTSCREEN YOKOY CREDENTIALS (V3)
Vul de volgende gegevens in:
Name: Vul de naam van de credential in: [Administratienaam] - Yokoy - [Test / Prod];
Client Id: Vul hier de Yokoy Cliënt Id in (welke is gegenereerd in Stap: Aanmaken koppelings user in Yokoy van deze handleiding);
Client Secret: Vul hier de Yokoy Cliënt Secret in (welke is gegenereerd in Stap: Aanmaken koppelings user in Yokoy van deze handleiding);
Yokoy organization Id: Vul hier de Yokoy organization Id in;
Environment: Selecteer “Production” indien de koppeling ingesteld wordt met de productie omgeving in Yokoy en selecteer “Test” indien de koppeling ingesteld wordt voor de test omgeving in Yokoy.
De verbinden met Yokoy is compleet ingesteld.
Authenticatie van Twinfield
De koppeling van Databrydge dient toegang te krijgen tot Twinfield, middels het instellen van de credentials.
Klik op: Twinfield / Credential
Selecteer bij Credential: Create new credential;
Selecteer bij Credential type “Oauth 2”
Info |
---|
Indien er een tweede koppeling ingesteld wordt voor dezelfde Twinfield omgeving, is het niet nodig om de credential opnieuw aan te maken. Dan kan er bij stap 1 gekozen worden voor die betreffende credentail i.p.v. te kiezen voor “Create new credential”. |
Het scherm wordt vervolgens uitgebreid naar:
PRINTSCREEN TWINFIELD CREDENTIALS V3
Name: Vul de naam van de credential in: [Administratienaam] - Twinfield - [Test / Prod];
Klik op: CONNECT
Het inlogscherm van Twinfield wordt getoond:
...
Log in met de inloggegevens van Twinfield.
Het volgende scherm wordt geopend:
...
In dit scherm wordt de toestemming van Twinfield voor de koppeling geregeld.
Zorg dat de vinkjes zijn aan staan bij de volgende onderwerpen:
Users
Organization profile
Organization User
Office access
Remember My Decision
Klik op “Yes, ALLOW” om de instellingen op te slaan.
Info |
---|
Indien er meerdere keren met hetzelfde Twinfield account een koppeling gelegd dient te worden, zal dit enkel de eerste keer gevraagd worden. |
De internetbrowser zal nu een nieuw tabblad openen met het volgende scherm:
...
Dit scherm mag gesloten worden.
Ga nu (terug) naar het tabblad met de koppeling. Daar staat nu vermeld dat de koppeling met Twinfield CONNECTED is (hiervoor stond hier CONNECT).
PRINTSCREEN TEST YOKOY-TWINFIELD CONNECTION → CONNECTED NOG MAKEN
De verbinden met Twinfield is gelegd.
Klik op NEXT
De koppeling gaat nu de beschikbare administraties ophalen uit Twinfield.
...
Selecteer de betreffende Twinfield administratie
Klik op NEXT
Ophalen van alle data
De koppeling gaat nu de beschikbare data ophalen uit Yokoy en Twinfield.
Info |
---|
LET OP: het duurt nu ongeveer 80 seconden voordat de koppeling verder ingesteld kan worden. |
Basisinstellingen in de koppeling
De gegevens die in het volgende scherm ingesteld worden, bepalen het gedrag van de koppeling. Indien hier wijzigingen in aan worden gebracht, zal de koppeling dit gedrag toepassen op de nieuw aangeleverde data. Dit betekend dat data die al compleet geëxporteerd zijn richting Twinfield, niet wordt gewijzigd.
Info |
---|
Wanneer de gehele koppeling is ingesteld en je wilt een wijziging doorvoeren in de basis instellingen van de koppeling. Dan hoeven alle vorige stappen in het Databrydge platform niet opnieuw doorlopen te worden. Zodra in het vervolg geklikt wordt op de knop “Change”, dan opent hetzelfde scherm dat nu ingesteld dient te worden. |
Zodra de koppeling klaar is met het ophalen van alle data uit Yokoy en Twinfield, wordt het volgende scherm geopend:
PRINTSCREEN TOEVOEGEN BASISINSTELLINGEN KOPPELING LEEG DATA SCHERM → NOG MAKEN
Vul de volgende gegevens in indien alle Yokoy modules gebruikt worden:
Twinfield Office code: Selecteer de betreffende Twinfield administratie;
Onboarding.settings.periodCalculationMode:
Yokoy Legal Entity: Selecteer de betreffende Yokoy administratie;
Purchase journal for expenses: Selecteer het betreffende Twinfield dagboek waar de Yokoy Expenses naar toe dienen te worden geëxporteerd (welke is gegenereerd in Stap: Aanmaken van dagboek(en) in Twinfield van deze handleiding);
Default cost center for expenses: Selecteer de Twinfield kostenplaats die standaard meegeven dient te worden aan een Yokoy Expense, indien er geen cost object is ingegeven in Yokoy;
Default general ledger account for expense remaining amount: Selecteer de Twinfield grootboekrekening die gebruikt dient te worden voor de fooien en restbedragen (welke is gegenereerd in Stap: Aanmaken van grootboekrekening(en) in Twinfield van deze handleiding);
Answer Barra 20-11-2024: The databrydge settings field 'Default general ledger account for expense remaining amount' is used for the rounding difference remaing amounts as the connection needs to perform many calculations. Those calculations can result in couple of cents defferent between the line amounts (summation of the line amonts) and the total line amount. The difference we put it in that general ledger account.
ASKED GERARD 20-11-2024 for way of working with the additional charges in Yokoy, I thought it went to this GLAccount.General journal for transactions: Selecteer het betreffende Twinfield dagboek waar de Yokoy Pay transacties naar toe dienen te worden geëxporteerd (welke is gegenereerd in Stap: Aanmaken van dagboek(en) in Twinfield van deze handleiding);
Default general ledger account for transactions: Selecteer de Twinfield grootboekrekening die gebruikt dient te worden voor de Yokoy Pay transacties (welke is gegenereerd in Stap: Aanmaken van grootboekrekening(en) in Twinfield van deze handleiding);
Yokoy user for triggering financial expense export: Selecteer de naam van de Yokoy users die vermeldt wordt in Yokoy als zijnde de persoon die de export heeft uitgevoerd. Ons advies is om de Databrydge Connection user te selecteren;
Yokoy company currency: Selecteer de standaard valuta van de administratie;
Currency synchronization mode: Selecteer de betreffende valuta synchronisatie van de transacties richting Twinfield. Hierin zijn de volgende opties beschikbaar:
Use_original_currency → Met deze optie zal de koppeling de data exporteren naar Twinfield in de valuta waarmee de Yokoy Expenses, Yokoy Pay transacties en de Yokoy invoices zijn aangemaakt in Yokoy;
Use_company_currency → Met deze optie zal de koppeling de data exporteren naar Twinfield in de standaard valuta van de administratie (die ingesteld is bij punt 10);
Rouding difference general ledger account: Selecteer de Twinfield grootboekrekening die gebruikt dient te worden voor de afrondingsverschillen van Yokoy Invoices (welke is gegenereerd in Stap: Aanmaken van grootboekrekening(en) in Twinfield van deze handleiding);
Yokoy dimension id for projects: Vul hier de Yokoy ID in, welke gekoppeld is aan de Tag dimensie “Projecten” (welke is terug te vinden via: Admin / Company / Enable tags / Selecteer de juiste tag / Rechts onderin staat “ID”);
Yokoy dimension code for projects: Vul hier de Yokoy Code (ERP) in, welke gekoppeld is aan de Tag dimensie “Projecten” (welke is terug te vinden via: Admin / Company / Enable tags / Selecteer de juiste tag / Rechts bovenin staat “Code (ERP)”);
Project synchronization mode: Selecteer de betreffende projectsynchronisatie richting Yokoy. Hierin zijn de volgende opties beschikbaar:
Update_tags_with_mapped_projects → Met deze optie zal de koppeling de tags enkel update in Yokoy, wanneer deze ingesteld zijn in de koppeling;
Send_projects_as_tags_to_yokoy → Met deze optie zal de koppeling alle projecten in Twinfield synchroniseren als tags richting Yokoy;
Supplier synchronization mode: Selecteer de betreffende leverancierssynchronisatie richting Yokoy. Hierin zijn de volgende opties beschikbaar:
Send_creditors_as_suppliers_to_yokoy → Met deze optie zal de koppeling alle crediteuren in Twinfield synchroniseren als supplier richting Yokoy;
Disable_suppliers_synchronization→ Met deze optie zal de koppeling de crediteuren in Twinfield niet synchroniseren als supplier richting Yokoy;
General ledger account types for invoice category synchronization: Selecteer de betreffende optie voor het synchroniseren van de grootboekrekeningen van Twinfield als invoice categories richting Yokoy. Hierin zijn de volgende opties beschikbaar:
BAS → Met deze optie zal de koppeling alle balansgrootboekrekening in Twinfield synchroniseren als invoice categories richting Yokoy;
PNL→ Met deze optie zal de koppeling alle winst- en verliesgrootboekrekening in Twinfield synchroniseren als invoice categories richting Yokoy;
Beide: Het is mogelijk om zowel BAS als PNL te selecteren. Daarmee worden zowel de balansgrootboekrekeningen als de winst- en verliesgrootboekrekeningen in Twinfield gesynchroniseerd als invoice categories richting Yokoy;
Purchase journal for invoices: Selecteer het betreffende Twinfield dagboek waar de Yokoy Invoices naar toe dienen te worden geëxporteerd (welke is gegenereerd in Stap: Aanmaken van dagboek(en) in Twinfield van deze handleiding);
Yokoy invoice export facility: Om facturen te kunnen exporteren, is de Yokoy Invoice exporteerfunctie geactiveerd. Het Yokoy Invoice Export ID (welke is gegenereerd in Stap: Yokoy Invoice Export instellen van deze handleiding) dient hier ingevuld te worden;
Info |
---|
Indien er gebruik gemaakt wordt van de Yokoy Expense Module, dienen de volgende gegevens ingevuld te worden: 1, 2, 3, 4, 5, 6, 9, 10, 11 |
Info |
---|
Indien er gebruik gemaakt wordt van de Yokoy Pay Module, dienen de volgende gegevens ingevuld te worden: 1, 3, 7, 8, 9, 10, 11 |
Info |
---|
Indien er gebruik gemaakt wordt van de Yokoy Invoice Module, dienen de volgende gegevens ingevuld te worden: 1, 3, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19 |
Mapping van de data in koppeling
Voor de volgende onderdelen kan de data vanuit Yokoy gemapt worden aan de data uit Twinfield in het Databrydge platform:
Cost centers
Expense categories
Tags
Tax rates
Users
De instellingen voor de mapping, staan onder de basisinstellingen en zijn beschikbaar in hetzelfde scherm:
PRINTSCREEN TOEVOEGEN BASISINSTELLINGEN KOPPELING LEEG MAPPING SCHERM V5 → NOG MAKEN
Info |
---|
Indien er gebruik gemaakt wordt van de Yokoy Expense Module, dienen de volgende onderdelen gemapt te worden: 1 (indien van toepassing), 2, 3 (indien van toepassing), 4, 5. |
Info |
---|
Indien er gebruik gemaakt wordt van de Yokoy Pay Module, dienen de volgende onderdelen gemapt te worden: VRAGEN BARRA |
Info |
---|
Indien er gebruik gemaakt wordt van de Yokoy Invoices Module, dienen de volgende onderdelen gemapt te worden: 1 (indien van toepassing), 3 (indien van toepassing), 4. |
De printscreens in dit gedeelte van de handleiding zijn gemaakt van Cost Center mapping, maar de inrichting voor alle onderdelen werkt op dezelfde manier.
Klik op ADD ROW
PRINTSCREEN TOEVOEGEN MAPPING ADD ROW V5
Selecteer in het eerste veld de gewenste data uit Yokoy;
Selecteer in het veld daarachter de gewenste data uit Twinfield;
Indien een mappingsregel niet meer nodig is, klik op DELETE ROW
Note |
---|
LET OP: Map alle benodigde data in de koppeling om foutmeldingen te voorkomen. |
Zodra alle mapping compleet is:
Kik op:
FINISH: indien de koppeling wenst op te slaan - de eerste synchronisatie zal dan de volgende ochtend plaats vinden!
FINISH AND ACTIVATE: indien u de koppeling wenst op te slaan en direct de synchronisatie wenst uit te voeren!
De koppeling is nu volledig ingesteld en zal iedere nacht de Yokoy Expenses, Yokoy Payt transacties en Yokoy Invoices met de status “Ready for export” in Yokoy doorzetten naar Twinfield. Indien er geen nieuwe data klaarstaat om te exporteren, zal de koppeling niet automatisch de beschikbare data, zoals bijvoorbeeld leveranciers etc., updaten in Yokoy.