Uw Odoo-kassa verbinden met Shyfter

Importeer automatisch de omzet van uw Odoo-kassa in Shyfter, elke dag, zonder enige handmatige invoer.

In het kort

Zodra de integratie geïnstalleerd is, maakt Shyfter verbinding met uw Odoo-account en haalt uw omzet automatisch op:

• Uw historiek van de laatste 24 maanden wordt geïmporteerd zodra u installeert.
• Elke ochtend wordt de omzet van de vorige dag automatisch toegevoegd.
• Uw gegevens voeden uw dashboard en uw personeelsprognoses, zonder iets handmatig in te voeren.

U houdt de controle: u kiest of u de omzet importeert incl. btw of excl. btw.

Wat u nodig heeft

Zorg dat u vóór het starten beschikt over:

• Een Odoo-account met de module Kassa (Point of Sale) actief.
• De rechten om een API-sleutel aan te maken in Odoo (meestal een beheerdersaccount).

U heeft 4 gegevens nodig, uitgelegd in de volgende stap:

Gegeven	Voorbeeld
Adres van uw Odoo	https://mijn-bedrijf.odoo.com
Naam van de database	mijn-bedrijf
Inlog-e-mail	[email protected]
API-sleutel	een lange reeks tekens aangemaakt in Odoo

Stap 1: Uw Odoo-gegevens ophalen

1.1 Het adres en de databasenaam

• Het adres van uw Odoo is het adres dat in de adresbalk van uw browser verschijnt wanneer u ingelogd bent, bijvoorbeeld https://mijn-bedrijf.odoo.com.
• De naam van de database is het begin van dat adres. Voor https://mijn-bedrijf.odoo.com is de database mijn-bedrijf.

1.2 Een API-sleutel aanmaken

Om veiligheidsredenen maakt Shyfter geen verbinding met uw wachtwoord, maar met een API-sleutel die u in Odoo aanmaakt.

1. Log in bij Odoo.
2. Klik op uw profielfoto rechtsboven en daarna op Mijn profiel.
3. Open het tabblad Accountbeveiliging.
4. Klik op Nieuwe API-sleutel, geef ze een naam (bijvoorbeeld "Shyfter") en bevestig.
5. Kopieer de getoonde sleutel en houd ze apart: ze is daarna niet meer zichtbaar.

💡 Goed om te weten: de API-sleutel vervangt uw wachtwoord alleen voor deze verbinding. U kunt ze op elk moment intrekken vanuit Odoo.

Stap 2: De integratie installeren in Shyfter

1. Open in Shyfter Instellingen > Integraties, tabblad Productiviteit, en selecteer Odoo.
2. Klik op Installeren.
3. Vul in het venster Verbind Odoo het formulier in:

• Adres van uw Odoo
• Naam van de database
• Inlog-e-mail
• API-sleutel (die u kopieerde in stap 1.2)
• Te importeren bedrag: kies incl. btw of excl. btw

4. Bevestig om de verbinding te starten.

Shyfter controleert de verbinding met Odoo meteen. Als alles klopt, wordt de integratie geïnstalleerd en verschijnt het bericht "Odoo is succesvol geïnstalleerd!". Anders geeft een duidelijk bericht aan wat u moet corrigeren (zie het onderdeel "Bij problemen").

✅ Zodra de integratie geïnstalleerd is, importeert Shyfter automatisch uw omzet van de laatste 24 maanden. De historiek wordt maand per maand verwerkt: afhankelijk van het volume kan dit enkele minuten duren.

Wat gebeurt er na de installatie?

• Import van de historiek: de omzet van de laatste 24 maanden wordt opgehaald en dag per dag verdeeld.
• Dagelijkse import: elke ochtend wordt de omzet van de vorige dag automatisch toegevoegd.
• Geen actie nodig van uw kant in het dagelijks gebruik.

Het geïmporteerde bedrag volgt uw keuze incl. btw / excl. btw.

Waar u uw omzet terugvindt

Ga naar Instellingen > Prestaties > Prognosebasis om uw geïmporteerde bedragen dag per dag te bekijken. U kunt bovenaan de pagina van maand wisselen.

