Codabox API Connect Instellingen
De Codabox API Connect instellingen zijn bereikbaar via Codabox API Instellingen in Business Central.
Setupwizard
De eenvoudigste manier om de koppeling te configureren is via de ingebouwde setupwizard. De wizard doorloopt de volgende stappen:
- Welkomstscherm: korte toelichting bij de wizard.
- Authenticatiegegevens: voer het API-token, de gebruikersnaam en het wachtwoord in die u van Codabox ontvangen heeft. Activeer optioneel de sandboxomgeving voor testdoeleinden.
- Verbinding testen: de wizard test automatisch de verbinding met de Codabox API en toont het resultaat.
- Klaar: de koppeling is geconfigureerd.
De wizard is ook achteraf beschikbaar via de actie Configuratiewizard op de instellingenpagina.
Instellingenpagina
Algemeen
| Veld | Omschrijving |
|---|---|
| Actief | Geeft aan of de Codabox API-koppeling actief is. De connector is uitgeschakeld zolang dit veld niet aangevinkt is. |
| Sandbox gebruiken | Gebruik de Codabox-sandboxomgeving (https://sandbox-api.codabox.com/v2/) in plaats van de productieomgeving. Nuttig voor testdoeleinden. |
Authenticatie
| Veld | Omschrijving |
|---|---|
| Codabox Token | Het API-token dat u van Codabox ontvangen heeft. |
| Codabox Gebruikersnaam | De gebruikersnaam voor authenticatie bij de Codabox API. |
| Codabox Wachtwoord | Het wachtwoord dat bij de gebruikersnaam hoort. |
De gebruikersnaam en het wachtwoord worden versleuteld opgeslagen via Isolated Storage.
Acties
| Actie | Omschrijving |
|---|---|
| Configuratiewizard | Start de wizard voor de initiële instelling van de Codabox API-koppeling. |
| Verbinding testen | Test de verbinding met de Codabox API en toont het aantal gevonden clients. |
| Bankafschriften ophalen | Haalt alle nieuwe bankafschriften op via de Codabox API en maakt EBanking-documenten aan. |
Verwerking
De connector haalt bankafschriften op via de volgende stappen:
- Alle beschikbare clients (POD-clients) worden opgehaald via de Codabox API.
- Per client worden de beschikbare feed-items opgehaald.
- Voor elk feed-item met documenttype
codawordt het CODA-bestand gedownload. - Er wordt een EBanking-document aangemaakt van het type Bankafschrift met de CODA-processor.
- Het feed-offset wordt bijgewerkt zodat hetzelfde document niet opnieuw opgehaald wordt.
Documenten die eerder al zijn geïmporteerd (op basis van het feed-index), worden overgeslagen.