@nubiia/mcp-freematica 0.7.0 → 0.8.0

package/dist/schemas/clientes.js

@@ -0,0 +1,205 @@
+import { z } from 'zod';
+/**
+ * Zod schemas (raw shapes) y builders de body para las tools de escritura de
+ * Clientes y Contactos de Clientes (módulo pgrl, v2).
+ *
+ * Convención: nombres amigables en castellano traducidos a los campos nativos
+ * del API (VoClientes / VoContactosClientes CC_*). Solo se incluyen en el body
+ * los campos definidos. Los campos menos comunes se pasan en
+ * `camposAdicionales` con su nombre nativo.
+ *
+ * Límites de longitud según el spec OpenAPI
+ * (https://api-config.freefy.cloud/openapi.json).
+ */
+/** Añade `target[key] = value` solo si value !== undefined. */
+function setIf(target, key, value) {
+    if (value !== undefined)
+        target[key] = value;
+}
+/** Convierte boolean a los flags '1'/'0' de Freemática. */
+function boolFlag(value) {
+    return value ? '1' : '0';
+}
+/**
+ * Passthrough de campos nativos no expuestos con nombre amigable.
+ * Se validan las claves con estilo de columna Freemática (mayúsculas + '_').
+ */
+const camposAdicionales = (ejemplo) => 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 correspondiente (ej: ${ejemplo}). Ver spec OpenAPI para la lista completa.`);
+// ---------------------------------------------------------------------------
+// Clientes (VoClientes, 109 campos)
+// ---------------------------------------------------------------------------
+const clienteOptionalFieldsShape = {
+    personaFiscal: z.string().max(200).optional().describe('Nombre fiscal (PERSONA_FISCAL, 200c).'),
+    contacto: z.string().max(40).optional().describe('Nombre del contacto (CONTACTO, 40c).'),
+    cargo: z.string().max(40).optional().describe('Cargo del contacto (CARGO, 40c).'),
+    tipoVia: z.string().max(10).optional().describe('Tipo de vía (TIPO_VIA, 10c). Ej: CL, AV.'),
+    nombreVia: z.string().max(40).optional().describe('Nombre de la vía (NOMBRE_VIA, 40c).'),
+    numero: z.string().max(10).optional().describe('Número de vía (NUMERO, 10c).'),
+    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).'),
+    codProvincia: z.string().max(5).optional().describe('Código de provincia (COD_PROVINCIA, 5c).'),
+    codPais: z.string().max(3).optional().describe('Código de país (COD_PAIS, 3c).'),
+    email: z.string().max(100).optional().describe('Correo electrónico (E_MAIL, 100c).'),
+    web: z.string().max(100).optional().describe('Página web (WEB, 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).'),
+    nombreComercial: z.string().max(40).optional().describe('Nombre comercial (NOMBRECOMERCIAL, 40c).'),
+    representante: z.string().max(5).optional().describe('Código del comercial (REPRESENTANTE, 5c).'),
+    codTipo: z.string().max(2).optional().describe('Código tipo de cliente (COD_TIPO, 2c).'),
+    comentarios: z.string().optional().describe('Comentarios libres (COMENTARIOS).'),
+    camposAdicionales: camposAdicionales('COD_TARIFA, COD_ZONA, CREDITO, CMC_LINKEDIN'),
+};
+export const CreateClienteShape = {
+    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.'),
+    nombre: z.string().max(40).describe('Nombre del cliente (NOMBRE_CLI, 40c). Requerido.'),
+    nif: z.string().max(15).describe('NIF (15c). Requerido.'),
+    tipoImpuesto: z.string().max(4).describe('Tipo de impuesto (TIPO_IMPTO, 4c). Requerido.'),
+    divisa: z.string().max(4).describe('Código de divisa (COD_DIVISA, 4c). Ej: EUR. Requerido.'),
+    tipoFacturacion: z
+        .enum(['D', 'M', 'Q'])
+        .describe('Tipo de proceso de facturación (TIPO_FACT): D=Diario, M=Mensual, Q=Quincenal. Requerido.'),
+    ...clienteOptionalFieldsShape,
+};
+export const UpdateClienteShape = {
+    idReg: z
+        .string()
+        .min(1)
+        .describe('idReg opaco del cliente (campo "idReg" en freematica_list_clientes).'),
+    nombre: z.string().max(40).optional().describe('Nombre del cliente (NOMBRE_CLI, 40c).'),
+    nif: z.string().max(15).optional().describe('NIF (15c).'),
+    tipoImpuesto: z.string().max(4).optional().describe('Tipo de impuesto (TIPO_IMPTO, 4c).'),
+    divisa: z.string().max(4).optional().describe('Código de divisa (COD_DIVISA, 4c).'),
+    tipoFacturacion: z
+        .enum(['D', 'M', 'Q'])
+        .optional()
+        .describe('Tipo de proceso de facturación (TIPO_FACT): D/M/Q.'),
+    ...clienteOptionalFieldsShape,
+};
+/**
+ * Construye el idReg de un cliente a partir de sus códigos naturales.
+ * Formato verificado contra el API real: Base64("{GRUPO}__{COD}").
+ */
+export function buildClienteIdReg(grupoCliente, codCliente) {
+    return Buffer.from(`${grupoCliente}__${codCliente}`).toString('base64');
+}
+/** Construye el body VoClientes con los campos definidos. */
+export function buildClienteBody(args) {
+    const body = {};
+    setIf(body, 'COD_GRUPO_CLI', args.grupoCliente);
+    setIf(body, 'COD_CLI', args.codCliente);
+    setIf(body, 'NOMBRE_CLI', args.nombre);
+    setIf(body, 'NIF', args.nif);
+    setIf(body, 'TIPO_IMPTO', args.tipoImpuesto);
+    setIf(body, 'COD_DIVISA', args.divisa);
+    setIf(body, 'TIPO_FACT', args.tipoFacturacion);
+    setIf(body, 'PERSONA_FISCAL', args.personaFiscal);
+    setIf(body, 'CONTACTO', args.contacto);
+    setIf(body, 'CARGO', args.cargo);
+    setIf(body, 'TIPO_VIA', args.tipoVia);
+    setIf(body, 'NOMBRE_VIA', args.nombreVia);
+    setIf(body, 'NUMERO', args.numero);
+    setIf(body, 'COD_POBLACION', args.codPoblacion);
+    setIf(body, 'COD_POSTAL', args.codPostal);
+    setIf(body, 'COD_PROVINCIA', args.codProvincia);
+    setIf(body, 'COD_PAIS', args.codPais);
+    setIf(body, 'E_MAIL', args.email);
+    setIf(body, 'WEB', args.web);
+    setIf(body, 'TELEFONO1', args.telefono1);
+    setIf(body, 'TELEFONO2', args.telefono2);
+    setIf(body, 'NOMBRECOMERCIAL', args.nombreComercial);
+    setIf(body, 'REPRESENTANTE', args.representante);
+    setIf(body, 'COD_TIPO', args.codTipo);
+    setIf(body, 'COMENTARIOS', args.comentarios);
+    if (args.camposAdicionales)
+        Object.assign(body, args.camposAdicionales);
+    return body;
+}
+// ---------------------------------------------------------------------------
+// Contactos de clientes (VoContactosClientes, campos CC_*)
+// ---------------------------------------------------------------------------
+const contactoOptionalFieldsShape = {
+    nombreApellidos: z.string().max(100).optional().describe('Nombre y apellidos (CC_NOM_APELL, 100c).'),
+    cargo: z.string().max(40).optional().describe('Cargo (CC_CARGO, 40c).'),
+    codCargo: z.string().max(4).optional().describe('Código de cargo (CC_COD_CARGO, 4c). Catálogo cargos-clientes.'),
+    telefono: z.string().max(15).optional().describe('Teléfono (CC_TELEFONO, 15c).'),
+    movil: z.string().max(15).optional().describe('Móvil (CC_MOBIL, 15c).'),
+    email: z.string().max(100).optional().describe('Correo electrónico (CC_EMAIL1, 100c).'),
+    nif: z.string().max(15).optional().describe('NIF del contacto (CC_NIF, 15c).'),
+    comentarios: z.string().max(1000).optional().describe('Comentarios (CC_COMENTARIOS, 1000c).'),
+    contactoPrincipal: z
+        .boolean()
+        .optional()
+        .describe('Contacto principal (CC_CONTACTO_PRINCIPAL): true → "1", false → "0".'),
+    decisor: z.boolean().optional().describe('Contacto decisor (CC_DECISOR): true → "1", false → "0".'),
+    inactivo: z.boolean().optional().describe('Contacto inactivo (CC_INACTIVO): true → "1", false → "0".'),
+    localizacion: z
+        .number()
+        .int()
+        .optional()
+        .describe('Código de localización del cliente a la que pertenece (CC_LOCALIZ).'),
+    linkedin: z.string().max(200).optional().describe('LinkedIn (CC_LINKEDIN, 200c).'),
+    camposAdicionales: camposAdicionales('CC_SALUDO, CC_TRATAMIENTO, CC_MAILING'),
+};
+export const CreateContactoClienteShape = {
+    grupoCliente: z.number().int().describe('Código de grupo de cliente (CC_GRUPO_CLI). Requerido.'),
+    codCliente: z.string().max(10).describe('Código de cliente (CC_CLI, 10c). Requerido.'),
+    ...contactoOptionalFieldsShape,
+};
+export const UpdateContactoClienteShape = {
+    idReg: z
+        .string()
+        .min(1)
+        .describe('idReg opaco del contacto (campo "idReg" en freematica_list_contactos_clientes).'),
+    ...contactoOptionalFieldsShape,
+};
+/** Construye el body VoContactosClientes con los campos definidos. */
+export function buildContactoClienteBody(args) {
+    const body = {};
+    setIf(body, 'CC_GRUPO_CLI', args.grupoCliente);
+    setIf(body, 'CC_CLI', args.codCliente);
+    setIf(body, 'CC_NOM_APELL', args.nombreApellidos);
+    setIf(body, 'CC_CARGO', args.cargo);
+    setIf(body, 'CC_COD_CARGO', args.codCargo);
+    setIf(body, 'CC_TELEFONO', args.telefono);
+    setIf(body, 'CC_MOBIL', args.movil);
+    setIf(body, 'CC_EMAIL1', args.email);
+    setIf(body, 'CC_NIF', args.nif);
+    setIf(body, 'CC_COMENTARIOS', args.comentarios);
+    if (args.contactoPrincipal !== undefined)
+        body['CC_CONTACTO_PRINCIPAL'] = boolFlag(args.contactoPrincipal);
+    if (args.decisor !== undefined)
+        body['CC_DECISOR'] = boolFlag(args.decisor);
+    if (args.inactivo !== undefined)
+        body['CC_INACTIVO'] = boolFlag(args.inactivo);
+    setIf(body, 'CC_LOCALIZ', args.localizacion);
+    setIf(body, 'CC_LINKEDIN', args.linkedin);
+    if (args.camposAdicionales)
+        Object.assign(body, args.camposAdicionales);
+    return body;
+}
+/**
+ * Claves de metadatos de presentación que devuelven los GET de Freemática y
+ * que no forman parte del Vo de escritura. Se eliminan antes de hacer el
+ * merge de un update (fetch + merge + PUT).
+ */
+const METADATA_KEYS = ['RowNumber', '_id', '_cellSettings'];
+/**
+ * Fusiona el estado actual de un registro (obtenido por GET) con los cambios
+ * a aplicar, eliminando los metadatos de presentación.
+ *
+ * ASUNCIÓN EMPÍRICA: los endpoints PUT de Freemática aceptan el objeto
+ * completo devuelto por el GET (mismos nombres de columna). Si en pruebas
+ * funcionales el API rechazara algún campo de solo lectura, habría que
+ * añadirlo a METADATA_KEYS.
+ */
+export function mergeForUpdate(current, changes) {
+    const merged = { ...current, ...changes };
+    for (const key of METADATA_KEYS)
+        delete merged[key];
+    return merged;
+}
+//# sourceMappingURL=clientes.js.map

package/dist/schemas/clientes.js.map

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

package/dist/schemas/localizaciones.d.ts

@@ -0,0 +1,90 @@
+import { z } from 'zod';
+export type LocalizacionTipo = 'cobro' | 'envio' | 'factura' | 'servicio';
+export declare const LOC_TIPOS: LocalizacionTipo[];
+interface LocFieldMap {
+    /** Columna del código de localización (requerida por el API). */
+    codField: string;
+    /** Columna del nombre/denominación. */
+    nombreField: string;
+    /** Columna del domicilio. */
+    domicilioField: string;
+    /** Columna de la persona de contacto. */
+    contactoField: string;
+    /** ¿El API exige el nombre en el alta? */
+    nombreRequerido: boolean;
+    /** Path del recurso v2 (list/create; update añade /{idReg}). */
+    path: string;
+    /** Path del GET singular usado en el fetch+merge del update. */
+    getPath: string;
+    /** Sufijo del nombre de tool: freematica_*_localizacion_<sufijo>_cliente. */
+    toolSuffix: string;
+}
+export declare const LOC_FIELD_MAP: Record<LocalizacionTipo, LocFieldMap>;
+/**
+ * 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 declare const CreateLocalizacionClienteShape: {
+    codPais: z.ZodOptional<z.ZodNumber>;
+    codProvincia: z.ZodOptional<z.ZodString>;
+    codPoblacion: z.ZodOptional<z.ZodString>;
+    codPostal: z.ZodOptional<z.ZodString>;
+    domicilio: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+    telefono1: z.ZodOptional<z.ZodString>;
+    telefono2: z.ZodOptional<z.ZodString>;
+    contacto: z.ZodOptional<z.ZodString>;
+    camposAdicionales: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+    tipo: z.ZodEnum<{
+        cobro: "cobro";
+        envio: "envio";
+        factura: "factura";
+        servicio: "servicio";
+    }>;
+    grupoCliente: z.ZodNumber;
+    codCliente: z.ZodString;
+    codLocalizacion: z.ZodNumber;
+    nombre: z.ZodOptional<z.ZodString>;
+    formaPago: z.ZodOptional<z.ZodString>;
+};
+export declare const UpdateLocalizacionClienteShape: {
+    codPais: z.ZodOptional<z.ZodNumber>;
+    codProvincia: z.ZodOptional<z.ZodString>;
+    codPoblacion: z.ZodOptional<z.ZodString>;
+    codPostal: z.ZodOptional<z.ZodString>;
+    domicilio: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+    telefono1: z.ZodOptional<z.ZodString>;
+    telefono2: z.ZodOptional<z.ZodString>;
+    contacto: z.ZodOptional<z.ZodString>;
+    camposAdicionales: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+    tipo: z.ZodEnum<{
+        cobro: "cobro";
+        envio: "envio";
+        factura: "factura";
+        servicio: "servicio";
+    }>;
+    idReg: z.ZodString;
+    nombre: z.ZodOptional<z.ZodString>;
+    formaPago: z.ZodOptional<z.ZodString>;
+};
+export type LocalizacionClienteFields = {
+    grupoCliente?: number;
+    codCliente?: string;
+    codLocalizacion?: number;
+    nombre?: string;
+    formaPago?: string;
+    codPais?: number;
+    codProvincia?: string;
+    codPoblacion?: string;
+    codPostal?: string;
+    domicilio?: string;
+    email?: string;
+    telefono1?: string;
+    telefono2?: string;
+    contacto?: string;
+    camposAdicionales?: Record<string, string | number>;
+};
+/** Construye el body del Vo de localización correspondiente al tipo. */
+export declare function buildLocalizacionClienteBody(tipo: LocalizacionTipo, args: LocalizacionClienteFields): Record<string, unknown>;
+export {};

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":"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"}

package/dist/server-instructions.js

@@ -91,6 +91,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoJ1C,CAAC,IAAI,EAAE,CAAC"}

package/dist/server.js

@@ -22,15 +22,15 @@ 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);

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/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;

package/dist/tools/clientes.js

@@ -1,9 +1,12 @@
 import { z } from 'zod';
 import { FreematicaError } from '../clients/base-client.js';
 import { PaginationSchema } from '../schemas/pagination.js';
+import { CreateClienteShape, UpdateClienteShape, buildClienteBody, buildClienteIdReg, mergeForUpdate, } from '../schemas/clientes.js';
 import { error, ok, okList } from './helpers.js';
 const LIST_TOOL_NAME = 'freematica_list_clientes';
 const GET_TOOL_NAME = 'freematica_get_cliente';
+const CREATE_TOOL_NAME = 'freematica_create_cliente';
+const UPDATE_TOOL_NAME = 'freematica_update_cliente';
 const LIST_DESCRIPTION = [
     'Devuelve la lista paginada de clientes de Freemática.',
     '',
@@ -16,11 +19,35 @@ const GET_DESCRIPTION = [
     '',
     'El parámetro `id` DEBE ser el campo `idReg` (string opaco base64) que aparece en los items de freematica_list_clientes. NO usar COD_CLI ni otro código natural — el API devuelve not_found.',
 ].join('\n');
-export function registerClientesTools(server, client) {
+const CREATE_DESCRIPTION = [
+    'Da de alta un cliente en Freemática.',
+    '',
+    'Endpoint: POST /pgrl/v2/clientes — body VoClientes (109 campos).',
+    'Requeridos: grupoCliente, codCliente, nombre (40c), nif, tipoImpuesto,',
+    'divisa (ej. EUR) y tipoFacturacion (D=Diario, M=Mensual, Q=Quincenal).',
+    'El idReg del cliente se calcula automáticamente (Base64 "GRUPO__COD").',
+    '',
+    'Los campos no expuestos con nombre amigable se pasan en camposAdicionales',
+    'con su nombre nativo (ej. COD_TARIFA, CREDITO). Devuelve el cliente creado.',
+].join('\n');
+const UPDATE_DESCRIPTION = [
+    'Actualiza un cliente existente (actualización parcial).',
+    '',
+    'Endpoint: PUT /pgrl/v2/clientes/{idReg}. La tool primero recupera el',
+    'cliente actual, aplica encima los campos informados y envía el objeto',
+    'completo (el API exige los campos obligatorios en cada PUT). El estado',
+    'previo queda en el log de auditoría.',
+].join('\n');
+export function registerClientesTools(server, client, opts = { enableWrites: false }) {
     server.tool(LIST_TOOL_NAME, LIST_DESCRIPTION, PaginationSchema, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ page, items }) => {
         try {
             const result = await client.listClientes({ page, items });
-            return okList({ items: result.items, total: result.total, page, itemsPerPage: items });
+            return okList({
+                items: result.items,
+                total: result.total,
+                page,
+                itemsPerPage: items,
+            });
         }
         catch (err) {
             if (err instanceof FreematicaError)
@@ -44,5 +71,39 @@ export function registerClientesTools(server, client) {
             return error(err instanceof Error ? err : new Error(String(err)));
         }
     });
+    if (!opts.enableWrites)
+        return;
+    server.tool(CREATE_TOOL_NAME, CREATE_DESCRIPTION, CreateClienteShape, { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }, async (args) => {
+        try {
+            const fields = args;
+            const body = buildClienteBody(fields);
+            // El API exige idReg también en el alta; se deriva de los códigos naturales.
+            body['idReg'] = buildClienteIdReg(fields.grupoCliente, fields.codCliente);
+            const created = await client.createCliente(body);
+            return ok(created);
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+    server.tool(UPDATE_TOOL_NAME, UPDATE_DESCRIPTION, UpdateClienteShape, { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true }, async ({ idReg, ...fields }) => {
+        try {
+            const changes = buildClienteBody(fields);
+            if (Object.keys(changes).length === 0) {
+                return error(new Error('Debes informar al menos un campo a actualizar además de idReg.'));
+            }
+            const current = await client.getCliente(idReg);
+            const body = mergeForUpdate(current, changes);
+            const updated = await client.updateCliente(idReg, body);
+            return ok(updated);
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
 }
 //# sourceMappingURL=clientes.js.map