@nubiia/mcp-freematica 0.7.0 → 0.9.0

package/dist/schemas/localizaciones.js

@@ -0,0 +1,145 @@
+import { z } from 'zod';
+/**
+ * Zod schemas (raw shapes) y builders de body para las tools de escritura de
+ * Localizaciones de Clientes (módulo pgrl, v2): cobro, envío, factura y
+ * servicio.
+ *
+ * Los cuatro tipos comparten la mayoría de campos (dirección, teléfonos,
+ * email, contacto) pero cada uno usa nombres de columna distintos para el
+ * código, el nombre, el domicilio y el contacto. `LOC_FIELD_MAP` centraliza
+ * ese mapeo.
+ */
+/** Añade `target[key] = value` solo si value !== undefined. */
+function setIf(target, key, value) {
+    if (value !== undefined)
+        target[key] = value;
+}
+export const LOC_TIPOS = ['cobro', 'envio', 'factura', 'servicio'];
+export const LOC_FIELD_MAP = {
+    cobro: {
+        codField: 'LOC_CLI_COB',
+        nombreField: 'NOM_LOC_COB',
+        domicilioField: 'DOMICILIO',
+        contactoField: 'COB_CONTACTO',
+        nombreRequerido: true,
+        path: '/pgrl/v2/localizaciones-cobro-clientes',
+        getPath: '/pgrl/v2/localizaciones-cobro-clientes',
+        toolSuffix: 'cobro',
+    },
+    envio: {
+        codField: 'LOC_CLI_ENV',
+        nombreField: 'NOM_LOC_ENV',
+        domicilioField: 'DOMICILIO_ENVIO',
+        contactoField: 'ENV_CONTACTO',
+        nombreRequerido: false,
+        path: '/pgrl/v2/localizaciones-envio-clientes',
+        getPath: '/pgrl/v2/localizaciones-envio-clientes',
+        toolSuffix: 'envio',
+    },
+    factura: {
+        codField: 'LOC_CLI_FAC',
+        nombreField: 'NOM_LOC_FAC',
+        domicilioField: 'DOMICILIO',
+        contactoField: 'FAC_CONTACTO',
+        nombreRequerido: true,
+        path: '/pgrl/v2/localizaciones-factura-clientes',
+        // El GET singular v2 no existe para factura; se usa el v1 (mismas columnas).
+        getPath: '/pgrl/v1/localizaciones-factura-clientes',
+        toolSuffix: 'factura',
+    },
+    servicio: {
+        codField: 'LOC_CLI_SERV',
+        nombreField: 'DESCRIPCION',
+        domicilioField: 'DOMICILIO',
+        contactoField: 'CONTACTO',
+        nombreRequerido: true,
+        path: '/pgrl/v2/localizaciones-servicio-clientes',
+        getPath: '/pgrl/v2/localizaciones-servicio-clientes',
+        toolSuffix: 'servicio',
+    },
+};
+const localizacionOptionalFieldsShape = {
+    codPais: z.number().int().optional().describe('Código de país (COD_PAIS).'),
+    codProvincia: z.string().max(5).optional().describe('Código de provincia (COD_PROVINCIA, 5c).'),
+    codPoblacion: z.string().max(40).optional().describe('Código de población (COD_POBLACION, 40c).'),
+    codPostal: z.string().max(10).optional().describe('Código postal (COD_POSTAL, 10c).'),
+    domicilio: z
+        .string()
+        .max(100)
+        .optional()
+        .describe('Domicilio (DOMICILIO / DOMICILIO_ENVIO según el tipo).'),
+    email: z.string().max(100).optional().describe('Correo electrónico (E_MAIL, 100c).'),
+    telefono1: z.string().max(15).optional().describe('Teléfono 1 (TELEFONO1, 15c).'),
+    telefono2: z.string().max(15).optional().describe('Teléfono 2 (TELEFONO2, 15c).'),
+    contacto: z
+        .string()
+        .max(40)
+        .optional()
+        .describe('Persona de contacto (COB_CONTACTO / ENV_CONTACTO / FAC_CONTACTO / CONTACTO según el tipo).'),
+    camposAdicionales: z
+        .record(z.string().regex(/^[A-Z][A-Z0-9_]*$/, 'Las claves deben ser columnas Freemática (MAYUSCULAS_CON_GUION_BAJO)'), z.union([z.string(), z.number()]))
+        .optional()
+        .describe('Campos nativos adicionales del Vo del tipo (ej: cobro → CMCC_IBAN, COD_BANCO; servicio → COD_ZONA, LATITUD_LONGITUD, CMCS_COD_DLG). Ver spec OpenAPI.'),
+};
+/**
+ * Shape del alta de localización. `formaPago` solo lo exige el API en el tipo
+ * `cobro`; para el resto es ignorable (se valida en el handler).
+ */
+export const CreateLocalizacionClienteShape = {
+    tipo: z
+        .enum(['cobro', 'envio', 'factura', 'servicio'])
+        .describe('Tipo de localización: cobro, envio, factura o servicio (instalación).'),
+    grupoCliente: z.number().int().describe('Código de grupo de cliente (COD_GRUPO_CLI). Requerido.'),
+    codCliente: z.string().max(10).describe('Código de cliente (COD_CLI, 10c). Requerido.'),
+    codLocalizacion: z
+        .number()
+        .int()
+        .describe('Código de la localización (LOC_CLI_COB/ENV/FAC/SERV según el tipo). Requerido.'),
+    nombre: z
+        .string()
+        .max(80)
+        .optional()
+        .describe('Denominación (NOM_LOC_COB / NOM_LOC_ENV / NOM_LOC_FAC / DESCRIPCION). Requerido por el API en cobro, factura y servicio.'),
+    formaPago: z
+        .string()
+        .max(3)
+        .optional()
+        .describe('Código de forma de pago (COD_FORMA_PAGO). Requerido por el API SOLO en tipo cobro.'),
+    ...localizacionOptionalFieldsShape,
+};
+export const UpdateLocalizacionClienteShape = {
+    tipo: z
+        .enum(['cobro', 'envio', 'factura', 'servicio'])
+        .describe('Tipo de localización: cobro, envio, factura o servicio.'),
+    idReg: z
+        .string()
+        .min(1)
+        .describe('idReg opaco de la localización (campo "idReg" en la list tool del tipo).'),
+    nombre: z.string().max(80).optional().describe('Nueva denominación.'),
+    formaPago: z.string().max(3).optional().describe('Código de forma de pago (solo tipo cobro).'),
+    ...localizacionOptionalFieldsShape,
+};
+/** Construye el body del Vo de localización correspondiente al tipo. */
+export function buildLocalizacionClienteBody(tipo, args) {
+    const map = LOC_FIELD_MAP[tipo];
+    const body = {};
+    setIf(body, 'COD_GRUPO_CLI', args.grupoCliente);
+    setIf(body, 'COD_CLI', args.codCliente);
+    setIf(body, map.codField, args.codLocalizacion);
+    setIf(body, map.nombreField, args.nombre);
+    if (tipo === 'cobro')
+        setIf(body, 'COD_FORMA_PAGO', args.formaPago);
+    setIf(body, 'COD_PAIS', args.codPais);
+    setIf(body, 'COD_PROVINCIA', args.codProvincia);
+    setIf(body, 'COD_POBLACION', args.codPoblacion);
+    setIf(body, 'COD_POSTAL', args.codPostal);
+    setIf(body, map.domicilioField, args.domicilio);
+    setIf(body, 'E_MAIL', args.email);
+    setIf(body, 'TELEFONO1', args.telefono1);
+    setIf(body, 'TELEFONO2', args.telefono2);
+    setIf(body, map.contactoField, args.contacto);
+    if (args.camposAdicionales)
+        Object.assign(body, args.camposAdicionales);
+    return body;
+}
+//# sourceMappingURL=localizaciones.js.map

