Mercurius Export
Je registreert in Yesplan prestaties in de vorm van resourceboekingen, maar je kan geen facturen maken in Yesplan. Dat kan echter wel met software zoals Mercurius, gemaakt door Cipal Schaubroeck.
Deze integratie laat je toe om:
- In Yesplan resourceboekingen per evenement(groep) te exporteren naar een XML-bestand.
- Dat XML-bestand te importeren in Mercurius.
- De facturatie uit te voeren in Mercurius op basis van de gegevens in het XML-bestand.
Concepten§
Mercurius en Yesplan gaan anders om met concepten. In de lijst hieronder vind je verschillende begrippen uit Mercurius en de manier waarop ze in Yesplan weergegeven worden.
- Organisatienummer: Dit is een nummer waarmee een klant binnen Mercurius geïdentificeerd wordt. Registreer dit nummer in Yesplan manueel op contacten via een customdataveld (van het type “Invulveld”). Bij het exporteren en importeren van prestaties laat dit nummer je toe om contacten uit Yesplan te koppelen aan klanten in Mercurius.
- Rijksregisternummer en ondernemingsnummer: In Mercurius kunnen klanten ook geïdentificeerd worden aan de hand van hun rijksregisternummer (natuurlijke personen) of ondernemingsnummer (organisaties). Registreer deze nummers in Yesplan manueel op contacten via een customdataveld (van het type “Invulveld”). Bij het exporteren en importeren van prestaties laten deze nummers je toe om contacten uit Yesplan te koppelen aan klanten in Mercurius.
- Prestatie: Prestaties zijn in Mercurius diensten of producten die gefactureerd worden aan een klant. In Yesplan komt dit overeen met geboekte resources op evenementen:
- Voor deze resources moet de checkbox “Aan te rekenen” geselecteerd zijn.
- Op het evenement moet de klant ingevuld zijn in een customdataveld van het type “Contactboeking”. Het organisatie-, rijksregister- of ondernemingsnummer op het geboekte contact zorgt vervolgens voor de juiste identificatie in Mercurius bij het exporteren en importeren van prestaties.
- Budgetcode: Mercurius bevat diensten of producten die aangerekend kunnen worden, met één enkele prijs. Dit correspondeert met de prijsdefinitie van een resource in Yesplan. Je moet de waarde van het veld “Budgetcode extern” uit Mercurius overnemen in het veld “Boekhoudcode” van de corresponderende prijsdefinitie in Yesplan. Op die manier worden de producten/diensten uit Mercurius gekoppeld aan prijsdefinities uit Yesplan.
- Themis: Themis is een softwareprogramma van Cipal Schaubroeck waarin contacten beheerd worden. Als jouw organisatie een integratie met Themis gebruikt, worden contacten uit Themis in Yesplan geïmporteerd. Als je deze contacten boekt als klant voor de facturatie in Mercurius, worden hun gegevens automatisch opgehaald uit Themis.
Configuratie§
Om de integratie in te stellen moet je de volgende stappen zetten:
- De integratie aanvragen bij je Customer Success Manager.
- Customdatavelden aanmaken voor het identificeren van de klant en deze invullen voor bestaande klanten:
- Ofwel een veld voor het organisatienummer
- Ofwel velden voor het rijksregisternummer/ondernemingsnummer.
- Customdatavelden aanmaken op evenementen voor het boeken van de klant en het exporteren van de prestaties per evenement.
- Optioneel: customdatavelden aanmaken op evenementen voor het factuurnummer en de factuurdatum.
- Je human resources correct organiseren.
- De “Budgetcode extern” invullen op prijsdefinities.
- Je export instellen in de systeeminstellingen van Yesplan.
Mercurius Export aanvragen§
Je Customer Success Manager kan de integratie met Mercurius activeren en je kan dat aanvragen met een e-mail naar support@yesplan.be. Je Customer Success Manager zal je dan verder helpen om de Mercurius Export te activeren.
Klanten identificeren§
Als je Mercurius reeds gebruikt bevat het veel klanten. Om de integratie goed te laten werken, moeten de relevante klanten uit Mercurius gekoppeld worden aan contacten in Yesplan.
- Als je Themis gebruikt om contacten te importeren in Yesplan, moet je niets doen in deze stap. Alles gebeurt automatisch.
- Als je in Mercurius het organisatienummer gebruikt om klanten te identificeren, moet je hiervoor een customdataveld aanmaken op alle contacten.
- Als je in Mercurius het rijksregisternummer en ondernemingsnummer gebruikt om klanten te identificeren, moet je hiervoor customdatavelden aanmaken op alle contacten en die invullen voor respectievelijk personen en organisaties.
Opmerking
De klanten die als contact in Yesplan toegevoegd zijn moeten in Yesplan ook een volledig adres hebben. Indien niet, krijg je een waarschuwing bij het exporteren van het XML-bestand.
Organisatienummer toevoegen§
Gebruik je het organisatienummer om klanten te identificeren in Mercurius? Doe dan het volgende.
Maak eerst het customdataveld aan:
- Ga in Yesplan als beheerder naar “Systeeminstellingen” > “Contacten” > “Custom data”.
- Maak een nieuwe groep aan voor Mercurius, of je kan er ook voor kiezen om het veld toe te voegen aan een bestaande groep.
- Maak het veld aan:
- Type: “Invulveld”
- Label: kies een duidelijke naam, bijv. ‘Organisatienummer Mercurius’
- Klik op “Voeg toe”
- Dubbelklik op het keyword van het veld en geef het een heldere naam die duidelijk weergeeft wat het doet, bijv. ‘mercuriusexport_organisatienummer’.
Tip
Je kan de zichtbaarheid van customdatavelden nog verder aanpassen en bepalen waar ze moeten verschijnen. Zie Zichtbaarheid van customdatavelden voor meer informatie.
Nu kan je het organisatienummer uit Mercurius toevoegen aan Yesplan:
- Zoek voor elke klant in Mercurius het contact op in Yesplan. Zorg dat je het juiste contact selecteert (bijv. de organisatie en niet de persoon of de link).
- Open het infovenster voor het contact en navigeer naar het customdataveld dat je net aangemaakt hebt.
- Vul het organisatienummer uit Mercurius in.
Tip
- Je kan de klantgegevens ook exporteren uit Mercurius en omvormen naar een importbestand voor contacten in Yesplan. We raden wel aan om dit eerst te bespreken met je Customer Success Manager, aangezien dit een grote impact kan hebben. Zie Importeren van contacten voor meer informatie.
- Eens je Mercurius en Yesplan naast elkaar gebruikt, moeten de contacten ook up to date gehouden worden. Zie Contacten beheren voor meer informatie.
Rijksregisternummer en ondernemingsnummer toevoegen§
Gebruik je het rijksregisternummer of ondernemingsnummer om klanten te identificeren in Mercurius? Doe dan het volgende.
Maak eerst het customdataveld voor het rijksregisternummer aan:
- Ga in Yesplan als beheerder naar “Systeeminstellingen” > “Contacten” > “Custom data”.
- Maak een nieuwe groep aan voor Mercurius, of je kan er ook voor kiezen om het veld toe te voegen aan een bestaande groep.
- Maak het veld voor het rijksregisternummer aan:
- Type: “Invulveld”
- Label: kies een duidelijke naam, bijv. ‘Rijksregisternummer Mercurius’
- Klik op “Voeg toe”
- Dubbelklik op het keyword van het veld en geef het een heldere naam die duidelijk weergeeft wat het doet, bijv. ‘mercuriusexport_rijksregisternummer’.
- Maak het veld voor het ondernemingsnummer aan:
- Type: “Invulveld”
- Label: kies een duidelijke naam, bijv. ‘Ondernemingsnummer Mercurius’
- Klik op “Voeg toe”
- Dubbelklik op het keyword van het veld en geef het een heldere naam die duidelijk weergeeft wat het doet, bijv. ‘mercuriusexport_ondernemingsnummer’.
Tip
Je kan de zichtbaarheid van customdatavelden nog verder aanpassen en bepalen waar ze moeten verschijnen. Zie Zichtbaarheid van customdatavelden voor meer informatie.
Nu kan je deze nummers uit Mercurius toevoegen aan Yesplan:
- Zoek voor elke klant in Mercurius het contact op in Yesplan. Zorg dat je het juiste contact selecteert (bijv. de organisatie en niet de persoon of de link).
- Open het infovenster voor het contact en navigeer naar het customdataveld dat je net aangemaakt hebt:
- Vul voor een persoon het rijksregisternummer in.
- Vul voor een organisatie het ondernemingsnummer in.
Tip
- Je kan de klantgegevens ook exporteren uit Mercurius en omvormen naar een importbestand voor contacten in Yesplan. We raden wel aan om dit eerst te bespreken met je Customer Success Manager, aangezien dit een grote impact kan hebben. Zie Importeren van contacten voor meer informatie.
- Eens je Mercurius en Yesplan naast elkaar gebruikt, moeten de contacten ook up to date gehouden worden. Zie Contacten beheren voor meer informatie.
Klantboeking en exportknop toevoegen§
Als je in Yesplan een evenement organiseert, moet je daar ook kunnen invullen aan wie het uiteindelijk gefactureerd moet worden in Mercurius. Dat doen we via een customdataveld op het evenement.
Je kan daarnaast op het evenement een knop toevoegen om enkel de resourceboekingen van dat evenement te exporteren.
- Ga in Yesplan als beheerder naar “Systeeminstellingen” > “Evenementen” > “Custom data”.
- Maak een nieuwe groep aan voor Mercurius, of je kan er ook voor kiezen om het veld toe te voegen aan een bestaande groep.
- Maak het contactveld aan:
- Type: “Contactveld”
- Label: kies een duidelijke naam, bijv. ‘Factureren aan klant’
- Klik op “Voeg toe”
- Dubbelklik op het keyword van het veld en geef het een heldere naam die duidelijk weergeeft wat het doet, bijv. ‘mercuriusexport_klant’.
- Maak de knop aan:
- Type: “Mercurius Exportknop”
- Label: kies een duidelijke naam, bijv. ‘Exporteren’
- Klik op “Voeg toe”.
Tip
Je kan de zichtbaarheid van customdatavelden nog verder aanpassen en bepalen waar ze moeten verschijnen. Zie Zichtbaarheid van customdatavelden voor meer informatie.
Bij een export van de prestaties zal Yesplan kijken naar de contactboeking op het evenement:
- Als dat contact een Themis-ID, organisatienummer, rijksregisternummer of ondernemingsnummer heeft, zal dat in het exportbestand vermeld worden, zodat je in Mercurius de prestaties kan koppelen aan de juiste klant.
- Als dat contact een contactlink is, zal Yesplan de klant identificeren aan de hand van het nummer in de gekoppelde organisatie.
Optioneel – factuurdatum en factuurnummer toevoegen§
Je kan optioneel ook aan evenementen customdatavelden toevoegen voor het ingeven van het factuurnummer en de factuurdatum. Deze kunnen dan op elk evenement ingevuld worden. Als ze ingevuld zijn, worden ze opgenomen in het exportbestand voor Mercurius.
- Ga in Yesplan als beheerder naar “Systeeminstellingen” > “Evenementen” > “Custom data”.
- Maak een nieuwe groep aan voor Mercurius, of je kan er ook voor kiezen om het veld toe te voegen aan een bestaande groep.
- Maak het veld voor de factuurdatum aan:
- Type: “Datumveld”
- Label: kies een duidelijke naam, bijv. ‘Factuurdatum Mercurius’
- Klik op “Voeg toe”
- Dubbelklik op het keyword van het veld en geef het een heldere naam die duidelijk weergeeft wat het doet, bijv. ‘mercuriusexport_factuurdatum’.
- Maak het veld voor het factuurnummer aan:
- Type: “Invulveld” of “Uniekereeksveld”
- Label: kies een duidelijke naam, bijv. ‘Factuurnummer Mercurius’
- Klik op “Voeg toe”
- Dubbelklik op het keyword van het veld en geef het een heldere naam die duidelijk weergeeft wat het doet, bijv. ‘mercuriusexport_factuurnummer’.
Let op
De velden voor de factuurdatum en het factuurnummer worden niet automatisch gesynchroniseerd met Mercurius: ze worden simpelweg opgenomen in het exportbestand voor Mercurius.
Human resources organiseren§
Je kan instellen op welke manier resources weergegeven worden in het exportbestand (en dus in Mercurius). Zie Mercurius Export instellen voor meer informatie.
Je zal hiervoor bijna altijd de naam van de resource gebruiken. Voor human resources is dit echter niet zo handig: dan verschijnt immers de naam van de human resource (bijv. ‘Violet Trudeau’) en dat wil je waarschijnlijk niet. Daarom raden we je aan om de human resources op onderstaande manier te organiseren.
Tip
Deze werkwijze maakt gebruik van plaatshouders/rollen. Je vindt meer informatie hierover in de handleiding:
Zet de volgende stappen:
- Maak op elke relevante plaatshouder (bijv. met de naam ‘Geluidstechnieker’) een prijsdefinitie aan met de naam van de plaatshouder (dus: ‘Geluidstechnieker’). Zie Prijsdefinities voor meer informatie.
- Voor elke human resource die ingewisseld kan worden met die plaatshouder, zet je de volgende stappen:
- Open het infovenster van de human resource (bijv. ‘Violet Trudeau’).
- Voeg de rol van de plaatshouder toe in het tabblad “Info” als dat nog niet gebeurd zou zijn. In dit geval zou dat dan ‘Geluidstechnieker’ zijn.
- Voeg in het tabblad “Prijzen” een prijsdefinitie toe met de naam van de rol/plaatshouder (dus: ‘Geluidstechnieker’).
Het selecteren van de naam gebeurt als volgt:
- Als Violet Trudeau ingewisseld wordt bij een boeking, dan verschijnt de naam van de rol in de export (dus ‘Geluidstechnieker’).
- Als er geen rol ingevuld is op de human resource, gebruikt Yesplan de waarde “Personeel”.
Budgetcode extern§
Mercurius bevat voor elke dienst en elk product een identificatiecode: de “Budgetcode extern”. Deze diensten en producten hebben slechts één prijs, en ze corresponderen bijgevolg met prijsdefinities in Yesplan. Daarom moet hun budgetcode manueel gekoppeld worden aan de prijsdefinities van resources in Yesplan.
- Zoek voor elk product en elke dienst in Mercurius de corresponderende prijsdefinitie in Yesplan.
- Neem de “Budgetcode extern” uit Mercurius over in het veld “Boekhoudcode”.
Bij een export zal Yesplan voor elke resourceboeking de boekhoudcode van de geselecteerde prijsdefinitie in het exportbestand vermelden, zodat je in Mercurius via de “Budgetcode extern” de resourceboeking kan koppelen aan de juiste dienst of het juiste product.
Mercurius Export instellen§
Eens de Mercurius Export geactiveerd is en je de stappen hierboven uitgevoerd hebt, kan je de export instellen.
Let op
Als je voor “Exporteer op het niveau van” kiest voor “evenementen” of “resourcegroepen”, zullen de boekingen samengeteld en samengevat worden op één lijn in het exportbestand, met name voor het evenement en de resourcegroep. Dat betekent wel dat al de resources op het evenement of in de resourcegroep hetzelfde btw-tarief moeten hebben: je kan immers niet meer dan één btw-tarief weergeven op één lijn.
Daarom raden we ten sterkste aan om voor de Mercurius Export te kiezen voor exports op het niveau van boekingen.
Ga als beheerder naar “Systeeminstellingen” > “Integraties” > “Mercurius Export” en vul de verschillende velden in:
-
Exporteer op het niveau van: kies hier op welk niveau Yesplan boekingen moet exporteren:
- Evenementen: Alle boekingen op één evenement worden samengeteld en in één lijn weergegeven in het exportbestand.
- Resourcegroepen: De boekingen worden samengeteld per resourcegroep. Het exportbestand bevat dan een lijn per resourcegroep.
- Resoureboekingen: Het exportbestand bevat een lijn per resourceboeking. We raden aan om deze optie te kiezen.
-
Klant op evenement: Selecteer hier het keyword dat je gebruikt hebt in de stap Klantboeking en exportknop toevoegen). In ons voorbeeld was ‘mercuriusexport_klant’.
-
Rijksregisternummer/Ondernemingsnummer gebruiken in plaats van organisatienummer?: Selecteer deze checkbox aan als je in Mercurius klanten identificeert aan de hand van hun rijksregister- en ondernemingsnummer. Er verschijnen dan twee extra opties:
- Rijksregisternummer op contact: Vul hier het keyword in dat je gebruikt hebt voor het rijksregisternummer in de stap Rijksregisternummer en ondernemingsnummer toevoegen. In ons voorbeeld was dat ‘mercuriusexport_rijksregisternummer’.
- Ondernemingsnummer op contact: Vul hier het keyword in dat je gebruikt hebt voor het ondernemingsnummer in de stap Rijksregisternummer en ondernemingsnummer toevoegen. In ons voorbeeld was dat ‘mercuriusexport_ondernemingsnummer’.
-
Organisatienummer op contact: Kies een waarde als je het organisatienummer gebruikt in Mercurius om klanten te identificeren. Kies dan het keyword dat je gebruikt hebt voor het organisatienummer in de stap Organisatienummer toevoegen. In ons voorbeeld was dat ‘mercuriusexport_organisatienummer’. Als je Themis gebruikt voor het beheer van contacten in Yesplan, mag je deze keuzelijst leeg laten.
-
Factuurnummer op evenement: Vul hier het keyword in dat je gebruikt hebt voor het factuurnummer in de stap Optioneel – factuurdatum en factuurnummer toevoegen. In ons voorbeeld was dat ‘mercuriusexport_factuurnummer’. Als je dit veld niet gebruikt of het leeg laat zal Yesplan de Yesplan-ID van het evenement gebruiken.
-
Factuurdatum op evenement: Vul hier het keyword in dat je gebruikt hebt voor de factuurdatum in de stap Optioneel – factuurdatum en factuurnummer toevoegen. In ons voorbeeld was dat ‘mercuriusexport-factuurdatum’. Als je dit veld niet gebruikt of het leeg laat zal Yesplan de datum gebruiken waarop je het exportbestand aanmaakt.
-
Betalingstermijn (in dagen): In Mercurius wordt deze waarde op de factuur toegevoegd voor de uiterste betalingstermijn (in dagen). Als je dit veld niet invult, bevat het exportbestand de waarde “0” voor de betalingstermijn.
-
Negeer boekingen met een aantal en prijs van 0: Je evenement zou boekingen kunnen bevatten met een aantal en prijs van 0, bijvoorbeeld als je een resourceset boekt voor catering maar niet alle boekingen in die set gebruikt zijn. Als je deze checkbox selecteert worden deze boekingen niet meegenomen in de export.
-
Exporteer correctielijnen: Yesplan rondt voor elke resourceboeking de prijs af, maar gebruikt voor de berekening van het totaal de niet-afgeronde prijs. Dit kan leiden tot een verschil in de berekening van de totalen. Als je deze checkbox selecteert zal aan het XML-bestand een lijn toegevoegd worden die dit verschil expliciet maakt. Als je de checkbox niet selecteert wordt deze lijn niet toegevoegd aan het XML-bestand en zal je het verschil kunnen oplossen in Mercurius zelf. Cipal Schaubroeck zelf raadt het gebruik van correctielijnen af. Zie Correctielijnen voor een voorbeeld.
-
Beschrijving factuur: Je kan de naam van de factuur bepalen en je kan daarbij – naast tekst – onderstaande variabelen gebruiken:
$event
: de naam van het evenement$date
: de datum van het evenement in het correcte formaat, bijv. ‘op 28-05-2020’ of ‘van 28-05-2020 tot 30-05-2020’$time
: de tijden van het evenement in het correcte formaat, bijv. ‘van 09:00 tot 22:00’$datetime
: de datum en de tijden van het evenement in het correcte formaat, bijv. ‘op 28-05-2020 van 09:00 tot 22:00’ of ‘van 28-05-2020 – 09:00 tot 30-05-2020 – 22:00’$keyword
: het keyword van een customdataveld op het evenement. De inhoud van dat customdataveld zal weergegeven worden.
De standaardwaarde is
$event
maar je kan dit zelf aanpassen naar bijvoorbeeldFactuur voor $event $date
. Dat wordt dan ‘Factuur voor Hamlet op 01-10-2020’. -
Beschrijving boekingslijn: Je kan bepalen hoe een resourceboeking omschreven wordt en je kan daarbij – naast tekst – onderstaande variabelen gebruiken:
$amount
: het aantal van de resourceboeking, gevolgd door “x”, bijv. ‘3x’$resource
: de naam van de resource$date
: de datum van de boeking in het correcte formaat, bijv. ‘op 28-05-2020’ of ‘van 28-05-2020 tot 30-05-2020’$time
: de tijden van de boeking in het correcte formaat, bijv. ‘van 09:00 tot 22:00’$datetime
: de datum en de tijden van de boeking in het correcte formaat, bijv. ‘op 28-05-2020 van 09:00 tot 22:00’ of ‘van 28-05-2020 – 09:00 tot 30-05-2020 – 22:00’$keyword
: het keyword van een customdataveld op de resourceboeking. De inhoud van dat customdataveld zal weergegeven worden.
De standaardwaarde is
$resource
maar je kan dit zelf aanpassen naar bijvoorbeeld$time: $amount $resource
. Dat wordt dan ‘van 09:00 tot 11:00: 10x Koffie’.
Je hebt nu alles ingesteld om de integratie met Mercurius te gebruiken.
Gebruik§
In deze integratie exporteer je een XML-bestand met de gewenste prestaties uit Yesplan, en importeer je dat bestand vervolgens in Mercurius. Je kan het bestand op twee manieren exporteren:
- via het zoekvenster “Mercurius Export”
- via het infovenster van het evenement.
Opmerking
Hou er rekening mee dat enkel de resourceboekingen geëxporteerd worden waarvoor “Aan te rekenen” geselecteerd is.
Zoekvenster Mercurius Export§
Als je de prestaties voor meerdere evenementen wenst te exporteren is het zoekvenster “Mercurius Export” het meest aangewezen.
- Ga naar “Rapporten” > “Mercurius Export”.
- Geef in de zoekbalk bovenaan een zoekopdracht in, bijvoorbeeld
event:date:21-09-2020
voor al de evenementen die op 21 september 2020 plaatsvinden. Zie de Zoektaal voor meer informatie over zoekopdrachten. - Je krijgt dan een lijst te zien van alle evenementen op die dag. Selecteer links de checkbox voor de evenementen die je zou willen exporteren en klik op “Exporteer…”.
- In het volgende scherm kan je een overzicht bekijken van de velden die geëxporteerd zullen worden. Klik op “Exporteer” als alles correct is. Yesplan zal één XML-bestand aanmaken waarin elk evenement een aparte factuur is.
Tip
Je kan in het zoekvenster ook het infovenster voor een evenement openen door:
- dubbel te klikken op de rij voor dat evenement
- of rechts te klikken op de rij en in het contextmenu “Toon info” te kiezen.
Op die manier kan je evenementen nog aanpassen alvorens ze te exporteren.
Infovenster van het evenement§
Als je in de stap Klantboeking en exportknop toevoegen een knop aangemaakt hebt, zal die verschijnen in het infovenster van het evenement. Gebruik deze knop om de prestaties van individuele evenementen of evenementgroepen te exporteren.
- Open het infovenster voor het evenement en navigeer naar het tabblad waar de knop zich bevindt. Dit hangt af van de manier waarop je de zichtbaarheid van deze knop ingesteld hebt. Zie Zichtbaarheid van customdatavelden voor meer informatie.
- Klik op de knop “Exporteer…”. In het volgende scherm kan je een overzicht bekijken van de velden die geëxporteerd zullen worden. Klik op “Exporteer” als alles correct is. Yesplan zal het XML-bestand aanmaken en je zal het automatisch downloaden.
Veelgestelde vragen§
Hieronder beantwoorden we enkele vragen over het beheer en gebruik van de integratie.
Contacten beheren§
Contacten en klanten zijn geen statisch gegeven. Ze bestaan echter in Mercurius én Yesplan, hoe beheer je ze dan?
Nieuwe klanten§
Eens je de integratie ingesteld hebt, zullen er nieuwe klanten bijkomen. Hoe voeg je die toe?
- Als je Themis gebruikt, zullen de klanten daar beheerd worden. Ze worden dan automatisch geïmporteerd in Yesplan en Mercurius.
- In de andere gevallen moet je de klant aanmaken in Mercurius én Yesplan. Neem het organisatienummer of het rijksregisternummer/ondernemingsnummer uit Mercurius over in het juiste veld in Yesplan.
Aanpassingen bestaande klanten§
Wat als het adres van een klant verandert? Waar moet je dit dan aanpassen?
- Als je Themis gebruikt, zullen de klanten daar beheerd worden. De aanpassingen worden dan automatisch geïmporteerd in Yesplan en Mercurius.
- In de andere gevallen zullen deze gegevens manueel in Mercurius én Yesplan aangepast moeten worden.
Resourcesets§
Stel dat je een resourceset geboekt hebt. Die bestaat uit verschillende resources, maar hoe zal die set dan geëxporteerd worden?
- Als de prijs van de resourceset berekend wordt aan de hand van de onderliggende resources, zullen de individuele boekingen van de resources als prestaties doorgestuurd worden.
- Als de resourceset zelf een prijsdefinitie bevat, zal deze prijs als prestatie doorgestuurd worden. De onderliggende resourceboekingen zullen niet doorgestuurd worden. Je kan dus prijsdefinities toevoegen aan een resourceset, en er ook de “Budgetcode extern” uit Mercurius aan koppelen.
Opmerking
Je kan de integratie zo instellen dat resourceboekingen met een aantal en een prijs van 0 niet geëxporteerd worden als prestaties. Zie Mercurius Export instellen voor meer informatie.
Prijzen overschrijven§
In Yesplan kan je prijzen overschrijven op verschillende niveaus. In dat geval zal voor deze prijs wel een “Budgetcode extern” meegegeven moeten worden. Die is echter niet altijd voorhanden. Wat wordt dan meegestuurd in het exportbestand?
Overschrijven op evenement§
Je kan de prijs van resources in Yesplan overschrijven op het niveau van het evenement, maar evenementen hebben geen prijsdefinities en ook geen veld voor “Boekhoudcode”.
Yesplan zal dan de naam van het evenement meegeven als waarde voor “Budgetcode extern”. Dat betekent dat je in Mercurius een product/dienst moet aanmaken met deze budgetcode.
Overschrijven op resourcegroep§
Je kan de prijs van resources in Yesplan overschrijven op het niveau van de resourcegroep, maar resourcegroepen hebben geen prijsdefinities en ook geen veld voor “Boekhoudcode”.
Yesplan zal dan de naam van de resourcegroep meegeven als waarde voor “Budgetcode extern”. Dat betekent dat je in Mercurius een product/dienst moet aanmaken met deze budgetcode.
Overschrijven op resourceset§
Als een resourceset geen eigen prijsdefinitie heeft en je overschrijft de prijs op het niveau van de set, dan zal er geen veld zijn voor “Boekhoudcode”.
Yesplan zal dan geen enkele waarde meegeven voor “Budgetcode extern”.
Opmerking
We raden deze manier van werken af. Het is een goed idee om:
- Ofwel resourcesets een prijsdefinitie toe te kennen (met een “Budgetcode extern”) en dan de prijs te overschrijven indien gewenst.
- Ofwel resourcesets géén prijsdefinitie toe te kennen. De prijs wordt dan bepaald door de onderliggende resources in de set. In dit geval overschrijf je de prijs beter niet op het niveau van de resourceset.
Kortingen§
In Yesplan kan je kortingen toevoegen voor het aantal en de duur van een resourceboeking. Zie Kortingen voor meer informatie. Hoe wordt deze korting echter geëxporteerd?
Yesplan zal de kortingen op een resourceboeking steeds correct berekenen. De korting zal evenwel niet zichtbaar zijn op de uiteindelijke prijs. Dit betekent dat de korting niet geëxporteerd kan worden naar Mercurius en niet op de factuur zal verschijnen.
We raden daarom aan om een keuze te maken. Je kan:
- ofwel de kortingen op resourceboekingen gebruiken. Deze zullen dan niet zichtbaar zijn in Mercurius.
- ofwel de kortingen op resourceboekingen niet gebruiken. Je kan dan wel bijvoorbeeld de prijs overschrijven op de resourceboeking zelf, of een resourceboeking toevoegen met een negatieve prijs (i.e. de korting). Dit zal wel verschijnen in Mercurius.
Let op
We raden ten sterkste af om deze twee methodes te combineren, aangezien ze tot verwarring en fouten kunnen leiden in de facturatie.
Correctielijnen§
De instellingen van de integratie laten je toe om correctielijnen toe te voegen (zie Mercurius export instellen voor meer informatie). Maar wat is een correctielijn precies?
Stel dat twee resources op een evenement geboekt zijn:
Naam | Prijs | Afgeronde prijs |
---|---|---|
Microfoon 1 | 119.775 | 119.78 |
Microfoon 2 | 110.215 | 110.22 |
Totaal | 229.99 | 230 |
Yesplan gebruikt de volgende logica in de berekeningen:
- Voor de prijzen van individuele resources wordt steeds de afgeronde prijs getoond.
- Voor de berekening van de totale prijs van alle resources samen wordt echter de niet-afgeronde prijs gebruikt.
- Dit kan zorgen voor een verschil tussen het totaal van enerzijds de afgeronde prijs en anderzijds de niet-afgeronde prijs. In het voorbeeld hierboven is dat verschil 0.01.
Yesplan kan in de export een correctielijn toevoegen om dit verschil expliciet te maken: de correctielijn zal in dit voorbeeld “–0.01” bevatten. Als je beslist om geen correctielijnen toe te voegen aan het exportbestand, zal je dit verschil op kunnen lossen in Mercurius zelf, waar het automatisch gedetecteerd zal worden.