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 → Settings → 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 roles web permitidos en cada skill (AI & MCP → Skills).

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. Un AI agent del tenant puede acotar aún más qué secciones de las 16 ve una conexión, por encima de lo que ya permite el rol MCP del usuario.

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 (un cliente de escritorio de IA, un cliente de IA para IDE) 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.

Roles y auditoría

• Las herramientas de sección se declaran write, pero el área de cada sección empieza en solo lectura en un rol: un usuario cuyos roles MCP no conceden Write en esa área solo puede llamar métodos de lectura y recibe scope_denied de inmediato en las escrituras.
• Conceder Write en un área dentro de un rol activa los métodos de escritura sin registro de esa sección para quien tenga el rol; conceder Post activa además los métodos marcados como posting en las skills (registrar recepción, registrar pick, registrar recuento, registrar diario, enviar pedido), que no se pueden deshacer en Business Central. No hay cola de aprobación: una escritura se ejecuta en cuanto un rol la permite.
• 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: necesita Write en el área documents. 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.

El tools/list del servidor y la skill index son el catálogo autoritativo; los conteos de arriba salen del _catalog.json generado en la build del servidor.

Relacionado: Herramientas de Business Central · Roles MCP · Conecta tu cliente de IA · Modelo de seguridad