¿Existe un nodo PaperOffice para n8n?
No. No existe un nodo propio, ni credenciales listas para usar, ni plantillas publicadas. Trabaja con los nodos estándar HTTP Request, Webhook y el cliente MCP contra la API documentada REST-API y el servidor MCP.
¿Qué clave necesito?
La genera en la aplicación en Cuenta → API. Para REST utilice po_sk_ o po_ut_, para MCP po_ut_, po_gt_ u OAuth 2.1; el servidor MCP rechaza po_sk_ y po_pk_. Basta con un correo electrónico confirmado. La función API está disponible en todos los planes, también en Free.
¿Cómo sabe n8n que un documento está listo?
A través de una suscripción a Webhook, desde Professional. Suscribe document.processed con la URL de producción de su nodo Webhook. La entrega incluye pofid, workspace_id, tipo de documento, key_fields y los campos extraídos. Para trabajos iniciados por n8n mismo, consulte GET /job/get/{job_id}.
¿Qué eventos puede recibir n8n?
document.processed, document.edited, document.deleted, document.version_created, document.note_added, document.tag_added, document.comment_added, document.lifecycle_changed, document.legal_hold_placed, document.legal_hold_released, document.generated y task.completed. El final de un trabajo API se consulta mediante job/get.
¿Debe mi instancia n8n ser accesible públicamente?
Para Webhooks, sí. PaperOffice solo entrega a direcciones públicas mediante http o https y no sigue redirecciones. Las direcciones privadas, localhost y los hosts de metadatos están bloqueados. Para llamadas al servidor REST-API y MCP, n8n solo necesita acceso saliente a api.paperoffice.ai y mcp.paperoffice.ai.
¿Puedo crear suscripciones a Webhook en la aplicación?
No. Las suscripciones a Webhook se crean mediante API con POST /webhooks/subscribe o a través de la herramienta MCP po_webhooks_subscribe. Con POST /webhooks/test envía un test.ping a su nodo Webhook.
¿Cómo verifico que un envío proviene de PaperOffice?
Cada envío lleva la firma X-PaperOffice con sha256= y el HMAC-SHA256 sobre el texto sin procesar. El secreto se encuentra en la respuesta a la suscripción. Además, puede solicitar que se envíe su propio encabezado y activar la autenticación de encabezados en el nodo del webhook.
¿Puede un agente de IA utilizar n8n PaperOffice?
Sí, a través del cliente MCP con la URL del servidor https://mcp.paperoffice.ai/dms y el transporte Streamable HTTP o SSE. El inicio de sesión se realiza mediante OAuth 2.1 o un token po_ut_ o po_gt_. Las herramientas disponibles dependen de su plan.
¿Puede n8n enviar datos comerciales a PaperOffice?
Sí, a partir de Plus. En Knowledge Base AI crea una fuente operativa de tipo Push (URL de ingestión). n8n envía pedidos, envíos, facturas o presupuestos como JSON, con un máximo de 500 registros por llamada y 60 llamadas por cada 10 minutos y fuente. Los agentes de chat y teléfono leen estos datos a partir de Professional, pero no escriben nada de vuelta.
¿Existen límites para las llamadas?
Sí. Por cada clave, se permiten al menos 5 llamadas por segundo, 30 por minuto, 100 por hora y 500 por día en cada plan; en los planes de pago, más. Las consultas en bucle cuentan como llamadas, por lo que debe programar pausas de 5 a 10 segundos.
¿Funciona también con Make o Zapier?
Sí, siguiendo el mismo patrón: en Make con el módulo HTTP, en Zapier con una solicitud personalizada contra la REST-API, y para agentes de IA con un cliente MCP contra https://mcp.paperoffice.ai/dms. No existen aplicaciones o módulos propios para Make y Zapier.
¿Dónde se almacenan los datos?
Los documentos que n8n envía a PaperOffice son procesados por PaperOffice en su propio centro de datos en la UE. Lo que n8n almacena por sí mismo se encuentra donde se ejecuta su instancia de n8n, ya sea operada por usted mismo o en la nube de n8n.