Documentación

Empresas, regiones y personas

Cada espacio de trabajo de Pleaxy pertenece a una sola empresa. El dominio de tu correo no forma parte del árbol: Pleaxy solo lo usa como pista cuando alguien se registra.

• Empresa - la organización en Pleaxy. No hay nada por encima: ni grupo ni empresa matriz. Sus administradores son los administradores de cualquiera de sus perfiles de comprador o proveedor.
• Región - un espacio de trabajo dentro de una empresa, por ejemplo EMEA. Una región nunca pasa a otra empresa.
• Perfiles de comprador y proveedor - los dos lados de una región, que tiene uno o ambos. Cada uno tiene sus propios usuarios y roles, órdenes de compra, facturas y conexiones con compradores o proveedores.

Quién termina en qué empresa

• La primera persona de un dominio de trabajo crea una empresa nueva y pasa a ser su administradora.
• Un colega que se registra después ve, una vez confirmado su correo, las empresas de Pleaxy que ya tienen personas con su dominio, cada una con sus regiones. Puede pedir a un administrador de esas empresas una invitación a una región, o confirmar que la suya es otra empresa y crear una aparte. Las empresas separadas no ven las órdenes, facturas ni proveedores de las demás.
• Un administrador que agrega una región la agrega a su propia empresa.
• Las empresas no se pueden fusionar. Si se creó una empresa aparte por error, invita a sus personas a las regiones de tu empresa.

Inicio rápido

Inicia sesión, conecta un proveedor de nube y crea tu primera orden de compra. La consola y los SDK llaman a la misma API /v1, a la que también puedes llamar con una clave de API con permisos acotados (consulta Agentes de IA para generar una). Algunas acciones siempre necesitan a una persona con sesión iniciada en Pleaxy, nunca una clave de API: aprobar, cambiar los flujos de aprobación o la autonomía, y registrar un pago.

import { Pleaxy } from "@pleaxy/sdk";

// The base URL is the origin only: the SDK adds /v1/workspaces/<Workspace ID>.
const pleaxy = new Pleaxy({
  baseUrl: "https://api.pleaxy.ai",
  apiKey: process.env.PLEAXY_API_KEY, // "<keyId>.<secret>"
  workspaceId: process.env.PLEAXY_WORKSPACE_ID, // Company profile → Workspace ID
});

// AWS: start the connection, run the returned setup script in your own
// account, then pass back the read-only IAM role it created.
const setup = await pleaxy.cloudConnections.initAwsCloudConnection();
await pleaxy.cloudConnections.createCloudConnection({
  provider: "aws",
  accountLabel: "Production payer",
  awsConnectionId: setup.connectionId,
  roleArn: "arn:aws:iam::912345678901:role/PleaxyBillingRead",
});

const po = await pleaxy.purchaseOrders.createPurchaseOrder({
  supplier: "Amazon Web Services",
  provider: "aws",
  lineItems: [
    {
      scopeType: "sku",
      scopeId: "AWS-EC2-M5LG",
      name: "EC2 m5.large",
      ruleType: "quantity",
      unit: "hr",
      unitPrice: 0.096,
      qty: 5_000,
      nteAmount: 0,
      paymentTerms: "Net 30",
      validFrom: "2026-01-01",
      validUntil: "2026-12-31",
    },
  ],
});

// po.status is "pending_approval" while your approval flow runs, then
// "awaiting_fulfillment". Autonomy, if on, can approve it straight away.

Órdenes de compra y líneas

Una orden de compra se compone de una o más líneas, cada una con su propio precio y seguimiento:

• Líneas de SKU: un artículo concreto del catálogo de un proveedor, facturado por cantidad × precio unitario. Cuando el proveedor publica un catálogo en Pleaxy, el id del artículo de la línea se valida en el servidor.
• Líneas abiertas por servicio o por cuenta: un tope máximo que cubre un servicio completo o toda una cuenta de nube.
• Líneas personalizadas: para todo lo que no esté en el catálogo de un proveedor, ya sea por cantidad o con un importe máximo fijo.