package/dist/schemas/localizaciones.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localizaciones.js","sourceRoot":"","sources":["../../src/schemas/localizaciones.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;GASG;AAEH,+DAA+D;AAC/D,SAAS,KAAK,CAAC,MAA+B,EAAE,GAAW,EAAE,KAAc;IACzE,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAC/C,CAAC;AAID,MAAM,CAAC,MAAM,SAAS,GAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AAqBvF,MAAM,CAAC,MAAM,aAAa,GAA0C;IAClE,KAAK,EAAE;QACL,QAAQ,EAAE,aAAa;QACvB,WAAW,EAAE,aAAa;QAC1B,cAAc,EAAE,WAAW;QAC3B,aAAa,EAAE,cAAc;QAC7B,eAAe,EAAE,IAAI;QACrB,IAAI,EAAE,wCAAwC;QAC9C,OAAO,EAAE,wCAAwC;QACjD,UAAU,EAAE,OAAO;KACpB;IACD,KAAK,EAAE;QACL,QAAQ,EAAE,aAAa;QACvB,WAAW,EAAE,aAAa;QAC1B,cAAc,EAAE,iBAAiB;QACjC,aAAa,EAAE,cAAc;QAC7B,eAAe,EAAE,KAAK;QACtB,IAAI,EAAE,wCAAwC;QAC9C,OAAO,EAAE,wCAAwC;QACjD,UAAU,EAAE,OAAO;KACpB;IACD,OAAO,EAAE;QACP,QAAQ,EAAE,aAAa;QACvB,WAAW,EAAE,aAAa;QAC1B,cAAc,EAAE,WAAW;QAC3B,aAAa,EAAE,cAAc;QAC7B,eAAe,EAAE,IAAI;QACrB,IAAI,EAAE,0CAA0C;QAChD,6EAA6E;QAC7E,OAAO,EAAE,0CAA0C;QACnD,UAAU,EAAE,SAAS;KACtB;IACD,QAAQ,EAAE;QACR,QAAQ,EAAE,cAAc;QACxB,WAAW,EAAE,aAAa;QAC1B,cAAc,EAAE,WAAW;QAC3B,aAAa,EAAE,UAAU;QACzB,eAAe,EAAE,IAAI;QACrB,IAAI,EAAE,2CAA2C;QACjD,OAAO,EAAE,2CAA2C;QACpD,UAAU,EAAE,UAAU;KACvB;CACF,CAAC;AAEF,MAAM,+BAA+B,GAAG;IACtC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IAC3E,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;IAC/F,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IACjG,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IACrF,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,wDAAwD,CAAC;IACrE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IACpF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IACjF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IACjF,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,EAAE;SACV,QAAQ,CAAC,4FAA4F,CAAC;IACzG,iBAAiB,EAAE,CAAC;SACjB,MAAM,CACL,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAmB,EAAE,sEAAsE,CAAC,EAC7G,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAClC;SACA,QAAQ,EAAE;SACV,QAAQ,CACP,uJAAuJ,CACxJ;CACJ,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;SAC/C,QAAQ,CAAC,uEAAuE,CAAC;IACpF,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;IACjG,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,8CAA8C,CAAC;IACvF,eAAe,EAAE,CAAC;SACf,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,CAAC,gFAAgF,CAAC;IAC7F,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,EAAE;SACV,QAAQ,CACP,0HAA0H,CAC3H;IACH,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,oFAAoF,CAAC;IACjG,GAAG,+BAA+B;CACnC,CAAC;AAEF,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;SAC/C,QAAQ,CAAC,yDAAyD,CAAC;IACtE,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,0EAA0E,CAAC;IACvF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IACrE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IAC9F,GAAG,+BAA+B;CACnC,CAAC;AAoBF,wEAAwE;AACxE,MAAM,UAAU,4BAA4B,CAC1C,IAAsB,EACtB,IAA+B;IAE/B,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,IAAI,GAA4B,EAAE,CAAC;IACzC,KAAK,CAAC,IAAI,EAAE,eAAe,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACxC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,IAAI,IAAI,KAAK,OAAO;QAAE,KAAK,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IACpE,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACtC,KAAK,CAAC,IAAI,EAAE,eAAe,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,EAAE,eAAe,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1C,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IACzC,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IACzC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,aAAa,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9C,IAAI,IAAI,CAAC,iBAAiB;QAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACxE,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/schemas/pedidos-compras.d.ts

