Je Bullhorn-account koppelen
Bullhorn geeft API-toegang per klant uit. Je vraagt bij Bullhorn support een API-gebruikersnaam, client ID en client secret aan, plakt die in Schakel en logt daarna één keer in bij Bullhorn. Het aanvragen duurt meestal een paar werkdagen; de rest is vijf minuten.
Wat je overhoudtEen gekoppeld Bullhorn-account in Schakel, met je plaatsingen zichtbaar voor de koppeling.
- 01
Vraag API-toegang aan bij Bullhorn
Mail Bullhorn support en vraag om REST API-toegang voor een koppeling met een boekhoudpakket. Vraag er expliciet bij om refresh tokens: zonder die staat je koppeling elke tien minuten stil. Je krijgt drie dingen terug: een API-gebruikersnaam, een client ID en een client secret. Dit is de enige stap die je niet zelf kunt doen, en de enige die tijd kost.
Of ga direct naar https://www.bullhorn.com/support/
- 02
Geef de callback door
Bullhorn vraagt naar welk adres ze je na het inloggen terug mogen sturen. Geef precies dit door: https://app.schakel.app/api/connections/bullhorn/callback. Wijkt er één teken af, dan weigert Bullhorn de aanmelding zonder uitleg.
- 03
Vul de drie gegevens in Schakel in
Ga in Schakel naar Verbindingen en vul bij Bullhorn de API-gebruikersnaam, het client ID en de client secret in. Schakel zoekt met die gebruikersnaam op welk datacenter jouw Bullhorn draait, want dat verschilt per klant. Let op: Bullhorn accepteert bij die opzoekvraag elke gebruikersnaam, dus een typefout blijkt pas bij de volgende stap.
- 04
Log één keer in bij Bullhorn
Klik daarna op Verbinden met Bullhorn, log in met de API-gebruiker en geef toestemming. Je komt terug in Schakel met de naam van je Bullhorn-omgeving erbij. Je wachtwoord komt nergens in Schakel terecht: je typt het op het scherm van Bullhorn zelf.
Goed om te weten
- Vaste plaatsingen en detachering worden verschillend gefactureerd. Een vaste plaatsing levert één keer een fee op, en die staat op de plaatsing zelf; dat werkt in elke Bullhorn. Detachering loopt via goedgekeurde uren, en die bestaan alleen als je Bullhorn Back Office (Pay & Bill) hebt. Schakel controleert bij het koppelen of je die module hebt en zet de optie uit als dat niet zo is.
- Vul in Bullhorn de fee op een vaste plaatsing goed in. Een getal onder de 1 leest Schakel als een percentage van het jaarsalaris, dus 0,2 is 20%. Een getal boven de 1 leest hij als een vast bedrag, dus 7500 is € 7.500. Staat er precies 1, dan slaat Schakel de plaatsing over en zegt waarom: dat kan allebei betekenen en geen van beide is waarschijnlijk wat je bedoelde.
- Alleen plaatsingen met de status die je in de instellingen opgeeft worden gefactureerd, standaard Approved en Completed. Een plaatsing die nog op Placed staat kan alsnog afketsen, en die factureren kost je een creditnota en een telefoontje.
- Bullhorn draait op genummerde datacenters. Schakel zoekt aan de hand van je API-gebruikersnaam op welke van jou is, dus je hoeft daar zelf niets over te weten. Verhuist Bullhorn je omgeving, dan merkt de koppeling dat vanzelf.
- Er wordt niets in Bullhorn gewijzigd. De koppeling leest plaatsingen, klanten en goedgekeurde uren, en schrijft de facturen in je boekhoudpakket. In Bullhorn blijft alles zoals het is.
Als er iets misgaat
- Het inloggen bij Bullhorn wordt geweigerd.
- Vergelijk hem letter voor letter met wat support je stuurde. Het is de API-gebruikersnaam, niet je gewone Bullhorn-login, en ook niet je e-mailadres. Je ziet dit pas bij het inloggen, niet bij het invullen: de opzoekvraag die Schakel ervoor doet accepteert elke gebruikersnaam.
- Schakel zegt dat Bullhorn geen blijvende toegang teruggaf.
- Dan staan refresh tokens uit voor jouw client ID. Mail Bullhorn support en vraag of ze die aanzetten; het is een vinkje aan hun kant. Zonder dat zou je elke tien minuten opnieuw moeten inloggen, dus Schakel slaat de koppeling liever niet half op.
- Ik word na het inloggen niet teruggestuurd naar Schakel.
- Dan staat er bij Bullhorn een ander adres geregistreerd. Vraag support om precies https://app.schakel.app/api/connections/bullhorn/callback in te stellen, zonder schuine streep aan het eind.
- De koppeling vindt geen uren om te factureren.
- Controleer of je Bullhorn Back Office hebt en of de uren daar goedgekeurd zijn. Zonder die module bestaan goedgekeurde uren niet in de API, en dan kan alleen op vaste plaatsingen gefactureerd worden. Dat staat ook in de instellingen van de koppeling.
Loop je vast op een stap?
Schermen verschuiven weleens. Ziet het er bij jou anders uit dan op de schermafbeeldingen, stuur ons dan een bericht. Dan kijken we mee en passen we de pagina aan.