Cada línea está en la moneda de la región, tiene sus propias condiciones de pago y su período de vigencia, y lleva un saldo en tiempo real (consumido frente a restante) para ese período, marcando las líneas que van camino de agotarse antes de tiempo.

Conexiones a la nube

Pleaxy se conecta en modo de solo lectura a la facturación de Amazon Web Services (AWS), Google Cloud, Microsoft Azure y Oracle Cloud Infrastructure (OCI), mediante un acceso que creas en tu propia cuenta con un script de configuración y que puedes revocar cuando quieras. Pleaxy guarda cada orden de compra como un registro propio y no escribe órdenes de compra en ningún proveedor de nube:

• Amazon Web Services (AWS): un rol de IAM entre cuentas que Pleaxy asume. Lee tus facturas emitidas y Cost Explorer. Para que AWS imprima un número de orden de compra de Pleaxy en sus facturas, añádelo en Purchase orders, en la consola de AWS Billing and Cost Management.
• Google Cloud: Workload Identity Federation hacia una cuenta de servicio que solo puede leer tu exportación de facturación de BigQuery. Google no tiene una API de facturas, así que Pleaxy usa el total mensual de la exportación.
• Microsoft Azure: una credencial federada en una aplicación de tu propio tenant. Lee las facturas de tu perfil de facturación y el coste del mes en curso. Pleaxy no añade números de orden de compra a las facturas EA.
• Oracle Cloud Infrastructure (OCI): una clave de firma de API que genera Pleaxy; tú solo subes la clave pública. Lee las facturas de uso cuando tu cuenta las tiene y, si no, el coste de cada mes cerrado.

Gasto en IA

El gasto en IA es lo que cuestan los servicios de IA de la facturación de nube que tienes conectada: Amazon Bedrock, SageMaker, Vertex AI, Azure OpenAI, OCI Generative AI y los modelos del marketplace en la misma factura. Pleaxy lo muestra por facturador, proveedor del modelo, modelo y medidor (tokens de entrada, de salida y en caché, horas aprovisionadas), mes en curso y previsión del periodo, frente al último mes cerrado, y junto a cada facturador las líneas de orden de compra abiertas emitidas a su nombre y lo que les queda: así sabes que Bedrock costará más de lo que le queda a PO-8842 antes de que llegue la factura. Todos los importes están en la moneda de facturación del facturador, nunca convertidos ni sumados entre monedas.

• El proveedor es quien factura. La empresa cuyo modelo se usó es el vendor de la línea. Claude en Bedrock es gasto de AWS con vendor anthropic, nunca gasto de Anthropic, así que agrupar por facturador coincide con tus facturas y agrupar por proveedor del modelo responde a cuánto gastas en Claude, lo facture quien lo facture. Nada se cuenta dos veces.
• De dónde sale: de las líneas de servicios de IA de la facturación de AWS, Google Cloud, Azure y OCI que tienes conectada, leídas con el mismo acceso de solo lectura que el resto de la factura y con la misma elección de fuentes de datos: una conexión que permite current_cost da el mes en curso y una previsión; una que permite invoices, el mes cerrado. AWS da sus líneas de IA solo a través de Cost Explorer, así que una cuenta de AWS necesita current_cost para verlas, y entonces muestra también el mes cerrado. No se pide nada nuevo a tu cuenta, y un tipo de uso que Pleaxy aún no conoce se conserva con su nombre original, nunca se descarta.
• Tarifas: Pleaxy mantiene los precios de lista públicos de cada proveedor de modelo y facturador que mapea, con fechas de vigencia: un cambio de precio es una entrada nueva, así que una línea se juzga frente al precio que regía en su día. La tarifa negociada de un contrato o su descuento sobre el precio de lista prevalece; las tarifas en sí no se pueden editar.

