AFAS - Bol.com
Technische documentatie
Redundant uitgevoerd
De middleware servers voor het APIcenter zijn redundant in meerdere datacenters.
AVG proof
Alle logs worden een maximale termijn opgeslagen en kunnen desgewenst verwijderd of niet opgeslagen worden.
Toegang tot APIcenter
Je hebt toegang tot ons APIcenter om de status van de koppeling te monitoren
Technische informatie
In deze documentatie wordt beschreven wat de koppeling tussen Bol.com en AFAS inhoudt, welke gegevens worden uitgewisseld en hoe dit tot stand komt. In de basis is de koppeling zelf een tussenlaag, welke met behulp van instellingen en parameters, verzoeken doet aan zowel AFAS als Bol.com voor bepaalde informatie. De koppeling slaat daarbij zelf geen informatie op, deze wordt alleen verwerkt, voornamelijk relevant in verband met de AVG wetgeving.
Instelling verbinding
Informatie uit AFAS verkrijgen gaat met behulp van connectoren. In de connectoren wordt bepaald welke velden worden uitgelezen om vervolgens te kunnen verzenden naar de Bol.com marktplaats. De koppeling maakt gebruik van de volgende connectoren, waarbij de connectoren met een extra suffix, kopieën zijn van standaard connectoren met extra velden:
- Profit_Article_Basic_BOL
- KnOrganisation (update)
- KnPerson (update)
- FbSales (update)
- KnSalesRelationOrg (update)
- KnSalesRelationPer (update)
Hoe deze connectoren zijn opgebouwd wordt uitgebreid besproken bij de documentatie van de verschillende functionaliteiten.
Informatie vanuit Bol.com wordt verkregen via de APIv2, door middel van keys in het klantenaccount. Op basis van een token wordt het mogelijk om verzoeken te doen voor informatie.
Zodra beide verbindingen tot stand zijn gekomen worden deze configuratie opgeslagen op het Dashboard. Dit wordt aangeduid met “APIcenter”. Deze tussenlaag verwerkt alle aanvragen of verzendingen van informatie. Afhankelijk van de gekozen oplossing zijn op het dashboard ook de overige instellingen terug te vinden.
Functionaliteiten
De koppeling bestaat uit 3 onderdelen/modules. Dit zijn;
- het exporteren van bestellingen
- het importeren van producten
- eventuele terugkoppeling voorraad en orderstatus.
Daarbij is het financiële systeem AFAS altijd leidend, met uitzondering van de bestellingen. Deze komen binnen op Bol.com.
Exporteren van Bestellingen
Zodra in Bol.com een bestelling binnenkomt wordt de bestelling naar AFAS gestuurd. Periodiek wordt er via een cronjob gecheckt of er nieuwe bestellingen zijn binnengekomen. De gemiddelde snelheid van het verwerken van bestellingen bedraagt 10 bestellingen per 15-30 minuten. Bol.com biedt alleen de mogelijkheid om open orders uit te lezen via de API, en bestellingen uit het verleden kunnen ook niet meer verwerkt worden.
- Periodieke controle op nieuwe bestellingen via een cronjob.
- Bestellingen kunnen naar AFAS gestuurd worden als verkooporder of als verkoopfactuur.
- Producten dienen in AFAS aanwezig te zijn. Match wordt gemaakt met EAN. Deze worden als orderregels toegevoegd aan de verkooporder.
- BTW instellingen worden veelal intern door AFAS geregeld.
- De klant die de bestelling plaatst wordt aan de hand van het versleutlede Bol.com emailadres gematched in AFAS. Hierin zijn ook andere mogelijkheden
- Ondersteuning voor zowel factuur- als verzendadres.
Importeren van producten:
Ook de producten worden geïmporteerd op basis van een periodiek proces. Afhankelijk van de server is de gemiddelde import snelheid rond de 250 producten per uur. De initiële import is dan ook een tijdrovend proces. Echter zodra dit voltooid is, worden alleen producten bijgewerkt die recentelijk zijn gewijzigd of recentelijk zijn toegevoegd.
| AFAS Attribuut | Bol.com attribuut | Type |
| Itemcode of EAN | EAN | Text |
| Basisverkoopprijs | Price | Numeriek (currency) |
| Voorraad | Amount | Numeriek |
| Vrij veld* | Conditie* | Tweede hands attribuut |
*Niet verplicht voor producten betiteld als nieuw.
Extra instellingen Dashboard (APIcenter)
- Bij het aanmaken van nieuwe debiteuren worden standaardvelden meegestuurd. Betaalconditie (default=14), Verzamelrekening (default=1400), administratie (default=2)