@nubiia/mcp-freematica 0.6.1

package/dist/schemas/albaranes.js

@@ -0,0 +1,250 @@
+import { z } from 'zod';
+import { PaginationSchema } from './pagination.js';
+// ---------------------------------------------------------------------------
+// Albaranes de ventas (GET /pven/v2/albaranes-ventas)
+// ---------------------------------------------------------------------------
+//
+// Mapeo de filtros → query params del endpoint:
+//
+// Los params con (*) se envían como query params NATIVOS (no FIQL).
+// El endpoint albaranes-ventas usa exclusivamente params nativos para todos
+// sus filtros (no expone `rQuery` para los filtros principales).
+//
+// | Filtro lógico        | Param nativo   | Campo response |
+// |----------------------|----------------|----------------|
+// | empresa (*)          | codEmpresa     | ALVC_CODEMP    |
+// | delegacion           | codDelegacion  | ALVC_DELEG     |
+// | codCliente           | codCliente     | ALVC_CODCLI    |
+// | codDocumento         | codDocumento   | ALVC_CODDOC    |
+// | fechaDesde           | desdeFecha     | ALVC_FCHDOC    |
+// | fechaHasta           | hastaFecha     | ALVC_FCHDOC    |
+// | (orden)              | order          | —              |
+// | page / items         | page / items   | —              |
+/**
+ * Filtros tipados para `freematica_list_albaranes_ventas`.
+ *
+ * El endpoint GET /pven/v2/albaranes-ventas usa exclusivamente query params
+ * nativos. `codEmpresa` es obligatorio según el spec OpenAPI.
+ *
+ * Mapeo:
+ * | Filtro       | Query param    |
+ * |--------------|----------------|
+ * | empresa      | codEmpresa     |
+ * | delegacion   | codDelegacion  |
+ * | codCliente   | codCliente     |
+ * | codDocumento | codDocumento   |
+ * | fechaDesde   | desdeFecha     |
+ * | fechaHasta   | hastaFecha     |
+ * | order        | order          |
+ */
+export const ListAlbaranesVentasFiltersSchema = {
+    ...PaginationSchema,
+    empresa: z
+        .string()
+        .min(1)
+        .max(4)
+        .describe('Código de empresa Freemática (ALVC_CODEMP). Ej.: "1". Requerido por el endpoint.'),
+    delegacion: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de delegación (ALVC_DELEG). Se envía como codDelegacion.'),
+    codCliente: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código natural del cliente (ALVC_CODCLI). Se envía como codCliente.'),
+    codDocumento: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de documento/serie del albarán (ALVC_CODDOC). Se envía como codDocumento.'),
+    fechaDesde: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/, 'Debe ser una fecha en formato ISO 8601 YYYY-MM-DD')
+        .optional()
+        .describe('Fecha inicio del albarán (ALVC_FCHDOC). Formato YYYY-MM-DD. Se envía como desdeFecha.'),
+    fechaHasta: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/, 'Debe ser una fecha en formato ISO 8601 YYYY-MM-DD')
+        .optional()
+        .describe('Fecha fin del albarán (ALVC_FCHDOC). Formato YYYY-MM-DD. Se envía como hastaFecha.'),
+    order: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Campo de ordenación (ej: "ALVC_FCHDOC DESC"). Valor libre enviado como param nativo.'),
+};
+// ---------------------------------------------------------------------------
+// Albaranes-facturas (GET /pven/v2/albaranes-facturas)
+// ---------------------------------------------------------------------------
+//
+// Vinculación albarán ↔ factura. Este endpoint expone muy pocos filtros:
+// - `idReg`   (query param nativo) — ID opaco del registro de vinculación
+// - `rQuery`  (FIQL) — para filtros sobre campos FVCA_*
+//
+// Campos del response (prefijo FVCA_*):
+// | Campo FIQL       | Semántica                       |
+// |------------------|---------------------------------|
+// | FVCA_CODEMP      | Empresa                         |
+// | FVCA_SERIEFRA    | Serie de factura                |
+// | FVCA_NUMFRA      | Número de factura               |
+// | FVCA_CODCLI      | Código de cliente               |
+// | FVCA_NUMALB      | Número de albarán               |
+// | FVCA_FCHALB      | Fecha del albarán               |
+// | FVCA_NUMPED      | Número de pedido relacionado    |
+// | FVCA_FCHPED      | Fecha del pedido                |
+// | FVCA_FCHFAC      | Fecha de factura                |
+// | FVCA_CODDOC      | Código de documento             |
+//
+// Filtros propuestos:
+// - `idReg`       → query param nativo (caso principal)
+// - `empresa`     → FIQL FVCA_CODEMP==X
+// - `serie`       → FIQL FVCA_SERIEFRA==X
+// - `numFactura`  → FIQL FVCA_NUMFRA==N  (string, aunque el campo es integer)
+// - `codCliente`  → FIQL FVCA_CODCLI==X
+/**
+ * Filtros tipados para `freematica_list_albaranes_factura`.
+ *
+ * Endpoint: GET /pven/v2/albaranes-facturas
+ *
+ * El filtro `idReg` es un query param nativo. El resto se pasan como FIQL
+ * en el parámetro `rQuery`.
+ *
+ * Mapeo:
+ * | Filtro      | Mecanismo | Campo         |
+ * |-------------|-----------|---------------|
+ * | idReg       | nativo    | —             |
+ * | empresa     | FIQL      | FVCA_CODEMP   |
+ * | serie       | FIQL      | FVCA_SERIEFRA |
+ * | numFactura  | FIQL      | FVCA_NUMFRA   |
+ * | codCliente  | FIQL      | FVCA_CODCLI   |
+ */
+export const ListAlbaranesFacturaFiltersSchema = {
+    ...PaginationSchema,
+    idReg: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('ID opaco del registro de vinculación albarán-factura. Se envía como query param nativo.'),
+    empresa: z
+        .string()
+        .min(1)
+        .max(4)
+        .optional()
+        .describe('Código de empresa (FVCA_CODEMP). Filtro FIQL.'),
+    serie: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Serie de la factura (FVCA_SERIEFRA). Filtro FIQL.'),
+    numFactura: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Número de factura (FVCA_NUMFRA). Filtro FIQL.'),
+    codCliente: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código del cliente (FVCA_CODCLI). Filtro FIQL.'),
+};
+// ---------------------------------------------------------------------------
+// Resultados de facturación (GET /pvss/v1/facturacion-resultados)
+// ---------------------------------------------------------------------------
+//
+// Resultados del proceso batch de facturación automática desde vigilancia.
+// Este endpoint solo expone `rquery`/`rQuery` (FIQL) + `page` + `order`.
+//
+// Campos del response (prefijo FACT_*):
+// | Campo FIQL       | Semántica                          |
+// |------------------|------------------------------------|
+// | FACT_EMP         | Empresa                            |
+// | FACT_DELEG       | Delegación                         |
+// | FACT_CAL         | Calendario (año)                   |
+// | FACT_MES         | Mes del proceso                    |
+// | FACT_CTRT        | Contrato de servicios              |
+// | FACT_SERV        | Servicio                           |
+// | FACT_TIPFAC      | Tipo de facturación                |
+// | FACT_COD_CLI     | Código de cliente                  |
+// | FACT_TRASP       | Estado de traspaso                 |
+// | FACT_NUMDOC      | Número de documento generado       |
+// | FACT_PORC_FAC    | Porcentaje de facturación          |
+/**
+ * Filtros tipados para `freematica_list_resultados_facturacion`.
+ *
+ * Endpoint: GET /pvss/v1/facturacion-resultados
+ *
+ * Todos los filtros se envían como FIQL en el parámetro `rquery`.
+ *
+ * Mapeo:
+ * | Filtro      | Campo FIQL   |
+ * |-------------|--------------|
+ * | empresa     | FACT_EMP     |
+ * | delegacion  | FACT_DELEG   |
+ * | codCliente  | FACT_COD_CLI |
+ * | calendario  | FACT_CAL     |
+ * | mes         | FACT_MES     |
+ * | contrato    | FACT_CTRT    |
+ * | servicio    | FACT_SERV    |
+ * | tipoFac     | FACT_TIPFAC  |
+ * | traspasado  | FACT_TRASP   |
+ * | order       | order        |
+ */
+export const ListResultadosFacturacionFiltersSchema = {
+    ...PaginationSchema,
+    empresa: z
+        .string()
+        .min(1)
+        .max(4)
+        .optional()
+        .describe('Código de empresa (FACT_EMP). Filtro FIQL.'),
+    delegacion: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de delegación (FACT_DELEG). Filtro FIQL.'),
+    codCliente: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código del cliente (FACT_COD_CLI). Filtro FIQL.'),
+    calendario: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Año del calendario de facturación (FACT_CAL). Filtro FIQL. Ej.: "2024".'),
+    mes: z
+        .number()
+        .int()
+        .min(1)
+        .max(12)
+        .optional()
+        .describe('Mes del proceso de facturación (FACT_MES, 1-12). Filtro FIQL.'),
+    contrato: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de contrato de servicios (FACT_CTRT). Filtro FIQL.'),
+    servicio: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de servicio (FACT_SERV). Filtro FIQL.'),
+    tipoFac: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Tipo de facturación (FACT_TIPFAC). Filtro FIQL.'),
+    traspasado: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Estado de traspaso de la facturación (FACT_TRASP). Filtro FIQL. Ej.: "S" (sí), "N" (no).'),
+    order: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Campo de ordenación (ej: "FACT_MES DESC"). Param nativo order.'),
+};
+//# sourceMappingURL=albaranes.js.map