En la API, el gasto en IA es un recurso solo para compradores: GetAiSpend para las cifras por facturador, proveedor del modelo, modelo o centro de coste, ListAiUsageLines para las líneas que hay detrás, ListAiRateCards para el precio vigente en un día y CheckAiSpend para saber si la previsión cabe en las líneas de orden de compra abiertas y en el presupuesto. El servidor MCP expone lo mismo como get_ai_spend y check_ai_spend (ver Agentes de IA).

Además de tu facturación en la nube, el gasto en IA cubre los proveedores de IA a los que pagas directamente, las líneas de IA de tus órdenes y facturas, los centros de coste y los límites en el proveedor:

• Proveedores de IA directos: OpenAI y Anthropic se conectan con una clave de administrador de solo lectura que creas en su consola y puedes revocar; Mistral también, si tu organización tiene su Admin API (una función de Enterprise). OpenRouter se conecta con una clave de gestión, CoreWeave con un token de API con el rol Billing Viewer y Databricks con una entidad de servicio; para Snowflake, Pleaxy genera un par de claves y tú asignas su clave pública a un usuario de servicio. La clave se comprueba con una lectura antes de guardarla, se guarda cifrada y nunca se usa para cambiar nada en el proveedor. Las líneas de cada proveedor se leen cada día y aparecen como su propio facturador (ListAiProviders, CreateAiProvider).
• Facturas de IA conciliadas línea a línea: una línea de IA en una orden, una condición de contrato o una factura indica su modelo y su medidor, y cada línea de factura se contrasta con la línea de la orden y la condición del contrato para ese modelo: su tarifa frente al contrato y al precio de lista del mes, su cantidad frente al consumo que informó el proveedor, y lo que consume de un compromiso. Las líneas nunca se concilian por descripción. SuggestAiPoLines rellena las líneas de IA de una orden con el consumo del mes anterior, y ListAiCommitments muestra cuánto se ha usado de cada compromiso.
• Centros de coste y presupuestos: las reglas de atribución asignan las etiquetas, proyectos y espacios de trabajo de los proveedores a centros de coste (GetAiAttribution). Así cada presupuesto cuenta el consumo de IA atribuido del mes como gasto en curso, y Pleaxy avisa cuando la previsión llega al 80% o al 100% (ListAiCostCenters).
• Límites en el proveedor: opcionales. Una línea de orden aprobada puede fijar el tope mensual del propio proveedor: un presupuesto de AWS, un límite de proyecto de OpenAI, un límite de espacio de trabajo de Anthropic si Anthropic lo ofrece en tu cuenta, un presupuesto o tope de gasto de Google Cloud, o un presupuesto de Azure, que solo avisa. Requiere una credencial aparte que creas tú, nunca la de la conexión de solo lectura (SetAiSpendLimit).
• IA por puesto: las facturas por puesto de ChatGPT Enterprise, Claude Enterprise, Microsoft 365 Copilot, GitHub Copilot y Cursor se contrastan con los usuarios activos registrados para el mes (SetAiSeatCount). Pleaxy no lee tu proveedor de identidad: una persona, un script o un agente registra el número.

Aprobaciones y autonomía

Cada región tiene un flujo de aprobación para órdenes de compra y otro para pagos de facturas, que editas en Flujos de trabajo en Pleaxy. Una región nueva empieza con un único paso dirigido a un administrador de la región. Un flujo se construye con tres tipos de paso:

• Aprobador: una persona da el visto bueno.
• Aprobadores en paralelo: varias personas distintas dan cada una su visto bueno, en cualquier orden.
• Aprobador condicional: solo se ejecuta cuando se cumplen todas sus condiciones. Las condiciones pueden comprobar el importe (en la moneda de la región), el proveedor o el solicitante.

