¿Qué es la integración mediante API de NDD Print 360?
La integración mediante API conecta los datos de NDD Print portal 360 con sistemas externos a través de servicios web SOAP.
Gracias a ella, es posible consultar y tratar automáticamente la información de los trabajos de impresión y los presupuestos, sin necesidad de exportar informes manualmente.
¿Cuáles son las principales ventajas?
La integración permite:
-
automatizar el consumo de datos por parte de sistemas de BI, ERP, financieros o portales internos;
-
reducir las tareas manuales de exportación, tratamiento y consolidación de informes;
-
consultar solo los datos necesarios, utilizando filtros de fecha y campos específicos;
-
facilitar el análisis de costes, volúmenes, comportamiento de impresión y seguimiento de cuotas;
-
integrar los procesos de gestión de la impresión en las rutinas que ya utiliza el cliente.
¿Qué información se puede consultar?
La API permite consultar información sobre los trabajos de impresión, como:
-
usuario y dominio;
-
cuenta de costes;
-
equipo y cola de impresión;
-
sitio y departamento;
-
páginas en blanco y negro y en color;
-
costes;
-
modo simplex o dúplex;
-
fecha de impresión;
-
aplicación de origen;
-
título del documento.
Los campos devueltos dependen de los seleccionados en la consulta.
¿Qué métodos son disponibles para consultar datos?
PrintJobsData
GetPrintJobs
Devuelve los trabajos de impresión según los filtros indicados.
Está indicado para integraciones de informes, BI, auditoría, reparto de costes y análisis de volumen.
La consulta permite definir:
-
la fecha;
-
el tipo de filtro, que puede ser fecha de impresión o fecha de inclusión;
-
los campos que deben devolverse.
QuotasData
GetBalance
Devuelve el saldo de cuotas del usuario, incluyendo créditos corporativos y personales, por páginas, color o valor.
Está indicado para portales internos, consultas de saldo, paneles de seguimiento e integraciones con procesos de control de impresión.
QuotasWS
GetUserQuotas
Devuelve el total de cuotas por usuario y permite aplicar filtros por cuenta, tipo de cuota, saldo, créditos, débitos y cuotas caducadas.
Está indicado para el seguimiento de gestión, la comprobación del consumo y la integración con sistemas de gestión de usuarios o centros de coste.
¿La API también permite modificar las cuotas?
Sí. El servicio web QuotasData permite añadir o eliminar créditos:
-
AddCreditTotalPages; -
AddCreditColor; -
AddCreditMoney; -
DebitTotalPages; -
DebitColor; -
DebitMoney.
Estos métodos solo deben utilizarse cuando exista una regla de negocio definida y validada, ya que modifican las cuotas de los usuarios.
¿Se puede utilizar la integración en Power BI?
Sí. Para ello, es necesario desarrollar un integrador o un proceso ETL capaz de consumir los servicios web, tratar las respuestas y poner los datos a disposición en Power BI.
La documentación describe servicios web SOAP con respuesta en formato JSON. No hay indicación de un conector nativo y automático de NDD Print 360 para Power BI.
¿Cómo se devuelven los datos?
Los servicios web devuelven una cadena de caracteres en formato JSON. La aplicación integradora puede deserializar estos datos y dirigirlos a una base de datos, un dashboard, un ERP u otra herramienta de análisis.
¿Qué información se necesita para la autenticación?
Las consultas utilizan información de la empresa, como el nombre y la clave, además de un usuario con los permisos necesarios.
La contraseña debe introducirse de forma cifrada, tal y como se muestra en los ejemplos disponibles en el Integration Kit.
¿Hay alguna configuración adicional para consultar las cuotas por usuario?
Sí. Para utilizar el método GetUserQuotas en entornos locales, es necesario:
-
utilizar el NDD Print Portal 360 Local en la versión 5.65.13;
-
configurar la API QuotasWS en el IIS del servidor.
¿Qué precauciones hay que tener en cuenta?
-
Solicitar únicamente los campos necesarios para la integración.
-
Evitar consultas excesivas o sin filtros, sobre todo en entornos con un elevado volumen de impresión.
-
Proteger las credenciales y la clave de la empresa.
-
Evaluar la necesidad de acceder al título de los documentos, teniendo en cuenta las políticas de privacidad del cliente.
-
Tratar los errores de la API, incluidos los fallos de autenticación, los permisos insuficientes o el límite diario de accesos.
¿Dónde se puede consultar la documentación técnica?
La documentación completa, que incluye WSDL, parámetros, campos de respuesta, ejemplos de cifrado y posibles errores, es disponible en el Integration Kit.