Een maand onmiddellijk importeren

Als u niet wilt wachten op de automatische import van de volgende dag, gebruik dan de knop Weergegeven maand importeren (verversingsicoon), rechtsboven op de pagina Prognosebasis. Deze knop verschijnt alleen wanneer een kassa verbonden is.

U wordt gevraagd te bevestigen: de omzet van de weergegeven maand (tot vandaag) wordt opgehaald uit uw kassa en de bestaande waarden worden bijgewerkt. De knop is uitgeschakeld voor toekomstige maanden.

De configuratie wijzigen

U kunt de instellingen van de integratie op elk moment wijzigen:

1. Open de Odoo-kaart in Instellingen > Integraties.
2. Klik op Configureren.
3. De velden zijn al vooraf ingevuld met uw huidige gegevens (adres, database, e-mail en keuze incl./excl. btw).
4. Wijzig wat u wilt, bijvoorbeeld het Te importeren bedrag.
5. Klik op Opslaan. Het bericht "Configuratie succesvol bijgewerkt." bevestigt de wijziging.

🔒 Voor uw veiligheid wordt de API-sleutel niet opnieuw getoond. U hoeft ze niet opnieuw in te voeren om uw instellingen te wijzigen: uw bestaande sleutel blijft behouden. Alleen door een nieuwe sleutel in te voeren wordt de verbinding opnieuw gevalideerd.

💡 De instelling incl. btw / excl. btw is gedeeld met de optie "Omzet exclusief btw importeren" in uw prestatie-instellingen. Ze hier wijzigen werkt die instelling voor uw vestiging bij.

Incl. btw of excl. btw: welke kiezen?

• Incl. btw: het geïmporteerde bedrag bevat btw. Dat is wat uw kassa werkelijk ontvangt.
• Excl. btw: het geïmporteerde bedrag is zonder btw. Handig als u uw activiteit op bedragen zonder btw stuurt.

U kunt deze keuze op elk moment wijzigen via Configureren.

De integratie verwijderen

Om de import te stoppen, opent u de Odoo-kaart in Instellingen > Integraties en klikt u op Verwijderen. Na bevestiging wordt de integratie uitgeschakeld en worden uw verbindingsgegevens (waaronder de API-sleutel) verwijderd. De reeds geïmporteerde omzet blijft beschikbaar in Shyfter, en u kunt de integratie later opnieuw installeren.

Bij problemen

Als de verbinding mislukt, geeft Shyfter precies aan wat u moet controleren:

Bericht	Wat te doen
Kan de Odoo-instantie niet bereiken. Controleer de URL.	Controleer het adres van uw Odoo (kopieer het uit uw browser).
Odoo-database niet gevonden. Controleer de naam van de database.	Corrigeer de databasenaam (vaak het begin van uw adres).
Odoo-inloggegevens geweigerd. Controleer de e-mail en API-sleutel.	Controleer uw inlog-e-mail en maak indien nodig een nieuwe API-sleutel aan.
De API-sleutel is verplicht.	Voer de in Odoo aangemaakte API-sleutel in.

Als het probleem aanhoudt, neem contact op met onze support: we helpen u graag verder.

Veelgestelde vragen

Is de import automatisch? Ja. Na de installatie importeert Shyfter uw omzet elke ochtend, zonder actie van uw kant.

Verlies ik mijn historiek? Nee. De laatste 24 maanden worden bij de installatie geïmporteerd, daarna wordt elke nieuwe dag automatisch toegevoegd.

Wordt mijn Odoo-wachtwoord opgeslagen? Nee. Shyfter gebruikt uitsluitend een API-sleutel, die u op elk moment in Odoo kunt intrekken. Uw wachtwoord wordt nooit gevraagd of bewaard.

Kan ik later van incl. btw naar excl. btw overschakelen? Ja, via Configureren. De wijziging geldt voor de volgende imports.

Hoe wijzig ik mijn API-sleutel? Open Configureren, voer de nieuwe sleutel in het veld API-sleutel in en sla op: de verbinding wordt opnieuw gevalideerd met de nieuwe sleutel.

Hulp nodig? Ons supportteam staat klaar om u te begeleiden bij de installatie.