Cada paso indica una persona concreta, y solo esa persona puede actuar sobre él. Marca un paso como Solo por encima del umbral de alto valor y los importes iguales o inferiores al umbral lo omiten. Un flujo necesita al menos un paso sin condiciones, para que cada orden y cada factura llegue a una persona. Si creaste tú el documento, tu paso pasa a otro administrador. Solo puedes aprobarlo tú cuando nadie más de la región podría hacerlo, y entonces se marca como Autoaprobado.

En el plan Autonomous puedes activar la autonomía, también en Flujos de trabajo. Pleaxy aprueba entonces por sí mismo una orden de compra o una factura hasta tu importe de aprobación automática, como Pleaxy Autonomy, con el mismo registro de auditoría. Nunca lo hace cuando se aplica un paso condicional o de alto valor, ni cuando una orden de compra supera el límite de gasto de su solicitante. Con las facturas es más estricto: solo puede aprobarse automáticamente una factura conciliada con una factura emitida por AWS, y nunca una que haya introducido un comprador ni una en otra moneda. Las reglas de automatización te permiten tratar a un proveedor de forma distinta: enviar siempre sus documentos a una persona o, en el plan Autonomous, aprobarlos automáticamente hasta un importe.

Una clave de API puede leer los flujos de aprobación y la configuración de autonomía, pero solo una persona con sesión iniciada en Pleaxy puede cambiarlos, y una clave de API nunca aprueba un paso.

const flow = await pleaxy.approvalChains.get("purchase_order"); // or "invoice_payment"

const autonomy = await pleaxy.settlement.getAutonomy();
// { enabled, maxAutoApproveAmount, approvalThreshold }
// approvalThreshold is the high-value threshold. Change these in Pleaxy, under Workflows.

Conciliación de facturas

Una factura emitida contra una orden de compra, de un proveedor de nube con el que tienes una conexión de facturación activa, empieza con el estado de conciliación pending. Al ejecutar la conciliación se compara el importe facturado con el consumo que informó el proveedor:

• Dentro del 3 % → matched, y pasa a tu flujo de aprobación de facturas.
• Más de un 3 % de diferencia, o en otra moneda → discrepancy. Pleaxy no convierte monedas. Alguien la revisa frente a la factura del proveedor y después la resuelve enviándola al flujo de aprobación o la rechaza. Si la autonomía está activada y la diferencia está dentro de tu importe de aprobación automática, Pleaxy la aprueba por sí mismo, dentro de los límites para facturas descritos en Aprobaciones y autonomía.

Una factura sin orden de compra, o sin una conexión de facturación con la que comprobarla, queda como unverified. Una persona con sesión iniciada en Pleaxy la revisa y después la envía al flujo de aprobación o la rechaza.

Notas de crédito y de débito

Una nota de crédito reduce lo que debe el comprador: mercancía devuelta, una corrección de precio, un reembolso. El proveedor la emite sobre la factura que corrige, o solo a nombre del comprador, y un comprador puede registrar una que el proveedor envió fuera de Pleaxy. Una nota de crédito que corrige una factura y no la supera se acepta al instante; cualquier otra espera a que el comprador la acepte o la rechace. Al aceptar un crédito por mercancía devuelta o una corrección de precio, su importe antes de impuestos vuelve a la línea de la orden de compra, y ese saldo se puede volver a usar.

Quién liquida los créditos es un ajuste del espacio de trabajo:

• Los liquida Pleaxy. Los créditos aceptados se aplican a facturas pendientes y reducen su importe a pagar, y una nota de crédito sobre una factura pendiente se aplica a ella al aceptarse. Los créditos pueden cubrir una factura por completo: una vez aprobada, queda liquidada con crédito y sin nada que pagar. Rechazar una factura devuelve los créditos aplicados.
• Los liquida tu sistema contable. En Pleaxy no se compensa nada, y cada nota de crédito aceptada sale una vez en la exportación de pagos, como una fila negativa.

