MCP Freematica
Freemática ERP: invoicing, receivables, suppliers, accounting and HR through 300+ MCP tools
Connector by nubiia-dev · GitHub account verified by the MCP Registry
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/nubiia-dev-mcp-freematica
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.
- Tools
- 56 read · 8 write · 8 delete
- Secrets
- 5 (API keys, tokens or passwords)
- Install scripts
- None found
- Runs as
- Node.js package
Tools by what they do 72
Read from the source code; the running server may list different tools.
Read 56 · Look things up without changing anything.
freematica_export_asientosfreematica_get_albaran_facturafreematica_get_albaran_ventafreematica_get_articulofreematica_get_cartera_clientefreematica_get_clientefreematica_get_contratofreematica_get_contrato_opcionalesfreematica_get_edicom_infofreematica_get_factura_cabecerafreematica_get_factura_comprafreematica_get_factura_documento
Show 44 more tools
freematica_get_factura_electronicafreematica_get_factura_logfreematica_get_ficha_prev_clientefreematica_get_master_datafreematica_get_oportunidad_negociofreematica_get_oportunidad_negocio_datos_ampliadosfreematica_get_pedido_comprafreematica_get_personafreematica_get_precio_articulofreematica_get_proveedorfreematica_get_servicio_contratofreematica_get_vigilancia_saludfreematica_list_albaranes_facturafreematica_list_albaranes_ventasfreematica_list_articulosfreematica_list_calendario_periodosfreematica_list_calendariosfreematica_list_cartera_clientesfreematica_list_clientesfreematica_list_contactos_clientesfreematica_list_contratosfreematica_list_contratos_opcionalesfreematica_list_cuentas_analiticasfreematica_list_cuentas_contablesfreematica_list_factura_ivafreematica_list_factura_lineasfreematica_list_factura_vencimientosfreematica_list_facturas_cabecerafreematica_list_facturas_comprasfreematica_list_facturas_documentosfreematica_list_facturas_electronicasfreematica_list_localizaciones_cobro_clientesfreematica_list_localizaciones_envio_clientesfreematica_list_localizaciones_factura_clientesfreematica_list_localizaciones_pago_proveedoresfreematica_list_localizaciones_servicio_clientesfreematica_list_materiales_asignados_serviciosfreematica_list_oportunidades_negociofreematica_list_pedidos_comprafreematica_list_personalfreematica_list_proveedoresfreematica_list_resultados_facturacionfreematica_list_servicios_contratofreematica_list_vigilancia_salud
Write 8 · Create, change, send or run things.
freematica_create_clientefreematica_create_contacto_clientefreematica_create_contratofreematica_create_contrato_opcionalesfreematica_create_localizacion_clientefreematica_create_servicio_contratofreematica_create_servicio_facturacion_txtfreematica_create_servicio_historico_precios
Delete 8 · Delete, drop, revoke or wipe things.
freematica_update_clientefreematica_update_contacto_clientefreematica_update_contratofreematica_update_contrato_opcionalesfreematica_update_localizacion_clientefreematica_update_servicio_facturacionfreematica_update_servicio_fechasfreematica_update_servicio_historico_precios
Secrets and settings it asks for
Secrets: values you paste in that let it act as you.
FREEMATICA_AUTH_APPFREEMATICA_AUTH_COMPANYFREEMATICA_AUTH_ORGANIZATIONFREEMATICA_AUTH_SESSIONFREEMATICA_AUTH_TOKEN
Other settings (environment variables or headers).
FREEMATICA_BASE_URLFREEMATICA_ENABLE_WRITES
Network hosts it talks to 1
api-p01.clientservicepanel.com· found in code
Tools (72)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
freematica_create_clienteDa 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.
freematica_create_contacto_clienteDa de alta un contacto de cliente. Endpoint: POST /pgrl/v2/contactos-clientes — body VoContactosClientes. Requeridos: grupoCliente y codCliente (el cliente al que pertenece). Opcionales frecuentes: nombreApellidos, cargo, telefono, movil, email, contactoPrincipal, decisor. El resto vía camposAdicionales (CC_*).
freematica_create_contratoDa de alta una cabecera de contrato (módulo Contratos y Servicios). Endpoint: POST /pvss/v2/contratos — body VoContratos. Requeridos: delegacion, descripcion (máx 40c), fecha, codCliente. Si no se informa codContrato, Freemática asigna el código automáticamente. IMPORTANTE: el API no valida referencias de negocio en el spec (p. ej. que codCliente exista); verifica los códigos con freematica_list_clientes antes. Devuelve el contrato creado, incluido su idReg.
freematica_create_contrato_opcionalesDa de alta un registro de opcionales de contrato. Endpoint: POST /ppre/v2/contratos/opcionales — body VoContratosOpcionales. Requeridos: empresa, delegacion, tipoContrato, numContrato, fechaContrato. Los campos flexibles (CON2_OPC_NUM1..10, CON2_OPC_ALFA1..10, descuentos, garantías) se pasan en camposAdicionales con su nombre nativo CON2_*.
freematica_create_localizacion_clienteDa de alta una localización de cliente del tipo indicado: - cobro: condiciones de cobro/domiciliación (requiere formaPago) - envio: dirección de entrega - factura: dirección fiscal/de facturación - servicio: instalación donde se presta el servicio Endpoint: POST /pgrl/v2/localizaciones-{tipo}-clientes. Requeridos: tipo, grupoCliente, codCliente, codLocalizacion; nombre es obligatorio salvo en tipo envio; formaPago solo se exige en tipo cobro. Campos específicos del tipo vía camposAdicionales (ej: cobro → CMCC_IBAN; servicio → COD_ZONA, CMCS_COD_DLG).
freematica_create_servicio_contratoDa de alta un servicio en un contrato existente (Alta servicio de Cuadrantes). Endpoint: POST /pvss/v2/contratos/{idReg}/servicios — body VoServicios. Los campos requeridos por el API (empresa, delegación, código de contrato) se derivan automáticamente del idContrato; solo hay que pasar los datos del servicio. Si no se informa codServicio, lo asigna Freemática. NOTA: los precios del servicio NO van aquí; usa freematica_create_servicio_historico_precios tras crear el servicio.
freematica_create_servicio_facturacion_txtDa de alta una línea de texto de facturación de un servicio. Endpoint: POST /pvss/v2/contratos/{idContrato}/servicios-facturacion-txt/{idServicio}. Los textos aparecen en las líneas de factura del servicio. Requerido: linea (código de línea, 4c). Los campos de identificación se derivan de los idReg.
freematica_create_servicio_historico_preciosDa de alta un registro de histórico de precios de un servicio. Endpoint: POST /pvss/v2/contratos/{idContrato}/servicios-historico-precios/{idServicio}. Los precios de un servicio se gestionan como histórico versionado: cada alta añade una revisión (precio hora global/diurna/nocturna/festiva, importe fijo, % de incremento). Los campos de identificación se derivan de los idReg.
freematica_export_asientosread-onlyExporta asientos contables de Freemática en batch. Endpoint: GET /pcon/v2/export-asientos. ⚠️ AVISO: Este endpoint puede devolver volúmenes MUY GRANDES de datos. Acota siempre con `periodo` o con UNA fecha (fechaDesde O fechaHasta — son excluyentes: el API devuelve 0 filas si se combinan ambas). Parámetros obligatorios: - empresa: código de empresa de 4 caracteres exactos (ej. "0001"). - cal: código de calendario/ejercicio contable de 4 caracteres exactos (ej. "2025"). Parámetros opcionales nativos (query param directo, no FIQL): - periodo: número de periodo contable (1-12, puede ten…
freematica_get_albaran_facturaread-onlyDevuelve el detalle completo de un registro de vinculación albarán↔factura. El parámetro `id` DEBE ser el campo `idReg` (string opaco base64) que aparece en los items de freematica_list_albaranes_factura. NO usar FVCA_NUMFRA ni otro código natural.
freematica_get_albaran_ventaread-onlyDevuelve el detalle completo de un albarán de venta. El parámetro `id` DEBE ser el campo `idReg` (string opaco base64) que aparece en los items de freematica_list_albaranes_ventas. NO usar ALVC_NUMDOC ni otro código natural.
freematica_get_articuloread-onlyDevuelve 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.
freematica_get_cartera_clienteread-onlyDevuelve el detalle completo de un documento de cartera de clientes. El parámetro `id` DEBE ser el campo `idReg` (string opaco base64) que aparece en los items de freematica_list_cartera_clientes. NO usar CARCL_CODAUX ni otro código natural.
freematica_get_clienteread-onlyDevuelve el detalle completo de un cliente. 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.
freematica_get_contratoread-onlyBusca una cabecera de contrato por sus códigos naturales (empresa + código de contrato, opcionalmente delegación). No existe endpoint singular en el API y el listado ignora los filtros FIQL, así que esta tool pagina el listado internamente (200 items por página) y filtra en cliente. Puede requerir varias llamadas al API en datasets grandes. Devuelve not_found si no hay coincidencia.
Show 57 more tools
freematica_get_contrato_opcionalesread-onlyDevuelve el detalle de un registro de opcionales de contrato. Endpoint: GET /ppre/v2/contratos/opcionales/{idReg}. `idReg` es el identificador opaco (campo "idReg" en los items de freematica_list_contratos_opcionales).
freematica_get_edicom_inforead-onlyDevuelve la configuración de integración con EDICOM (empresa emisora, aplicación, credenciales, URLs). Útil para diagnosticar el estado de la integración EDICOM/FACe y verificar la configuración. Campos de respuesta: EDICOM_COMPANY_ID, EDICOM_APPLICATION, EDICOM_CLIENT_ID, EDICOM_DOMAIN, EDICOM_SERVER_URL, EDICOM_RAZON_SOCIAL, EDICOM_MESSAGE_FORMAT, entre otros. NOTA: incluye campos sensibles (EDICOM_USER, EDICOM_PASSWORD). Usar con precaución.
freematica_get_factura_cabeceraread-onlyDevuelve el detalle completo de una factura de ventas (cabecera). El parámetro `id` DEBE ser el campo `idReg` (string opaco base64) que aparece en los items de freematica_list_facturas_cabecera. NO usar FVC_NUMFRA ni FVC_SERIEFRA.
freematica_get_factura_compraread-onlyDevuelve el detalle completo de una factura de compra. El parámetro `id` DEBE ser el campo `idReg` (string opaco base64) que aparece en los items de freematica_list_facturas_compras. NO usar FCC_NUMFRA ni otro código natural.
freematica_get_factura_documentoread-onlyDevuelve el documento binario (PDF o XML Facturae firmado) de una factura electrónica. El documento se devuelve como objeto JSON con los campos de VoFacturasDocumento (FACED_DOCUMENTO_PDF, FACED_DOCUMENTO_XML, FACED_DOCUMENTO_XML2, etc.) que contienen el contenido codificado en base64. Si el tamaño del response supera FREEMATICA_MAX_RESPONSE_SIZE_MB, se devuelve `truncated: true` con `warning` y `sizeBytes` pero sin el contenido del documento. Parámetros opcionales: - documentType: tipo de documento a recuperar (ej. "PDF", "XML") - actualizaLeido: si true, marca la factura como leída al…
freematica_get_factura_electronicaread-onlyDevuelve el detalle completo de una factura electrónica (Facturae/EDICOM/FACe). El parámetro `id` DEBE ser el campo `idReg` (string opaco base64) que aparece en los items de freematica_list_facturas_electronicas. NO usar FACED_NUMFRA ni otro código natural.
freematica_get_factura_logread-onlyDevuelve el log de auditoría de una factura electrónica: envío, recepción, aceptación AAPP, etc. El parámetro `id` DEBE ser el campo `idReg` opaco de freematica_list_facturas_electronicas. Campos de respuesta con prefijo FVCTRLE_*: FVCTRLE_CODEMP (empresa), FVCTRLE_FCHFRA (fecha factura), FVCTRLE_SERIEFRA (serie), FVCTRLE_NUMFRA (número), FVCTRLE_FCH_MOV (fecha movimiento), FVCTRLE_CODCLI (cliente).
freematica_get_ficha_prev_clienteread-onlyDevuelve la ficha de Prevención de Riesgos Laborales (PRL) de un cliente. Endpoint: GET /pprl/v2/ficha-prev-cliente Los filtros se envían como query params nativos (NO FIQL). Al menos uno de los cuatro identificadores es obligatorio: codCliente, grupoCliente, codLocalizacionServicio o codigoFicha. Si se pasan varios se combinan con AND. IMPORTANTE: si no se pasa ningún identificador, la tool devuelve un error de validación sin llamar al API. Campos de respuesta principales: COD_CLI, NOMBRE_CLI, COD_GRUPO_CLI, COD_LOC_SERV, CODIGO_FICHA, FECHA_ALTA, ESTADO, etc.
freematica_get_master_dataread-onlyDescription is built at runtime.
freematica_get_oportunidad_negocioread-onlyDevuelve el detalle de una oportunidad de negocio. El parámetro `id` DEBE ser el `idReg` opaco que aparece en los items de freematica_list_oportunidades_negocio.
freematica_get_oportunidad_negocio_datos_ampliadosread-onlyDevuelve los datos ampliados de una oportunidad de negocio. NOTA: Este endpoint puede devolver `not_found` si la oportunidad no tiene datos ampliados configurados. Es un caso esperado, no un error de software — explicarle al usuario que esa oportunidad no tiene info adicional. El parámetro `id` DEBE ser el `idReg` opaco (mismo que en get_oportunidad_negocio).
freematica_get_pedido_compraread-onlyDevuelve el detalle completo de un pedido de compra. El parámetro `id` DEBE ser el campo `idReg` (string opaco base64) que aparece en los items de freematica_list_pedidos_compra. NO usar ALCC_NUMDOC ni otro código natural. La respuesta es un objeto compuesto: { VoPedidosCompraCab, cabecera_proveedor, lineas[] }. Se devuelve sin aplanar para conservar la estructura original del API.
freematica_get_personaread-onlyDevuelve el detalle completo de una persona. Endpoint: GET /pers/v1/personal/{idreg} El parámetro `id` DEBE ser el campo `idReg` (string opaco base64) que aparece en los items de freematica_list_personal.
freematica_get_precio_articuloread-onlyDevuelve 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).
freematica_get_proveedorread-onlyDevuelve el detalle completo de un proveedor. El parámetro `id` DEBE ser el campo `idReg` (string opaco base64) que aparece en los items de freematica_list_proveedores. NO usar COD_PRO ni otro código natural.
freematica_get_servicio_contratoread-onlyDevuelve el detalle de un servicio de contrato. Endpoint: GET /pvss/v2/contratos-servicios/{idreg}. `idReg` es el identificador opaco del servicio (campo "idReg" en los items de freematica_list_servicios_contrato).
freematica_get_vigilancia_saludread-onlyDevuelve el detalle completo de un registro de Vigilancia de la Salud. Endpoint: GET /pprl/v1/vigilancia-salud/{idreg} El parámetro `id` DEBE ser el campo `idReg` (string opaco base64) que aparece en los items de freematica_list_vigilancia_salud.
freematica_list_albaranes_facturaread-onlyDevuelve la lista paginada de vinculaciones albarán↔factura de Freemática. Cada item contiene campos con prefijo FVCA_*: FVCA_CODEMP (empresa), FVCA_SERIEFRA (serie factura), FVCA_NUMFRA (número factura), FVCA_CODCLI (cliente), FVCA_NUMALB (número albarán), FVCA_FCHALB (fecha albarán), FVCA_FCHFAC (fecha factura), FVCA_NUMPED (número pedido), FVCA_CODDOC (código documento), más `idReg` opaco. El filtro `idReg` es un query param nativo. Los filtros empresa, serie, numFactura y codCliente se envían como FIQL en el parámetro rQuery. Casos de uso principales: - Buscar qué facturas incluyen un…
freematica_list_albaranes_ventasread-onlyDevuelve la lista paginada de albaranes de ventas de Freemática. Cada item contiene campos con prefijo ALVC_* (cabecera) y ALVL_* (líneas). Campos destacados: ALVC_CODEMP (empresa), ALVC_DELEG (delegación), ALVC_CODCLI (cliente), ALVC_CODDOC (código documento), ALVC_NUMDOC (número), ALVC_FCHDOC (fecha), ALVC_SERIEFRA (serie factura), ALVC_IND_NOFAC (no facturar), ALVC_FPAGO (forma pago), más `idReg` opaco para el endpoint singular. Los filtros principales (empresa, delegacion, codCliente, codDocumento, fechaDesde, fechaHasta) se envían como query params NATIVOS del endpoint (no FIQL). El cam…
freematica_list_articulosread-onlyDevuelve 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 co…
freematica_list_calendario_periodosread-onlyDevuelve los periodos de un calendario laboral concreto. Endpoint: GET /pgrl/v1/calendarios/{idreg}/periodos El parámetro `idCalendario` DEBE ser el campo `idReg` (string opaco base64) que aparece en los items de freematica_list_calendarios. Soporta paginación estándar (page, items).
freematica_list_calendariosread-onlyDevuelve la lista paginada de calendarios laborales registrados en Freemática. Endpoint: GET /pgrl/v1/calendarios Cada item incluye `idReg` opaco que se usa en freematica_list_calendario_periodos para obtener los periodos de un calendario concreto. Soporta paginación estándar (page, items).
freematica_list_cartera_clientesread-onlyDevuelve la lista paginada de documentos de cartera de clientes (cobros, efectos, impagados). Útil para analizar el estado de cobros: deudas pendientes, impagados, vencimientos próximos. Cada item contiene ~40 campos: CARCL_CODAUX (código cliente), CARCL_IMPCOB (importe cobrado), CARCL_IMPPEN (importe pendiente), CARCL_FECDOC (fecha documento), CARCL_FECVCTO (fecha vencimiento), CARCL_SITCAR (estado: 1=pendiente, 2=cancelado, 3=derivado), CARCL_FECIMPAG (fecha impago, null si no hay) más un campo `idReg` opaco (base64) para `freematica_get_cartera_cliente`. Filtros disponibles: - empresa, c…
freematica_list_clientesread-onlyDevuelve la lista paginada de clientes de Freemática. Cada item tiene ~87 campos (COD_CLI, NOMBRE_CLI, NIF, FECHA_ALTA, etc.) más un campo `idReg` opaco (base64) que se usa para el endpoint singular `freematica_get_cliente`. Paginación 1-indexed: la primera página es page=1. Devuelve también `total` con el total de clientes en el dataset.
freematica_list_contactos_clientesread-onlyDevuelve la lista paginada de contactos de clientes (personas asociadas a clientes corporativos). Cada item incluye un campo `idReg` opaco (base64) que se usa en freematica_update_contacto_cliente. Paginación 1-indexed.
freematica_list_contratosread-onlyDevuelve la lista paginada de cabeceras de contratos (módulo Contratos y Servicios). Endpoint: GET /pvss/v1/contratos. Cada item tiene campos CTRT_* (CTRT_EMP, CTRT_DELEG, CTRT_COD, CTRT_DES, CTRT_FECHA, CTRT_COD_CLI, dirección, CTRT_ABIERTO…) más `idReg` opaco (Base64 "EMP__DELEG__COD") que se usa en el resto de tools de contratos. Filtros disponibles: SOLO empresa y delegacion (params nativos del API). AVISO: el API ignora silenciosamente los filtros FIQL en este endpoint; para localizar un contrato concreto usa freematica_get_contrato.
freematica_list_contratos_opcionalesread-onlyDevuelve la lista paginada de registros de opcionales de contratos (módulo Presupuestos y Contratos, ppre). Endpoint: GET /ppre/v2/contratos/opcionales. Cada item tiene campos CON2_* (10 numéricos y 10 alfanuméricos de propósito libre, descuentos, garantías, observaciones) más `idReg` opaco para el resto de tools de opcionales.
freematica_list_cuentas_analiticasread-onlyDevuelve el catálogo de cuentas analíticas de Freemática. Endpoint: GET /pcon/v2/cuentas-analiticas. Devuelve los registros de cuentas analíticas (COD_CTA_ANL, COD_PLAN, COD_GRUPO_ANL, CTA_ACTIVA_ANL, AREA_ANL, DELEG, etc.). Filtros FIQL disponibles: - codPlan: filtra por código de plan (COD_PLAN). - prefijoCuenta: filtra cuentas cuyo COD_CTA_ANL comienza por el prefijo indicado. - activa: si true, solo cuentas activas (CTA_ACTIVA_ANL==1); si false, solo inactivas. - grupoCuenta: filtra por código de grupo analítico (COD_GRUPO_ANL). - area: filtra por área analítica (AREA_ANL). -…
freematica_list_cuentas_contablesread-onlyDevuelve el plan de cuentas contables de Freemática. Endpoint: GET /pcon/v2/cuentas. Devuelve los registros del catálogo de cuentas del Plan Contable (COD_CTA, COD_PLAN, COD_GRUPO_CTA, CTA_ACTIVA, NOMBRE_CTA, etc.). Filtros FIQL disponibles: - codPlan: filtra por código de plan contable (COD_PLAN). - prefijoCuenta: filtra cuentas cuyo COD_CTA comienza por el prefijo indicado (prefijo match). - activa: si true, devuelve solo cuentas activas (CTA_ACTIVA==1); si false, solo inactivas. - grupoCuenta: filtra por código de grupo de cuenta (COD_GRUPO_CTA). Los filtros se combinan con AND. …
freematica_list_factura_ivaread-onlyDevuelve las líneas de IVA de una factura de ventas. Requiere el `idFactura` (idReg opaco) de la factura cabecera. Cada línea contiene: FVI_TIPO_IVA (tipo IVA), FVI_POR_IVA_DV (%), FVI_IMPBRUT_DV (base imponible), FVI_IMPDTO_DV (descuento) y demás importes FVI_*. Filtro disponible: tipoIva (FVI_TIPO_IVA exacto).
freematica_list_factura_lineasread-onlyDevuelve las líneas de detalle de una factura de ventas. Requiere el `idFactura` (idReg opaco) de la factura cabecera. Cada línea contiene: FVL_CODARTIC (artículo), FVL_DESCRIP (descripción), FVL_IMPORTE (importe línea), FVL_IMP_IVA (IVA), FVL_COD_FAMILIA, FVL_COD_SUBFAM, FVL_DELEG. Filtros disponibles: codArticulo, codFamilia, codSubfamilia, delegacion.
freematica_list_factura_vencimientosread-onlyDevuelve los vencimientos de cobro de una factura de ventas. Requiere el `idFactura` (idReg opaco) de la factura cabecera. Cada vencimiento contiene: FVV_FCH_VTO (fecha vencimiento), FVV_IMP_VTO (importe a cobrar), FVV_MODOPAGO (modo de pago), FVV_NUM_VTO (número de vencimiento). Filtros disponibles: fechaVencimientoDesde/Hasta, modoPago.
freematica_list_facturas_cabeceraread-onlyDevuelve la lista paginada de cabeceras de facturas de ventas. Cada item contiene ~70 campos: FVC_NUMFRA (número factura), FVC_SERIEFRA (serie), FVC_CODCLI (cliente), FVC_FCHFAC (fecha factura), FVC_BASEIVA_DV (base), FVC_TOTFRA_DV (total factura), FVC_TRASP_CONTAB (traspasado a contabilidad), FVC_DELEG (delegación), más `idReg` opaco para el endpoint singular. Filtros disponibles: - empresa, codCliente, representante - fechaFacturaDesde O fechaFacturaHasta (EXCLUYENTES: el API devuelve 0 filas si se combinan; usa solo uno por consulta) - serie, numFactura (número exacto) - formaPago, delega…
freematica_list_facturas_comprasread-onlyDevuelve la lista paginada de facturas de compras de Freemática. Cada item contiene campos como FCC_CODEMP (empresa), FCC_CODPRO (proveedor), FCC_FCHFAC (fecha factura), FCC_SERIEFRA (serie), FCC_NUMFRA (número), FCC_FPAGO (forma de pago), FCC_TRASP_CONTAB (traspasado contabilidad), FCC_DELEG (delegación), FCC_LIN_NEGOCIO (línea negocio), más `idReg` opaco para el endpoint singular. Paginación 1-indexed. Los filtros de fecha aplican sobre la fecha de la factura (FCC_FCHFAC). El parámetro `exportado` acepta exactamente: "all" (todas) | "not_exported" (no exportadas). Se envía como query para…
freematica_list_facturas_documentosread-onlyDescarga masiva de documentos de facturas electrónicas (PDF/XML/ERROR). Permite recuperar múltiples documentos a la vez filtrando por identificadores y tipo de documento. Los documentos se devuelven en formato base64 dentro de los campos documentoPdf, documentoXml, etc. CUIDADO: este endpoint puede devolver respuestas muy grandes. Si supera FREEMATICA_MAX_RESPONSE_SIZE_MB los items se truncarán y se añadirá `truncated: true` + `warning` en la respuesta. Campos de respuesta (prefijo VoEFraDoc): empresa, fecha, serie, numFra, documentoPdf, documentoXml, documentoXml2, decError, decError2, doc…
freematica_list_facturas_electronicasread-onlyDevuelve la lista paginada de facturas electrónicas (Facturae firmadas / EDICOM / FACe) de Freemática. Diferente de freematica_list_facturas_cabecera: ésta expone las facturas firmadas y enviadas a AAPP/portales. Los campos de respuesta usan el prefijo FACED_* (factura electrónica). Campos clave: FACED_CODEMP (empresa), FACED_FCHFAC (fecha), FACED_SERIEFRA (serie), FACED_NUMFRA (número), FACED_ESTADO / FACED_ESTADO_DESC (estado firma), FACED_LEIDO (flag leído), COD_CLI (código cliente), NIF, NOMBRE_CLI (nombre), TIENE_DOC_PDF / TIENE_DOC_XML (tiene documentos). Todos los filtros son qu…
freematica_list_localizaciones_cobro_clientesread-onlyDevuelve la lista paginada de localizaciones de cobro de clientes. Las localizaciones de cobro definen la domiciliación bancaria o condiciones de pago de un cliente. Cada item contiene campos como COD_CLI (cliente), GRUPO_CLI (grupo), COD_FORMA_COBRO (forma de cobro), más `idReg` opaco. Paginación 1-indexed.
freematica_list_localizaciones_envio_clientesread-onlyDevuelve la lista paginada de localizaciones de envío de clientes. Direcciones de entrega/envío asociadas a un cliente. Cada item incluye LOC_CLI_ENV (código), NOM_LOC_ENV, dirección, más `idReg` opaco que se usa en freematica_update_localizacion_cliente (tipo=envio). Paginación 1-indexed.
freematica_list_localizaciones_factura_clientesread-onlyDevuelve la lista paginada de localizaciones de factura de clientes. Direcciones fiscales/de facturación asociadas a un cliente (incluye datos de factura electrónica: oficina contable, órgano gestor, EDI). Cada item incluye LOC_CLI_FAC (código), NOM_LOC_FAC, más `idReg` opaco que se usa en freematica_update_localizacion_cliente (tipo=factura). Paginación 1-indexed.
freematica_list_localizaciones_pago_proveedoresread-onlyDevuelve la lista paginada de localizaciones de pago de proveedores. Las localizaciones de pago definen las condiciones bancarias o de pago de un proveedor. Cada item contiene campos como COD_PRO (proveedor), COD_GRUPO_PRO (grupo), COD_FORMA_PAGO (forma de pago), más `idReg` opaco. Paginación 1-indexed.
freematica_list_localizaciones_servicio_clientesread-onlyDevuelve la lista paginada de localizaciones de servicio de clientes. Las localizaciones de servicio son las direcciones donde se presta servicio a un cliente. Cada item contiene campos como COD_CLI (cliente), GRUPO_CLI (grupo), COD_PAIS, COD_PROVINCIA, COD_REPRES (representante), más `idReg` opaco. Paginación 1-indexed.
freematica_list_materiales_asignados_serviciosread-onlyDevuelve la lista completa de material asignado a servicios. Endpoint: GET /pvss/v2/contratos-servicios-material (Freemática API). Tipo de respuesta: VoContratosServMatAsignado[]. Esta operación no acepta parámetros: siempre devuelve la lista entera para la organización autenticada. La respuesta es un objeto con dos campos: - items: array de objetos VoContratosServMatAsignado - count: número total de elementos
freematica_list_oportunidades_negocioread-onlyDevuelve la lista paginada de oportunidades de negocio (CRM). Cada item tiene ~33 campos: COD_CLI (id del cliente), COD_ESTADO_OPOR, COD_ETAPA_OPOR, NOMBRE, VALOR, ID_OPORTUNIDAD, FECHA, FECHA_CREACION, USU_ASIGNADO, etc. Más `idReg` opaco para el endpoint singular. Paginación 1-indexed.
freematica_list_pedidos_compraread-onlyDevuelve la lista paginada de pedidos de compra de Freemática. DISEÑO MIXTO: este endpoint tiene 4 filtros como query params nativos (no FIQL) y el resto de filtros vía rQuery (FIQL con campos ALCC_*). Filtros nativos (van directamente como query params): - empresa (4c) → codEmpresa - codProveedor (≤10c) → codProveedor - fechaPedidoDesde (ISO) → desdeFecha - fechaPedidoHasta (ISO) → hastaFecha Filtros FIQL (van en rQuery con campos ALCC_*): - numPedido → ALCC_NUMDOC - codDocumento → ALCC_CODDOC - delegacion → ALCC_DELEG - formaPago → ALCC_FPAGO - tipoIva → ALCC_TIPO_IVA …
freematica_list_personalread-onlyDevuelve la lista paginada de personas (empleados / personal) de Freemática. Endpoint: GET /pers/v1/personal Permite filtrar por empresa (VSSPER_EMP), delegación (VSSPER_DELEG), código de persona (VSSPER_COD), nombre (VSSPER_NOM), primer apellido (VSSPER_APELL1), NIF (VSSPER_NIF), situación (VSSPER_SIT), departamento (VSSPER_DPTO) y sección (VSSPER_SECCION). AVISO: todos los filtros son de coincidencia EXACTA (el API no soporta búsqueda parcial en este endpoint). Para localizar a una persona por nombre parcial, lista sin filtros y filtra sobre los resultados. Cada item incluye `idReg` opac…
freematica_list_proveedoresread-onlyDevuelve la lista paginada de proveedores de Freemática. Cada item contiene campos como COD_PRO (código), COD_GRUPO_PRO (grupo), NIF, NOMBRE_PRO (nombre), FECHA_BAJA (baja del proveedor), CMP_TIPO_IDENT (tipo identificador), COD_PROVINCIA, COD_PAIS, más `idReg` opaco para el endpoint singular. Paginación 1-indexed. El filtro `activo` es un booleano: true = FECHA_BAJA nula (proveedores activos, filtrado sobre la página recibida — el total refleja el dataset sin filtrar); false = FECHA_BAJA informada (dados de baja). El filtro `nombre` es de coincidencia EXACTA con el nombre completo (el API…
freematica_list_resultados_facturacionread-onlyDevuelve los resultados del proceso batch de facturación automática de vigilancia. Cada item contiene campos con prefijo FACT_*: FACT_EMP (empresa), FACT_DELEG (delegación), FACT_CAL (año calendario), FACT_MES (mes), FACT_CTRT (contrato), FACT_SERV (servicio), FACT_TIPFAC (tipo facturación), FACT_COD_CLI (cliente), FACT_TRASP (estado traspaso), FACT_NUMDOC (documento generado), FACT_IMP_BASE (importe base), FACT_IMPF (importe final), y múltiples campos de horas (FACT_HHD, FACT_HHF, FACT_HHG, FACT_HHN, etc.). Todos los filtros se envían como FIQL en el parámetro rquery. Paginación 1-indexed.…
freematica_list_servicios_contratoread-onlyDevuelve la lista paginada de servicios de un contrato. Endpoint: GET /pvss/v1/contratos/{idContrato}/servicios. Cada item tiene campos CTRTS_* (CTRTS_COD, CTRTS_DES, CTRTS_TIPO, CTRTS_FECALTA, CTRTS_FECFIN, CTRTS_CLASE…) más `idReg` opaco (Base64 "EMP__DELEG__CTRT__COD") que se usa en las tools de escritura.
freematica_list_vigilancia_saludread-onlyDevuelve la lista paginada de registros de Vigilancia de la Salud. Endpoint: GET /pprl/v1/vigilancia-salud ÚNICO filtro soportado: `idRegPersona` (el campo `idReg` de la persona en freematica_list_personal). El API ignora cualquier otro filtro en este endpoint, así que para acotar por empresa, tipo de revisión o fechas hay que filtrar sobre los resultados. Campos principales: PERVS_EMP, PERVS_DELEG, PERVS_PERSO, PERVS_TIPO_REVISION, PERVS_RESULTADO, PERVS_FCH_CITA, idReg.
freematica_update_clientecan change or delete dataActualiza 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.
freematica_update_contacto_clientecan change or delete dataActualiza un contacto de cliente existente (actualización parcial). Endpoint: PUT /pgrl/v2/contactos-clientes/{idReg}. La tool recupera el contacto actual, aplica encima los campos informados y envía el objeto completo. `idReg` sale de freematica_list_contactos_clientes.
freematica_update_contratocan change or delete dataActualiza la cabecera de un contrato existente. Endpoint: PUT /pvss/v2/contratos/{idReg} — body VoContratos. `idReg` es el identificador opaco del contrato (de freematica_list_contratos o freematica_get_contrato). Solo se envían al API los campos informados.
freematica_update_contrato_opcionalescan change or delete dataActualiza un registro de opcionales de contrato existente. Endpoint: PUT /ppre/v2/contratos/opcionales/{idReg}. Solo se envían al API los campos informados.
freematica_update_localizacion_clientecan change or delete dataActualiza una localización de cliente existente (actualización parcial). Endpoint: PUT /pgrl/v2/localizaciones-{tipo}-clientes/{idReg}. La tool recupera la localización actual, aplica encima los campos informados y envía el objeto completo. El `idReg` sale de la list tool del tipo (freematica_list_localizaciones_{cobro|envio|factura|servicio}_clientes).
freematica_update_servicio_facturacioncan change or delete dataActualiza los datos de facturación de un servicio (precios hora, importe, forma de pago, clave de facturación…). Endpoint: PUT /pvss/v2/contratos/{idContrato}/servicios-facturacion/{idServicio}. Los campos más comunes tienen parámetro propio; el resto de los 42 campos VoServiciosFac puede pasarse en camposAdicionales con su nombre nativo CTRTF_*.
freematica_update_servicio_fechascan change or delete dataActualiza las fechas de inicio y/o fin de un servicio de contrato. Endpoint: PUT /pvss/v2/contratos/{idContrato}/servicio/{idServicio}. Según el spec del API, este endpoint SOLO actualiza fecha inicio y fecha fin. Informar fechaFin es la forma estándar de dar de baja un servicio (no existe DELETE en el API).
freematica_update_servicio_historico_precioscan change or delete dataActualiza un registro de histórico de precios de un servicio. Endpoint: PUT /pvss/v2/contratos/{idContrato}/servicios-historico-precios/{idServicio}.
Compare and alternatives
Featured in
Signals
- Stars
- 0
- Forks
- 0
- Open issues
- 0
- Weekly downloads
- 358
- Last commit
- Jul 10, 2026 (3 months ago)
- Last release
- Oct 22, 2026 (6 days ago)
- Last package publish
- Oct 22, 2026 (6 days ago)
From GitHub (fetched Oct 24, 2026) and the package registry.
Details
- Registry name
io.github.nubiia-dev/mcp-freematica- Version
- 0.11.2
- Auth
- API key
- Packages
- npm @nubiia/mcp-freematica
- License
- MIT
- Repository
- github.com/nubiia-dev/mcp-freematica
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
More from nubiia-dev
- 0.654score
MCP Holded
nubiia-dev
Complete Holded Invoice API integration with 72 MCP tools for invoices, contacts, products, and more
ConnectorAFreshness: ALocal★ 20↓ 231/wkClaude Code +5 - 0.649score
MCP Pipedrive
nubiia-dev
Complete Pipedrive CRM integration with 254 MCP tools for deals, contacts, and pipelines
ConnectorAFreshness: ALocal★ 12↓ 230/wkClaude Code +5 - 0.618score
MCP Borme
nubiia-dev
OpenMercantil (BORME): 37 read-only tools for Spanish company search, officers, sectors and tenders
ConnectorAFreshness: ALocal↓ 559/wkClaude Code +5 - 0.609score
MCP Newsapi
nubiia-dev
NewsAPI.ai (Event Registry): 10 read-only MCP tools for news articles, events, autosuggest, trends
ConnectorAFreshness: ALocal↓ 221/wkClaude Code +5 - 0.609score
MCP Quipu
nubiia-dev
Quipu API integration with 18 MCP tools for invoices, expenses, contacts and Spanish VAT reporting
ConnectorAFreshness: ALocal↓ 212/wkClaude Code +5
Cite this page
MCP Freematica. Agent Mart. https://agentmart.dev/connectors/nubiia-dev-mcp-freematica (last updated 2026-10-24)