package/dist/schemas/albaranes.js.map

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

package/dist/schemas/cartera.d.ts

@@ -0,0 +1,70 @@
+import { z } from 'zod';
+/**
+ * Estado del documento de cartera de clientes.
+ *
+ * Se mapea al campo `CARCL_SITCAR` del API de Freemática:
+ * - `pendiente` → `CARCL_SITCAR==1`
+ * - `cancelado`  → `CARCL_SITCAR==2`
+ * - `derivado`   → `CARCL_SITCAR==3`
+ */
+export declare const EstadoCarteraEnum: z.ZodEnum<["pendiente", "cancelado", "derivado"]>;
+export type EstadoCartera = z.infer<typeof EstadoCarteraEnum>;
+/** Mapa de enum lógico → valor numérico FIQL en `CARCL_SITCAR`. */
+export declare const ESTADO_CARTERA_FIQL_MAP: Record<EstadoCartera, string>;
+/**
+ * Filtros tipados para `freematica_list_cartera_clientes`.
+ *
+ * Todos los campos son opcionales y se combinan con AND en la FIQL generada
+ * (`rquery`). El campo de paginación hereda de `PaginationSchema`.
+ *
+ * Mapeo de filtros → campos FIQL de Freemática:
+ * | Filtro lógico           | Campo FIQL      |
+ * |-------------------------|-----------------|
+ * | empresa                 | CARCL_EMP       |
+ * | codCliente              | CARCL_CODAUX    |
+ * | grupoCliente            | CARCL_GRUPAUX   |
+ * | representante           | CARCL_CODREP    |
+ * | formaPago               | CARCL_CODFPAG   |
+ * | modoPago                | CARCL_CODMPAG   |
+ * | fechaDocDesde           | CARCL_FECDOC =ge= |
+ * | fechaDocHasta           | CARCL_FECDOC =le= |
+ * | fechaVencimientoDesde   | CARCL_FECVCTO =ge= |
+ * | fechaVencimientoHasta   | CARCL_FECVCTO =le= |
+ * | estado                  | CARCL_SITCAR==N |
+ * | soloImpagados           | CARCL_FECIMPAG!=null |
+ * | referencia              | CARCL_REFCAR    |
+ */
+export declare const ListCarteraFiltersSchema: {
+    empresa: z.ZodOptional<z.ZodString>;
+    codCliente: z.ZodOptional<z.ZodString>;
+    grupoCliente: z.ZodOptional<z.ZodString>;
+    representante: z.ZodOptional<z.ZodString>;
+    formaPago: z.ZodOptional<z.ZodString>;
+    modoPago: z.ZodOptional<z.ZodString>;
+    fechaDocDesde: z.ZodOptional<z.ZodString>;
+    fechaDocHasta: z.ZodOptional<z.ZodString>;
+    fechaVencimientoDesde: z.ZodOptional<z.ZodString>;
+    fechaVencimientoHasta: z.ZodOptional<z.ZodString>;
+    estado: z.ZodOptional<z.ZodEnum<["pendiente", "cancelado", "derivado"]>>;
+    soloImpagados: z.ZodOptional<z.ZodBoolean>;
+    referencia: z.ZodOptional<z.ZodString>;
+    page: z.ZodDefault<z.ZodNumber>;
+    items: z.ZodDefault<z.ZodNumber>;
+};
+export type ListCarteraFilters = {
+    page?: number;
+    items?: number;
+    empresa?: string;
+    codCliente?: string;
+    grupoCliente?: string;
+    representante?: string;
+    formaPago?: string;
+    modoPago?: string;
+    fechaDocDesde?: string;
+    fechaDocHasta?: string;
+    fechaVencimientoDesde?: string;
+    fechaVencimientoHasta?: string;
+    estado?: EstadoCartera;
+    soloImpagados?: boolean;
+    referencia?: string;
+};

