¿En qué consiste la integración mediante API de NDD Print MPS?
La integración mediante API permite conectar sistemas externos a NDD Print MPS a través de los servicios web disponibles en el Integration Kit.
Gracias a ella, es posible consultar información y automatizar acciones relacionadas con contratos, contadores, equipos, eventos, consumibles, stock, pedidos y NDD Print Host.
¿Cuáles son las principales ventajas de la integración?
La integración permite:
-
automatizar actividades operativas que antes dependían de consultas y acciones manuales en el portal;
-
centralizar los datos del MPS en sistemas propios, como ERP, BI, CRM o portales internos;
-
apoyar los procesos de gestión de contratos, facturación, logística de consumibles y seguimiento de eventos;
-
crear flujos integrados para solicitudes, pedidos, stocks y atención al cliente;
-
recibir notificaciones automáticas sobre eventos y modificaciones en los pedidos.
¿Qué información se puede consultar?
Dependiendo del servicio web utilizado, es posible consultar información como:
-
contratos, cierres y valores consolidados;
-
contadores de impresoras;
-
eventos de impresoras y eventos del sistema;
-
empresas, sitios, departamentos, impresoras, fabricantes y modelos;
-
consumibles, stocks, centros de distribución y proveedores;
-
pedidos de transferencia y pedidos a proveedores;
-
NDD Print Hosts e impresoras registradas para su supervisión en red.
¿Qué servicios web están disponibles?
ContractsData
Permite consultar y gestionar información sobre contratos, impresoras vinculadas, cierres, valores consolidados y el estado de los equipos dentro o fuera de contrato.
CountersData
Permite consultar tipos de contadores, contadores simples y contadores de referencia, además de permitir la inclusión de contadores cuando sea aplicable al flujo de integración.
EventsData
Permite consultar eventos de impresoras y del sistema, además de realizar acciones como abrir, cerrar, reabrir, ignorar, comentar o esperar a que se resuelvan los eventos.
GeneralData y GeneralData2
Permiten consultar y gestionar datos generales del entorno, incluyendo empresas, impresoras, sitios, departamentos, materiales, consumibles, stock e información sobre equipos.
GeneralData2 es una versión mejorada, que ofrece información adicional y una comunicación más flexible.
PrintHostsData
Permite consultar los NDD Print Hosts del distribuidor y gestionar las direcciones de red registradas para la monitorización de impresoras.
ServicesDeskData
Permite realizar acciones relacionadas con las demandas y consultar información del Portal de Servicios a través de la integración.
StockOrdersData
Permite consultar y realizar acciones en pedidos de transferencia vinculados a los centros de distribución.
SupplierOrdersData
Permite consultar y realizar acciones en los pedidos de entrada relacionados con los proveedores.
¿Es posible recibir notificaciones automáticas del MPS?
Sí. El MPS ofrece servicios web de notificación que pueden ser implementados por el distribuidor o por el cliente para recibir información automática sobre:
-
apertura, cierre, comentarios y modificaciones en los eventos;
-
cambios en el estado de los pedidos y las entregas.
En este caso, el servicio web del cliente debe publicarse utilizando HTTPS y devolver a MPS el resultado del procesamiento de la llamada.
¿La integración solo permite consultar información?
No. Además de consultar información, la integración permite realizar acciones, tales como:
-
actualizar datos de impresoras;
-
gestionar eventos;
-
importar información;
-
gestionar direcciones de monitorización;
-
gestionar pedidos de consumibles.
Los métodos que realizan modificaciones solo deben utilizarse tras la validación del flujo de negocio y de los permisos necesarios.
¿Es posible utilizar los datos en Power BI?
Sí. Para ello, es necesario desarrollar un integrador o un proceso ETL que utilice los servicios web, trate las respuestas y ponga los datos a disposición de Power BI.
Los servicios web devuelven los datos en formato JSON, lo que facilita su procesamiento por parte de las aplicaciones de integración. Sin embargo, no existe un conector nativo y automático de MPS para Power BI.
¿Cuáles son los requisitos de acceso?
La integración requiere:
-
credenciales válidas;
-
permisos compatibles con el método utilizado;
-
acceso habilitado a los servicios web para el distribuidor o la empresa.
Las contraseñas deben introducirse de forma cifrada, tal y como se muestra en los ejemplos disponibles en el Integration Kit.
¿Qué precauciones deben tomarse?
-
Utilizar únicamente los métodos necesarios para el proceso de integración.
-
Aplicar filtros para evitar consultas excesivas.
-
Proteger las credenciales, las claves y los datos devueltos por la API.
-
Validar los permisos antes de ejecutar métodos que realicen modificaciones.
-
Tratar los errores, incluidos los fallos de autenticación, los permisos insuficientes o el límite diario de accesos.
-
Publicar los servicios web de notificación utilizando HTTPS.
¿Dónde consultar la documentación técnica?
La documentación completa, que incluye los métodos disponibles, los parámetros, los ejemplos, los resultados y los errores, está disponible en el Integration Kit.