Saltar al contenido
Resumen Resumen Noticias Noticias
Compartir

Cookbook

Prompts para copiar. Ejemplos listos de API.

28 prompts para Document AI, Data APIs y flujos de trabajo IDE — copiar, pegar, obtener código.

El llms.txt de PaperOffice lo lee cualquier LLM moderno: Claude, Cursor y su IDE escriben el resto.

28 prompts listos Puntos finales reales REST y MCP

Integración

De llms.txt a integración continua

Tres pasos: vincular documentación, indicar intención, copiar código.

  1. Insertar llms.txt

    Insertar en Claude, Cursor o su IDE.

  2. Indicar intención

    Qué se debe construir o un prompt desde esta página.

  3. Generar código

    El IDE proporciona la integración continua.

Document AI

Leer, verificar y enviar documentos

Copiar el prompt, pegarlo en Claude o Cursor — listo.

IDP Factura + AI-OCR + Cajas delimitadoras

Extraer campos de la factura incluyendo la posición en el documento.

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 — Texto de imagen/PDF

Texto completo mediante 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

División de PDF con IA — Separar PDF combinado

Detectar límites de documentos y nombrar los archivos individuales.

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

Anonimización de Documentos — Enmascarar PII

Detectar y editar nombres, IBANs y direcciones.

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

Voz TTS — Texto a Audio

MP3 síncrono mediante voice=Nadja (entre otros).

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 Contrato + AI-OCR + Cajas delimitadoras

Extraer campos del contrato incluyendo su posición en el documento.

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

Firma Electrónica — Crear solicitud de firma

Invitar firmantes y controlar estado/recordatorios.

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

Carta certificada digital — Enviar por correo electrónico

Entrega segura con contraseña PDF (correo electrónico o SMS) y registro de envío.

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

Datos y Seguridad APIs

Verificar ubicación, riesgo y datos maestros

Geocodificación, clima, huella digital, NIF/VAT y más — como prompt.

Geocodificación — Directa / Inversa / Autocompletado

Dirección ↔ Coordenadas.

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

Clima — Actual + Calidad del aire

Clima actual incluido facturación.

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 → Ubicación

Ubicación desde IP, opcionalmente Clima.

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

Huella Digital del Dispositivo — ID de Visitante

ID de Visitante y Confianza.

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

Detector de Correos Falsos — Verificación Desechable

Correo Desechable y Puntuación de Riesgo.

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

Verificación de VPN / Anonimato

VPN, Proxy, Tor, Centro de Datos.

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

Validador de IVA — ID de IVA de la UE

Validez y Datos de la Empresa.

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

Intercambio de divisas — Tipos de cambio en vivo

Conversión con tipo de cambio actual.

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 y herramientas de IA

Para Claude, Cursor y su IDE

Prompts que funcionan en el IDE — incluido el servidor MCP.

Pipeline de facturas IDP + Cajas delimitadoras + CSV

Extracción por lotes con coordenadas de verificación.

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

Servidor MCP — Document AI en el IDE

Conectar MCP y procesar documentos desde el espacio de trabajo.

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

Agente de voz — STT + TTS

Procesar la entrada de voz y generar respuestas de audio.

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

Detección de Fraude — Huella digital + IP

Verificar la huella del dispositivo y las señales Geo/IP.

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

División por lotes de PDF con IA

Dividir asíncronamente carpetas con archivos PDF grandes.

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

Clasificador de Documentos — OCR + Carpetas

OCR, clasificar y organizar en subcarpetas.

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.

De extremo a extremo

Pipelines completas

Desde la entrada hasta la exportación — cada etapa en el mismo prompt.

IDP Facturas → Exportación Contable

Carga de PDF → AI-IDP + Cajas delimitadoras → Validación → Exportación CSV

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 Contratos + Alertas de Plazos

Carga del contrato → Términos clave → Knowledge Graph → Notificaciones

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

Convertidor de PDF — Word / PowerPoint / PDF/A

Carga de PDF → Seleccionar formato → Conversión → Descarga

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 — procesar job.completed

Registrar webhook → Enviar documento → Recibir evento → Procesar

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 — Documento a audio

OCR del documento → Preparar texto → Generar TTS → Guardar audio

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

OCR por lotes → Exportación a CSV

Escanear carpeta → OCR por lotes → Recopilar texto → Exportar a CSV

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

Siguiente paso

Continuar con API

llms.txt y Playground — sin desvíos.

Un token para REST y MCP Respuesta con credits_billed Infraestructura propia en la UE
Vídeo

Cookbook en acción

Vea cómo funciona la PaperOffice API en la práctica — en el vídeo.

Cookbook en acción

Preguntas frecuentes

Todo lo importante a primera vista

¿Necesito un SDK?

No. La PaperOffice API es REST puro: un punto final, un token Bearer, multipart/form-data. Además, está disponible un servidor MCP para IDEs y agentes.

¿Por qué aparece llms.txt en cada prompt?

llms.txt es la versión legible por máquina de la documentación API. Su modelo lee de ella los endpoints, parámetros y formatos de respuesta; no inventa campos.

¿Qué clave debo introducir?

Un User Token con el prefijo po_ut_. Lo encontrará en la aplicación PaperOffice en Cuenta → API. Reemplace po_ut_YOUR_API_KEY en el prompt por su propia clave.

¿El resultado llega inmediatamente o debo hacer polling?

Con processing_lane=instant, API responde de forma sincrónica (HTTP 200 con result). Sin este parámetro se devuelve HTTP 202 con una job_id; puede obtener el resultado mediante GET /job/get/{job_id} o por webhook.

¿Funcionan los prompts en cualquier entorno?

Los prompts no contienen instrucciones específicas de herramientas. Verificados con Claude, Claude Code y Cursor; cualquier entorno que pueda leer una URL se adapta a ello.

¿Cuánto cuesta una llamada?

Cada respuesta indica credits_billed. Los precios de créditos por pipeline están en el resumen de precios; solo se cobra lo que realmente se ha procesado.

¿Dónde desea probar PaperOffice?

Ordenador y smartphone conectados: espacio de trabajo en el ordenador, captura en el teléfono.

Su versión de prueba está lista

¿Dónde desea comenzar?

El espacio de trabajo completo está optimizado para el ordenador. La versión móvil es adecuada para capturar, revisar y aprobar documentos.

app.paperoffice.ai

Comenzar en el ordenador

Le enviaremos su enlace de acceso personal a su dirección de correo electrónico.

Registrarse gratis Abrir aplicación Aplicación PaperOffice El producto completo: web, escritorio y móvil. Capture, organice, busque y trabaje en documentos con su equipo. Se requiere una cuenta gratuita Abrir Playground Playground Pruebe funciones seleccionadas de inmediato — con una clave API de demostración restringida. Con una clave API de demostración restringida