package/dist/schemas/cartera.js

@@ -0,0 +1,104 @@
+import { z } from 'zod';
+import { PaginationSchema } from './pagination.js';
+/**
+ * Estado del documento de cartera de clientes.
+ *
+ * Se mapea al campo `CARCL_SITCAR` del API de Freemática:
+ * - `pendiente` → `CARCL_SITCAR==1`
+ * - `cancelado`  → `CARCL_SITCAR==2`
+ * - `derivado`   → `CARCL_SITCAR==3`
+ */
+export const EstadoCarteraEnum = z.enum(['pendiente', 'cancelado', 'derivado']);
+/** Mapa de enum lógico → valor numérico FIQL en `CARCL_SITCAR`. */
+export const ESTADO_CARTERA_FIQL_MAP = {
+    pendiente: '1',
+    cancelado: '2',
+    derivado: '3',
+};
+/**
+ * Filtros tipados para `freematica_list_cartera_clientes`.
+ *
+ * Todos los campos son opcionales y se combinan con AND en la FIQL generada
+ * (`rquery`). El campo de paginación hereda de `PaginationSchema`.
+ *
+ * Mapeo de filtros → campos FIQL de Freemática:
+ * | Filtro lógico           | Campo FIQL      |
+ * |-------------------------|-----------------|
+ * | empresa                 | CARCL_EMP       |
+ * | codCliente              | CARCL_CODAUX    |
+ * | grupoCliente            | CARCL_GRUPAUX   |
+ * | representante           | CARCL_CODREP    |
+ * | formaPago               | CARCL_CODFPAG   |
+ * | modoPago                | CARCL_CODMPAG   |
+ * | fechaDocDesde           | CARCL_FECDOC =ge= |
+ * | fechaDocHasta           | CARCL_FECDOC =le= |
+ * | fechaVencimientoDesde   | CARCL_FECVCTO =ge= |
+ * | fechaVencimientoHasta   | CARCL_FECVCTO =le= |
+ * | estado                  | CARCL_SITCAR==N |
+ * | soloImpagados           | CARCL_FECIMPAG!=null |
+ * | referencia              | CARCL_REFCAR    |
+ */
+export const ListCarteraFiltersSchema = {
+    ...PaginationSchema,
+    empresa: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de empresa Freemática (CARCL_EMP). Ej.: "1".'),
+    codCliente: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código natural del cliente (CARCL_CODAUX). Ej.: "0001000".'),
+    grupoCliente: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de grupo de clientes (CARCL_GRUPAUX).'),
+    representante: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código del representante/comercial asignado (CARCL_CODREP).'),
+    formaPago: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de forma de pago (CARCL_CODFPAG). Ej.: "REC".'),
+    modoPago: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de modo de pago (CARCL_CODMPAG). Ej.: "TRF".'),
+    fechaDocDesde: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/, 'Debe ser una fecha en formato ISO 8601 YYYY-MM-DD')
+        .optional()
+        .describe('Fecha inicio del documento (CARCL_FECDOC). Formato YYYY-MM-DD. Inclusive.'),
+    fechaDocHasta: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/, 'Debe ser una fecha en formato ISO 8601 YYYY-MM-DD')
+        .optional()
+        .describe('Fecha fin del documento (CARCL_FECDOC). Formato YYYY-MM-DD. Inclusive.'),
+    fechaVencimientoDesde: 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 vencimiento (CARCL_FECVCTO). 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 (CARCL_FECVCTO). Formato YYYY-MM-DD. Inclusive.'),
+    estado: EstadoCarteraEnum.optional().describe('Estado del documento de cartera: "pendiente" (CARCL_SITCAR=1), "cancelado" (CARCL_SITCAR=2), "derivado" (CARCL_SITCAR=3).'),
+    soloImpagados: z
+        .boolean()
+        .optional()
+        .describe('Si true, filtra sólo los documentos con impago (CARCL_FECIMPAG no nulo). Si false o no se pasa, devuelve todos.'),
+    referencia: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Referencia exacta del documento de cartera (CARCL_REFCAR).'),
+};
+//# sourceMappingURL=cartera.js.map

