Naar inhoud springen
Overzicht Overzicht Nieuws Nieuws
Delen

Cookbook

Prompts om te kopiëren. Kant-en-klare API-voorbeelden.

28 prompts voor Document AI, Data APIs en IDE-workflows — kopiëren, plakken, code krijgen.

De PaperOffice llms.txt leest elk modern LLM: Claude, Cursor en uw IDE schrijven de rest.

28 kant-en-klare prompts Echte eindpunten REST en MCP

Integratie

Van llms.txt naar lopende integratie

Drie stappen: documentatie koppelen, intentie aangeven, code overnemen.

  1. Voeg llms.txt in

    Plak in Claude, Cursor of uw IDE.

  2. Doel aangeven

    Wat er gebouwd moet worden — of een prompt vanaf deze pagina.

  3. Code laten schrijven

    De IDE levert de lopende integratie.

Document AI

Documenten lezen, controleren, verzenden

Prompt kopiëren, invoegen in Claude of Cursor — klaar.

IDP Factuur + AI-OCR + Bounding Boxes

Factuurgegevens extraheren inclusief positie in het document.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build me an invoice extractor that:
1. Uploads a PDF via POST /job/add/workflow (multipart, field file_1)
2. Uses idp_collection=invoice, processing_lane=instant (sync)
3. Reads every field from result.pages_idp[0].suggested_fields
   (keys like _supplier_name, _total_amount, _invoice_date)
   and the boxes from result.pages_aiocr.pages
4. Renders a verification view highlighting each value
   at its bounding box position

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

AI-OCR — Tekst uit afbeelding/PDF

Volledige tekst via POST /job/add/paperoffice_aiocr___generate (ocr_mode=complete).

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Write a minimal script that:
1. Sends an image or PDF to POST /job/add/paperoffice_aiocr___generate
   (multipart, field file_1)
2. Uses ocr_mode=complete and processing_lane=instant (sync)
3. Prints the extracted text from result ?? job_result (pages)

Modes: complete (+tables), grid (+bounding boxes), text (plain).
Auth: Authorization: Bearer po_ut_YOUR_API_KEY

AI PDF splitsen — Verzamel-PDF scheiden

Documentgrenzen detecteren en individuele bestanden benoemen.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a splitter for large batch PDFs (up to 3000 pages):
1. POST /job/add/workflow with template=pdf_ai_split (multipart, field file)
2. naming_instruction=Dokumenttyp_Datum_Absender,
   locale=de_DE, processing_lane=instant
3. List every created document from the result
   (suggested filename + page range)

The AI detects document boundaries automatically.
Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Document Anonimiseren — PII verbergen

Namen, IBAN, adressen detecteren en redigeren.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt
Also use llms-full.txt for anonymize parameters (scenario, apply).

Build a GDPR anonymizer (preview → apply):
1. POST /job/add/workflow template=document_anonymize_preview (field file)
2. Set scenario=gdpr_auskunft (or externe_weitergabe / finanzdaten),
   redact_categories=all, optional whitelist / custom_redact
3. client_wait=false then poll GET /job/get/{job_id}
4. Show detected_pii.redact_box_ids + simplified_boxes
5. Apply: POST /job/add/paperoffice_dataripper___redact_image
   with files + bounding_boxes + redact_boxes from the preview
   (or MCP: po_anonymization_pii_detect → po_anonymization_redaction_apply
   with preview_job_id)
Optional one-shot: REST template=document_anonymize OR MCP po_anonymization_anonymize
  (no HITL; pass scenario/whitelist).
Redact Agent: POST /documents/redact-agent-run or MCP po_documents_redact_agent_run.

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Stem TTS — Tekst naar audio

Synchron MP3 via voice=Nadja (o.a.).

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a text-to-speech generator:
1. POST /job/add/paperoffice_voice___tts with text=..., voice=Nadja,
   output_format=mp3
2. output=url and processing_lane=instant for a synchronous audio link
3. Play or download the audio URL from result ?? job_result

Voices: Nadja, Thomas, Anna, Hans (DE) + 100+ more.
Auth: Authorization: Bearer po_ut_YOUR_API_KEY

