freematica_list_materiales_asignados_servicios
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_contratos
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.
輸入參數pageitemsorderempresadelegacion
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.
輸入參數empresa必填delegacioncodContrato必填
freematica_list_servicios_contrato
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.
輸入參數pageitemsorderidContrato必填
freematica_get_servicio_contrato
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).
輸入參數idReg必填
freematica_list_contratos_opcionales
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.
輸入參數pageitemsorder
freematica_get_contrato_opcionales
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).
輸入參數idReg必填
freematica_get_master_data
Devuelve un catálogo de datos maestros de Freemática (tipos, geográficos, organizativos, inventario, financiero).
Catálogos disponibles (24): tipos-contrato (tipos de contrato comercial), tipo-instalacion (tipos de instalación física), clases-servicios (clases de servicio operativas), tipos-casos (CRM), subtipos-casos (CRM), tipos-oportunidad-negocio (CRM), tipos-impuestos (IVA, IRPF, retenciones), naturalezas-abono, incidencecode (códigos de incidencia en servicios), claves-facturacion (claves de facturación de servicios), paises, nacionalidades, provincias, poblaciones (municipios — dataset grande, paginar con cuidado), empresas, delegaciones (agrupadas por código — listado global), lineas-negocio, cargos-clientes (puestos de contactos), calendarios (calendarios laborales — solo lookup; para detalle y períodos usar freematica_list_calendarios), series (series de numeración de documentos), familias (de artículos), subfamilias, lineas (líneas de artículos), bancos (entidades bancarias).
Útil para traducir códigos crípticos en respuestas de otras tools (por ejemplo, los IDs de tipo de contrato o clase de servicio que aparecen en freematica_list_materiales_asignados_servicios).
La respuesta es un objeto con tres campos:
- catalog: el catálogo solicitado (echo del input)
- items: array de objetos con los registros del catálogo
- count: número total de elementos
輸入參數catalog必填
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.
輸入參數pageitems
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.
輸入參數id必填
freematica_list_clientes_v1
Devuelve la lista paginada de clientes usando el endpoint v1 de Freemática.
Versión v1 del endpoint. Generalmente preferir freematica_list_clientes (v2) para datos más completos.
Paginación 1-indexed.
輸入參數pageitems
freematica_get_cliente_v1
Devuelve el detalle de un cliente usando el endpoint v1 de Freemática.
Versión v1 del endpoint. Generalmente preferir freematica_get_cliente (v2) para datos más completos.
輸入參數idReg必填
freematica_list_contactos_clientes
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.
輸入參數pageitems
freematica_list_contactos_clientes_v1
Devuelve la lista paginada de contactos de clientes usando el endpoint v1 de Freemática.
Paginación 1-indexed.
輸入參數pageitems
freematica_get_contacto_cliente
Devuelve el detalle de un contacto de cliente por su `idReg`. El `idReg` sale de freematica_list_contactos_clientes.
輸入參數idReg必填
freematica_list_oportunidades_negocio
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.
輸入參數pageitems
freematica_get_oportunidad_negocio
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.
輸入參數id必填
freematica_get_oportunidad_negocio_datos_ampliados
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).
輸入參數id必填
freematica_list_cartera_clientes
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, codCliente, grupoCliente, representante, formaPago, modoPago
- fechaDocDesde O fechaDocHasta (excluyentes: el API no soporta ambos a la vez)
- fechaVencimientoDesde (no existe fecha fin: el API la ignora)
- estado: "pendiente" | "cancelado" | "derivado"
- soloImpagados: true → solo documentos con impago registrado (CARCL_FECIMPAG no nulo)
- referencia: referencia exacta del documento (CARCL_REFCAR)
Paginación 1-indexed. Default: page=1, items=20.
輸入參數pageitemsestadoempresamodoPagoformaPagocodClientereferenciagrupoClientefechaDocDesdefechaDocHastarepresentante另有 2 個
freematica_get_cartera_cliente
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.
輸入參數id必填
freematica_list_facturas_cabecera
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, delegacion
- traspasadoContabilidad: true → solo facturas ya traspasadas a contabilidad
Paginación 1-indexed. Default: page=1, items=20.
輸入參數pageitemsserieempresaformaPagocodClientedelegacionnumFacturarepresentantefechaFacturaDesdefechaFacturaHastatraspasadoContabilidad
freematica_get_factura_cabecera
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.
輸入參數id必填
freematica_list_factura_lineas
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.
輸入參數pageitemsidFactura必填codFamiliadelegacioncodArticulocodSubfamilia
freematica_list_factura_iva
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).
輸入參數pageitemstipoIvaidFactura必填
freematica_list_factura_vencimientos
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.
輸入參數pageitemsmodoPagoidFactura必填fechaVencimientoDesdefechaVencimientoHasta
freematica_list_facturas_compras
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 param nativo, no como FIQL.
輸入參數pageitemsserieempresaexportadoformaPagodelegacionfechaDesdefechaHastanumFacturacodProveedorlineaNegocio另有 1 個
freematica_get_factura_compra
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.
輸入參數id必填
freematica_list_pedidos_compra
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
- codCliente → ALCC_COD_CLIENTE
- codInstalador → ALCC_COD_INSTALADOR
- codMantenedor → ALCC_COD_MANTENEDOR
- fechaEntregaDesde / fechaEntregaHasta → ALCC_FCHENTREGA con =ge=/=le=
- referencia → ALCC_REFERENCIA (match exacto)
- estado → enum: pendiente | bloqueado | recibido
Cada item contiene los campos del pedido (ALCC_*) más `idReg` opaco para el endpoint singular.
Paginación 1-indexed.
輸入參數pageitemsestadoempresatipoIvaformaPagonumPedidocodClientedelegacionreferenciacodDocumentocodProveedor另有 6 個
freematica_get_pedido_compra
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.
輸入參數id必填
freematica_list_proveedores
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 no soporta búsqueda parcial en este endpoint).
輸入參數nifpageitemsactivonombrecodPaistipoIdentcodProveedorcodProvinciagrupoProveedor
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.
輸入參數id必填
freematica_list_proveedores_v1
Devuelve la lista paginada de proveedores usando el endpoint v1 de Freemática.
Paginación 1-indexed.
輸入參數pageitems
freematica_list_localizaciones_cobro_clientes
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.
輸入參數pageitemsformaPagocodClientegrupoCliente
freematica_list_localizaciones_pago_proveedores
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.
輸入參數pageitemsformaPagocodProveedorgrupoProveedor
freematica_list_localizaciones_servicio_clientes
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.
輸入參數pageitemscodPaiscodClientecodProvinciagrupoClienterepresentante
freematica_list_localizaciones_envio_clientes
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.
輸入參數pageitemscodClientegrupoCliente
freematica_list_localizaciones_factura_clientes
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.
輸入參數pageitemscodClientegrupoCliente
freematica_list_localizaciones_cobro_clientes_v1
Devuelve la lista paginada de localizaciones de cobro de clientes (v1). Paginación 1-indexed.
輸入參數pageitems
freematica_get_localizacion_cobro_cliente
Devuelve el detalle de una localización de cobro de cliente (v1) por su `idReg`.
輸入參數idReg必填
freematica_get_localizacion_cobro_cliente_v2
Devuelve el detalle de una localización de cobro de cliente (v2) por su `idReg`.
輸入參數idReg必填
freematica_list_localizaciones_envio_clientes_v1
Devuelve la lista paginada de localizaciones de envío de clientes (v1). Paginación 1-indexed.
輸入參數pageitems
freematica_get_localizacion_envio_cliente
Devuelve el detalle de una localización de envío de cliente (v1) por su `idReg`.
輸入參數idReg必填
freematica_get_localizacion_envio_cliente_v2
Devuelve el detalle de una localización de envío de cliente (v2) por su `idReg`.
輸入參數idReg必填
freematica_get_localizacion_factura_cliente
Devuelve el detalle de una localización de factura de cliente (v1) por su `idReg`.
輸入參數idReg必填
freematica_list_localizaciones_servicio_clientes_v1
Devuelve la lista paginada de localizaciones de servicio de clientes (v1). Paginación 1-indexed.
輸入參數pageitems
freematica_get_localizacion_servicio_cliente
Devuelve el detalle de una localización de servicio de cliente (v1) por su `idReg`.
輸入參數idReg必填
freematica_get_localizacion_servicio_cliente_v2
Devuelve el detalle de una localización de servicio de cliente (v2) por su `idReg`.
輸入參數idReg必填
freematica_list_localizaciones_pago_proveedores_v1
Devuelve la lista paginada de localizaciones de pago de proveedores (v1). Paginación 1-indexed.
輸入參數pageitems
freematica_get_localizacion_pago_proveedor
Devuelve el detalle de una localización de pago de proveedor (v1) por su `idReg`.
輸入參數idReg必填
freematica_get_localizacion_pago_proveedor_v2
Devuelve el detalle de una localización de pago de proveedor (v2) por su `idReg`.
輸入參數idReg必填
freematica_list_cuentas_contables
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. Todos son opcionales.
輸入參數activacodPlangrupoCuentaprefijoCuenta
freematica_list_cuentas_analiticas
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).
- delegacion: filtra por delegación (DELEG).
Los filtros se combinan con AND. Todos son opcionales.
輸入參數areaactivacodPlandelegaciongrupoCuentaprefijoCuenta
freematica_export_asientos
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 tener ceros, ej. "01").
Filtros FIQL adicionales (opcionales):
- fechaDesde O fechaHasta (excluyentes): límite de fecha sobre ASI_FCHASI, YYYY-MM-DD.
- diario: código del diario contable (ASI_DIARIO).
- borrador: si true, incluye solo asientos borrador (ASI_BORR no nulo).
Protección de tamaño: si la respuesta supera FREEMATICA_MAX_RESPONSE_SIZE_MB (default 10 MB),
la tool devuelve los datos truncados con un campo "warning" indicando el truncado.
Se recomienda usar rangos de fecha cortos (máx. 1 mes) para evitar truncados.
輸入參數cal必填diarioempresa必填periodoborradorfechaDesdefechaHasta
freematica_get_ficha_prev_cliente
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.
輸入參數codClientecodigoFichagrupoClientecodLocalizacionServicio
freematica_list_vigilancia_salud
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.
輸入參數pageitemsidRegPersona
freematica_get_vigilancia_salud
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.
輸入參數id必填
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` opaco para usar en freematica_get_persona.
輸入參數nifpageitemsnombreempresaseccionapellidosituacioncodPersonadelegaciondepartamento
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.
輸入參數id必填
freematica_list_personal_v2
Lista de personas (endpoint de sincronización incremental v2).
Endpoint: GET /pers/v2/personal
A diferencia de freematica_list_personal (v1), este endpoint acepta el
parámetro opcional `fchmodificacion` (YYYY-MM-DD) para recuperar solo los
registros modificados desde esa fecha. Útil para sincronización incremental.
Cada item incluye `idReg` opaco para usar en freematica_get_persona.
輸入參數pageitemsfchmodificacion
freematica_list_personal_identificacion
Lista paginada de datos de identificación de personas.
Endpoint: GET /pers/v2/personal-identificacion
Devuelve documentos de identificación (DNI, NIE, pasaporte, etc.) asociados
a las personas del módulo de personal.
輸入參數pageitems
freematica_list_personal_notas
Lista paginada de notas de personal.
Endpoint: GET /pers/v2/personal-notas
Parámetro opcional `idReg` para filtrar las notas de una persona concreta.
Sin `idReg` devuelve todas las notas del sistema.
Cada item incluye `idReg` opaco para usar en freematica_get_personal_nota.
輸入參數pageidRegitems
freematica_get_personal_nota
Devuelve el detalle de una nota de personal.
Endpoint: GET /pers/v2/personal-notas/{idReg}
El parámetro `id` debe ser el campo `idReg` de freematica_list_personal_notas.
輸入參數id必填
freematica_list_personal_experiencias
Lista paginada de experiencias profesionales previas de las personas.
Endpoint: GET /pers/v1/personal-experiencias
Parámetro opcional `idReg` para filtrar las experiencias de una persona.
Cada item incluye `idReg` opaco para usar en freematica_get_personal_experiencia.
輸入參數pageidRegitems
freematica_get_personal_experiencia
Devuelve el detalle de una experiencia profesional previa.
Endpoint: GET /pers/v1/personal-experiencias/{idreg}
El parámetro `id` debe ser el campo `idReg` de freematica_list_personal_experiencias.
輸入參數id必填
freematica_list_personal_formaciones
Lista paginada de formaciones académicas/profesionales de las personas.
Endpoint: GET /pers/v1/personal-formaciones
Parámetro opcional `idReg` para filtrar las formaciones de una persona.
Cada item incluye `idReg` opaco para usar en freematica_get_personal_formacion.
輸入參數pageidRegitems
freematica_get_personal_formacion
Devuelve el detalle de una formación de personal.
Endpoint: GET /pers/v1/personal-formaciones/{idReg}
El parámetro `id` debe ser el campo `idReg` de freematica_list_personal_formaciones.
輸入參數id必填
freematica_list_personal_contratos
Lista paginada de contratos laborales de las personas.
Endpoint: GET /pers/v1/personal_contratos
Incluye tipo de contrato, fechas de inicio/fin, categoría y salario.
Cada item incluye `idReg` para usar en freematica_get_personal_contrato.
輸入參數pageitems
freematica_get_personal_contrato
Devuelve el detalle de un contrato laboral.
Endpoint: GET /pers/v1/personal_contratos/{idreg}
El parámetro `id` debe ser el campo `idReg` de freematica_list_personal_contratos.
輸入參數id必填
freematica_list_personal_tramos
Lista paginada de tramos horarios de las personas (v1).
Endpoint: GET /pers/v1/personal_tramos
Incluye código de horario, jornada, fechas de vigencia.
Cada item incluye `idReg` para usar en freematica_get_personal_tramo.
Para sincronización incremental usa freematica_list_personal_tramos_sync (v2).
輸入參數pageitems
freematica_get_personal_tramo
Devuelve el detalle de un tramo horario (v1).
Endpoint: GET /pers/v1/personal_tramos/{idreg}
El parámetro `id` debe ser el campo `idReg` de freematica_list_personal_tramos.
輸入參數id必填
freematica_list_personal_tramos_sync
Lista de tramos horarios — endpoint de sincronización incremental (v2).
Endpoint: GET /pers/v2/personal/tramos
Parámetro opcional `fchmodificacion` (YYYY-MM-DD) para recuperar solo los
tramos modificados desde esa fecha.
Cada item incluye `idReg` para usar en freematica_get_personal_tramo_v2.
輸入參數pageitemsfchmodificacion
freematica_get_personal_tramo_v2
Devuelve el detalle de un tramo horario (v2 — sincronización).
Endpoint: GET /pers/v2/personal/tramos/{idreg}
El parámetro `id` debe ser el campo `idReg` de freematica_list_personal_tramos_sync.
輸入參數id必填
freematica_list_personal_pago
Lista paginada de datos bancarios/de pago de las personas.
Endpoint: GET /pers/v1/personal_pago
Incluye IBAN, entidad bancaria, forma de pago.
Cada item incluye `idReg` para usar en freematica_get_personal_pago.
輸入參數pageitems
freematica_get_personal_pago
Devuelve el detalle de los datos bancarios/de pago de una persona.
Endpoint: GET /pers/v1/personal_pago/{idreg}
El parámetro `id` debe ser el campo `idReg` de freematica_list_personal_pago.
輸入參數id必填
freematica_list_personal_adicionales
Lista paginada de datos adicionales (campos extra) de las personas.
Endpoint: GET /pers/v2/personal-adicionales
Los datos adicionales son campos configurables por empresa que no existen
en la ficha estándar de personal (VSSPERA_*).
Cada item incluye `idReg` para operaciones de escritura.
輸入參數pageitems
freematica_list_personal_prorroga
Lista paginada de prórrogas de contratos laborales.
Endpoint: GET /pers/v1/personal-prorroga
Incluye extensiones y renovaciones de contratos.
Cada item incluye `idReg` para usar en freematica_get_personal_prorroga.
輸入參數pageitems
freematica_get_personal_prorroga
Devuelve el detalle de una prórroga de contrato laboral.
Endpoint: GET /pers/v1/personal-prorroga/{idreg}
El parámetro `id` debe ser el campo `idReg` de freematica_list_personal_prorroga.
輸入參數id必填
freematica_list_incidencias_personal
Lista paginada de incidencias de personal.
Endpoint: GET /pers/v2/incidencias
Incidencias laborales registradas en el módulo de RRHH.
Cada item incluye `idReg` opaco.
輸入參數pageitems
freematica_get_agenda_persona
Devuelve la agenda de una persona (eventos, citas, tareas programadas).
Endpoint: GET /pers/v1/agenda-persona
Parámetro opcional `idReg` para filtrar la agenda de una persona concreta.
輸入參數pageidRegitems
freematica_list_equipamiento_ficha_seguridad
Lista paginada de equipamiento de ficha de seguridad del personal.
Endpoint: GET /pers/v2/equipamiento-ficha-seguridad
EPIs (Equipos de Protección Individual) y equipamiento de seguridad
asignado al personal.
輸入參數pageitems
freematica_list_anticipos_personal
Lista paginada de anticipos de nómina del personal.
Endpoint: GET /pers/v2/personal/anticipos
Anticipos de salario solicitados o concedidos a los empleados.
Cada item incluye `idReg` para usar en freematica_get_anticipo_personal.
輸入參數pageitems
freematica_get_anticipo_personal
Devuelve el detalle de un anticipo de nómina.
Endpoint: GET /pers/v2/personal/anticipos/{idReg}
El parámetro `id` debe ser el campo `idReg` de freematica_list_anticipos_personal.
輸入參數id必填
freematica_list_calendario_personal
Lista paginada de entradas del calendario personal de los empleados.
Endpoint: GET /pers/v2/personal-cal
Vacaciones, permisos, ausencias y días especiales del calendario
individual de cada empleado.
Cada item incluye `idReg` para usar en freematica_get_calendario_personal.
輸入參數pageitems
freematica_get_calendario_personal
Devuelve el detalle de una entrada del calendario personal.
Endpoint: GET /pers/v2/personal-cal/{idReg}
El parámetro `id` debe ser el campo `idReg` de freematica_list_calendario_personal.
輸入參數id必填
Lista paginada de documentos del CPD (Cuadro Personal de Documentos).
Endpoint: GET /pers/v1/cpd
Documentos que los empleados deben firmar o gestionar (contratos, nóminas,
comunicaciones, etc.).
Cada item incluye `idReg` para usar en freematica_get_cpd.
輸入參數pageitems
Devuelve el detalle de un documento CPD.
Endpoint: GET /pers/v1/cpd/{idreg}
El parámetro `id` debe ser el campo `idReg` de freematica_list_cpd.
NOTA: El endpoint de descarga binaria (GET /pers/v1/cpd/download) no está
expuesto porque devuelve un ZIP binario no manejable por herramientas LLM.
輸入參數id必填
freematica_list_cpd_movimientos
Lista los movimientos/historial de un documento CPD.
Endpoint: GET /pers/v1/cpd/{idreg}/movimientos
El parámetro `id` debe ser el campo `idReg` de freematica_list_cpd.
Devuelve el historial de estados y acciones sobre el documento.
輸入參數id必填pageitems
freematica_list_cpd_firmados_vid
Lista paginada de documentos CPD firmados mediante VID (firma digital).
Endpoint: GET /pers/v1/cpd/firmados-vid
Documentos que han sido firmados electrónicamente por los empleados.
輸入參數pageitems
freematica_list_personal_irpf
Lista paginada de datos de IRPF de las personas.
Endpoint: GET /pers/v2/personal_irpf
Tipos de retención, situaciones familiares, y demás datos fiscales
necesarios para el cálculo del IRPF.
Cada item incluye `idReg` para usar en freematica_get_personal_irpf.
輸入參數pageitems
freematica_get_personal_irpf
Devuelve el detalle de los datos de IRPF de una persona.
Endpoint: GET /pers/v2/personal_irpf/{idreg}
El parámetro `id` debe ser el campo `idReg` de freematica_list_personal_irpf.
輸入參數id必填
freematica_list_sesiones_formacion
Lista paginada de sesiones de formación.
Endpoint: GET /pers/v1/sesiones-formacion
Sesiones formativas impartidas o planificadas para el personal.
Cada item incluye `idReg` para usar en freematica_get_sesion_formacion.
輸入參數pageitems
freematica_get_sesion_formacion
Devuelve el detalle de una sesión de formación.
Endpoint: GET /pers/v1/sesiones-formacion/{idreg}
El parámetro `id` debe ser el campo `idReg` de freematica_list_sesiones_formacion.
輸入參數id必填
freematica_list_vss_incidencias
Lista paginada de incidencias de Vigilancia de la Salud (VSS).
Endpoint: GET /pers/v2/vss-incidencias
Incidencias médico-laborales: accidentes, enfermedades profesionales,
bajas por IT, reconocimientos médicos.
Cada item incluye `idReg` para usar en freematica_get_vss_incidencia.
輸入參數pageitems
freematica_get_vss_incidencia
Devuelve el detalle de una incidencia de Vigilancia de la Salud.
Endpoint: GET /pers/v2/vss-incidencias/{idReg}
El parámetro `id` debe ser el campo `idReg` de freematica_list_vss_incidencias.
輸入參數id必填
freematica_list_calendarios
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).
輸入參數pageitems
freematica_list_calendario_periodos
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).
輸入參數pageitemsidCalendario必填
freematica_list_facturas_electronicas
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 query params nativos (NO FIQL). Paginación 1-indexed.
輸入參數pageitemsleidoorderestadoempresacodClientefechaDesdefechaHasta
freematica_get_factura_electronica
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.
輸入參數id必填
freematica_get_factura_documento
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 recuperar el documento
輸入參數id必填documentTypeactualizaLeido
freematica_get_factura_log
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).
輸入參數id必填pageitems
freematica_get_edicom_info
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.
輸入參數pageitems
freematica_list_facturas_documentos
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, documentoError, documentoGuid, documentoFSDir.
輸入參數documentsdocumentType
freematica_list_albaranes_ventas
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 campo `empresa` es requerido por el endpoint de Freemática.
Paginación 1-indexed.
輸入參數pageitemsorderempresa必填codClientedelegacionfechaDesdefechaHastacodDocumento
freematica_get_albaran_venta
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.
輸入參數id必填
freematica_list_albaranes_factura
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 albarán determinado (filtrar por FVCA_NUMALB vía rQuery)
- Listar todos los albaranes vinculados a una factura (filtrar por numFactura + serie)
Paginación 1-indexed.
輸入參數pageidRegitemsserieempresacodClientenumFactura
freematica_get_albaran_factura
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.
輸入參數id必填
freematica_list_resultados_facturacion
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. El param `order` es nativo del endpoint.
輸入參數mespageitemsorderempresatipoFaccontratoserviciocalendariocodClientedelegaciontraspasado
freematica_list_naturalezas_abono
Devuelve la lista paginada de naturalezas de abono (módulo pven).
Nota: este endpoint (/pven/v1/naturalezas-abono) devuelve los registros operativos paginados del módulo pven.
Es distinto del catálogo estático "naturalezas-abono" de freematica_get_master_data, que devuelve la tabla maestra.
Use freematica_get_master_data({ catalog: "naturalezas-abono" }) para el catálogo de referencia (sin paginar).
Endpoint: GET /pven/v1/naturalezas-abono.
輸入參數pageitems
freematica_list_articulos
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 coincidencia EXACTA (el API no soporta búsqueda
parcial en este endpoint). COD_ARTICULO puede llevar espacios iniciales que forman
parte del código (ej. " QQ10615"). Para explorar por texto, filtra por familia o
proveedor y revisa las descripciones de los resultados.
輸入參數pageitemslineaactivofamiliasubfamiliatipoCodigocodArticulodescripcioncodProveedorcodigoBarras
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.
輸入參數id必填
freematica_get_precio_articulo
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).
輸入參數id必填
freematica_list_articulos_costes
Devuelve la lista paginada de costes de artículos en Freemática.
Endpoint: GET /part/v2/articulos-costes
Cada item incluye el coste estándar (PRECIO_COSTE_DV1, PRECIO_COSTE_DV2),
precio medio ponderado y otros datos de valoración del artículo.
輸入參數pageitems
freematica_get_articulo_coste
Devuelve el detalle de costes de un artículo por su `idReg` opaco.
Endpoint: GET /part/v2/articulos-costes/{idreg}
El parámetro `id` DEBE ser el campo `idReg` que aparece en
freematica_list_articulos_costes.
輸入參數id必填
freematica_list_vinculos_personas_servicios
Devuelve la lista paginada de vínculos entre personas y servicios.
Permite resolver la relación centro/servicio → trabajador, clave para la integración CAE.
Endpoint: GET /pvss/v2/vinculos-personas-servicios.
Cada item contiene los campos de asignación de la persona al servicio.
輸入參數pageitemsorder
freematica_get_vinculo_persona_servicio
Devuelve el detalle de un vínculo persona-servicio por su idReg opaco.
Endpoint: GET /pvss/v2/vinculos-personas-servicios/{idreg}.
輸入參數idReg必填
freematica_list_habilitaciones_servicios_alta
Devuelve altas de servicios-personal en el módulo de habilitaciones CAE (feed incremental).
Usar para detectar nuevas asignaciones de trabajadores a centros de trabajo.
Endpoint: GET /peqv/v2/habilitaciones/servicios/alta.
輸入參數pagedesdeitems
freematica_list_habilitaciones_servicios_baja
Devuelve bajas de servicios-personal en el módulo de habilitaciones CAE (feed incremental).
Usar para detectar desvinculaciones de trabajadores de centros de trabajo.
Endpoint: GET /peqv/v2/habilitaciones/servicios/baja.
輸入參數pagedesdeitems
freematica_list_habilitaciones_personal_alta
Devuelve altas de licencias de personal en el módulo de habilitaciones CAE (feed incremental).
Usar para detectar nuevas habilitaciones del personal.
Endpoint: GET /peqv/v2/habilitaciones/personal/alta.
輸入參數pagedesdeitems
freematica_list_habilitaciones_personal_baja
Devuelve bajas de licencias de personal en el módulo de habilitaciones CAE (feed incremental).
Usar para detectar revocaciones de habilitaciones del personal.
Endpoint: GET /peqv/v2/habilitaciones/personal/baja.
輸入參數pagedesdeitems
freematica_list_solicitudes_material
Devuelve la lista paginada de solicitudes de material (módulo PEQV).
Endpoint: GET /peqv/v2/solicitud-material.
輸入參數pageitems
freematica_get_solicitud_material
Devuelve el detalle de una solicitud de material por su idReg opaco.
Endpoint: GET /peqv/v2/solicitud-material/:idreg.
輸入參數idReg必填
freematica_list_cuadrantes
Devuelve la lista paginada de cuadrantes de planificación.
Endpoint: GET /pvss/v1/cuadrantes.
輸入參數pageitemsorder
freematica_list_cuadrantes_detalles
Devuelve la lista paginada de líneas de detalle de cuadrantes.
Endpoint: GET /pvss/v1/cuadrantes-detalles.
輸入參數pageitemsorder
freematica_list_cuadrantes_observaciones
Devuelve la lista paginada de observaciones asociadas a cuadrantes.
Endpoint: GET /pvss/v1/cuadrantes-observaciones.
輸入參數pageitemsorder
freematica_list_cuadrantes_auditoria
Devuelve la lista paginada de registros de auditoría de cuadrantes (feed incremental). Usar con `desde` para sincronización incremental.
Endpoint: GET /pvss/v1/cuadrantes-auditoria.
輸入參數pagedesdeitemsorder
freematica_list_cuadrantes_tareas
Devuelve la lista paginada de tareas de cuadrantes.
Endpoint: GET /pvss/v2/cuadrantes-tareas.
輸入參數pageitemsorder
freematica_list_computos_pers
Devuelve la lista paginada de cómputos de personas.
Endpoint: GET /pvss/v2/computos-pers.
輸入參數pageitems
freematica_get_computos_pers
Devuelve el detalle de cómputos de una persona por su idReg opaco.
Endpoint: GET /pvss/v2/computos-pers/{idreg}.
輸入參數idReg必填
freematica_get_computos_pers_h
Devuelve el detalle de cómputos históricos de una persona por su idReg opaco.
Endpoint: GET /pvss/v2/computos-pers-h/{idreg}.
輸入參數idReg必填
freematica_list_cuadrantes_cierre_personas
Devuelve la lista paginada de cierres de cuadrante por persona.
Endpoint: GET /pvss/v1/cuadrantes-cierre-personas.
輸入參數pageitemsorder
freematica_get_cuadrante_cierre_persona
Devuelve el detalle de un cierre de cuadrante por persona por su idReg opaco.
Endpoint: GET /pvss/v1/cuadrantes-cierre-personas/{idreg}.
輸入參數idReg必填
freematica_list_cuadrantes_cierre_personas_complementos
Devuelve la lista paginada de complementos de cierres de cuadrante por persona.
Endpoint: GET /pvss/v1/cuadrantes-cierre-personas-complementos.
輸入參數pageitemsorder
freematica_get_cuadrante_cierre_persona_complemento
Devuelve el detalle de un complemento de cierre de cuadrante por persona por su idReg opaco.
Endpoint: GET /pvss/v1/cuadrantes-cierre-personas-complementos/{idreg}.
輸入參數idReg必填
freematica_list_cuadrantes_cierre_personas_especiales
Devuelve la lista paginada de jornadas especiales de cierres de cuadrante por persona.
Endpoint: GET /pvss/v1/cuadrantes-cierre-personas-especiales.
輸入參數pageitemsorder
freematica_get_cuadrante_cierre_persona_especial
Devuelve el detalle de una jornada especial de cierre de cuadrante por persona por su idReg opaco.
Endpoint: GET /pvss/v1/cuadrantes-cierre-personas-especiales/{idreg}.
輸入參數idReg必填
freematica_list_cuadrantes_cierre_personas_incidencias
Devuelve la lista paginada de incidencias de cierres de cuadrante por persona.
Endpoint: GET /pvss/v1/cuadrantes-cierre-personas-incidencias.
輸入參數pageitemsorder
freematica_get_cuadrante_cierre_persona_incidencia
Devuelve el detalle de una incidencia de cierre de cuadrante por persona por su idReg opaco.
Endpoint: GET /pvss/v1/cuadrantes-cierre-personas-incidencias/{idreg}.
輸入參數idReg必填
freematica_list_campos_estadisticos
Devuelve la lista paginada de campos estadísticos de cuadrantes.
Endpoint: GET /pvss/v2/campos-estadisticos.
輸入參數pageitemsorder
freematica_list_inspecciones
Devuelve la lista paginada de inspecciones de cuadrantes.
Endpoint: GET /pvss/v2/inspecciones.
輸入參數pageitemsorder
freematica_list_plantillas
Devuelve la lista paginada de plantillas de cuadrantes.
Endpoint: GET /pvss/v2/plantillas.
輸入參數pageitemsorder
Devuelve la lista paginada de normas de cuadrantes.
Endpoint: GET /pvss/v2/normas.
輸入參數pageitemsorder
freematica_list_rutas_gestion
Devuelve la lista paginada de rutas de gestión.
Endpoint: GET /pvss/v1/rutas-gestion.
輸入參數pageitemsorder
freematica_list_rutas_planificacion
Devuelve la lista paginada de rutas de planificación.
Endpoint: GET /pvss/v1/rutas-planificacion.
輸入參數pageitemsorder
freematica_list_acompanante_ruta
Devuelve la lista paginada de acompañantes de ruta.
Endpoint: GET /pvss/v2/acompanante-ruta.
輸入參數pageitemsorder
freematica_list_contratos_servicios_global
Devuelve la lista paginada GLOBAL de servicios de todos los contratos.
A diferencia de freematica_list_servicios_contrato (que requiere un contrato específico),
este endpoint devuelve todos los servicios independientemente del contrato al que pertenecen.
Endpoint: GET /pvss/v1/contratos-servicios.
輸入參數pageitemsorder
freematica_list_contratos_turnos
Devuelve la lista paginada de turnos de contratos.
Endpoint: GET /pvss/v1/contratos-turnos.
輸入參數pageitemsorder
freematica_list_contratos_horarios_operativa
Devuelve la lista paginada de horarios de operativa de contratos.
Endpoint: GET /pvss/v1/contratos-horarios-operativa.
輸入參數pageitemsorder
freematica_list_clases_servicios
Devuelve la lista paginada de clases de servicios.
Endpoint: GET /pvss/v1/clases-servicios.
輸入參數pageitemsorder
freematica_list_inspectores
Devuelve la lista paginada de inspectores.
Endpoint: GET /pvss/v1/inspectores.
輸入參數pageitemsorder
freematica_get_inspector_empresa
Devuelve el inspector asignado a la empresa actual.
Endpoint: GET /pvss/v1/inspector-empresa.
無需輸入參數。
freematica_list_claves_facturacion
Devuelve la lista paginada de claves de facturación.
Endpoint: GET /pvss/v2/claves-facturacion.
輸入參數pageitemsorder
freematica_list_incidencias_servicios
Devuelve la lista paginada de incidencias de servicios.
Endpoint: GET /pvss/v2/incidencias-servicios.
輸入參數pageitemsorder
freematica_get_incidencia_servicio
Devuelve el detalle de una incidencia de servicio por su idReg opaco.
Endpoint: GET /pvss/v2/incidencias-servicios/{idReg}.
輸入參數idReg必填
freematica_list_incidencecode
Devuelve la lista paginada de códigos de incidencia (incidencecode).
Usa el endpoint v2 por defecto; la versión v1 también existe pero puede diferir en campos.
Endpoint: GET /pvss/v2/incidencecode.
輸入參數pageitemsorder
freematica_get_contratos_servicios_material
Devuelve el detalle del material asignado a un servicio de contrato por su idReg opaco.
Para la lista global de materiales asignados a servicios, usar freematica_list_materiales_asignados_servicios.
Endpoint: GET /pvss/v2/contratos-servicios-material/{idreg}.
輸入參數idReg必填
freematica_list_ppre_contratos
Lista paginada de contratos de instalación/mantenimiento (v1).
Endpoint: GET /ppre/v1/contratos
Devuelve los contratos del módulo de Preventivos y Mantenimiento.
Cada item incluye `idReg` opaco para usar en freematica_get_ppre_contrato_v1.
輸入參數pageitems
freematica_list_ppre_contratos_v2
Lista paginada de contratos de instalación/mantenimiento (v2).
Endpoint: GET /ppre/v2/contratos
Versión v2 del listado de contratos ppre.
Cada item incluye `idReg` opaco para usar en freematica_get_ppre_contrato_v2.
輸入參數pageitems
freematica_get_ppre_contrato_v1
Detalle de un contrato de instalación/mantenimiento (v1).
Endpoint: GET /ppre/v1/contratos/{idreg}
El parámetro `id` debe ser el campo `idReg` de freematica_list_ppre_contratos.
輸入參數id必填
freematica_get_ppre_contrato_v2
Detalle de un contrato de instalación/mantenimiento (v2).
Endpoint: GET /ppre/v2/contratos/{idReg}
El parámetro `id` debe ser el campo `idReg` de freematica_list_ppre_contratos_v2.
輸入參數id必填
freematica_list_ppre_contratos_instalacion
Lista paginada de contratos de instalación (v1).
Endpoint: GET /ppre/v1/contratosInstalacion
Contratos vinculados a instalaciones físicas.
Cada item incluye `idReg` opaco.
輸入參數pageitems
freematica_list_ppre_tipos_contrato
Catálogo de tipos de contrato ppre (v2).
Endpoint: GET /ppre/v2/tipos-contrato
Devuelve el catálogo completo de tipos de contrato disponibles.
Endpoint de catálogo, sin paginación.
無需輸入參數。
freematica_list_ppre_ordenes_trabajo
Lista paginada de órdenes de trabajo (v1).
Endpoint: GET /ppre/v1/ordenes-trabajo
Devuelve las órdenes de trabajo del módulo de Preventivos y Mantenimiento.
Cada item incluye `idReg` opaco para usar en freematica_get_ppre_orden_trabajo.
輸入參數pageitems
freematica_get_ppre_orden_trabajo
Detalle de una orden de trabajo (v1).
Endpoint: GET /ppre/v1/ordenes-trabajo/{idreg}
El parámetro `id` debe ser el campo `idReg` de freematica_list_ppre_ordenes_trabajo.
輸入參數id必填
freematica_list_ppre_partes
Lista paginada de partes de mantenimiento (v1).
Endpoint: GET /ppre/v1/partes
Partes de trabajo del módulo de Preventivos y Mantenimiento.
Cada item incluye `idReg` opaco para usar en freematica_get_ppre_parte.
輸入參數pageitems
freematica_get_ppre_parte
Detalle de un parte de mantenimiento (v1).
Endpoint: GET /ppre/v1/partes/{idreg}
El parámetro `id` debe ser el campo `idReg` de freematica_list_ppre_partes.
輸入參數id必填
freematica_get_ppre_parte_componentes_ficha_tecnica
Componentes de ficha técnica de un parte de mantenimiento.
Endpoint: GET /ppre/v1/partes/{idreg}/componentes-ficha-tecnica
El parámetro `id` debe ser el campo `idReg` de freematica_list_ppre_partes.
輸入參數id必填
freematica_list_ppre_parte_ultimas_intervenciones
Últimas intervenciones de un parte de mantenimiento.
Endpoint: GET /ppre/v1/partes/{idreg}/ultimas-intervenciones
El parámetro `id` debe ser el campo `idReg` de freematica_list_ppre_partes.
輸入參數id必填pageitems
freematica_list_ppre_partes_orden_trabajo
Lista paginada de partes vinculados a órdenes de trabajo (v2).
Endpoint: GET /ppre/v2/partes/partes-orden-trabajo
Partes asociados a órdenes de trabajo.
Cada item incluye `idReg` opaco.
輸入參數pageitems
freematica_list_ppre_partes_fin_mantenedor
Lista paginada de partes fin de mantenedor (v2).
Endpoint: GET /ppre/v2/partes/partes-fin-mantenedor
Partes finalizados por el mantenedor.
Cada item incluye `idReg` opaco.
輸入參數pageitems
freematica_list_ppre_cabecera_actas_partes
Lista paginada de cabeceras de actas de partes (v2).
Endpoint: GET /ppre/v2/partes/cabecera-actas-partes
Cabeceras de las actas de partes de mantenimiento.
Cada item incluye `idReg` opaco.
輸入參數pageitems
freematica_list_ppre_lineas_actas_partes
Lista paginada de líneas de actas de partes (v2).
Endpoint: GET /ppre/v2/partes/lineas-actas-partes
Líneas de detalle de las actas de partes de mantenimiento.
Cada item incluye `idReg` opaco.
輸入參數pageitems
freematica_list_ppre_fichas_instalacion
Lista fichas de instalación (v1).
Endpoint: GET /ppre/v1/fichas-instalacion (o /ppre/v1/fichas-instalacion/{idReg} si se proporciona idReg).
Si se proporciona `idReg`, el idReg forma parte del path y actúa como filtro.
Cada item incluye `idReg` opaco.
輸入參數pageidRegitems
freematica_get_ppre_ficha_tecnica
Detalle de una ficha técnica (v1).
Endpoint: GET /ppre/v1/ficha-tecnica/{idReg}
El parámetro `id` debe ser el campo `idReg` de freematica_list_ppre_fichas_instalacion.
輸入參數id必填
freematica_list_ppre_componentes_ficha_tecnica
Lista componentes de una ficha técnica (v1).
Endpoint: GET /ppre/v1/fichas-tecnicas/{idreg}/componentes
El parámetro `id` debe ser el campo `idReg` de freematica_list_ppre_fichas_instalacion.
輸入參數id必填pageitems
freematica_list_ppre_marcajes
Lista paginada de marcajes de presencia (v1).
Endpoint: GET /ppre/v1/marcajes
Marcajes de entrada/salida del personal de mantenimiento.
Cada item incluye `idReg` opaco.
輸入參數pageitems
freematica_list_ppre_marcajes_v2
Lista paginada de marcajes de presencia (v2).
Endpoint: GET /ppre/v2/marcajes
Versión v2 de los marcajes del personal de mantenimiento.
Cada item incluye `idReg` opaco.
輸入參數pageitems
freematica_list_ppre_incidencias_anomalias
Lista paginada de incidencias y anomalías de mantenimiento (v1).
Endpoint: GET /ppre/v1/incidencias-anomalias
Incidencias y anomalías registradas en el módulo de Preventivos y Mantenimiento.
Cada item incluye `idReg` opaco.
輸入參數pageitems
freematica_list_ppre_tipo_instalacion
Lista paginada de tipos de instalación (v1).
Endpoint: GET /ppre/v1/tipo-instalacion
Catálogo de tipos de instalación disponibles en el sistema.
Cada item incluye `idReg` opaco.
輸入參數pageitems
freematica_list_pemf_marcajes
Lista paginada de marcajes de campo e-Movifree (v2).
Endpoint: GET /pemf/v2/marcajes
Marcajes de entrada/salida/novedad del personal de campo (operarios de seguridad).
Cada item incluye `idReg` opaco.
輸入參數pageitems
freematica_get_pemf_marcaje
Detalle de un marcaje de campo e-Movifree por idReg (v2).
Endpoint: GET /pemf/v2/marcajes/{idReg}
El parámetro `idReg` debe ser el campo `idReg` de freematica_list_pemf_marcajes.
輸入參數idReg必填
freematica_list_pemf_tracking
Lista paginada de marcajes de tracking e-Movifree (v1).
Endpoint: GET /pemf/v1/tracking
Marcajes de seguimiento de operarios de campo (versión v1 del endpoint de tracking).
Cada item incluye `idReg` opaco.
輸入參數pageitems
freematica_list_pemf_calls
Lista paginada de marcajes CCR (llamadas fijas) de e-Movifree.
Endpoint: GET /pemf/v1/calls
Marcajes realizados mediante llamada telefónica fija (CCR legacy).
Cada item incluye `idReg` opaco.
輸入參數pageitems
freematica_list_pemf_geoposition
Lista paginada de marcajes de geoposición e-Movifree (v1).
Endpoint: GET /pemf/v1/geoposition
Posiciones GPS de los operarios de campo registradas desde la app e-Movifree.
Cada item incluye `idReg` opaco.
輸入參數pageitems
freematica_list_pemf_geoposition_v2
Lista paginada de marcajes de geoposición e-Movifree (v2).
Endpoint: GET /pemf/v2/geoposition
Versión v2 de las posiciones GPS de los operarios de campo.
Cada item incluye `idReg` opaco.
輸入參數pageitems
Lista paginada de novedades activas e-Movifree (CNA — Control Novedades Activo).
Endpoint: GET /pemf/v2/cna
Novedades activas de los operarios de campo en el momento actual.
Cada item incluye `idReg` opaco.
輸入參數pageitems
freematica_list_pemf_devices
Lista paginada de dispositivos e-Movifree registrados.
Endpoint: GET /pemf/v1/devices
Dispositivos móviles, fijos y de control registrados en el sistema e-Movifree.
Cada item incluye `idReg` (o idDevice) opaco.
輸入參數pageitems
freematica_get_pemf_device
Detalle de un dispositivo e-Movifree por idDevice.
Endpoint: GET /pemf/v1/devices/{idDevice}
El parámetro `idDevice` debe ser el campo `idReg` de freematica_list_pemf_devices.
輸入參數idDevice必填
freematica_list_pemf_rondas
Lista paginada de rondas de seguridad e-Movifree (v1).
Endpoint: GET /pemf/v1/rounds
Rondas de vigilancia/seguridad realizadas por los operarios de campo.
Cada item incluye `idReg` opaco.
輸入參數pageitems
freematica_list_pemf_rondas_v2
Lista paginada de rondas de seguridad e-Movifree (v2).
Endpoint: GET /pemf/v2/rounds
Versión v2 de las rondas de vigilancia/seguridad de los operarios de campo.
Cada item incluye `idReg` opaco.
輸入參數pageitems
freematica_list_pemf_ronda_points
Lista los puntos de control de una ronda e-Movifree (v1).
Endpoint: GET /pemf/v1/rounds/{idRonda}/points
Puntos de control (checkpoints) de una ronda de seguridad.
El parámetro `idRonda` debe ser el campo `idReg` de freematica_list_pemf_rondas.
輸入參數pageitemsidRonda必填
freematica_list_pemf_ronda_points_v2
Lista los puntos de control de una ronda e-Movifree (v2).
Endpoint: GET /pemf/v2/rounds/{idRonda}/points
Versión v2 de los puntos de control de una ronda de seguridad.
El parámetro `idRonda` debe ser el campo `idReg` de freematica_list_pemf_rondas_v2.
輸入參數pageitemsidRonda必填
freematica_list_pemf_services
Lista paginada de servicios de campo e-Movifree.
Endpoint: GET /pemf/v1/services
Servicios de seguridad/vigilancia asignados a los operarios de campo.
Cada item incluye `idReg` opaco.
輸入參數pageitems
freematica_get_pemf_service
Detalle de un servicio de campo e-Movifree por idService.
Endpoint: GET /pemf/v1/services/{idService}
El parámetro `idService` debe ser el campo `idReg` de freematica_list_pemf_services.
輸入參數idService必填
freematica_list_pemf_service_alarms
Lista de alarmas activas de un servicio de campo e-Movifree.
Endpoint: GET /pemf/v1/services/{idService}/alarms
El parámetro `idService` debe ser el campo `idReg` de freematica_list_pemf_services.
輸入參數idService必填
freematica_list_pemf_service_issues
Lista de incidencias de un servicio de campo e-Movifree.
Endpoint: GET /pemf/v1/services/{idService}/issues
El parámetro `idService` debe ser el campo `idReg` de freematica_list_pemf_services.
輸入參數idService必填
freematica_list_pemf_service_rounds
Lista de rondas de un servicio de campo e-Movifree.
Endpoint: GET /pemf/v1/services/{idService}/rounds
El parámetro `idService` debe ser el campo `idReg` de freematica_list_pemf_services.
輸入參數idService必填
freematica_list_pemf_service_jobs
Lista de trabajos/tareas de un servicio de campo e-Movifree.
Endpoint: GET /pemf/v1/services/{idService}/jobs
El parámetro `idService` debe ser el campo `idReg` de freematica_list_pemf_services.
輸入參數idService必填
freematica_list_pemf_identificadores_servicio
Lista paginada de identificadores de servicio e-Movifree.
Endpoint: GET /pemf/v2/identificadores-servicio
Tags/códigos de identificación de los servicios de campo (códigos QR, NFC, etc.).
Cada item incluye `idReg` opaco.
輸入參數pageitems
freematica_list_pemf_rutas
Lista paginada de rutas de campo e-Movifree.
Endpoint: GET /pemf/v2/routes
Rutas de trabajo asignadas a los operarios de campo (turnos, frecuencias, horarios).
Cada item incluye `idReg` opaco.
輸入參數pageitems
freematica_list_pemf_materiales_consumibles
Lista de materiales consumibles de un servicio de campo e-Movifree.
Endpoint: GET /pemf/v2/services/{idReg}/materiales-consumibles
Materiales de uso común (consumibles) asignados a un servicio específico.
El parámetro `idReg` debe ser el campo `idReg` de freematica_list_pemf_services.
輸入參數idReg必填