HIX

Connectie opzetten

Om de koppeling op te zetten, vul je je subdomein, API-sleutel en Client Group ID in.

Subdomein: Dit is de omgeving waarop je inlogt. Bijvoorbeeld: https://jouwbedrijf.hixportal.com.

API-sleutel ophalen:

1. Ga naar de Hix-applicatie.
2. Navigeer naar Beheerdersportaal > Instellingen > Toegang > API.
3. Klik op het +-teken om een nieuwe API-token aan te maken.
   Let op: De API-token kun je na aanmaak niet meer volledig inzien. Bewaar deze daarom op een veilige plek.

Klantgroep-ID ophalen:

1. Ga naar de Hix-applicatie.
2. Navigeer naar Beheerdersportaal > Groepen.
3. Het ID van de klantgroep vind je in de URL van de groepspagina.
   Voorbeeld: https://{subdomain}.hixportal.com/manage/groups/1234/overview (hier is 1234 het klantgroep-ID).

Relaties synchroniseren naar HIX

De synchronisatie naar HIX gebeurd door het plaatsen van HIX als andere software op de relatie. Dit veld is terug te vinden onder de accountant info: 

Er zijn vier verschillende soorten synchronisaties mogelijk:

1. Bedrijven
   Bedrijven worden gesynchroniseerd als afzonderlijke entiteiten, volgens de mapping zoals hieronder beschreven.

2. Personen
   Personen worden gesynchroniseerd als Klantgebruikers en toegewezen aan de groep-ID van de connect-pagina.

3. Eenmanszaken
   Eenmanszaken worden zowel gesynchroniseerd als een bedrijf én als een klantgebruiker. Vervolgens worden deze twee entiteiten in HIX aan elkaar gekoppeld.

4. Gelinkte relaties

   • Als je een persoon als contactpersoon koppelt aan een bedrijf in AdminPulse, worden beide entiteiten in HIX aangemaakt (als ze nog niet bestaan) en aan elkaar gelinkt.
   • Hetzelfde geldt voor een eenmanszaak die je koppelt aan een bedrijf: de gebruiker van de eenmanszaak wordt gekoppeld aan het bedrijf.
   • Ook als je een persoon koppelt aan een eenmanszaak, wordt de persoon gekoppeld aan het bedrijf van de eenmanszaak.

Mapping

Voor Bedrijven :

AdminPulse	HIX
Naam	Naam
Adres	Adres
Kvk nummer	KvK-nummer(*)
Unieke ID code	Interne klant ID
Btw-identificatienummer	BTW-nummer(*)
BTW / Omzetbelasting nr	Fiscaal nummer(*)
Loonheffingen nr	Loonheffingenummer(*)
BSN nr.	Bsn nummer(*)
e-mail	Scan & Herken e-mail (inkoop)
e-mail	Scan & Herken e-mail (verkoop)

(*) dit zijn identifiers in HIX.

Als het loon heffingen nummer is ingevuld, moet het correcte formaat zijn om de sync te kunnen laten werken: 'xxxxxxxxx'  of 'xxxxxxxxxLxx', waarbij de x cijfers zijn.

Voor gebruikers: 

AdminPulse	HIX
Voornaam*	samengevoegd tot naam
Tussenvoegsel	samengevoegd tot naam
Achternaam*	samengevoegd tot naam
e-mail*	E-mail
e-mail	Gebruikersnaam
mobiel	Mobiel nummer

De gebruiker zal aangemaakt worden als klantgebruiker en gelinkt aan de groep waarvan het id is ingevuld op de connect-pagina. De groep kan niet meer aangepast worden via de API, dat kan enkel in de HIX omgeving.

Indien op de connect-pagina de vlag aanstaat om een e-mail te versturen, zal bij aanmaken van een gebruiker, een e-mail verstuurd worden. 

Deeplink vanuit AdminPulse

Indien de relatie vanuit AdminPulse is gesynct, ga je vanuit de externe links meteen naar de juiste relatie in HIX doorgestuurd worden. 

Het icoon hier gaat achterliggend de juiste URL opbouwen en deze openen in een nieuw tabblad.

Voorbeeld van de link: 

https:// jouw subdomain .hixportal.com/manage/companies/ HIXID /overview