Twinfield koppelen aan APIcenter

Je koppelt Twinfield aan APIcenter door de verbinding in te richten en de code van je administratie in te vullen. Je doet dit één keer. Daarna gebruik je Twinfield in al je integraties.

Hoe Twinfield toegang geeft

Twinfield gebruikt OAuth 2.0 en OpenID Connect. Met een toegangstoken krijgt APIcenter toegang tot je Twinfield-administratie. APIcenter stuurt het toegangstoken bij elk verzoek mee in de header van het bericht. Het token is een tijdelijke sleutel: bij de autorisatiecode-flow van Twinfield is een toegangstoken 1 uur geldig en kan een vernieuwingstoken (refresh token) een nieuw toegangstoken geven.

Twinfield vraagt naast het toegangstoken altijd de code van de administratie in de header. Die vul je zelf in bij de instelling Company ID.

Wat je nodig hebt

• Een Twinfield-gebruiker die in Twinfield mag inloggen en bij de administratie kan waarmee je wilt koppelen.
• De code van de administratie, zoals Twinfield die gebruikt.
• De gegevens die APIcenter vraagt als je Twinfield koppelt.

Twinfield beschrijft zijn eigen API en inloggen in de documentatie van de Twinfield API.

Zo koppel je Twinfield

1. Ga in APIcenter naar Applicaties en kies Nieuwe applicatie koppelen, of doe dit in stap 2 van de wizard, Verbind je apps. Kies Twinfield.
2. Vul de velden in die APIcenter voor Twinfield toont. Vul bij Company ID de code van je administratie in.
3. Laat Cluster leeg, tenzij je de waarde zeker weet. APIcenter vult de waarde zelf in als die leeg is. Zie hieronder.
4. Sla de verbinding op en klik op Testverbinding. Zie je "Verbinding is goed!", dan is Twinfield klaar voor gebruik.

De algemene stappen staan in Een nieuwe applicatie koppelen en Een applicatie bewerken.

De cluster

Twinfield draait op meerdere clusters. De cluster bepaalt het adres waar APIcenter Twinfield aanroept. Als Cluster leeg is, vraagt APIcenter Twinfield om het adres van de cluster van je administratie en slaat APIcenter de naam van de cluster zelf op. Je hoeft dit dus niet zelf uit te zoeken.

Wat de test controleert

Testverbinding vraagt aan Twinfield de lijst met administraties (offices) op. Krijgt APIcenter geen administratie terug, dan is de test mislukt. Controleer dan het inloggen en de rechten van de gebruiker in Twinfield.

Als het niet lukt

Zie Twinfield: veelvoorkomende fouten en Verbinding of inloggen mislukt.

Volgende stappen

Maak een integratie met Twinfield en controleer de instellingen. Zie Twinfield verbindings- en integratie-instellingen.