Wat doet de koppeling?
Met de koppeling tussen Caseware en Hix verstuur je publicatiestukken en aangiftes vanuit Caseware naar Hix, zodat je klant ze digitaal kan goedkeuren of ondertekenen. Daarna kun je vanuit Hix het document direct laten deponeren of doorsturen naar de Belastingdienst.
Caseware kent twee smaken: Caseware Working Papers (Desktop) en Caseware Cloud. De inrichting verschilt per variant — dit artikel beschrijft beide.
Voor je begint: controleer eerst welke Caseware-variant je gebruikt. Werk je in Caseware Working Papers op je computer? Volg dan Scenario A. Werk je in een browser via Caseware Cloud? Volg dan Scenario B.
Scenario A — Caseware Working Papers (Desktop)
In de desktopvariant wordt Hix gekoppeld via de Caseware Connector Financieel. Veel problemen ("ik kan geen portaal kiezen", "Hix verschijnt niet als optie") komen doordat de Connector nog niet of niet volledig is ingericht. Doorloop daarom onderstaande punten zorgvuldig.
Vereisten
Zorg dat je de juiste versies van de software hebt geĂŻnstalleerd:
- Caseware Connector Financieel — versie 3.5.3 of hoger Download via Caseware Connector Financieel op MyCaseware.
- Caseware Financials — versie 2023.9 of hoger
- Caseware Connector Global Portal — versie 1.3.3 of hoger Download via Caseware Connector Global Portal op MyCaseware.
Tip: check de geĂŻnstalleerde versies via de Caseware-omgeving zelf voordat je verder gaat. Een oudere Connector Financieel kan ervoor zorgen dat Hix niet als portaal verschijnt, ook al staat de rest goed.
Setup in Connector Financieel
De Connector Financieel kent een aantal instellingen die in de juiste volgorde moeten worden gezet. We onderscheiden drie blokken: Algemeen, Standaard en Module Hix.
1. Tabblad Algemeen — module Hix aanzetten
- Open de instellingen van Connector Financieel.
- Ga naar het tabblad Algemeen.
- Zet het vinkje aan bij module Hix.
Vanaf nu weet de Connector dat Hix een mogelijk afleveringskanaal is.
2. Tabblad Standaard — Hix als default portaal
- Open het tabblad Standaard.
- Stel Hix in als het default portaal.
- Bepaal of medewerkers per dossier hiervan mogen afwijken (bijvoorbeeld om incidenteel een ander portaal te kiezen).
Meer details over deze instellingen vind je in de officiële Beheerdershandleiding Connector Financieel — inrichting algemeen van Caseware.
3. Module Hix — verbindingsgegevens invullen
Open de module Hix binnen de Connector en vul daar de verbindingsgegevens in:
- URL — het webadres van jouw Hix-omgeving.
- API key — de sleutel uit jouw Hix-beheerdersportaal (zie De API-key uit Hix halen hieronder).
- Opties — vink aan welke functies van Hix je wilt gebruiken (zoals deponeren of accorderen).
Een uitgewerkte schermafdruk en uitleg per veld staat in de Beheerdershandleiding Connector Financieel — module Hix van Caseware. Houd die handleiding er bij de hand — daarin staat exact welke opties wat doen.
De API-key uit Hix halen
- Log in op Hix en open het Beheerdersportaal.
- Ga naar Instellingen → Toegang → API.
- Klik op het + om een nieuw token aan te maken.
- Kopieer het token en plak het in het veld API key in Connector Financieel.
Tip: bewaar het token op een veilige plek. Mocht het uitlekken, draai het token dan in Hix in en maak een nieuw token aan.
Klaar — wat zie je nu?
Na deze setup verschijnt Hix als afleveringskanaal in Caseware Working Papers. Bij het deponeren of versturen van een document kun je voortaan Hix kiezen als portaal, en wordt het document naar Hix doorgestuurd voor verdere afhandeling door de klant.
Scenario B — Caseware Cloud
In Caseware Cloud zit de koppeling met Hix in een ander deel van het systeem: de CDT (Cloud Deployment Tool), beschikbaar voor beheerders.
Inrichten in Caseware Cloud
- Log in op Caseware Cloud als administrator.
- Open de CDT-optie in het menu.
- Kies het scenario dat past bij jouw werkwijze:
| Scenario | Wat stel je in? |
|---|---|
| Direct via Digipoort indienen | Configureer de Caseware Digipoort-koppeling. |
| Via een takensysteem laten accorderen | Configureer de Hix-koppeling. |
Beide opties vragen om verbindingsgegevens (URL, API key, ondertekenaars). De API key haal je op de manier zoals beschreven in De API-key uit Hix halen hierboven.
Belangrijke beperking in Caseware Cloud
Let op: op dit moment is het niet mogelijk om in Caseware Cloud zowel een bestaand Hix-account te gebruiken voor accordering Ă©n rechtstreeks via Caseware Digipoort in te sturen. Een poging om beide tegelijk te configureren levert een foutmelding op.
Caseware werkt aan een oplossing hiervoor. Tot die in productie staat, moet je kiezen: Ăłf rechtstreeks via Digipoort indienen, Ăłf via Hix accorderen. Houd voor de actuele status het Caseware supportÂportaal in de gaten of neem contact op met support.
Veelvoorkomende problemen
"Ik kan geen portaal kiezen in Caseware Working Papers." Dit betekent vrijwel altijd dat in de Connector Financieel niet is ingesteld dat er via Hix wordt gedeponeerd. Loop punt 1 (Algemeen → module Hix aanvinken) en punt 2 (Standaard → default portaal Hix) van Scenario A na.
"Hix verschijnt niet als optie, ook al heb ik het ingesteld." Controleer de versies van Connector Financieel (3.5.3 of hoger), Financials (2023.9 of hoger) en Connector Global Portal (1.3.3 of hoger). Een te oude versie verbergt de Hix-optie of zorgt voor stille fouten.
"In Caseware Cloud krijg ik een foutmelding als ik Digipoort én Hix wil gebruiken." Dit is een bekende beperking — zie Belangrijke beperking in Caseware Cloud hierboven. Kies voor nu één van de twee opties.
"De API key wordt niet geaccepteerd." Controleer dat de API key in Hix is aangemaakt onder Beheerdersportaal → Instellingen → Toegang → API en dat je 'm zonder extra spaties of regeleinden in Caseware hebt geplakt. Maak desnoods een nieuwe token aan in Hix.
Veelgestelde vragen
Welke variant van Caseware gebruik ik? Werk je in een lokale applicatie op je computer? Dan is het Caseware Working Papers (Desktop) — Scenario A. Werk je in de browser via een Caseware Cloud-omgeving? Dan is het Caseware Cloud — Scenario B.
Heb ik Hix-licenties nodig? Ja. Om documenten naar Hix te kunnen sturen voor accordering of ondertekening heb je een actieve Hix-omgeving nodig. Neem contact op met support als je nog geen Hix-account hebt.
Kan ik per dossier kiezen of ik via Hix of via een ander portaal indien? Dat hangt af van je instelling op het tabblad Standaard in Connector Financieel. Sta je daar afwijken toe, dan kunnen medewerkers per dossier kiezen.
Wat als de Caseware-versie van mijn klant nog te oud is? Dan moet eerst Caseware worden bijgewerkt. Verwijs de klant naar de downloadpagina's: Connector Financieel en Connector Global Portal. Zonder de juiste versies werkt de Hix-koppeling niet stabiel.
Mijn API key werkt niet meer. API keys kunnen ongeldig worden als ze in Hix zijn ingetrokken. Maak in dat geval een nieuwe key aan via Beheerdersportaal → Instellingen → Toegang → API en vervang 'm in Caseware.
Hulp nodig?
Loop je vast bij de inrichting? Twee handige bronnen:
Voor de Caseware-kant van de inrichting verwijzen we naar de officiële Caseware-handleidingen, vooral:
- Beheerdershandleiding Connector Financieel — inrichting algemeen
- Beheerdershandleiding Connector Financieel — module Hix
Voor deze artikelen heb je een MyCaseware-account nodig.
- Voor de Hix-kant (API key, instellingen Beheerdersportaal): stuur een bericht naar support@hellohix.com met daarbij de naam van je Hix-omgeving (subdomein) en — indien beschikbaar — een screenshot van de foutmelding of de instelling die je probeert te doen.