package/dist/schemas/cartera.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cartera.js","sourceRoot":"","sources":["../../src/schemas/cartera.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC;AAIhF,mEAAmE;AACnE,MAAM,CAAC,MAAM,uBAAuB,GAAkC;IACpE,SAAS,EAAE,GAAG;IACd,SAAS,EAAE,GAAG;IACd,QAAQ,EAAE,GAAG;CACd,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,GAAG,gBAAgB;IACnB,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,qDAAqD,CAAC;IAClE,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,4DAA4D,CAAC;IACzE,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,8CAA8C,CAAC;IAC3D,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,6DAA6D,CAAC;IAC1E,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,sDAAsD,CAAC;IACnE,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,qDAAqD,CAAC;IAClE,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,KAAK,CACJ,qBAAqB,EACrB,mDAAmD,CACpD;SACA,QAAQ,EAAE;SACV,QAAQ,CAAC,2EAA2E,CAAC;IACxF,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,KAAK,CACJ,qBAAqB,EACrB,mDAAmD,CACpD;SACA,QAAQ,EAAE;SACV,QAAQ,CAAC,wEAAwE,CAAC;IACrF,qBAAqB,EAAE,CAAC;SACrB,MAAM,EAAE;SACR,KAAK,CACJ,qBAAqB,EACrB,mDAAmD,CACpD;SACA,QAAQ,EAAE;SACV,QAAQ,CAAC,6EAA6E,CAAC;IAC1F,qBAAqB,EAAE,CAAC;SACrB,MAAM,EAAE;SACR,KAAK,CACJ,qBAAqB,EACrB,mDAAmD,CACpD;SACA,QAAQ,EAAE;SACV,QAAQ,CAAC,0EAA0E,CAAC;IACvF,MAAM,EAAE,iBAAiB,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAC3C,2HAA2H,CAC5H;IACD,aAAa,EAAE,CAAC;SACb,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CACP,iHAAiH,CAClH;IACH,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,4DAA4D,CAAC;CAC1E,CAAC"}