@@ -20,12 +20,14 @@ import { z } from 'zod';
  *   - recibido=true   → `ALCC_PED_RECIB!=''` (campo tiene valor → recibido)
  *   - pendiente       → ambos campos vacíos
  *
- * Esta convención NO ha sido verificada contra la API real de Freemática.
- * Si en pruebas funcionales el filtro no actúa correctamente, puede que el
- * centinela sea el literal `null` (como en CARCL_FECIMPAG), un valor 'S'/'N'
- * o un valor numérico '1'/'0'. Documentado para futura verificación empírica.
- *
- * TODO(TD-152): verificar contra API real cuando esté disponible.
+ * Verificación parcial contra la API real (v0.9.0): estado=bloqueado devuelve
+ * 7059/33545 pedidos (subconjunto real) y estado=pendiente devuelve 0 en esta
+ * organización — la convención `!=''`/`==''` funciona sobre columnas de texto.
+ * AVISO: NO usar el literal `null` como centinela alternativo — está
+ * desacreditado empíricamente en v0.9.0 (`==null` devuelve 0 resultados
+ * silenciosamente y `=='null'` responde 500; ver CARCL_FECIMPAG y FECHA_BAJA
+ * de proveedores, que migraron a rangos de fecha). Sobre columnas de FECHA la
+ * comparación con `''` tampoco funciona (devuelve 0).
  */
 export declare const EstadoPedidoEnum: z.ZodEnum<{
     pendiente: "pendiente";

package/dist/schemas/pedidos-compras.js

@@ -21,12 +21,14 @@ import { PaginationSchema } from './pagination.js';
  *   - recibido=true   → `ALCC_PED_RECIB!=''` (campo tiene valor → recibido)
  *   - pendiente       → ambos campos vacíos
  *
- * Esta convención NO ha sido verificada contra la API real de Freemática.
- * Si en pruebas funcionales el filtro no actúa correctamente, puede que el
- * centinela sea el literal `null` (como en CARCL_FECIMPAG), un valor 'S'/'N'
- * o un valor numérico '1'/'0'. Documentado para futura verificación empírica.
- *
- * TODO(TD-152): verificar contra API real cuando esté disponible.
+ * Verificación parcial contra la API real (v0.9.0): estado=bloqueado devuelve
+ * 7059/33545 pedidos (subconjunto real) y estado=pendiente devuelve 0 en esta
+ * organización — la convención `!=''`/`==''` funciona sobre columnas de texto.
+ * AVISO: NO usar el literal `null` como centinela alternativo — está
+ * desacreditado empíricamente en v0.9.0 (`==null` devuelve 0 resultados
+ * silenciosamente y `=='null'` responde 500; ver CARCL_FECIMPAG y FECHA_BAJA
+ * de proveedores, que migraron a rangos de fecha). Sobre columnas de FECHA la
+ * comparación con `''` tampoco funciona (devuelve 0).
  */
 export const EstadoPedidoEnum = z.enum(['pendiente', 'bloqueado', 'recibido']);
 /**

package/dist/schemas/pedidos-compras.js.map

@@ -1 +1 @@
-{"version":3,"file":"pedidos-compras.js","sourceRoot":"","sources":["../../src/schemas/pedidos-compras.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pedidos-compras.js","sourceRoot":"","sources":["../../src/schemas/pedidos-compras.ts"],"names":[],"mappings":"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"}

package/dist/server-instructions.js

@@ -5,10 +5,29 @@ Este servidor expone operaciones del API REST de Freemática como tools MCP.
 
 ## Tools destacadas (lista parcial; el resto se descubren vía tools/list)
 
+### Artículos — catálogo de inventario (3)
+
+- **freematica_list_articulos(page, items, filtros?)** — Catálogo completo de
+  artículos/materiales/consumibles con referencias. Filtros (EXACTOS, sin
+  búsqueda parcial): codArticulo, tipoCodigo, codProveedor, linea, familia,
+  subfamilia, descripcion, codigoBarras, activo. Cada item incluye \`idReg\`.
+- **freematica_get_articulo(id)** — Detalle de un artículo. \`id\` = \`idReg\`.
+- **freematica_get_precio_articulo(id)** — Precios de venta (PRECIO_VENTA,
+  DESCUENTO, FACTURABLE). \`id\` = \`idReg\` de list_articulos.
+
 ### Materiales (1)
 
 - **freematica_list_materiales_asignados_servicios** — Lista de material
   asignado a servicios (sin parámetros). Devuelve { items, count, total }.
+  OJO: es material YA asignado a servicios de contratos; para el catálogo de
+  referencias/consumibles usa freematica_list_articulos.
+
+### Personal (2)
+
+- **freematica_list_personal(page, items, filtros?)** — Lista paginada de
+  empleados. Filtros EXACTOS (sin búsqueda parcial): empresa, delegacion,
+  codPersona, nombre, apellido, nif, situacion, departamento, seccion.
+- **freematica_get_persona(id)** — Detalle. \`id\` = \`idReg\` de list_personal.
 
 ### Datos maestros (1)
 
@@ -91,6 +110,30 @@ Flujo típico para crear un contrato completo:
 3. freematica_create_servicio_historico_precios con los precios.
 4. (opcional) freematica_create_servicio_facturacion_txt.
 
+## Clientes, Contactos y Localizaciones — escritura
+
+Con FREEMATICA_ENABLE_WRITES=true (no existe borrado):
+
+- **freematica_create_cliente** — requeridos: grupoCliente, codCliente,
+  nombre, nif, tipoImpuesto, divisa, tipoFacturacion (D/M/Q). El idReg se
+  calcula automáticamente.
+- **freematica_update_cliente(idReg, …)** — actualización parcial: la tool
+  recupera el cliente y fusiona los cambios antes del PUT.
+- **freematica_create_contacto_cliente** — requeridos: grupoCliente y
+  codCliente. Opcionales: nombreApellidos, cargo, telefono, movil, email…
+- **freematica_update_contacto_cliente(idReg, …)** — parcial (fetch+merge).
+- **freematica_create_localizacion_cliente(tipo, …)** — tipo: cobro | envio |
+  factura | servicio. formaPago solo se exige en cobro; nombre en todos salvo
+  envío. Campos específicos del tipo vía camposAdicionales.
+- **freematica_update_localizacion_cliente(tipo, idReg, …)** — parcial
+  (fetch+merge). El idReg sale de la list tool del tipo.
+
+Flujo típico cliente nuevo completo:
+1. freematica_create_cliente
+2. freematica_create_contacto_cliente
+3. freematica_create_localizacion_cliente (tipo=servicio, y cobro/factura si aplica)
+4. freematica_create_contrato + servicios (ver sección Contratos)
+
 ## IDs opacos en endpoints de detalle
 
 Las tools \`freematica_get_*\` requieren un \`id\` que es el campo \`idReg\` de los

package/dist/server-instructions.js.map

@@ -1 +1 @@
-{"version":3,"file":"server-instructions.js","sourceRoot":"","sources":["../src/server-instructions.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,2BAA2B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4H1C,CAAC,IAAI,EAAE,CAAC"}
+{"version":3,"file":"server-instructions.js","sourceRoot":"","sources":["../src/server-instructions.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,2BAA2B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuK1C,CAAC,IAAI,EAAE,CAAC"}

package/dist/server.js

@@ -2,6 +2,7 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { FREEMATICA_MCP_INSTRUCTIONS } from './server-instructions.js';
 import { VERSION } from './version.js';
 import { registerAlbaranesTools } from './tools/albaranes.js';
+import { registerArticulosTools } from './tools/articulos.js';
 import { registerCalendariosTools } from './tools/calendarios.js';
 import { registerCarteraTools } from './tools/cartera.js';
 import { registerClientesTools } from './tools/clientes.js';
@@ -22,21 +23,22 @@ export function createFreematicaServer(opts) {
     const server = new McpServer({ name: 'freematica-mcp', version: VERSION }, { instructions: FREEMATICA_MCP_INSTRUCTIONS });
     registerContratosTools(server, opts.client, { enableWrites: opts.enableWrites ?? false });
     registerMasterDataTools(server, opts.client);
-    registerClientesTools(server, opts.client);
-    registerContactosClientesTools(server, opts.client);
+    registerClientesTools(server, opts.client, { enableWrites: opts.enableWrites ?? false });
+    registerContactosClientesTools(server, opts.client, { enableWrites: opts.enableWrites ?? false });
     registerOportunidadesNegocioTools(server, opts.client);
     registerCarteraTools(server, opts.client);
     registerFacturasVentasTools(server, opts.client);
     registerFacturasComprasTools(server, opts.client);
     registerPedidosComprasTools(server, opts.client);
     registerProveedoresTools(server, opts.client);
-    registerLocalizacionesTools(server, opts.client);
+    registerLocalizacionesTools(server, opts.client, { enableWrites: opts.enableWrites ?? false });
     registerContabilidadTools(server, opts.client);
     registerPrlTools(server, opts.client);
     registerPersonalTools(server, opts.client);
     registerCalendariosTools(server, opts.client);
     registerFacturasElectronicasTools(server, opts.client);
     registerAlbaranesTools(server, opts.client);
+    registerArticulosTools(server, opts.client);
     return server;
 }
 //# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/tools/articulos.d.ts

@@ -0,0 +1,14 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FreematicaClient } from '../clients/freematica-client.js';
+/**
+ * Registra las tools MCP del dominio Artículos (catálogo de inventario).
+ *
+ * Tools expuestas:
+ *  1. freematica_list_articulos      — lista paginada con filtros FIQL
+ *  2. freematica_get_articulo        — detalle por idReg
+ *  3. freematica_get_precio_articulo — precios de venta por idReg
+ *
+ * @param server - Instancia del servidor MCP.
+ * @param client - Cliente Freemática autenticado.
+ */
+export declare function registerArticulosTools(server: McpServer, client: FreematicaClient): void;

package/dist/tools/articulos.js

@@ -0,0 +1,183 @@
+import { z } from 'zod';
+import { FreematicaError } from '../clients/base-client.js';
+import { PaginationSchema } from '../schemas/pagination.js';
+import { error, ok, okList } from './helpers.js';
+// ---------------------------------------------------------------------------
+// Tool names
+// ---------------------------------------------------------------------------
+const LIST_TOOL_NAME = 'freematica_list_articulos';
+const GET_TOOL_NAME = 'freematica_get_articulo';
+const PRECIO_TOOL_NAME = 'freematica_get_precio_articulo';
+// ---------------------------------------------------------------------------
+// Descriptions
+// ---------------------------------------------------------------------------
+const LIST_DESCRIPTION = [
+    'Devuelve la lista paginada del catálogo de artículos (materiales, consumibles,',
+    'productos) de Freemática.',
+    '',
+    'Endpoint: GET /part/v1/articulos',
+    '',
+    'Cada item incluye COD_ARTICULO (referencia), DESC_ART (descripción), COD_PROVEEDOR,',
+    'COD_LIN_ART (línea), COD_FAMILIA, COD_SUBFAM, COD_IVA, CODIGO_BARRAS, FECHA_ALTA,',
+    'FECHA_BAJA/MOTIVO_BAJA (baja del artículo) y el `idReg` opaco para usar en',
+    'freematica_get_articulo y freematica_get_precio_articulo.',
+    '',
+    'Los códigos de familia/subfamilia/línea se pueden resolver con',
+    'freematica_get_master_data (catalogs: familias, subfamilias).',
+    '',
+    'AVISO: todos los filtros son de coincidencia EXACTA (el API no soporta búsqueda',
+    'parcial en este endpoint). COD_ARTICULO puede llevar espacios iniciales que forman',
+    'parte del código (ej. " QQ10615"). Para explorar por texto, filtra por familia o',
+    'proveedor y revisa las descripciones de los resultados.',
+].join('\n');
+const GET_DESCRIPTION = [
+    'Devuelve el detalle completo de un artículo del catálogo.',
+    '',
+    'Endpoint: GET /part/v1/articulos/{idreg}',
+    '',
+    'El parámetro `id` DEBE ser el campo `idReg` (string opaco base64) que aparece',
+    'en los items de freematica_list_articulos.',
+].join('\n');
+const PRECIO_DESCRIPTION = [
+    'Devuelve los precios de venta de un artículo: PRECIO_VENTA, DESCUENTO y FACTURABLE.',
+    '',
+    'Endpoint: GET /pgrl/v1/precio-articulo/{idreg}',
+    '',
+    'El parámetro `id` DEBE ser el campo `idReg` (string opaco base64) que aparece',
+    'en los items de freematica_list_articulos (el mismo que usa freematica_get_articulo).',
+].join('\n');
+// ---------------------------------------------------------------------------
+// Schemas
+// ---------------------------------------------------------------------------
+/** Schema para freematica_list_articulos. */
+const ListArticulosSchema = {
+    ...PaginationSchema,
+    codArticulo: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Referencia del artículo (COD_ARTICULO). Coincidencia EXACTA — respeta los ' +
+        'espacios iniciales del código si los tiene (ej. " QQ10615").'),
+    tipoCodigo: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Tipo de código del artículo (TIPO_CODIGO, ej. "NC").'),
+    codProveedor: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código del proveedor habitual (COD_PROVEEDOR).'),
+    linea: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de línea de inventario (COD_LIN_ART).'),
+    familia: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de familia (COD_FAMILIA). Ver freematica_get_master_data catalog=familias.'),
+    subfamilia: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de subfamilia (COD_SUBFAM). Ver freematica_get_master_data catalog=subfamilias.'),
+    descripcion: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Descripción del artículo (DESC_ART). Coincidencia EXACTA con la descripción ' +
+        'completa — no soporta búsqueda parcial.'),
+    codigoBarras: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de barras (CODIGO_BARRAS). Coincidencia exacta.'),
+    activo: z
+        .boolean()
+        .optional()
+        .describe('true = artículos sin motivo de baja (MOTIVO_BAJA vacío); false = artículos ' +
+        'dados de baja. Si se omite, devuelve todos.'),
+};
+// ---------------------------------------------------------------------------
+// Register function
+// ---------------------------------------------------------------------------
+/**
+ * Registra las tools MCP del dominio Artículos (catálogo de inventario).
+ *
+ * Tools expuestas:
+ *  1. freematica_list_articulos      — lista paginada con filtros FIQL
+ *  2. freematica_get_articulo        — detalle por idReg
+ *  3. freematica_get_precio_articulo — precios de venta por idReg
+ *
+ * @param server - Instancia del servidor MCP.
+ * @param client - Cliente Freemática autenticado.
+ */
+export function registerArticulosTools(server, client) {
+    // -------------------------------------------------------------------------
+    // 1. freematica_list_articulos
+    // -------------------------------------------------------------------------
+    server.tool(LIST_TOOL_NAME, LIST_DESCRIPTION, ListArticulosSchema, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ page, items, codArticulo, tipoCodigo, codProveedor, linea, familia, subfamilia, descripcion, codigoBarras, activo, }) => {
+        try {
+            const result = await client.listArticulos({
+                page,
+                items,
+                codArticulo,
+                tipoCodigo,
+                codProveedor,
+                linea,
+                familia,
+                subfamilia,
+                descripcion,
+                codigoBarras,
+                activo,
+            });
+            return okList({ items: result.items, total: result.total, page, itemsPerPage: items });
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+    // -------------------------------------------------------------------------
+    // 2. freematica_get_articulo
+    // -------------------------------------------------------------------------
+    server.tool(GET_TOOL_NAME, GET_DESCRIPTION, {
+        id: z
+            .string()
+            .min(1)
+            .describe('idReg opaco del artículo (campo "idReg" en los items de freematica_list_articulos).'),
+    }, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ id }) => {
+        try {
+            const articulo = await client.getArticulo(id);
+            return ok(articulo);
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+    // -------------------------------------------------------------------------
+    // 3. freematica_get_precio_articulo
+    // -------------------------------------------------------------------------
+    server.tool(PRECIO_TOOL_NAME, PRECIO_DESCRIPTION, {
+        id: z
+            .string()
+            .min(1)
+            .describe('idReg opaco del artículo (campo "idReg" en los items de freematica_list_articulos).'),
+    }, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ id }) => {
+        try {
+            const precios = await client.getPrecioArticulo(id);
+            return ok(precios);
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+}
+//# sourceMappingURL=articulos.js.map

package/dist/tools/articulos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"articulos.js","sourceRoot":"","sources":["../../src/tools/articulos.ts"],"names":[],"mappings":"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"}

package/dist/tools/cartera.js

@@ -16,8 +16,8 @@ const LIST_DESCRIPTION = [
     '',
     'Filtros disponibles:',
     '- empresa, codCliente, grupoCliente, representante, formaPago, modoPago',
-    '- fechaDocDesde/Hasta (rango de fecha del documento)',
-    '- fechaVencimientoDesde/Hasta (rango de vencimiento)',
+    '- fechaDocDesde O fechaDocHasta (excluyentes: el API no soporta ambos a la vez)',
+    '- fechaVencimientoDesde (no existe fecha fin: el API la ignora)',
     '- estado: "pendiente" | "cancelado" | "derivado"',
     '- soloImpagados: true → solo documentos con impago registrado (CARCL_FECIMPAG no nulo)',
     '- referencia: referencia exacta del documento (CARCL_REFCAR)',

package/dist/tools/cartera.js.map

@@ -1 +1 @@
-{"version":3,"file":"cartera.js","sourceRoot":"","sources":["../../src/tools/cartera.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cartera.js","sourceRoot":"","sources":["../../src/tools/cartera.ts"],"names":[],"mappings":"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"}

package/dist/tools/clientes.d.ts

@@ -1,3 +1,4 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { FreematicaClient } from '../clients/freematica-client.js';
-export declare function registerClientesTools(server: McpServer, client: FreematicaClient): void;
+import { type RegisterOptions } from './helpers.js';
+export declare function registerClientesTools(server: McpServer, client: FreematicaClient, opts?: RegisterOptions): void;