Tutorial: activos fijos en Business Central con Claude Code y MCP, de un CSV a asientos que registra una persona

En dos frases

Silviu Virlan, desarrollador y consultor de Business Central, conectó Claude Code a Dynamics 365 Business Central por MCP y publicó el camino completo desde un CSV de activos fijos hasta las altas, la amortización y las bajas registradas, incluidas todas las llamadas a la API que fallaron por el camino. Claude prepara los datos y los diarios en borrador, Business Central hace los cálculos de amortización y de resultado, y una persona registra cada asiento.

Quién lo hace y qué nivel de evidencia tiene

El tutorial se publicó el 10 de febrero de 2026 en Business Central Musings, el blog que Virlan mantiene desde 2016. En su página About cuenta que lleva más de doce años trabajando solo con Dynamics NAV y Business Central, sobre todo como desarrollador y consultor, que Microsoft le concedió el premio MVP algunas veces y que escribe libros sobre el producto. Su empresa, SVirlan.com LLC, con el nombre comercial SureHoofERP, es partner registrado de Microsoft. Una semana antes había publicado una entrada más corta sobre cómo conectó Claude a Business Central en un fin de semana.

Tres cosas fijan el nivel de evidencia:

• Se hizo en la empresa de demostración de Microsoft. Las llamadas van a CRONUS USA, Inc., la empresa de ejemplo que trae Business Central, y los nueve activos (tres vehículos y seis equipos de transporte y almacén) tienen toda la pinta de ser datos de demo. Nada sale del registro de inmovilizado de una empresa real.
• Las cifras describen la demo, no un ahorro. El autor da los importes registrados, el esfuerzo que le costó dar con el método (unas cuatro o cinco horas de prompts, lectura de respuestas de la API y corrección de fallos) y su propia estimación de que alrededor del 70 % del flujo es automatizable. Nadie lo ha cronometrado frente al alta manual.
• Vende consultoría de Business Central. El artículo termina ofreciendo sus servicios. No invalida el método, pero conviene saberlo.

Por qué merece la pena: es de los pocos textos públicos que van más allá de «preguntar al ERP» y explican cómo escribir datos contables en él a través de MCP, con franqueza sobre lo que la API estándar no permite y por qué el registro sigue en manos de una persona. Una respuesta en r/Accounting de junio de 2026, de alguien que pasó de QuickBooks Online a Business Central y creó extensiones con Claude Code, apunta a que hay profesionales probando la misma combinación.

El problema que resuelve

El inmovilizado es una tarea clásica del cierre. Cada activo nuevo necesita su ficha, su libro de amortización (método, fecha de inicio, vida útil, grupo contable) y su asiento de alta; cada mes o cada año, la amortización; y cada venta, una baja que deje el activo a cero y registre el beneficio o la pérdida. En Business Central eso supone varias pantallas por activo. Treinta altas tras un proyecto de inversión o veinte bajas a cierre son sobre todo teclear, y al teclear se cuelan errores. El tutorial se pregunta si eso puede salir de una hoja de cálculo y unas frases, sin código a medida.

Herramientas y arquitectura

• Claude Code, el agente de línea de comandos de Anthropic, conectado a Business Central mediante un servidor MCP.
• Un servidor MCP en Python escrito por el autor. Según su entrada sobre la configuración, traduce las llamadas de la IA a peticiones a la API de Business Central, guarda en caché los tokens OAuth, busca los identificadores de empresa y construye las consultas OData. Expone herramientas como bc_list_fixed_assets, bc_list_companies y bc_query. No ha publicado el código.
• Business Central online, con una aplicación registrada en Microsoft Entra ID con permisos de aplicación (advierte que los delegados no le funcionaron), API.ReadWrite.All y Automation.ReadWrite.All, consentimiento de administrador y la aplicación dada de alta en Business Central con un conjunto de permisos. Para las pruebas usó uno de acceso total.
• Cuatro endpoints OData V4. Aquí está el hallazgo clave. La API estándar v2.0 ofrece los datos maestros de los activos, pero su endpoint journalLines no tiene campo para el tipo de registro de activo fijo ni para el libro de amortización, así que un alta enviada por ahí falla con el error «FA Posting Type must not be blank». El endpoint OData V4 integrado workflowGenJournalLines expone la línea de diario general completa, con esos campos. Además publicó como servicios web la página 5619 de libros de amortización de activos (FADepBooks, lectura y escritura), la consulta 123 de análisis de activos fijos (FAAnalysis, solo lectura, movimientos con datos de amortización) y la página 5611, ficha del libro de amortización (DepBooks, solo lectura).