IDP-contract + AI-OCR + Bounding Boxes

Contractvelden extraheren inclusief positie in het document.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a contract extractor that:
1. Uploads a PDF via POST /job/add/workflow (multipart, field file_1)
2. Uses idp_collection=contract, processing_lane=instant (sync)
3. Reads parties, dates and notice period from
   result.pages_idp[0].suggested_fields (value + bounding box)
4. Renders a verification view with bounding boxes

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

E-Signatuur — Signauraanvraag aanmaken

Ontvangers uitnodigen en status/herinnering beheren.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build an e-signature request flow:
1. Ensure the document has a pofid in PaperOffice
2. POST /signatures/create with document_pofid (or pofid)
   and a signers array (name + email per signer)
3. Return the signature request id and status
4. Optionally POST /signatures/remind for pending signers

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Digitiek aangetekend — Per e-mail verzenden

Veilige levering met PDF-wachtwoord (e-mail of sms) en verzendprofiel.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a secure document delivery (digital registered mail):
1. POST /document_delivery/create_and_send with:
   pofids: ["POFID_HERE"],
   recipient_email, optional recipient_name,
   subject, optional message
2. security_mode=link → PDF password in the same email
   security_mode=secure_sms → link by email, password by SMS
   (requires recipient_phone in E.164, e.g. +49170…)
3. Show delivery_id and that access events are logged
   (Versandhistorie / delivery log)

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Data & Security APIs

Locatie, risico en mastergegevens controleren

Geocoding, weer, fingerprint, BTW-identificatienummer en meer — als prompt.

Geocoding — Voorwaarts / Omgekeerd / Autocomplete

Adres ↔ Coördinaten.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a geocoding helper that:
1. Forward: GET /geocoding/forward?q=...&lang=de
2. Reverse: GET /geocoding/reverse?lat=...&lon=...
3. Autocomplete: GET /geocoding/autocomplete?q=...
4. Prints display_name, lat, lon and credits_billed

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Weer — Huidig + Luchtkwaliteit

Huidig weer inclusief facturering.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a weather lookup that:
1. Calls GET /weather/current?lat=...&lon=...&lang=de
2. Shows temperature, condition text and air quality if present
3. Displays credits_billed from the response

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

IP2Location — IP → Locatie

Locatie op basis van IP, optioneel weer.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build an IP intelligence client that:
1. Calls GET /ip2location/full (empty ip = visitor IP)
2. Extracts country, city, geo_lat/lon, ISP
3. Optionally chains weather from the same response

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Device Fingerprint — Bezoekers-ID

Bezoekers-ID en betrouwbaarheid.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a device fingerprint check that:
1. Collects client signals in the browser
2. POSTs to /fingerprint/identify
3. Returns visitor_id / confidence for fraud checks

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Fake Email Detector — Controle op wegwerpadressen

Wegwerpe-mail en risicoscore.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build an email risk checker that:
1. Validates an address via the Fake Email Detector endpoint
2. Flags disposable / role / invalid domains
3. Returns a clear allow/deny recommendation

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

VPN / Anonimiteitcontrole

vpn, proxy, tor, datacenter.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a VPN/proxy detector that:
1. Calls GET /ip2location/vpn?ip=...
2. Normalizes is_vpn, is_proxy, is_tor, is_datacenter flags
3. Shows a clear risk badge for the visitor

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

BTW-valideraar — EU-BTW-ID-nr.

Geldigheid en bedrijfsgegevens.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a VAT ID validator that:
1. Checks an EU VAT number via the VAT validator endpoint
2. Returns company name and address when valid
3. Handles invalid / not-found responses cleanly

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Valuta wisselen — Live koersen

Omrekenen met actuele koers.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a currency converter that:
1. Calls the currency exchange endpoint (from, to, amount)
2. Shows rate and converted amount
3. Caches the last rate for the UI

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

IDE & AI-tools

Voor Claude, Cursor en uw IDE

Prompts die in de IDE werken — inclusief MCP-server.

IDP Factuur Pipeline + Bounding Boxes + CSV

