Flujos móviles de Business Central

Cómo se corresponde con Plur-e Mobile

Plur-e Mobile habla con Business Central a través de un único endpoint de Plure API (erp/processrequest) y una bound action de AL, pasando el nombre de un ProcessMethod y un array Parameters. El servidor MCP hace exactamente lo mismo, con la misma identidad que usaría la app: la cuenta del Admin Center se asocia por email a un usuario de Plur-e Mobile y sus módulos WMS / Sales aportan el WarehouseEmployee y el SalesPerson que Business Central espera. Los tenants sin usuarios móviles definen valores por defecto en AI & MCP → Scopes → Identidad ERP.

Todas las herramientas de sección reciben los mismos argumentos:

{
  "name": "bc_wms_receipts",
  "arguments": {
    "method": "GetWarehouseReceipt",
    "parameters": { "WsheDocumentNo": "WHSE REC-000123" }
  }
}

parameters es un objeto (se envía como array de un elemento, igual que la app) o un array cuando la skill indica que el array es el payload (líneas de recuento, de pick, de diario). La herramienta valida que el método pertenece a la sección, inyecta las claves de identidad cuando el método las necesita y devuelve la respuesta de Business Central como JSON. Los PDF y Excel en base64 vuelven como recurso embebido; las listas de más de 500 filas se truncan con truncated y totalCount.

Skills

El plugin no incluye nada: todas las skills viven en el servidor y se filtran por la licencia del tenant y los ámbitos del rol.

Tres formas de leerlas: la herramienta bc_get_skill ({ "name": "sections/wms-receipts" }), el recurso MCP plure-bc://skills/sections/wms-receipts o el prompt skill_bc_wms_receipts. bc_list_methods lista los métodos de una sección o busca en el catálogo por texto.

Editar skills en el Admin Center

AI & MCP → Skills lista todos los documentos incluidos en la build de los dos servidores (Business Central y CRM). Un administrador del tenant puede personalizar uno (el texto original se conserva como revisión 0 y cada guardado añade una revisión, así que siempre se puede restablecer), restringirlo a roles web, desactivarlo, exportarlo como Markdown, importar un archivo .md o añadir skills propias del tenant (flows/…, sections/… o una guía en la raíz). El servidor MCP sirve el documento efectivo — copia del tenant, luego una sobrescritura global de Plur-e, luego la build — a través de bc_get_skill, los recursos y los prompts, en unos 15 segundos tras el cambio.

Escaneo: códigos desde una imagen

Las etiquetas de una estantería, un palé o un albarán se pueden leer desde una foto en lugar de escanear una a una.

• bc_decode_barcodes({ image: { base64 | url | handoffId }, hints? }) encuentra todos los códigos de la imagen (EAN/UPC, Code 128, GS1-128, QR, Data Matrix, PDF417…), conserva su posición y los devuelve en orden de estantería (arriba-abajo, izquierda-derecha) con los identificadores de aplicación GS1 ya separados (01 GTIN, 10 lote, 21 serie, 00 SSCC, 17 caducidad). Las URL se limitan a la lista permitida del tenant (SharePoint, Azure Blob, plur-e.com por defecto) y las imágenes a 4 MB.
• bc_resolve_codes({ codes, locationCode? }) convierte cada cadena en una referencia tipada — bin, item, serial, licensePlate, document (recepción, pick, put-away, transferencia, pedido de venta o compra por prefijo) o unknown — preguntando a Business Central igual que la app (GetBinByLocation, IsItemOrSerial, GetItemIdentifier, GetLicencesPlate).

Un recuento típico: foto de la estantería → bc_decode_barcodes → bc_resolve_codes → ya se conocen el bin y los artículos → bc_wms_inventory_counts escribe las líneas. La skill flows/count-bins-from-photo lo recorre paso a paso.

Handoff: cámara, firma, foto y archivo sin login

Cuando el usuario está en la estantería o con el cliente, el servidor abre una página de un solo uso de Plur-e Web (https://app.plur-e.com/h/<token>): válida 15 minutos, un solo uso, sin login, ligada al tenant y al usuario que llama. No muestra nada de Business Central.

Los clientes que soportan elicitación por URL (Claude Desktop, Claude Code) abren la página y la herramienta espera a Listo; el resto recibe el enlace y llama después a bc_handoff_result(handoffId). Los archivos se guardan en la base de datos del tenant 24 horas y solo el servidor MCP puede leerlos: en cualquier array FileInfo, { "HandoffId": "…", "AssetId": "…" } sustituye al base64 y el servidor lo rellena.

Ámbitos, aprobaciones y auditoría

• Las herramientas de sección se declaran write pero por defecto son read para todos los roles: un rol con el ámbito por defecto solo puede llamar métodos de lectura y recibe scope_denied en las escrituras.
• Conceder write a un rol activa los métodos de escritura de esa sección; la opción Aprobaciones del tenant decide si las escrituras se ejecutan de inmediato, tras una elicitación en el cliente o tras aprobación en el Admin Center. Los métodos marcados como posting en las skills (registrar recepción, registrar pick, registrar recuento, registrar diario, enviar pedido) no se pueden deshacer en Business Central.
• Cada llamada queda auditada con el método y un resumen de los parámetros (sin los base64) en AI & MCP → Registro de auditoría.
• Los errores llevan un código legible por máquina: invalid_method (con sugerencia), invalid_arguments, erp_user_not_mapped, bc_error (el mensaje de Business Central), handoff_pending, handoff_expired.

Impresión de etiquetas

bc_list_printers devuelve las impresoras del tenant (cola de impresión de Plur-e) y las plantillas con los campos que necesita cada una; bc_print_document(printer, template, documentNo, fields) encola la etiqueta — etiquetas de LP (ZPL LPS), códigos de barras de artículo (BarCode) y etiquetas de caja / dirección — igual que Plur-e Mobile, y el agente Plur-e Print del puesto la imprime. Es una herramienta de escritura (ámbito None hasta que se concede). Las listas de empaque, recibos y vouchers son renderizados PDF que solo producen Plur-e Web y Mobile; la herramienta rechaza esas plantillas.

Fuera de alcance

Los vouchers offline, los envíos de paquetes por transportista y la pantalla de pago con Stripe de Plur-e Mobile no tocan Business Central y no se exponen.

Relacionado: Herramientas de Business Central · Conectar Claude · Modelo de seguridad