MCP · Bol.com finance
Nur Finance-Rollen
Bol.com-Rechnungen und Gebühren in ChatGPT und Claude
Der MCP-Server von Marktspan gibt ChatGPT, Claude und Cursor Lesezugriff auf Ihre Bol.com-Rechnungszeilen: Provision, LVB Pick & Pack, Versand, Werbung und Retourenkosten pro Bestellung und EAN. Finance stimmt Bol-Gebühren in normaler Sprache ab. Zugriff nur für Finance- und Admin-Rollen.
MCP server URL
https://marktspan.com/api/mcp
What is in the Bol finance data
Marktspan syncs Bol invoices and their specifications from the Retailer API, removes subtotal rows, and classifies every line, so the assistant gets clean transactions instead of raw PDFs.
- Section per line: sales, returns, or cost — with revenue sign-normalized to positive.
- Cost group: commission, fulfillment (LVB pick & pack), shipping, advertising, returns handling, or other.
- Order reference and EAN on every line, so charges tie back to a specific order and product.
- Net excl. VAT, VAT, and gross incl. VAT, with VAT rates resolved per product and country.
Questions finance teams ask
The assistant filters lines by EAN, order, or subject and summarizes them. For period totals it switches to the governed P&L metrics, so sums match the report.
- “What did Bol charge in commission and pick & pack on this EAN in September?”
- “Show every invoice line for order 1234567890, including corrections.”
- “Which products had return-handling charges above €50 last month?”
- “Does net margin on Bol NL this quarter match the P&L report?”
Governed by role
Invoice lines and net profit are finance-confidential. Workspace owners, admins, and users flagged as finance see them; other roles get commercial metrics only. Every tool is read-only and scoped to the workspace you signed in to.
Same numbers as the P&L
Finance lines feed the Marktspan P&L. The assistant reads the same cleaned data, so the chat answer and the report do not drift apart.
Finance tools on the Bol MCP server
Your AI chooses the tool. Row lookups return up to 500 lines per call; totals always come from the P&L metrics, not from summing rows.
| Tool | Plan | What you get | Try asking… |
|---|---|---|---|
| query_viz · bol_finance_report_lines | Start+ · finance role | One row per Bol invoice line: date, sales / returns / cost, cost group, EAN, order reference, amounts excl. and incl. VAT. | List every Bol charge on order 1234567890. |
| query_metric · net_profit | Start+ · finance role | Net profit and margin per period, shop, or EAN — the same totals as the in-app P&L. | Net margin on Bol NL per month this year. |
| query_report · pnl_report | Start+ | The P&L report as shown in the app, including fee and cost lines for a date range. | Give me the Bol BE P&L for Q3 with fee lines. |
| get_bol_unit_economics | Start+ | Commission, LVB fees, VAT, and estimated net margin for a price and category. | What margin is left at €29.95 in Sport with LVB? |
Finance workflows
Month-end fee check
Ask for commission and fulfillment charges per EAN for the month, then compare against the expected commission rate per category before you close the books.
Order-level dispute
A customer return looks double-charged. Ask for every invoice line on the order reference, see the correction lines, and decide whether to open a case with Bol.
FAQ
- Kann der MCP-Server Bol.com-Rechnungen lesen?
- Ja. Marktspan synchronisiert Bol-Rechnungen und Spezifikationen und stellt die bereinigten Zeilen Finance- und Admin-Rollen per MCP bereit.
- Wer sieht Finanzdaten in ChatGPT oder Claude?
- Owner, Admins und als Finance markierte Nutzer. Andere Rollen nicht.
Bol-Gebühren im Assistenten abstimmen, den Sie schon nutzen
Wir gehen es mit Ihrem Finance-Team auf Ihrer Workspace durch.