package/dist/schemas/contratos.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Zod schemas for inputs of tools in the "Contratos" API group.
+ *
+ * Empty for v0.1.0 because the only tool (list materiales asignados) takes
+ * no inputs. Will be populated as more tools land.
+ */
+export {};

package/dist/schemas/contratos.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contratos.js.map

package/dist/schemas/contratos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contratos.js","sourceRoot":"","sources":["../../src/schemas/contratos.ts"],"names":[],"mappings":""}

package/dist/schemas/facturas-electronicas.d.ts

@@ -0,0 +1,60 @@
+import { z } from 'zod';
+/**
+ * Filtros para `freematica_list_facturas_electronicas`.
+ *
+ * Todos los filtros son opcionales. Los filtros nativos del endpoint GET /pven/v1/facturas
+ * se envían como query params directos (no FIQL), según la especificación OpenAPI de Freemática.
+ *
+ * Mapeo de filtros → query params nativos de Freemática:
+ * | Filtro lógico           | Query param     | Notas                              |
+ * |-------------------------|-----------------|-------------------------------------|
+ * | empresa                 | empresa         | Código de empresa                   |
+ * | codCliente              | cliente         | Código natural del cliente          |
+ * | fechaDesde              | fechaIni        | ISO 8601 YYYY-MM-DD                 |
+ * | fechaHasta              | fechaFin        | ISO 8601 YYYY-MM-DD                 |
+ * | estado                  | estado          | String (p.ej. "ENVIADA", "ACEPTADA")|
+ * | leido                   | leido           | Boolean nativo                      |
+ * | page                    | page            | Paginación 1-indexed                |
+ * | items                   | items           | Items por página                    |
+ * | order                   | order           | Orden de resultados                 |
+ */
+export declare const ListFacturasElectronicasFiltersSchema: {
+    empresa: z.ZodOptional<z.ZodString>;
+    codCliente: z.ZodOptional<z.ZodString>;
+    fechaDesde: z.ZodOptional<z.ZodString>;
+    fechaHasta: z.ZodOptional<z.ZodString>;
+    estado: z.ZodOptional<z.ZodString>;
+    leido: z.ZodOptional<z.ZodBoolean>;
+    order: z.ZodOptional<z.ZodString>;
+    page: z.ZodDefault<z.ZodNumber>;
+    items: z.ZodDefault<z.ZodNumber>;
+};
+export type ListFacturasElectronicasFilters = {
+    page?: number;
+    items?: number;
+    empresa?: string;
+    codCliente?: string;
+    fechaDesde?: string;
+    fechaHasta?: string;
+    estado?: string;
+    leido?: boolean;
+    order?: string;
+};
+/**
+ * Filtros para `freematica_list_facturas_documentos`.
+ *
+ * Endpoint: GET /pven/v1/facturas/download
+ *
+ * | Filtro lógico    | Query param    | Notas                                           |
+ * |------------------|----------------|-------------------------------------------------|
+ * | documents        | documents      | Identificadores de documentos a descargar       |
+ * | documentType     | documentType   | Tipo de documento: "PDF", "XML", "ERROR"        |
+ */
+export declare const ListFacturasDocumentosFiltersSchema: {
+    documents: z.ZodOptional<z.ZodString>;
+    documentType: z.ZodOptional<z.ZodEnum<["PDF", "XML", "ERROR"]>>;
+};
+export type ListFacturasDocumentosFilters = {
+    documents?: string;
+    documentType?: 'PDF' | 'XML' | 'ERROR';
+};

