Skip to content
Agentmart
Submit a tool

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

IndexedMITLocal (stdio)
Write a review

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.

We use your email only for this newsletter. Privacy

About

Freemática ERP: invoicing, receivables, suppliers, accounting and HR through 300+ MCP tools

No 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_asientos
  • freematica_get_albaran_factura
  • freematica_get_albaran_venta
  • freematica_get_articulo
  • freematica_get_cartera_cliente
  • freematica_get_cliente
  • freematica_get_contrato
  • freematica_get_contrato_opcionales
  • freematica_get_edicom_info
  • freematica_get_factura_cabecera
  • freematica_get_factura_compra
  • freematica_get_factura_documento
Show 44 more tools
  • freematica_get_factura_electronica
  • freematica_get_factura_log
  • freematica_get_ficha_prev_cliente
  • freematica_get_master_data
  • freematica_get_oportunidad_negocio
  • freematica_get_oportunidad_negocio_datos_ampliados
  • freematica_get_pedido_compra
  • freematica_get_persona
  • freematica_get_precio_articulo
  • freematica_get_proveedor
  • freematica_get_servicio_contrato
  • freematica_get_vigilancia_salud
  • freematica_list_albaranes_factura
  • freematica_list_albaranes_ventas
  • freematica_list_articulos
  • freematica_list_calendario_periodos
  • freematica_list_calendarios
  • freematica_list_cartera_clientes
  • freematica_list_clientes
  • freematica_list_contactos_clientes
  • freematica_list_contratos
  • freematica_list_contratos_opcionales
  • freematica_list_cuentas_analiticas
  • freematica_list_cuentas_contables
  • freematica_list_factura_iva
  • freematica_list_factura_lineas
  • freematica_list_factura_vencimientos
  • freematica_list_facturas_cabecera
  • freematica_list_facturas_compras
  • freematica_list_facturas_documentos
  • freematica_list_facturas_electronicas
  • freematica_list_localizaciones_cobro_clientes
  • freematica_list_localizaciones_envio_clientes
  • freematica_list_localizaciones_factura_clientes
  • freematica_list_localizaciones_pago_proveedores
  • freematica_list_localizaciones_servicio_clientes
  • freematica_list_materiales_asignados_servicios
  • freematica_list_oportunidades_negocio
  • freematica_list_pedidos_compra
  • freematica_list_personal
  • freematica_list_proveedores
  • freematica_list_resultados_facturacion
  • freematica_list_servicios_contrato
  • freematica_list_vigilancia_salud

Write 8 · Create, change, send or run things.

  • freematica_create_cliente
  • freematica_create_contacto_cliente
  • freematica_create_contrato
  • freematica_create_contrato_opcionales
  • freematica_create_localizacion_cliente
  • freematica_create_servicio_contrato
  • freematica_create_servicio_facturacion_txt
  • freematica_create_servicio_historico_precios

Delete 8 · Delete, drop, revoke or wipe things.

  • freematica_update_cliente
  • freematica_update_contacto_cliente
  • freematica_update_contrato
  • freematica_update_contrato_opcionales
  • freematica_update_localizacion_cliente
  • freematica_update_servicio_facturacion
  • freematica_update_servicio_fechas
  • freematica_update_servicio_historico_precios

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • FREEMATICA_AUTH_APP
  • FREEMATICA_AUTH_COMPANY
  • FREEMATICA_AUTH_ORGANIZATION
  • FREEMATICA_AUTH_SESSION
  • FREEMATICA_AUTH_TOKEN

Other settings (environment variables or headers).

  • FREEMATICA_BASE_URL
  • FREEMATICA_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_cliente

    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.

  • freematica_create_contacto_cliente

    Da 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_contrato

    Da 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_opcionales

    Da 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_cliente

    Da 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_contrato

    Da 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_txt

    Da 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_precios

    Da 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-only

    Exporta 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-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve el detalle completo de un artículo del catálogo. Endpoint: GET /part/v1/articulos/{idreg} El parámetro `id` DEBE ser el campo `idReg` (string opaco base64) que aparece en los items de freematica_list_articulos.

  • freematica_get_cartera_clienteread-only

    Devuelve 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-only

    Devuelve 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-only

    Busca 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-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve 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-only

    Description is built at runtime.

  • freematica_get_oportunidad_negocioread-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve los precios de venta de un artículo: PRECIO_VENTA, DESCUENTO y FACTURABLE. Endpoint: GET /pgrl/v1/precio-articulo/{idreg} El parámetro `id` DEBE ser el campo `idReg` (string opaco base64) que aparece en los items de freematica_list_articulos (el mismo que usa freematica_get_articulo).

  • freematica_get_proveedorread-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve la lista paginada del catálogo de artículos (materiales, consumibles, productos) de Freemática. Endpoint: GET /part/v1/articulos Cada item incluye COD_ARTICULO (referencia), DESC_ART (descripción), COD_PROVEEDOR, COD_LIN_ART (línea), COD_FAMILIA, COD_SUBFAM, COD_IVA, CODIGO_BARRAS, FECHA_ALTA, FECHA_BAJA/MOTIVO_BAJA (baja del artículo) y el `idReg` opaco para usar en freematica_get_articulo y freematica_get_precio_articulo. Los códigos de familia/subfamilia/línea se pueden resolver con freematica_get_master_data (catalogs: familias, subfamilias). AVISO: todos los filtros son de co…

  • freematica_list_calendario_periodosread-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve 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-only

    Descarga 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-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve 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-only

    Devuelve 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 data

    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.

  • freematica_update_contacto_clientecan change or delete data

    Actualiza 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 data

    Actualiza 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 data

    Actualiza 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 data

    Actualiza 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 data

    Actualiza 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 data

    Actualiza 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 data

    Actualiza 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
    License
    MIT
    First seen
    Oct 24, 2026
    Last checked
    Oct 24, 2026

    More from nubiia-dev

    Cite this page

    MCP Freematica. Agent Mart. https://agentmart.dev/connectors/nubiia-dev-mcp-freematica (last updated 2026-10-24)