Batch-extractie met verificatie-coördinaten.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Create a Python script that:
1. Takes a folder of invoice PDFs
2. Extracts all fields using POST /job/add/workflow with idp_collection=invoice
3. Returns bounding boxes for verification (result.pages_aiocr)
4. Exports to CSV

Important: Use file_1 for uploads; fields live in result.pages_idp[0].suggested_fields.
Handle sync (HTTP 200 with result) and async (HTTP 202 → poll GET /job/get/{job_id}).
Auth: Authorization: Bearer po_ut_YOUR_API_KEY

MCP-server — Document AI in de IDE

MCP verbinden en documenten uit de workspace verwerken.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Help me set up the MCP Server for PaperOffice in Cursor.
I want to use Document AI directly in my IDE.

Show me:
1. How to configure the MCP connection (URL https://mcp.paperoffice.ai/cursor)
2. Available tools via tools/list
3. How to process documents from my workspace

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Stemagent — STT + TTS

Taalinput verwerken en audioantwoorden genereren.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Create a voice agent that:
1. Takes audio input (Speech-to-Text)
2. Processes the text
3. Generates audio response (Text-to-Speech)

Use these pipelines:
- STT: POST /job/add/paperoffice_voice___stt (audio_file)
- TTS: POST /job/add/paperoffice_voice___tts (text, voice=Nadja,
  output_format=mp3, output=url)
- Use processing_lane=instant for a synchronous response.
Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Fraudedetectie — Vingerafdruk + IP

Apparaatvingerafdruk en geo/IP-signalen controleren.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a fraud detection system that:
1. Checks device fingerprints
2. Validates IP geolocation
3. Detects suspicious patterns

Use the Security & Data AI endpoints.
These are instant APIs (no polling needed).
Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Batch AI PDF-splitsing

Map met grote PDF's asynchroon splitsen.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Create a batch processor that:
1. Takes a folder of large PDFs (up to 3000 pages each)
2. Uses POST /job/add/workflow with template=pdf_ai_split
3. Uses naming_instruction for smart filenames
4. Handles async jobs (HTTP 202) by polling GET /job/get/{job_id}

Use locale=de_DE for German document types.
Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Documentclassificator — OCR + Map

OCR, classificeren en sorteren in submappen.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a document classifier that:
1. Watches a folder for new PDFs
2. Uses OCR (POST /job/add/paperoffice_aiocr___generate, ocr_mode=complete)
   to extract text
3. Classifies into: invoice, contract, receipt, correspondence
4. Moves files to category subfolders
5. Logs results to classification_log.csv

Authenticate with: Authorization: Bearer po_ut_YOUR_API_KEY.
processing_lane=instant for a synchronous response.

End-to-end

Volledige pipelines

Van ontvangst tot export — elke stap in dezelfde prompt.

IDP Facturen → Boekhoudingsexport

PDF-upload → AI-IDP + bounding boxes → Validatie → CSV-export

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build an accounts-payable pipeline:
1. Watch a folder for incoming invoice PDFs
2. Extract fields via POST /job/add/workflow (file_1,
   idp_collection=invoice, processing_lane=instant)
3. Flag every field with confidence < 0.9 for manual review,
   including its bounding box for the verification UI
   (result.pages_idp[0].suggested_fields + result.pages_aiocr)
4. Export supplier, total, date and IBAN as CSV for the accounting import

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

IDP Contracten + Fristenalerts

Contractupload → Sleutelbegrippen → Knowledge Graph → Waarschuwingen

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a contract analyzer:
1. Upload contracts via POST /job/add/workflow (file_1,
   idp_collection=contract, processing_lane=instant)
2. Extract parties, start date, end date and notice period
   from result.pages_idp[0].suggested_fields (each with a bounding box)
3. Store the key terms in a knowledge graph
4. Alert me 90 days before a notice period expires

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

PDF Converter — Word / PowerPoint / PDF/A

PDF-upload → Formaat kiezen → Converteren → Downloaden

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a PDF converter service:
1. One pipeline per target format (field file_1):
   POST /job/add/pdfstudio___pdf_to_word | pdfstudio___pdf_to_powerpoint |
   pdfstudio___pdf_to_pdfa | pdfstudio___pdf_to_webp
2. processing_lane=instant for a synchronous response
3. Return the download URL from result ?? job_result

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Webhooks — job.completed verwerken

Webhook registreren → Document verzenden → Event ontvangen → Verwerken

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a webhook event handler:
1. Register a webhook via POST /webhooks/subscribe
   (url, events: ["job.completed", "job.failed"], secret)
2. Verify the HMAC-SHA256 signature of every delivery
   with the subscription secret (see llms-full.txt, webhooks)
3. Process the payload whenever job.completed arrives

Note: webhooks always require a token (account binding).
Auth: Authorization: Bearer po_ut_YOUR_API_KEY

OCR → TTS — Document naar Audio

Document OCR → Tekst verwerken → TTS genereren → Audio opslaan

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a document-to-audio pipeline:
1. OCR via POST /job/add/paperoffice_aiocr___generate
   (file_1, ocr_mode=complete, processing_lane=instant)
2. Split the extracted text (result ?? job_result, pages) into 5000-character chunks
3. TTS per chunk: POST /job/add/paperoffice_voice___tts (text, voice=Nadja,
   output_format=mp3, output=url, processing_lane=instant)
4. Save all returned audio URLs as a playlist

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Batch OCR → CSV-export

Map scannen → Batch OCR → Tekst verzamelen → CSV-export

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a batch OCR-to-CSV exporter:
1. Scan a folder for PDF/PNG/JPG/TIFF/WEBP files
2. For each file: POST /job/add/paperoffice_aiocr___generate
   (file_1, ocr_mode=complete, processing_lane=instant)
3. Collect filename, page_count, text preview and confidence
4. Write everything to ocr_results.csv

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Volgende stap

Doorgaan met API

llms.txt en Playground — zonder omwegen.

Een token voor REST en MCP Antwoord met credits_billed Eigen EU-infrastructuur
Video

Cookbook in actie

Zie hoe de PaperOffice API in de praktijk werkt — in de video.

Cookbook in actie

Veelgestelde vragen

Alles belangrijk op een rij

Heb ik een SDK nodig?

Nee. De PaperOffice API is puur REST: één endpoint, één Bearer-token, multipart/form-data. Voor IDEs en agents staat bovendien de MCP-server beschikbaar.

Waarom staat de llms.txt in elke prompt?

De llms.txt is de machineleesbare versie van de API-documentatie. Uw model leest hieruit endpoints, parameters en antwoordformaten — en verzonnen geen velden.

Welke key voer ik in?

Een User Token met het voorvoegsel po_ut_. U vindt deze in de PaperOffice App onder Account → API. Vervang po_ut_YOUR_API_KEY in de prompt door uw eigen key.

Komt het resultaat direct of moet ik polleren?

Met processing_lane=instant antwoordt de API synchroon (HTTP 200 met result). Zonder deze parameter komt HTTP 202 met een job_id; het resultaat haalt u op via GET /job/get/{job_id} of per webhook.

Werken de prompts in elke omgeving?

De prompts bevatten geen tool-specifieke instructies. Getest met Claude, Claude Code en Cursor — elke omgeving die een URL kan lezen, komt hiermee uit de voeten.

Wat kost een aanroep?

Elk antwoord noemt credits_billed. De credit-prijzen per pipeline staan in de prijsopzet; er wordt alleen gefactureerd wat daadwerkelijk is verwerkt.

Waar wilt u PaperOffice testen?

Computer en smartphone zijn verbonden: workspace op de computer, vastleggen op de telefoon.

Uw proefversie is klaar

Waar wilt u beginnen?

De volledige workspace is geoptimaliseerd voor de computer. De mobiele versie is geschikt voor het vastleggen, controleren en goedkeuren van documenten.

app.paperoffice.ai

Start op de computer

We sturen uw persoonlijke toegangslink naar uw e-mailadres.

Gratis registreren App openen PaperOffice-app Het volledige product: web, desktop en mobiel. Documenten vastleggen, organiseren, zoeken en bewerken met het team. Gratis account vereist Playground openen Playground Probeer geselecteerde functies direct — zonder registratie, met een beperkte demo-API-sleutel. Wel een beperkte demo-API-sleutel