package/dist/schemas/facturas-electronicas.js

@@ -0,0 +1,79 @@
+import { z } from 'zod';
+import { PaginationSchema } from './pagination.js';
+/**
+ * Filtros para `freematica_list_facturas_electronicas`.
+ *
+ * Todos los filtros son opcionales. Los filtros nativos del endpoint GET /pven/v1/facturas
+ * se envían como query params directos (no FIQL), según la especificación OpenAPI de Freemática.
+ *
+ * Mapeo de filtros → query params nativos de Freemática:
+ * | Filtro lógico           | Query param     | Notas                              |
+ * |-------------------------|-----------------|-------------------------------------|
+ * | empresa                 | empresa         | Código de empresa                   |
+ * | codCliente              | cliente         | Código natural del cliente          |
+ * | fechaDesde              | fechaIni        | ISO 8601 YYYY-MM-DD                 |
+ * | fechaHasta              | fechaFin        | ISO 8601 YYYY-MM-DD                 |
+ * | estado                  | estado          | String (p.ej. "ENVIADA", "ACEPTADA")|
+ * | leido                   | leido           | Boolean nativo                      |
+ * | page                    | page            | Paginación 1-indexed                |
+ * | items                   | items           | Items por página                    |
+ * | order                   | order           | Orden de resultados                 |
+ */
+export const ListFacturasElectronicasFiltersSchema = {
+    ...PaginationSchema,
+    empresa: z
+        .string()
+        .length(4)
+        .optional()
+        .describe('Código de empresa Freemática (query param "empresa"). 4 caracteres exactos. Ej.: "0001".'),
+    codCliente: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código natural del cliente (query param "cliente" en Freemática).'),
+    fechaDesde: 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 electrónica (query param "fechaIni"). Formato YYYY-MM-DD. Inclusive.'),
+    fechaHasta: 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 electrónica (query param "fechaFin"). Formato YYYY-MM-DD. Inclusive.'),
+    estado: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Estado de la factura electrónica (query param "estado"). Valores posibles según configuración Freemática ' +
+        '(p.ej. "ENVIADA", "ACEPTADA", "RECHAZADA"). Consultar con el administrador los valores disponibles.'),
+    leido: z
+        .boolean()
+        .optional()
+        .describe('Filtra por leído/no leído (query param "leido"). true = leídas, false = no leídas.'),
+    order: z
+        .string()
+        .optional()
+        .describe('Orden de resultados (query param "order"). Ej.: "FACED_FCHFAC desc".'),
+};
+/**
+ * Filtros para `freematica_list_facturas_documentos`.
+ *
+ * Endpoint: GET /pven/v1/facturas/download
+ *
+ * | Filtro lógico    | Query param    | Notas                                           |
+ * |------------------|----------------|-------------------------------------------------|
+ * | documents        | documents      | Identificadores de documentos a descargar       |
+ * | documentType     | documentType   | Tipo de documento: "PDF", "XML", "ERROR"        |
+ */
+export const ListFacturasDocumentosFiltersSchema = {
+    documents: z
+        .string()
+        .optional()
+        .describe('Identificadores de documentos separados por comas (query param "documents").'),
+    documentType: z
+        .enum(['PDF', 'XML', 'ERROR'])
+        .optional()
+        .describe('Tipo de documento a descargar: "PDF" | "XML" | "ERROR" (query param "documentType").'),
+};
+//# sourceMappingURL=facturas-electronicas.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"facturas-electronicas.js","sourceRoot":"","sources":["../../src/schemas/facturas-electronicas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,qCAAqC,GAAG;IACnD,GAAG,gBAAgB;IACnB,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,MAAM,CAAC,CAAC,CAAC;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,0FAA0F,CAAC;IACvG,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,mEAAmE,CAAC;IAChF,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,KAAK,CAAC,qBAAqB,EAAE,mDAAmD,CAAC;SACjF,QAAQ,EAAE;SACV,QAAQ,CAAC,iGAAiG,CAAC;IAC9G,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,KAAK,CAAC,qBAAqB,EAAE,mDAAmD,CAAC;SACjF,QAAQ,EAAE;SACV,QAAQ,CAAC,8FAA8F,CAAC;IAC3G,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CACP,2GAA2G;QAC3G,qGAAqG,CACtG;IACH,KAAK,EAAE,CAAC;SACL,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,oFAAoF,CAAC;IACjG,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,sEAAsE,CAAC;CACpF,CAAC;AAcF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAG;IACjD,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,8EAA8E,CAAC;IAC3F,YAAY,EAAE,CAAC;SACZ,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;SAC7B,QAAQ,EAAE;SACV,QAAQ,CAAC,sFAAsF,CAAC;CACpG,CAAC"}