@nubiia/mcp-freematica 0.7.0 → 0.9.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/facturas-ventas.d.ts

@@ -8,15 +8,19 @@ import { z } from 'zod';
  * Mapeo de filtros → campos FIQL de Freemática:
  * | Filtro lógico              | Campo FIQL       |
  * |----------------------------|------------------|
- * | empresa                    | FVC_EMP          |
- * | codCliente                 | FVC_CODAUX       |
- * | representante              | FVC_CODREP       |
- * | fechaFacturaDesde          | FVC_FECFAC =ge=  |
- * | fechaFacturaHasta          | FVC_FECFAC =le=  |
- * | serie                      | FVC_SERFAC       |
- * | numFactura                 | FVC_NUMFAC       |
- * | formaPago                  | FVC_CODFPAG      |
- * | traspasadoContabilidad     | FVC_TRSCONT      |
+ * | empresa                    | FVC_CODEMP          |
+ * | codCliente                 | FVC_CODCLI       |
+ * | representante              | FVC_CODREPRES       |
+ * | fechaFacturaDesde          | FVC_FCHFAC =ge=  |
+ * | fechaFacturaHasta          | FVC_FCHFAC =lt= (día siguiente; =le= responde 500) |
+ *
+ * fechaFacturaDesde y fechaFacturaHasta son EXCLUYENTES entre sí: el API
+ * devuelve 0 filas si se combinan dos condiciones de rango sobre el mismo
+ * campo (verificado en producción).
+ * | serie                      | FVC_SERIEFRA       |
+ * | numFactura                 | FVC_NUMFRA       |
+ * | formaPago                  | FVC_FPAGO      |
+ * | traspasadoContabilidad     | FVC_TRASP_CONTAB      |
  * | delegacion                 | FVC_DELEG        |
  */
 export declare const ListFacturasCabeceraFiltersSchema: {
@@ -53,9 +57,9 @@ export type ListFacturasCabeceraFilters = {
  * Mapeo de filtros → campos FIQL de Freemática (prefijo `FVL_`):
  * | Filtro lógico  | Campo FIQL       |
  * |----------------|------------------|
- * | codArticulo    | FVL_CODART       |
- * | codFamilia     | FVL_CODFAM       |
- * | codSubfamilia  | FVL_CODSFAM      |
+ * | codArticulo    | FVL_CODARTIC       |
+ * | codFamilia     | FVL_COD_FAMILIA       |
+ * | codSubfamilia  | FVL_COD_SUBFAM      |
  * | delegacion     | FVL_DELEG        |
  */
 export declare const ListFacturaLineasFiltersSchema: {
@@ -80,7 +84,7 @@ export type ListFacturaLineasFilters = {
  * Mapeo de filtros → campos FIQL de Freemática (prefijo `FVI_`):
  * | Filtro lógico  | Campo FIQL  |
  * |----------------|-------------|
- * | tipoIva        | FVI_TIPIVA  |
+ * | tipoIva        | FVI_TIPO_IVA  |
  */
 export declare const ListFacturaIvaFiltersSchema: {
     tipoIva: z.ZodOptional<z.ZodString>;
@@ -98,9 +102,9 @@ export type ListFacturaIvaFilters = {
  * Mapeo de filtros → campos FIQL de Freemática (prefijo `FVV_`):
  * | Filtro lógico             | Campo FIQL       |
  * |---------------------------|------------------|
- * | fechaVencimientoDesde     | FVV_FECVCTO =ge= |
- * | fechaVencimientoHasta     | FVV_FECVCTO =le= |
- * | modoPago                  | FVV_CODMPAG      |
+ * | fechaVencimientoDesde     | FVV_FCH_VTO =ge= |
+ * | fechaVencimientoHasta     | FVV_FCH_VTO =le= |
+ * | modoPago                  | FVV_MODOPAGO      |
  */
 export declare const ListFacturaVencimientosFiltersSchema: {
     fechaVencimientoDesde: z.ZodOptional<z.ZodString>;

package/dist/schemas/facturas-ventas.js

@@ -9,15 +9,19 @@ import { PaginationSchema } from './pagination.js';
  * Mapeo de filtros → campos FIQL de Freemática:
  * | Filtro lógico              | Campo FIQL       |
  * |----------------------------|------------------|
- * | empresa                    | FVC_EMP          |
- * | codCliente                 | FVC_CODAUX       |
- * | representante              | FVC_CODREP       |
- * | fechaFacturaDesde          | FVC_FECFAC =ge=  |
- * | fechaFacturaHasta          | FVC_FECFAC =le=  |
- * | serie                      | FVC_SERFAC       |
- * | numFactura                 | FVC_NUMFAC       |
- * | formaPago                  | FVC_CODFPAG      |
- * | traspasadoContabilidad     | FVC_TRSCONT      |
+ * | empresa                    | FVC_CODEMP          |
+ * | codCliente                 | FVC_CODCLI       |
+ * | representante              | FVC_CODREPRES       |
+ * | fechaFacturaDesde          | FVC_FCHFAC =ge=  |
+ * | fechaFacturaHasta          | FVC_FCHFAC =lt= (día siguiente; =le= responde 500) |
+ *
+ * fechaFacturaDesde y fechaFacturaHasta son EXCLUYENTES entre sí: el API
+ * devuelve 0 filas si se combinan dos condiciones de rango sobre el mismo
+ * campo (verificado en producción).
+ * | serie                      | FVC_SERIEFRA       |
+ * | numFactura                 | FVC_NUMFRA       |
+ * | formaPago                  | FVC_FPAGO      |
+ * | traspasadoContabilidad     | FVC_TRASP_CONTAB      |
  * | delegacion                 | FVC_DELEG        |
  */
 export const ListFacturasCabeceraFiltersSchema = {
@@ -26,46 +30,46 @@ export const ListFacturasCabeceraFiltersSchema = {
         .string()
         .min(1)
         .optional()
-        .describe('Código de empresa Freemática (FVC_EMP). Ej.: "1".'),
+        .describe('Código de empresa Freemática (FVC_CODEMP). Ej.: "1".'),
     codCliente: z
         .string()
         .min(1)
         .optional()
-        .describe('Código natural del cliente facturado (FVC_CODAUX).'),
+        .describe('Código natural del cliente facturado (FVC_CODCLI).'),
     representante: z
         .string()
         .min(1)
         .optional()
-        .describe('Código del representante/comercial (FVC_CODREP).'),
+        .describe('Código del representante/comercial (FVC_CODREPRES).'),
     fechaFacturaDesde: z
         .string()
         .regex(/^\d{4}-\d{2}-\d{2}$/, 'Debe ser una fecha en formato ISO 8601 YYYY-MM-DD')
         .optional()
-        .describe('Fecha inicio de la factura (FVC_FECFAC). Formato YYYY-MM-DD. Inclusive.'),
+        .describe('Fecha inicio de la factura (FVC_FCHFAC). Formato YYYY-MM-DD. Inclusive. EXCLUYENTE con fechaFacturaHasta: usa solo uno de los dos por consulta (limitación del API).'),
     fechaFacturaHasta: z
         .string()
         .regex(/^\d{4}-\d{2}-\d{2}$/, 'Debe ser una fecha en formato ISO 8601 YYYY-MM-DD')
         .optional()
-        .describe('Fecha fin de la factura (FVC_FECFAC). Formato YYYY-MM-DD. Inclusive.'),
+        .describe('Fecha fin de la factura (FVC_FCHFAC). Formato YYYY-MM-DD. Inclusive. EXCLUYENTE con fechaFacturaDesde: usa solo uno de los dos por consulta (limitación del API).'),
     serie: z
         .string()
         .min(1)
         .optional()
-        .describe('Serie de facturación (FVC_SERFAC). Ej.: "A", "B".'),
+        .describe('Serie de facturación (FVC_SERIEFRA). Ej.: "A", "B".'),
     numFactura: z
         .string()
         .min(1)
         .optional()
-        .describe('Número de factura exacto (FVC_NUMFAC).'),
+        .describe('Número de factura exacto (FVC_NUMFRA).'),
     formaPago: z
         .string()
         .min(1)
         .optional()
-        .describe('Código de forma de pago (FVC_CODFPAG). Ej.: "REC", "TRF".'),
+        .describe('Código de forma de pago (FVC_FPAGO). Ej.: "REC", "TRF".'),
     traspasadoContabilidad: z
         .boolean()
         .optional()
-        .describe('Si true, filtra facturas ya traspasadas a contabilidad (FVC_TRSCONT). Si false, las no traspasadas.'),
+        .describe('Si true, filtra facturas ya traspasadas a contabilidad (FVC_TRASP_CONTAB). Si false, las no traspasadas.'),
     delegacion: z
         .string()
         .min(1)
@@ -78,9 +82,9 @@ export const ListFacturasCabeceraFiltersSchema = {
  * Mapeo de filtros → campos FIQL de Freemática (prefijo `FVL_`):
  * | Filtro lógico  | Campo FIQL       |
  * |----------------|------------------|
- * | codArticulo    | FVL_CODART       |
- * | codFamilia     | FVL_CODFAM       |
- * | codSubfamilia  | FVL_CODSFAM      |
+ * | codArticulo    | FVL_CODARTIC       |
+ * | codFamilia     | FVL_COD_FAMILIA       |
+ * | codSubfamilia  | FVL_COD_SUBFAM      |
  * | delegacion     | FVL_DELEG        |
  */
 export const ListFacturaLineasFiltersSchema = {
@@ -89,17 +93,17 @@ export const ListFacturaLineasFiltersSchema = {
         .string()
         .min(1)
         .optional()
-        .describe('Código de artículo (FVL_CODART).'),
+        .describe('Código de artículo (FVL_CODARTIC).'),
     codFamilia: z
         .string()
         .min(1)
         .optional()
-        .describe('Código de familia de artículo (FVL_CODFAM).'),
+        .describe('Código de familia de artículo (FVL_COD_FAMILIA).'),
     codSubfamilia: z
         .string()
         .min(1)
         .optional()
-        .describe('Código de subfamilia de artículo (FVL_CODSFAM).'),
+        .describe('Código de subfamilia de artículo (FVL_COD_SUBFAM).'),
     delegacion: z
         .string()
         .min(1)
@@ -112,7 +116,7 @@ export const ListFacturaLineasFiltersSchema = {
  * Mapeo de filtros → campos FIQL de Freemática (prefijo `FVI_`):
  * | Filtro lógico  | Campo FIQL  |
  * |----------------|-------------|
- * | tipoIva        | FVI_TIPIVA  |
+ * | tipoIva        | FVI_TIPO_IVA  |
  */
 export const ListFacturaIvaFiltersSchema = {
     ...PaginationSchema,
@@ -120,7 +124,7 @@ export const ListFacturaIvaFiltersSchema = {
         .string()
         .min(1)
         .optional()
-        .describe('Tipo de IVA (FVI_TIPIVA). Ej.: "21", "10", "4".'),
+        .describe('Tipo de IVA (FVI_TIPO_IVA). Ej.: "21", "10", "4".'),
 };
 /**
  * Filtros tipados para `freematica_list_factura_vencimientos`.
@@ -128,9 +132,9 @@ export const ListFacturaIvaFiltersSchema = {
  * Mapeo de filtros → campos FIQL de Freemática (prefijo `FVV_`):
  * | Filtro lógico             | Campo FIQL       |
  * |---------------------------|------------------|
- * | fechaVencimientoDesde     | FVV_FECVCTO =ge= |
- * | fechaVencimientoHasta     | FVV_FECVCTO =le= |
- * | modoPago                  | FVV_CODMPAG      |
+ * | fechaVencimientoDesde     | FVV_FCH_VTO =ge= |
+ * | fechaVencimientoHasta     | FVV_FCH_VTO =le= |
+ * | modoPago                  | FVV_MODOPAGO      |
  */
 export const ListFacturaVencimientosFiltersSchema = {
     ...PaginationSchema,
@@ -138,16 +142,16 @@ export const ListFacturaVencimientosFiltersSchema = {
         .string()
         .regex(/^\d{4}-\d{2}-\d{2}$/, 'Debe ser una fecha en formato ISO 8601 YYYY-MM-DD')
         .optional()
-        .describe('Fecha inicio de vencimiento (FVV_FECVCTO). Formato YYYY-MM-DD. Inclusive.'),
+        .describe('Fecha inicio de vencimiento (FVV_FCH_VTO). Formato YYYY-MM-DD. Inclusive.'),
     fechaVencimientoHasta: z
         .string()
         .regex(/^\d{4}-\d{2}-\d{2}$/, 'Debe ser una fecha en formato ISO 8601 YYYY-MM-DD')
         .optional()
-        .describe('Fecha fin de vencimiento (FVV_FECVCTO). Formato YYYY-MM-DD. Inclusive.'),
+        .describe('Fecha fin de vencimiento (FVV_FCH_VTO). Formato YYYY-MM-DD. Inclusive.'),
     modoPago: z
         .string()
         .min(1)
         .optional()
-        .describe('Código de modo de pago (FVV_CODMPAG). Ej.: "TRF", "CHQ".'),
+        .describe('Código de modo de pago (FVV_MODOPAGO). Ej.: "TRF", "CHQ".'),
 };
 //# sourceMappingURL=facturas-ventas.js.map

package/dist/schemas/facturas-ventas.js.map

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