MCP · Bol.com finance
Alleen finance-rollen
Bol.com-facturen en kosten in ChatGPT en Claude
De MCP-server van Marktspan geeft ChatGPT, Claude en Cursor leestoegang tot je Bol.com-factuurregels: commissie, LVB pick & pack, verzending, advertenties en retourkosten per order en EAN, plus correcties op verkoop en retouren. Finance stemt Bol-kosten af in gewone taal in plaats van factuurspecificaties in Excel te openen. Toegang alleen voor finance- en admin-rollen.
MCP server-URL
https://marktspan.com/api/mcp
Wat er in de Bol-financiële data zit
Marktspan synchroniseert Bol-facturen en specificaties via de Retailer API, verwijdert subtotaalregels en classificeert elke regel, zodat de assistent schone transacties krijgt in plaats van PDF's.
- Sectie per regel: verkoop, retour of kosten — omzet altijd positief.
- Kostengroep: commissie, fulfilment (LVB pick & pack), verzending, advertenties, retourafhandeling of overig.
- Orderreferentie en EAN op elke regel, zodat kosten terug te leiden zijn naar order en product.
- Netto excl. btw, btw en bruto incl. btw, met btw-tarieven per product en land.
Vragen die finance stelt
De assistent filtert regels op EAN, order of omschrijving en vat ze samen. Voor periodetotalen schakelt hij over naar de P&L-metrics, zodat sommen kloppen met het rapport.
- “Hoeveel commissie en pick & pack rekende Bol in september op deze EAN?”
- “Toon alle factuurregels voor order 1234567890, inclusief correcties.”
- “Welke producten hadden vorige maand meer dan €50 aan retourkosten?”
- “Klopt de nettomarge op Bol NL dit kwartaal met het P&L-rapport?”
Afgeschermd per rol
Factuurregels en nettowinst zijn finance-vertrouwelijk. Owners, admins en gebruikers met de finance-vlag zien ze; andere rollen krijgen alleen commerciële metrics. Elke tool is read-only en beperkt tot de workspace waarin je bent ingelogd.
Dezelfde cijfers als de P&L
Factuurregels voeden de Marktspan P&L. De assistent leest dezelfde opgeschoonde data, dus chat en rapport lopen niet uiteen.
Finance-tools op de Bol MCP-server
Je AI kiest de tool. Regelopvragingen geven maximaal 500 regels per call; totalen komen altijd uit de P&L-metrics.
| Tool | Plan | Wat je krijgt | Probeer te vragen… |
|---|---|---|---|
| query_viz · bol_finance_report_lines | Start+ · finance-rol | Eén regel per Bol-factuurregel: datum, verkoop / retour / kosten, kostengroep, EAN, orderreferentie, bedragen excl. en incl. btw. | Toon alle Bol-kosten op order 1234567890. |
| query_metric · net_profit | Start+ · finance-rol | Nettowinst en marge per periode, shop of EAN — dezelfde totalen als de P&L in de app. | Nettomarge op Bol NL per maand dit jaar. |
| query_report · pnl_report | Start+ | Het P&L-rapport zoals in de app, inclusief kostenregels voor een periode. | Geef de Bol BE P&L voor Q3 met kostenregels. |
| get_bol_unit_economics | Start+ | Commissie, LVB-kosten, btw en geschatte nettomarge voor een prijs en categorie. | Welke marge blijft over bij €29,95 in Sport met LVB? |
Finance-workflows
Kostencheck bij maandafsluiting
Vraag commissie en fulfilmentkosten per EAN voor de maand op en vergelijk met het verwachte commissietarief per categorie voordat je de boeken sluit.
Discussie op orderniveau
Een retour lijkt dubbel belast. Vraag alle factuurregels op de orderreferentie op, bekijk de correctieregels en beslis of je een case bij Bol opent.
FAQ
- Kan de MCP-server Bol.com-facturen lezen?
- Ja. Marktspan synchroniseert Bol-facturen en specificaties en ontsluit de opgeschoonde regels via MCP voor finance- en admin-rollen.
- Welke Bol-kosten zitten erin?
- Commissie, LVB pick & pack, verzending, Sponsored Products, retourafhandeling, overige kosten en correcties op verkoop en retouren.
- Wie ziet financiële data in ChatGPT of Claude?
- Owners, admins en gebruikers met de finance-vlag. Andere rollen zien geen factuurregels of nettowinst.
- Kan de assistent facturen bij Bol wijzigen of betwisten?
- Nee. Finance-tools zijn read-only. Betwisten loopt via het caseproces van Bol.
- Hoe actueel is de data?
- Bol-finance synchroniseert wekelijks, in lijn met hoe Bol facturen publiceert. Orders en ads vaker.
Stem Bol-kosten af in de assistent die je al gebruikt
We lopen het met je finance-team door op je eigen workspace.