Cómo encaja con el servidor MCP oficial: la documentación de Microsoft, consultada el 19 de octubre de 2026, describe un servidor MCP de Business Central para entornos online que expone como herramientas páginas API, consultas API y codeunits API, con una página donde el administrador decide, objeto por objeto, si los agentes pueden leer, crear, modificar, borrar o ejecutar acciones, más un interruptor Unblock Edit Tools y consultas de datos de solo lectura en versión preliminar. Los servicios web OData V4 en los que se apoya este tutorial no son páginas API; por eso importa el servidor propio del autor. No hemos comprobado si el servidor de Microsoft llega a ellos.

Paso a paso

Resumimos los pasos con nuestras palabras. Trabaja siempre en un sandbox.

1. Conectar y publicar los servicios web

Registra la aplicación en Entra, dale los permisos de API y el consentimiento de administrador, añádela en la página de aplicaciones de Microsoft Entra de Business Central con un conjunto de permisos y conecta tu servidor MCP. Después abre Servicios web y publica la página 5619 como FADepBooks, la consulta 123 como FAAnalysis y la página 5611 como DepBooks. La dirección OData V4 sigue el patrón /v2.0/{tenant}/{entorno}/ODataV4/Company('{empresa}')/{servicio}. Según el autor, la consulta 123 se añadió hace relativamente poco a la aplicación base: comprueba que tu versión la tiene.

2. Preparar el CSV

Una fila por activo con número, descripción, clase o grupo contable (VEHICLES, EQUIPMENT), tipo de movimiento, importe, fecha de registro, método de amortización, número de años y fecha hasta la que amortizar. En la demo, los nueve activos se compraron el 1 de enero de 2024, con amortización lineal a cinco años y 363.500 de coste total. El artículo no crea fichas de activo: los números y nombres coinciden con activos que parecen existir ya en la empresa de demostración. En tu empresa, crea antes las fichas o añade ese paso.

3. Que Claude asigne los libros de amortización

Para cada activo Claude hizo tres llamadas a FADepBooks: crear el registro solo con las claves (número de activo y libro COMPANY), fijar la fecha de inicio de la amortización y, por último, el grupo contable y el número de años. Una única llamada con todos los campos falla, porque Business Central valida los campos en orden y rechaza los años mientras la fecha de inicio está vacía. La fecha final (31 de diciembre de 2028) la rellenó Business Central.

4. Que Claude prepare las líneas de alta

Una línea por activo en el diario general de activos fijos (plantilla ASSETS, sección DEFAULT) mediante workflowGenJournalLines, con tipo de cuenta Fixed Asset, tipo de registro Acquisition Cost, libro COMPANY, número de documento, fechas de registro, importe y cuenta contable de contrapartida. El autor comprobó que las líneas sin tipo de documento (usó Invoice) o sin contrapartida no se podían registrar, y que Claude dedujo la cuenta de contrapartida leyendo movimientos contables anteriores de activos fijos.

5. Registrar tú las altas

El endpoint OData no ofrece una acción de Registrar para este diario, así que abres el diario general de activos fijos, revisas las nueve líneas y registras. El autor lo ve como una red de seguridad, y estamos de acuerdo.

6. Que Business Central calcule la amortización

Ejecuta Calcular amortización para el libro, con la fecha de registro y el número de documento que quieras y la contrapartida por grupo contable, y registra el diario. El autor probó antes a que Claude la calculara con una fórmula por días, y los importes no coincidían con los de Business Central, que aplica su propio redondeo y sus periodos contables. Su conclusión, que compartimos: nunca dejes que la IA calcule una amortización que el ERP ya calcula.

7. Preparar las bajas, comprobar, registrar y verificar

Para una venta, Claude prepara una línea con tipo de registro Disposal (el valor de la API; el mensaje de error lista las opciones válidas, y Proceeds on Disposal, la etiqueta que él esperaba, no es una de ellas), el importe de la venta en negativo y el banco como contrapartida. Tú la registras y Business Central calcula el resultado y deja el activo a cero. Al final Claude lee FAAnalysis e informa del coste, la amortización acumulada y el valor neto de cada activo.

Un prompt inicial (nuestro, no del autor)

Trabajas en la empresa SANDBOX {{EMPRESA}} de Business Central a través de MCP.
Lee {{ARCHIVO_CSV}}. No registres nada ni invoques ninguna acción de registro.

1. Enumera todos los activos del archivo y confirma que existe su ficha. Para y
   pregunta si falta alguna ficha o si alguna fila tiene vacía la fecha, el
   importe o el grupo contable.
2. Para cada activo, crea el libro de amortización {{LIBRO_AMORTIZACION}} en tres
   llamadas (claves, después fecha de inicio, después grupo contable y años).
   Enséñame una tabla con lo que has creado.
