Voor AI-assistenten

WyslijList.pl print en post fysieke brieven. Een assistent kan dat hele proces zelf doorlopen: prijs opvragen, het document aanleveren, de bestelling klaarzetten en de status volgen. Alleen het betalen doet de klant, via een link die je hem geeft.

MCP-server

Voeg deze URL toe als connector. Er is geen sleutel of account nodig.

https://www.wyslijlist.pl/api/mcp

Vijf tools: landen, prijs, document, bestellen en status. De eerste, tweede en laatste zijn alleen-lezen; bestellen is als onomkeerbaar gemarkeerd, want er gaat een echte brief de deur uit.

Of gewoon HTTP

Spreek je geen MCP, dan werkt dit net zo goed. Drie aanroepen, JSON in en uit.

# 1 — document aanleveren (base64 of een publieke https-URL)
POST https://www.wyslijlist.pl/api/document
{ "fileUrl": "https://…/brief.pdf" }
→ { "pdfUrl": "…", "pages": 2 }

# 2 — prijs opvragen
POST https://www.wyslijlist.pl/api/prijs
{ "pages": 2, "land": "Duitsland", "kleur": false,
  "dubbelzijdig": false, "aangetekend": false }
→ { "total": 3.05, "currency": "EUR" }

# 3 — bestelling aanmaken; de klant betaalt de link
POST https://www.wyslijlist.pl/api/checkout
{ "ontvanger": { "naam": "…", "adres": "…", "postcode": "…",
                 "woonplaats": "…", "land": "Duitsland" },
  "opties": { "kleur": false, "dubbelzijdig": false, "aangetekend": false },
  "paginas": 2, "email": "klant@…", "pdfUrl": "…",
  "idempotencyKey": "<uniek per bestelling, min. 16 tekens>" }
→ { "url": "https://checkout.stripe.com/…" }

# volgen
GET https://www.wyslijlist.pl/api/status?s=<session_id>

Drie dingen om te weten

Betalen doet de mens. Wij geven een betaallink terug en verder niets. Dat is geen tijdelijke oplossing: binnen de EU gelden de regels voor sterke klantauthenticatie ook wanneer een assistent namens iemand bestelt. Laat de klant de link openen en afrekenen; tot dat moment gebeurt er niets.

Stuur dezelfde idempotencyKey bij opnieuw proberen. Weet je niet zeker of je verzoek aankwam, gebruik dan dezelfde sleutel. Je krijgt dan dezelfde bestelling terug in plaats van een tweede brief. Verzin er één per bestelling, minstens zestien tekens en niet te raden — een UUID is prima. Kortere sleutels negeren we.

Niet elk land kent aangetekend. Vraag landen op voordat je het aanbiedt. In Duitsland bestaat het wel maar zonder handtekening bij ontvangst — dat is iets om tegen de klant te zeggen.

Werkt er iets niet zoals hier beschreven? Mail support@briefverzenden.nl.