Una nota de débito cobra más sobre una factura ya enviada, por ejemplo un cargo que se omitió. Indica la factura que modifica y toma su orden de compra, línea y moneda, y luego pasa por conciliación, aprobación, pago y exportación como cualquier factura. No puede modificar una factura rechazada ni otra nota de débito.

Ambas están en Facturas en la app, vinculadas a la factura que modifican, y las notas de crédito de AWS y Azure llegan solas como notas de crédito. En la API son el recurso de facturas con un documentType de credit_note o debit_note (consulta CreateInvoice), y un flujo de facturas las envía como notas de crédito y de débito UBL, credit y debit memos cXML, o JSON con documentType.

Pagos

Pleaxy no paga facturas. Cuando termina el flujo de aprobación de una factura, el comprador la paga en su propio ciclo de pagos (las facturas aprobadas se pueden exportar para ello) y registra el pago en Pleaxy. Registrarlo no mueve dinero. El proveedor ve el pago como registrado por el comprador y recibe un aviso de remesa. Registrar un pago necesita a una persona con sesión iniciada en Pleaxy, nunca una clave de API.

Con el pago, o en cualquier momento después, el comprador puede enviar al proveedor una remesa: el comprobante de pago, como el recibo de transferencia del banco (PDF, PNG o JPEG, hasta 10 MB), y una nota de hasta 1000 caracteres. El proveedor recibe un aviso, también en su canal de Slack o Teams si envía allí los avisos de pago, y encuentra la remesa en la factura. Igual que registrar un pago, enviarla necesita a una persona con sesión iniciada en Pleaxy (consulta SendRemittance). Exportar para pago también funciona con una sola factura.

Agentes de IA (MCP)

Para conectar un agente con tu propia sesión, sin clave de API: Conectar un agente de IA.

El servidor MCP de Pleaxy expone las órdenes de compra y las facturas como herramientas para Claude o cualquier otro agente compatible con MCP. Es una capa fina: cada llamada a una herramienta es una solicitud autenticada a la misma API /v1 que usan la consola y los SDK, así que un agente puede hacer exactamente lo que permite su clave de API, nada más.

1. Genera una clave de API con permisos acotados con POST /v1/workspaces/:regionId/api-keys con tu propia sesión iniciada: una clave de API existente no puede generar otra (consulta Claves de API). La clave toma tu propio rol en el espacio de trabajo, comprador o proveedor, y solo un administrador puede generarla. Una clave de comprador es de solo lectura salvo que le asignes un procurementRole, como requisitions para crear órdenes de compra. La respuesta contiene la clave (solo se muestra una vez). Después copia el ID del espacio de trabajo desde Perfil de la empresa en la consola de Pleaxy: necesitarás ambos más abajo.
2. Comprueba que funciona (Node.js 22.18 o posterior). El servidor está en npm como pleaxy-mcp, así que no hay nada que compilar ni clonar: npx lo descarga.
   shell

   npx -y pleaxy-mcp --version

3. Añádelo a tu cliente MCP. Para Claude Desktop o Claude Code, añade esto a tu configuración de MCP. La URL base es solo el origen: el servidor añade /v1 por su cuenta.
   mcp config · json

   {
     "mcpServers": {
       "pleaxy": {
         "command": "npx",
         "args": ["-y", "pleaxy-mcp"],
         "env": {
           "PLEAXY_API_BASE_URL": "https://api.pleaxy.ai",
           "PLEAXY_API_KEY": "<keyId>.<secret>",
           "PLEAXY_WORKSPACE_ID": "<Company profile → Workspace ID>"
         }
       }
     }
   }

Un proceso de servidor atiende un espacio de trabajo: una clave de API, un ID del espacio de trabajo. Las claves de comprador y de proveedor ven la misma lista de herramientas, pero la API rechaza una llamada fuera del rol de la clave (por ejemplo, una clave de proveedor que llama a create_purchase_order) exactamente igual que lo haría por REST.