3. Crea una línea de alta por activo en la plantilla {{PLANTILLA}}, sección
   {{SECCION}}, con la cuenta de contrapartida {{CUENTA_CONTRAPARTIDA}}. Usa los
   números de documento {{PREFIJO_DOC}}-001 en adelante.
4. Dame un total de control: número de líneas e importe total, comparados con el
   CSV. Después para. El diario lo registraré yo.
No calcules nunca la amortización. No cambies datos maestros que no estén en el CSV.

Un ejemplo concreto y una cifra que hay que revisar

En la demo, tras amortizar hasta el 5 de febrero de 2026, los nueve activos sumaban 152.468 de amortización acumulada y 211.032 de valor neto, el 41,9 % del coste, coherente con unos dos años y un mes de una amortización lineal a cinco años. Después el autor vendió el cuadro eléctrico (coste 8.500) por 5.000 y el ordenador de la cinta transportadora (coste 15.000) por 18.000.

Su tabla de resultados esperados muestra una pérdida de 3.500 y una ganancia de 3.000, es decir, precio de venta contra coste. Pero su propio informe, unas líneas antes, da valores netos de 4.935 y 8.708. El código de bajas de Business Central, publicado por Microsoft, calcula el resultado como valor neto contable más el importe de la venta (que se registra en negativo). La amortización y las bajas tienen la misma fecha, 5 de febrero de 2026, así que, según nuestros cálculos, lo esperable serían ganancias de unos 65 y 9.292, no una pérdida de 3.500 y una ganancia de 3.000. No podemos saber qué se registró realmente, porque el listado de bajas no muestra la amortización. La lección importa más que la discrepancia: recalcula cada resultado esperado a partir del valor neto contable antes de registrar y trata la explicación de la IA como una afirmación que hay que comprobar. Microsoft recuerda además que la baja debe ser el último movimiento registrado de un activo y que una baja parcial exige dividir antes el activo.

Resultados declarados

• Nueve activos y 363.500 de coste: libros de amortización y líneas de alta creados desde un CSV y una instrucción breve.
• Amortización calculada y registrada por Business Central: 152.468 hasta el 5 de febrero de 2026.
• Dos bajas preparadas por Claude y registradas por una persona.
• Ninguna línea nueva de código AL, cuatro endpoints, unas cuatro o cinco horas para resolverlo todo y, según su estimación, alrededor del 70 % de los pasos automatizables, con cuatro puntos de revisión humana (todos los registros).

Todo en una empresa de demostración. No hay cifra de ahorro de tiempo sobre un registro de inmovilizado real.

Limitaciones y riesgos

• Al principio, solo en sandbox. Un conjunto de permisos de acceso total y una aplicación con permisos de escritura valen para una demo, no para producción. Da a la aplicación el conjunto más restringido que funcione y deja los permisos de registro a las personas.
• El servidor de Microsoft puede registrar documentos si se lo permites. Su documentación incluye ejecutar acciones OData «como registrar documentos» entre lo que pueden hacer los agentes cuando las acciones están permitidas. Si usas el servidor oficial, decide con cuidado qué objetos llevan Allow Actions; en este tutorial el registro es manual por diseño.
• Código del servidor sin publicar. El servidor MCP del autor no es público. Uses el que uses, registra cada llamada y mantén el lote del diario como punto de revisión.
• Normas de cada país. La demo es una empresa estadounidense con amortización lineal. Las vidas útiles, los métodos y la diferencia entre amortización contable y fiscal dependen de tu país y de tu política. En España, por ejemplo, la amortización fiscal se rige por las tablas del Impuesto sobre Sociedades y el inmovilizado tiene su propia nota en la memoria de las cuentas anuales. La IA no decide nada de eso.
• Las cifras de la propia demo hay que revisarlas, como muestran las bajas.

Errores comunes

1. Usar la API estándar journalLines para activos: sin tipo de registro A/F, falla.
2. Enviar todos los campos del libro en una sola llamada: Business Central valida en orden y la rechaza.
3. Omitir el tipo de documento o la contrapartida: las líneas no se registran.
4. Usar las etiquetas de la interfaz como valores de la API: el tipo es Disposal, no Proceeds on Disposal.
5. Dejar que la IA calcule la amortización: el redondeo y los periodos no cuadrarán.
6. Calcular el resultado de una baja contra el coste en lugar de contra el valor neto contable.

Conclusiones

Es un patrón modesto y útil: la IA teclea entre la hoja de cálculo y el ERP, el ERP hace la aritmética contable y una persona registra. Su valor está en las trampas que un consultor experimentado encontró y resolvió; su punto débil, el ejemplo de las bajas, recuerda por qué la revisión humana se queda. Pruébalo en un sandbox con pocos activos conocidos y compara cada línea antes de registrar.