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必填