Bexio koppelen aan APIcenter

Je koppelt Bexio aan APIcenter door APIcenter toegang te geven tot je Bexio-account. Je doet dit één keer. Daarna gebruik je Bexio in al je integraties.

Wat je nodig hebt

• Een Bexio-account. De toegang voor de API regel je in de developer portal van Bexio: developer.bexio.com. Je logt daar in met je Bexio-gegevens.
• Een Bexio-gebruiker die de gegevens mag zien en aanmaken waarmee de flows werken: contacten, artikelen, orders, facturen, offertes en leveringen. APIcenter werkt met de rechten van de gebruiker die de koppeling heeft gemaakt. Een recht dat die gebruiker in Bexio mist, geeft ook via de API geen toegang.

Hoe Bexio toegang geeft

Bexio kent twee manieren om een applicatie toegang te geven tot de API:

• Een app met Client ID en Client Secret. Je maakt in de developer portal een app aan en geeft bij Allowed redirect URL een geldige redirect-URL op. Bexio toont het Client ID en het Client Secret bij App Details. De gebruiker geeft daarna toestemming voor de rechten (scopes) die de app vraagt. Een app krijgt alleen de rechten die je bij de toestemming kiest.
• Een Personal Access Token (PAT). Je maakt een token op developer.bexio.com/pat. Een PAT heeft alle standaardrechten en dus volledige toegang tot de gegevens van je bedrijf. Een PAT is 60 dagen geldig na het aanmaken. Daarna moet je een nieuw token maken.

Gebruik voor een productieomgeving een eigen app, met een eigen Client ID en Client Secret.

Welke rechten de flows nodig hebben

Kies je een app met rechten, geef dan minimaal de rechten voor de gegevens van de flows die je gebruikt:

• Contacten (contact_edit): Klanten naar Bexio sturen en Verkooporders naar Bexio sturen, want beide maken contacten aan.
• Artikelen (article_edit): Producten naar Bexio sturen. Voor het ophalen van producten en voorraad is article_show genoeg.
• Orders (kb_order_edit), facturen (kb_invoice_edit), offertes (kb_offer_edit) en leveringen (kb_delivery_edit): Verkooporders naar Bexio sturen, afhankelijk van hoe je orders verstuurt.

Bexio geeft leesrechten automatisch als je het schrijfrecht van dezelfde gegevens geeft. De volledige lijst staat in de documentatie van de Bexio API.

Zo koppel je Bexio

1. Ga in APIcenter naar Applicaties en kies Nieuwe applicatie koppelen, of doe dit in stap 2 van de wizard, Verbind je apps. Kies Bexio.
2. Vul een Weergavenaam in, bijvoorbeeld de naam van je bedrijf, en vul de gegevens in die APIcenter vraagt.
3. Klik op Opslaan. Vraagt APIcenter om toestemming bij Bexio, klik dan op Autoriseren, log in bij Bexio en geef toestemming.
4. Klik op Testverbinding. Zie je "Verbinding is goed!", dan is Bexio klaar voor gebruik.

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

Toegang intrekken of vernieuwen

Je trekt een Personal Access Token in door hem te verwijderen op developer.bexio.com/pat. Dat kan tot een uur duren voordat het volledig werkt. Is een token verlopen of ingetrokken, dan werkt de koppeling niet meer. Maak dan een nieuw token en vul dat in bij de Bexio-verbinding in APIcenter.

Als het niet lukt

Zie Bexio: veelvoorkomende fouten en Verbinding of inloggen mislukt.

Volgende stappen

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