RICOH Account Administration

1 RICOH Account Administration

RICOH Account Administration es la interfaz de administración de aplicaciones RICOH TotalFlow Cloud, como RICOH Predictive Insight™.

Referencia: Para obtener información sobre las políticas de seguridad de RICOH TotalFlow Cloud, consulte RICOH TotalFlow Cloud Security Overview.

1.1 Descripción general de RICOH Account Administration

Los administradores utilizan RICOH Account Administration para administrar usuarios de RICOH TotalFlow Cloud y otros objetos utilizados en sus aplicaciones.

Las funciones disponibles varían en función de las suscripciones a aplicaciones que haya adquirido su empresa. En todas las aplicaciones de TotalFlow Cloud, se utiliza Account Administration para:

Añadir, modificar y eliminar usuarios.
Ver los detalles de sus suscripciones.
Ver y modificar los detalles de su cuenta.

Para algunas aplicaciones, se añaden otras funciones para que pueda:

Descargar e instalar RICOH Cloud Connector, para ayudarle a comunicarse con las aplicaciones de Ricoh instaladas en su red.

1.1.1 Novedades

RICOH Account Administration actualiza periódicamente las funciones disponibles y soluciona posibles fallos.

RICOH Account Administration incluye varias soluciones de posibles fallos y actualizaciones de seguridad en cada despliegue. Aquí se enumeran los cambios adicionales para cada despliegue.

3 de septiembre de 2026

Ya está disponible la función API de exportación de datos de RICOH Predictive Insight. La notación beta se ha eliminado de la documentación aquí: Cómo trabajar con la API de exportación de datos

5 de agosto de 2026

Correcciones de errores y actualizaciones de seguridad, incluidas las correcciones para CVE-2026-42198, CVE-2026-44431, CVE-2026-44432, CVE-2026-48522, CVE-2026-48524, CVE-2026-48525 y CVE-2026-48526.

21 de julio de 2026

Correcciones de errores y actualizaciones de seguridad para RICOH Cloud Connector, incluidas las correcciones para CVE-2026-8723, CVE-2026-41907, CVE-2026-44486, CVE-2026-44487, CVE-2026-44488, CVE-2026-44489, CVE-2026-44490, CVE-2026-44492, CVE-2026-44494, CVE-2026-44496, CVE-2026-45736 y CVE-2026-48779.

1 de julio de 2026

Correcciones de errores y actualizaciones de seguridad, incluidas las correcciones para CVE-2024-47535, CVE-2025-24970, CVE-2025-25193, CVE-2025-55163, CVE-2025-58057, CVE-2025-68161, CVE-2026-33871, CVE-2026-34477, CVE-2026-34478, CVE-2026-34480, CVE-2026-42581, CVE-2026-42583, CVE-2026-42584, CVE-2026-42587, CVE-2026-44249, CVE-2026-45416 y CVE-2026-47244.

12 de junio de 2026

Correcciones de errores y actualizaciones de seguridad, incluidas las correcciones para CWE-117 y CWE-93.

11 de junio de 2026

Se ha actualizado el sistema de ayuda para incluir contenido sobre la API de exportación de datos, una función disponible para pruebas beta: Cómo trabajar con la API de exportación de datos

1 de mayo de 2026

Actualizado el documento Ricoh TotalFlow Cloud Security.

7 de abril de 2026

Correcciones de errores y actualizaciones de seguridad, incluidas las correcciones para CVE-2025-45768 y CVE-2026-26007.

21 de enero de 2026

Corrección de errores y actualizaciones de seguridad, incluidas correcciones para CVE-2025-66418 y CVE-2025-66471.

17 de diciembre de 2025

Corrección de errores y actualizaciones de seguridad, incluidas correcciones para CVE-2025-48976, CVE-2025-7962 y CVE-2025-12383.

30 de octubre de 2025

Corrección de errores y actualizaciones de seguridad, incluidas correcciones para CVE-2025-9636 y CVE-2025-48924.

30 de julio de 2025

Corrección de errores y actualizaciones de seguridad, incluidas correcciones para CVE-2024-37891 y CVE-2024-12797.

23 de julio de 2025

Corrección de errores y actualizaciones de seguridad, incluidas correcciones para CVE-2025-50181 y CVE-2025-50182.

9 de julio de 2025

Actualizada la Política de Privacidad para Japón.
Añadido soporte para clientes en Eslovenia y Croacia.
Corrección de errores y actualizaciones de seguridad, incluyendo correcciones para CVE-2021-28168.

2 de julio de 2025

Corrección de errores y actualizaciones de seguridad, incluyendo correcciones para CVE-2023-52428 y CVE-2023-1370.

4 de junio de 2025

Corrección de errores y actualizaciones de seguridad, incluidas correcciones para CVE-2024-47554 y XUC-XUC-MAVEN-100000.

23 de abril de 2025

Corrección de errores y actualizaciones de seguridad, incluida una corrección para CVE-2024-37891.

8 de abril de 2025

Actualizado el documento RICOH TotalFlow Cloud Security.

2 de abril de 2025

Actualizado para cambiar el nombre de RICOH Supervisor a RICOH Predictive Insight en todas las referencias.
Actualizaciones de seguridad y correcciones de errores.

12 de marzo de 2025

Mejoras en el rendimiento.
Actualizaciones de seguridad y correcciones de errores.

4 de febrero de 2025

Varias actualizaciones de seguridad, incluidas correcciones para CVE-2024-45296, CVE-2024-45590, CVE-2017-20165 y CVE-2024-39338.
Cambios en la redacción y corrección de errores.

29 de enero de 2025

Varias actualizaciones de seguridad, incluyendo correcciones para CWE-798.
Cambios en la redacción y corrección de errores.

5 de diciembre de 2024

La Política de Privacidad de Ricoh Europe ahora también es aplicable a Ucrania, Rumanía e Israel.
Cambios en la redacción y corrección de errores.

30 de octubre de 2024

Varias actualizaciones de seguridad, incluidas correcciones para la CVE-2024-37891.
Cambios en la redacción y corrección de errores.

2 de octubre de 2024

Varias actualizaciones de seguridad, incluidas correcciones para las CVE-2023-2650, CVE-2023-3446, CVE-2023-49083, CVE-2023-50782, CVE-2024-0727, CVE-2024-26130 y CVE-2023-4807.
Cambios en la redacción y corrección de errores.

17 de julio de 2024

Eliminado el soporte para RICOH TotalFlow Producer.
Cambios en la redacción y corrección de errores.

20 de junio de 2024

Cambios en la redacción y corrección de errores.

11 de junio de 2024

Cambios en la redacción y corrección de errores.

22 de mayo de 2024

Se actualizó la lista de impresoras compatibles con la suscripción avanzada a RICOH TotalFlow Producer y se añadió soporte para impresoras con el controlador interno estándar de Ricoh.
Cambios en la redacción y corrección de errores.

30 de abril de 2024

Cambios en la redacción y corrección de errores.

15 de abril de 2024

Cambios en la redacción y corrección de errores.

9 de abril de 2024

Cambios en la redacción y corrección de errores.

14 de marzo de 2024

Cambios en la redacción y corrección de errores.

7 de marzo de 2024

Cambios en la redacción y corrección de errores.

27 de febrero de 2024

Para la suscripción avanzada a RICOH TotalFlow Producer, RICOH Account Administration añadió soporte para configurar y gestionar impresoras.
Para comunicarse con las impresoras que funcionan en su entorno, RICOH Cloud Connector incluye ahora el componente RICOH Printer Connector. El componente RICOH Printer Connector solo está disponible actualmente en la versión para Windows de RICOH Cloud Connector.
Cambios en la redacción y corrección de errores.

13 de febrero de 2024

Cambios en la redacción y corrección de errores.

30 de enero de 2024

Cambios en la redacción y corrección de errores.

14 de noviembre de 2023

En apoyo de RICOH TotalFlow Producer, RICOH Account Administration añadió la compatibilidad con la función BETA Conversión de Office.
Esta función está disponible con una suscripción avanzada a RICOH TotalFlow Producer.

2 de agosto de 2023

En apoyo de RICOH TotalFlow Producer, RICOH Account Administration añadió la compatibilidad con estos objetos de sistema:
- Automatizaciones
- Conectores
- Clientes
- Carpetas activas
Estos objetos sólo son visibles después de activar una suscripción a RICOH TotalFlow Producer; no obstante, en el sistema de ayuda se incluyen instrucciones para gestionarlos.

21 de junio de 2023

Actualizaciones del sistema de ayuda.

1 de marzo de 2023

Varias actualizaciones de seguridad, incluidas correcciones para la CVE-2022-41946 y la CVE-2022-42003.

10 de noviembre de 2022

Varias actualizaciones de seguridad, incluidas correcciones para la CVE-2022-42889.

24 de agosto de 2022

Varias actualizaciones de seguridad, incluidas correcciones para la CVE-2022-31197.

27 de julio de 2022

Varias actualizaciones de seguridad.

24 de junio de 2022

Se ha añadido soporte para configurar RICOH Cloud Connector para utilizar HTTPS.
Varias actualizaciones de seguridad, incluidas correcciones para la CVE-2022-21724.

17 de mayo de 2022

Ya está disponible la instalación de RICOH Cloud Connector a través de la interfaz de usuario.

11 de marzo de 2022

Se actualizaron las traducciones para incluir el contenido de RICOH Cloud Connector.
Se actualizó la documentación en inglés de RICOH Cloud Connector y los temas generales.

23 de febrero de 2022

Se añadió el soporte para los clientes de Canadá.

19 de enero de 2022

Varias actualizaciones de seguridad, incluidas correcciones para la CVE-2021-44228.

27 de octubre de 2021

RICOH Cloud Connector ya está disponible.

1 de septiembre de 2021

Se añadió el soporte para los clientes de Francia.

25 de agosto de 2021

Se añadió el soporte para los clientes de Alemania.

28 de julio de 2021

Se añadió el soporte para los clientes de Vietnam.

12 de mayo de 2021

Se añadió el soporte para los clientes de Bélgica y Luxemburgo.

7 de mayo de 2021

Se ha actualizado la política de cookies para los clientes de Japón.

17 de marzo de 2021

Se añadió el soporte para los clientes de Portugal.

17 de febrero de 2021

Se añadió el soporte para los clientes de España.

16 de diciembre de 2020

Se añadió el soporte para los clientes de Filipinas.

2 de diciembre de 2020

Se añadió el soporte para los usuarios de Suiza.

9 de septiembre de 2020

Se añadió el soporte para los clientes de Japón.

2 de septiembre de 2020

Se actualizó la Política de privacidad para los clientes de Estados Unidos.

5 de agosto de 2020

Se añadió el soporte para los clientes de Suecia.

20 de mayo de 2020

Se añadió el soporte para los clientes de Malasia y México.

1.1.2 Objetos del sistema

Los objetos del sistema son elementos que se definen en las aplicaciones de TotalFlow Cloud y se utilizan para construir la solución tal y como se desea. En Account Administration, algunos ejemplos de objetos del sistema son los usuarios y los conectores.

Los objetos del sistema que defina en Account Administration podrían utilizarse en todas las aplicaciones de TotalFlow Cloud.

1.1.2.1 Claves de API

Un « Clave de API » es una credencial que autoriza a una aplicación a enviar solicitudes a una API de RICOH TotalFlow Cloud en nombre de su cuenta. Las claves API se definen en RICOH Account Administration.

Las aplicaciones que utilizan una API en lugar de la interfaz de usuario no pueden iniciar sesión como usuario. En cambio, cada solicitud incluye el valor de una clave API, que identifica la cuenta a la que pertenece la solicitud. Dado que la clave contiene la identidad de su cuenta, no es necesario incluir un parámetro de cuenta o de inquilino en las solicitudes.

Puede definir hasta diez claves para su cuenta. Muchas organizaciones crean una clave para cada aplicación que recupera datos, de modo que se pueda sustituir o eliminar una clave sin interrumpir el funcionamiento de las demás aplicaciones. Cada clave tiene un nombre, una descripción y una fecha de caducidad.

El valor de una clave solo se muestra una vez, en el momento en que se crea o se renueva la clave. Account Administration no almacena el valor en un formato que permita volver a mostrarlo, por lo que deberá copiarlo y guardarlo de forma segura cuando se muestre. Si se pierde un valor, se gira la llave para generar uno nuevo. Cualquier persona que disponga de dicho valor puede enviar solicitudes en nombre de su cuenta, por lo que debe proteger las claves del mismo modo que protege una contraseña. Las claves no están limitadas a impresoras concretas.

Las claves se gestionan en la pestaña « Claves de API ». Puede modificar el nombre, la descripción o la fecha de caducidad de una clave; rotar una clave para sustituir su valor sin alterar su identidad; o eliminar una clave para revocar el acceso de forma inmediata.

En RICOH TotalFlow Cloud, las claves API se utilizan con la API de exportación de datos, que recupera información sobre impresoras, trabajos y el estado de las impresoras recopilada por RICOH Predictive Insight. El número de solicitudes a la API que puede realizar su cuenta, en todas las claves API, viene determinado por su suscripción. Cada suscripción establece un límite máximo para el número de solicitudes de API permitidas en un periodo de 30 días consecutivos. Si supera el número de llamadas que le permite su suscripción, no se aceptarán solicitudes hasta que el total de solicitudes de los últimos 30 días sea inferior al límite de la suscripción. Para consultar cuántas llamadas incluye su suscripción y cuántas ha utilizado en los últimos 30 días, acceda a la página « Claves de API ». Si considera que necesita más capacidad para las solicitudes de API, consulte a su representante de RICOH sobre la posibilidad de ampliar su suscripción.

1.1.2.2 Conectores

Los Conectores son aplicaciones almacenadas en sus sistemas locales que crean un vínculo entre las aplicaciones en la nube y el software o los dispositivos instalados a nivel local. Esta conexión crea un canal de comunicación entre los sistemas. Para conectarse a RICOH TotalFlow Cloud, debe instalar RICOH Cloud Connector en un servidor de su red.

Estas aplicaciones utilizan RICOH Cloud Connector para instalar y gestionar licencias de suscripción:

RICOH InfoPrint Manager para Windows y para Linux
RICOH Auto Color Adjuster

1.1.2.3 Usuarios

Cualquier persona que trabaje con aplicaciones de RICOH TotalFlow Cloud debe definirse como un Usuario.

Cuando Ricoh configura inicialmente su cuenta, se crea un usuario Administrador. El administrador recibe un correo electrónico de bienvenida de TotalFlow Cloud, con un enlace para iniciar sesión y cambiar su contraseña inicial. Este administrador es responsable de crear usuarios para el resto de su organización.

A los Usuarios se les asignan funciones para cada aplicación para la que haya adquirido una suscripción. Las funciones se basan en las responsabilidades laborales del usuario y varían de una aplicación a otra. Por ejemplo, la Account Administration tiene dos funciones que puede asignar a los usuarios:

Administrador: Usuarios con permiso para ver detalles sobre su cuenta, crear y gestionar otros usuarios, y administrar otros objetos, según sea necesario.
Ninguno: Usuarios cuyas responsabilidades laborales incluyen trabajar en sus aplicaciones suscritas, pero no administrar usuarios u otros objetos.

Un usuario puede ser un Administrador en Account Administration, pero un Visor en una aplicación como RICOH Predictive Insight.

A los Usuarios también se les asigna una función dentro de la plataforma de TotalFlow Cloud. La mayoría de los usuarios tienen asignada la función de plataforma Estándar. Sin embargo, otras aplicaciones pueden añadir funciones especiales de plataforma.

Por ejemplo, RICOH Predictive Insight añade la función de plataforma Visualización grande. Se crea un usuario con la función de plataforma Visualización grande cuando, por ejemplo, se desea mostrar los cuadros de mando de RICOH Predictive Insight en una pantalla del área de producción para mostrar el estado actual. Alguien de su empresa inicia sesión como usuario de Visualización grande y maximiza la ventana del navegador en la pantalla grande. El usuario de Visualización grande solo tiene acceso de visualización y puede permanecer conectado el tiempo máximo permitido.

1.1.3 Interfaz de usuario

Los usuarios con permiso de acceso a RICOH Account Administration pueden abrir la interfaz de usuario desde cualquier sistema que esté conectado a Internet y tenga instalado un navegador compatible.

1.1.3.1 Mensaje de cabecera

El mensaje de cabecera es la barra negra de la parte superior de la interfaz de usuario. Está disponible en todas las páginas de la interfaz.

Los iconos del mensaje de cabecera le permiten realizar diversas tareas:

Cambiar a otra aplicación de RICOH TotalFlow Cloud a la que tenga acceso.
Pulse , el icono App Switcher, y elija qué aplicación desea abrir. La aplicación se abre en la misma pestaña.
Enviar ideas para mejorar nuestras aplicaciones.
Haga clic en , el icono Enviar ideas y, a continuación, en Añadir una nueva idea para describir lo que deberíamos añadir. También puede revisar las ideas enviadas por otros clientes. Si le gusta la idea, vote a favor. Las ideas que cuentan con el apoyo de más de un cliente suelen captar nuestra atención y tienen más posibilidades de llevarse a la práctica
Ver las notificaciones enviadas por los administradores del sistema o por las propias aplicaciones.
Haga clic en , el icono Notificaciones.
- Puede ver algunas notificaciones sin abrir la lista Notificaciones. Estas notificaciones aparecen en una franja encima o debajo del mensaje de cabecera o en la parte inferior de la ventana del navegador.
Ver detalles sobre su ID de usuario o la cuenta de su empresa.
Haga clic en , el icono Cuenta. Su identificación de usuario y nombre de cuenta se encuentran en la parte superior del menú. Seleccione cualquier opción para ver los ajustes o la información asociados.
Obtener ayuda para utilizar la aplicación.
Haga clic en , el icono Ayuda, y seleccione Ayuda.
Consultar las Condiciones de uso de las aplicaciones de TotalFlow Cloud.
Haga clic en , el icono Ayuda, y seleccione Condiciones de uso.

1.1.3.2 Página principal

Al iniciar sesión en RICOH Account Administration o volver desde otra aplicación, se ve la página principal con una de las pestañas abiertas.

El número de pestañas disponibles varía en función de las aplicaciones a las que se haya suscrito. Todas las aplicaciones incluyen estas pestañas:

Suscripciones
Usuarios
Detalles

Otras aplicaciones añaden otras pestañas según sea necesario. Por ejemplo, con una suscripción a RICOH Auto Color Adjuster, la pestaña Conectores también está disponible.

La mayoría de las pestañas muestran una lista de objetos en una tabla. En todas las tablas se puede:

Ordenar las entradas.
Haga clic en el encabezado de la tabla una vez para ordenar en orden ascendente y otra vez para ordenar en orden descendente.
Cambiar y reorganizar las columnas que se muestran.
Haga clic en , el icono de engranaje y seleccione Gestionar las columnas.
Buscar texto en la tabla.
Haga clic en , el icono Buscar y escriba el texto que desea encontrar.

1.1.3.2.1 Pestaña Claves de API

La lista de claves API definidas para su cuenta aparece en la pestaña Claves de API (Configuración de API) en RICOH Account Administration. Utilice esta pestaña para crear las claves que autorizan las solicitudes a la API de exportación de datos y para gestionarlas a lo largo de su ciclo de vida.

Pestaña Claves de API

La pestaña Claves de API solo está disponible si su cuenta cuenta con una suscripción a RICOH Predictive Insight. Para ver la pestaña y utilizar las teclas, debe disponer de acceso d Administrador e a Account Administration.

Los dos enlaces situados en la parte superior de la pestaña permiten acceder a la información de referencia sobre la API de exportación de datos:

Primeros pasos con las claves API: Abre la ayuda de la API de exportación de datos, donde podrá consultar los pasos que debe seguir para empezar a utilizar las claves API, así como los puntos finales disponibles, los campos que devuelve cada uno de ellos y los límites que se aplican a las solicitudes.
Abrir el Explorador de API: Abre la página de documentación interactiva de la API, donde podrá consultar cada punto final, ver los parámetros que admite y enviar solicitudes de ejemplo directamente desde su navegador. Necesita el valor de una clave API para enviar una solicitud desde esa página.

Estas son las acciones que puede realizar en esta pestaña:

Consulte todas las claves definidas para su cuenta y sus propiedades, tales como: Nombre, Estado y Fecha de caducidad.
La tabla no muestra el valor de una clave.
Cree una clave.
Pulse Crear clave de API. Las claves suelen estar activas en un plazo de 30 segundos, aunque pueden producirse retrasos.
Supervise las solicitudes de API de la cuenta en relación con los límites de la suscripción.
El recuadro situado encima de la tabla de claves API muestra el plan de uso de la cuenta y el número máximo de llamadas a la API permitidas durante un periodo de 30 días. Realice un seguimiento del número de llamadas realizadas en los últimos 30 días.
Modifique el nombre, la descripción o la fecha de caducidad de una clave existente.
Haga clic con el botón derecho en una fila y seleccione Editar clave API. La modificación de una clave no altera su valor, por lo que las aplicaciones que ya la utilizan seguirán funcionando.
Gire una clave para sustituir su valor.
Haga clic con el botón derecho en una fila y seleccione Girar clave API. Establezca un periodo de solapamiento de modo que tanto el valor actual como el nuevo estén vigentes durante varios días, lo que le dará tiempo para actualizar sus aplicaciones. La clave con el nuevo valor suele estar disponible para su uso en un plazo de 30 segundos, aunque pueden producirse retrasos.
Eliminar una clave.
Haga clic con el botón derecho en una fila y seleccione Suprimir inmediatamente.
- Al eliminar una clave, esta se elimina del sistema en el plazo de un minuto, aunque pueden producirse retrasos. Las claves eliminadas se eliminan de forma definitiva. Si intenta realizar una solicitud a la API utilizando una clave API después de haberla eliminado, la solicitud fallará.
- Al eliminar una clave, se eliminan todas sus versiones. Si rota una clave y, a continuación, la elimina, se eliminarán ambas versiones de la clave, incluso si el periodo de solapamiento sigue activo.

Importante: El valor de una clave solo se muestra una vez, al crearla o al rotarla. No podrá volver a visualizarlo desde esta pestaña. Copie el valor y guárdelo de forma segura en ese momento. Si la pierde, gire la llave para generar un nuevo valor.

Las claves no están limitadas a impresoras concretas. Cualquier persona que disponga del valor de una clave puede enviar solicitudes en nombre de su cuenta. Comparta las claves únicamente con las personas que se encargan de desarrollar las integraciones y cámbielas periódicamente de acuerdo con sus prácticas de seguridad.

Al hacer clic en , el icono de herramientas, se abre un menú desde el que puede actualizar la información de la tabla y gestionar las columnas de esta.

1.1.3.2.2 Pestaña Conectores

Los conectores registrados aparecen en la pestaña Conectores en RICOH Account Administration.

Pestaña Conectores

Estas son las acciones que puede realizar en esta pestaña:

Ver todos los conectores registrados y sus propiedades, tales como: Estado, Versión, Plataforma o cuándo fueron contactados por última vez.
Descargar la última versión de RICOH Cloud Connector para su sistema operativo.
Haga clic en Descargar y seleccione el sistema operativo.
Generar un código de un solo uso para registrar un conector de nube.
Pulse Generar código único.
Editar, suprimir o visualizar las conexiones asociadas a un conector.
Haga clic con el botón derecho del ratón en un conector y seleccione una opción del menú.
- Para editar un conector, el servidor en el que está definido el conector debe estar en funcionamiento y usted debe tener una conexión de red operativa con él.
- Cuando elimina un conector, la instancia RICOH Cloud Connector no se desinstala pero se anula su registro en la nube y las suscripciones asociadas podrían verse afectadas.

Al hacer clic en , el icono de herramientas, se abre un menú desde el que puede actualizar la información de la tabla y gestionar las columnas de esta.

1.1.3.2.3 Pestaña Detalles

Utilice la pestaña Detalles para ver información sobre la cuenta de su empresa.

Puede hacer clic en Editar detalles, en la esquina superior derecha de la página, para actualizar el nombre de su empresa, la información de contacto y facturación, el idioma predeterminado y el periodo de tiempo de espera para todos los usuarios de su empresa.

1.1.3.2.4 Pestaña Suscripciones

Utilice la pestaña Suscripciones para ver todas las suscripciones asociadas a su cuenta, incluidas las que han caducado. También puede descargar RICOH Cloud Connector, si lo necesita.

Pestaña Suscripciones

Cada suscripción adquirida por su empresa se muestra como una tarjeta en la pestaña Suscripciones. La tarjeta muestra las fechas de inicio y vencimiento de la suscripción. Al hacer clic en Detalles, se abre un cuadro de diálogo que muestra más información, como por ejemplo:

El número y tipo de cada una de las licencias incluidas con la aplicación
Detalles sobre la suscripción, incluidos los complementos adquiridos con ella

1.1.3.2.5 Pestaña Usuarios

Utilice la pestaña Usuarios para crear y gestionar los usuarios que tienen acceso a sus aplicaciones.

Pestaña Usuarios

En la pestaña Usuarios, puede:

Crear nuevos usuarios.
Pulse Añadir usuario.
Editar, copiar y eliminar usuarios existentes.
Haga clic con el botón derecho en una fila y seleccione la opción correcta.
Vuelva a enviar invitaciones a los usuarios que no hayan respondido a su invitación inicial.
Haga clic con el botón derecho en una fila y seleccione Reenviar invitación.

1.1.4 RICOH Cloud Connector

RICOH Cloud Connector es una aplicación que se instala en la red para gestionar la comunicación con RICOH TotalFlow Cloud.

Cloud Connector sólo es necesaria con determinados productos y en determinadas configuraciones:

RICOH InfoPrint Manager Subscription
Si adquiere RICOH InfoPrint Manager Subscription, Cloud Connector se instala con el producto. Se conecta a RICOH TotalFlow Cloud para verificar que su suscripción no haya caducado.
RICOH Auto Color Adjuster
RICOH Auto Color Adjuster utiliza Cloud Connector para gestionar las suscripciones.

1.1.5 Accesibilidad

Ricoh se esfuerza por proporcionar productos que pueda utilizar todo el mundo, independientemente de la edad o las capacidades.

Para obtener más información sobre nuestro compromiso con la accesibilidad, consulte la página sobre accesibilidad en el sitio web de Ricoh.

Funciones de accesibilidad

Las funciones de accesibilidad ayudan a los usuarios con discapacidades físicas, como movilidad restringida o visión limitada, a utilizar los productos de tecnología de la información correctamente.

Las funciones de accesibilidad más importantes de este producto le permiten:

Utilizar lectores de pantalla, ampliadores de pantalla y otras tecnologías de asistencia.
Utilizar el teclado en lugar del ratón.
Cambiar atributos como el volumen, el color, el contraste y el tamaño de fuente.
Distinguir teclas de forma táctil sin activarlas.
Conectar dispositivos de entrada y salida alternativos como los dispositivos de señalización especial y los habilitados para Braille.

Además, el centro de información y las publicaciones para el producto se encuentran en un formato accesible.

Navegación con el teclado

Este producto utiliza las teclas de navegación estándar de Microsoft Windows.

1.1.6 Marcas registradas

RICOH InfoPrint Manager™ y RICOH Predictive Insight™ son marcas comerciales de Ricoh Company, Ltd. en Estados Unidos, en otros países o en ambos.

Firefox es una marca registrada de Mozilla Foundation.

Google y Chrome son marcas registradas de Google Inc.

Java y todas las marcas registradas y logotipos basados en Java son marcas registradas de Oracle y/o sus afiliados.

Linux es una marca registrada de Linus Torvalds en Estados Unidos y en otros países.

Microsoft, Windows, Windows Server, Windows Vista e Internet Explorer son marcas comerciales o marcas registradas de Microsoft Corporation en Estados Unidos y/u otros países.

Los nombres propios de los sistemas operativos Windows son los siguientes:

Windows Server 2019:
- Microsoft®Windows Server® 2019 Standard
- Microsoft®Windows Server® 2019 Essentials
Windows Server 2022:
- Microsoft®Windows Server® 2022 Standard
- Microsoft®Windows Server® 2022 Essentials
Windows 10:
- Microsoft® Windows 10 Pro
- Microsoft® Windows 10 Enterprise
Windows 11:
- Microsoft® Windows 11 Pro
- Microsoft® Windows 11 Enterprise

OpenJDK es una marca comercial de Oracle America, Inc. Java y OpenJDK son marcas comerciales o marcas registradas de Oracle y/o sus afiliados. Copyright Oracle America, Inc.

Otros nombres de productos utilizados aquí se utilizan con fines de identificación y podrían ser marcas comerciales de sus respectivas compañías. Renunciamos a todos los derechos sobre dichas marcas.

1.2 Introducción a RICOH TotalFlow™ Cloud

Familiarícese con las aplicaciones de TotalFlow Cloud para poder empezar a trabajar.

1.2.1 Iniciar sesión por primera vez en RICOH TotalFlow Cloud

Cuando se crea su cuenta, recibe un correo electrónico de RICOH TotalFlow Cloud. Utilice el botón incluido ese correo electrónico para conectarse por primera vez.

Para iniciar sesión en RICOH TotalFlow Cloud por primera vez, siga estos pasos:

Abra el correo electrónico que recibió de RICOH TotalFlow Cloud.
Haga clic en Iniciar sesión en la cuenta.
La página de inicio de sesión se abre en su navegador web predeterminado.
Introduzca una contraseña en los campos Nueva contraseña y Confirmar contraseña, y haga clic en crear contraseña.
Las contraseñas deben tener más de ocho caracteres y cumplir los criterios indicados en la página.
- La invitación por correo electrónico caduca a los siete días. Si hace clic en el enlace una vez caducada la invitación, se abrirá una página de error y se le enviará automáticamente una nueva invitación por correo electrónico.
  Importante: Haga clic en el enlace de Reenviar invitación de esa página únicamente si no recibe un nuevo correo electrónico de RICOH TotalFlow Cloud en los siguientes 15 minutos.
- Si tiene otros problemas para crear su cuenta, póngase en contacto con su administrador y pídale que le envíe de nuevo la invitación.

1.2.2 Introducción a RICOH TotalFlow Cloud para administradores

Los administradores configuran los objetos y aplicaciones de TotalFlow Cloud para prepararlos para que otros los utilicen. Crean los ID de usuario del resto y están informados sobre los periodos de inactividad programados, las actualizaciones del sistema y la información sobre suscripciones.

Los administradores realizan la mayoría de sus tareas en la aplicación RICOH Account Administration, pero también pueden acceder a otras aplicaciones y utilizarlas.

Para empezar a utilizar RICOH TotalFlow Cloud como administrador:

Inicie sesión y cambie su contraseña.
Una vez creado su ID de usuario, recibirá un correo electrónico que le invita a conectarse y a empezar a utilizar las aplicaciones de RICOH TotalFlow Cloud. La primera vez que inicie sesión, deberá restablecer su contraseña.
- Ricoh sólo crea un usuario para su cuenta. Ese usuario es un administrador. Si usted es el primer usuario, es responsable de añadir más usuarios y darles acceso a las aplicaciones correctas. Puede crear otros administradores y delegarles responsabilidades.
Como administrador, se le redirige a la aplicación Account Administration.
Tome medidas por lo que respecta a la configuración de cookies.
Las aplicaciones de TotalFlow Cloud utilizan cookies, algunas de las cuales son obligatorias. Visite Gestión de la configuración de las cookies para obtener más información sobre las cookies y las medidas que puede tomar al respecto.
Familiarícese con la interfaz de la aplicación. Revise estos temas:
- Mensaje de cabecera
- Página principal
Revise la información de su cuenta y sus suscripciones.
- Gestión de datos de la cuenta
  Puede actualizar los datos de contacto según sea necesario.
- Visualización de las suscripciones
  Si tiene alguna pregunta, póngase en contacto con su representante de Ricoh.
Obtenga información sobre los componentes de su sistema para empezar a planificar los objetos que debe crear.
- Objetos del sistema
- RICOH Cloud Connector
Utilice los procedimientos incluidos en esta sección y en la sección Configuración para crear los ID de usuario y otros objetos necesarios en su cuenta.

1.2.2.1 Visualización de las suscripciones

Puede ver los detalles de sus suscripciones en RICOH Account Administration.

Para ver las suscripciones:

Inicie sesión en RICOH Account Administration.
Haga clic en Suscripciones en el panel izquierdo.

La página Suscripciones contiene sus tarjetas de suscripciones, junto con sus estados actuales y fechas de caducidad. Las suscripciones pueden tener los siguientes estados:

Activo

Actualmente, la suscripción está disponible para su uso.

Pendiente

Aún no ha llegado la fecha de inicio de la suscripción.

Suspendido

La suscripción se ha desactivado debido a algún evento, como la infracción de los términos y condiciones o un impago. Puede restaurarse una vez solucionado el problema.

Caducado

El periodo de la suscripción ha finalizado.
Para ampliar los detalles de la suscripción, haga clic en Detalles.

La tabla Licencias incluye información sobre las licencias para varias funciones incluidas en la suscripción y todos los complementos y el número de cada tipo de licencia que ha adquirido con esta suscripción.

La tabla Detalles de la suscripción contiene un resumen del producto y de todos los complementos incluidos en esta suscripción.

Para renovar una suscripción o adquirir más complementos, póngase en contacto con su representante de Ricoh.

1.2.2.2 Adición de usuarios

Al añadir un usuario, debe especificar la información de contacto de este y la función que tendrá para cada aplicación.

Puede crear un nuevo usuario o copiar un usuario existente. Copiar usuarios puede ahorrar tiempo, sobre todo si necesita crear varios usuarios con propiedades similares.

Para añadir un usuario:

En el panel izquierdo, haga clic en Usuarios.
Elija una de estas opciones:
- Para añadir un nuevo usuario: haga clic en Añadir usuario en la esquina superior derecha de la ventana.
- Para copiar un usuario existente: haga clic con el botón derecho en la fila de un usuario existente y seleccione Duplicar.
En el cuadro de diálogo que se abre, introduzca los datos del usuario.
En Tipo de usuario, seleccione Interno para crear una cuenta de usuario para uno de sus empleados.
En Función de plataforma, seleccione una de estas opciones:
- Estándar: el usuario puede iniciar sesión en la aplicación con opciones estándar de acceso y tiempo de espera.
- Visualización grande: el usuario tiene acceso de solo lectura a la aplicación en una pantalla grande y su sesión no caduca.
En Acceso y funciones, seleccione el acceso y la función del usuario para cada aplicación. Haga clic en la flecha de la columna Acceso y funciones de cada aplicación.
- Algunas suscripciones incluyen limitaciones del número de usuarios que se pueden asignar a cada función.
Pulse Aceptar.

El usuario recibe un correo electrónico que le invita a iniciar sesión en RICOH TotalFlow Cloud, donde puede modificar sus datos y cambiar su contraseña. La invitación por correo electrónico es válida durante siete días.

Nota:

Si el usuario no inicia sesión antes de que caduque la invitación por correo electrónico, puede volver a enviarle la invitación. Haga clic con el botón derecho del ratón en el usuario y seleccione Reenviar invitación.

1.2.3 Introducción a RICOH TotalFlow Cloud para usuarios

Los usuarios de las aplicaciones de RICOH TotalFlow Cloud desempeñan funciones muy diversas, desde analistas de inteligencia empresarial hasta operadores de copisterías.

La mayoría de los usuarios tienen acceso a una aplicación de RICOH TotalFlow Cloud. También puede actualizar los detalles sobre su propio ID de usuario y su contraseña.

Para empezar a utilizar las aplicaciones de RICOH TotalFlow Cloud como usuario:

Inicie sesión y cambie su contraseña.
Una vez creado su ID de usuario, recibirá un correo electrónico que le invita a conectarse y a empezar a utilizar las aplicaciones de RICOH TotalFlow Cloud. La primera vez que inicie sesión, deberá restablecer su contraseña.
Después de cambiar su contraseña, verá la aplicación que puede utilizar.
Tome medidas por lo que respecta a la configuración de cookies.
Las aplicaciones de TotalFlow Cloud utilizan cookies, algunas de las cuales son obligatorias. Visite Gestión de la configuración de las cookies para obtener más información sobre las cookies y las medidas que puede tomar al respecto.
Familiarícese con la interfaz de la aplicación. Revise estos temas que le atañen:
Obtenga información sobre los componentes de su sistema.
- Objetos del sistema

1.2.4 Gestión de la configuración de las cookies

Las aplicaciones de RICOH TotalFlow Cloud utilizan cookies para mejorar su experiencia con nuestro software. Usted puede controlar la configuración de algunas de esas cookies.

Las aplicaciones de RICOH TotalFlow Cloud pueden utilizar este tipo de cookies:

Cookies estrictamente necesarias: Se trata de cookies esenciales para el funcionamiento de nuestras aplicaciones. Si decide no aceptar estas cookies, es posible que no pueda iniciar sesión en nuestras aplicaciones o utilizar otras funciones esenciales.
Cookies de rendimiento: Las cookies de rendimiento, también denominadas cookies estadísticas, recopilan información sobre la calidad del funcionamiento de nuestras aplicaciones. Esta información es agregada y se anonimiza, por lo que no puede utilizarse para identificarle.; Los datos de rendimiento recopilados incluyen información recopilada por Google Analytics. Para evitar que Google Analytics recopile sus datos, desactive las cookies de rendimiento.
Cookies de funcionalidad: Las cookies de funcionalidad, también denominadas cookies de preferencias, recuerdan información como la última página que visitó o el idioma que prefiere.
Cookies de marketing: Las cookies de marketing recopilan información sobre su actividad en línea para ayudar a mostrarle publicidad relevante.

Para gestionar la configuración de las cookies:

Inicie sesión en cualquier aplicación de TotalFlow Cloud.
En el banner, haga clic en el , el icono Cuenta, y seleccione Configuración de cookies.
En el cuadro de diálogo Configuración de cookies, haga clic en Ver la declaración de cookies para ver una lista de las cookies utilizadas en las aplicaciones de TotalFlow Cloud y sus descripciones.
Utilice los conmutadores para activar o desactivar cada tipo de cookie.
Por defecto, todas las cookies están activadas:
Pulse De acuerdo.

1.3 Configuración

Utilice estos procedimientos para configurar su sistema de modo que otras personas de su empresa puedan utilizarlo.

1.3.1 Adición de usuarios

Al añadir un usuario, debe especificar la información de contacto de este y la función que tendrá para cada aplicación.

Puede crear un nuevo usuario o copiar un usuario existente. Copiar usuarios puede ahorrar tiempo, sobre todo si necesita crear varios usuarios con propiedades similares.

Para añadir un usuario:

En el panel izquierdo, haga clic en Usuarios.
Elija una de estas opciones:
- Para añadir un nuevo usuario: haga clic en Añadir usuario en la esquina superior derecha de la ventana.
- Para copiar un usuario existente: haga clic con el botón derecho en la fila de un usuario existente y seleccione Duplicar.
En el cuadro de diálogo que se abre, introduzca los datos del usuario.
En Tipo de usuario, seleccione Interno para crear una cuenta de usuario para uno de sus empleados.
En Función de plataforma, seleccione una de estas opciones:
- Estándar: el usuario puede iniciar sesión en la aplicación con opciones estándar de acceso y tiempo de espera.
- Visualización grande: el usuario tiene acceso de solo lectura a la aplicación en una pantalla grande y su sesión no caduca.
En Acceso y funciones, seleccione el acceso y la función del usuario para cada aplicación. Haga clic en la flecha de la columna Acceso y funciones de cada aplicación.
- Algunas suscripciones incluyen limitaciones del número de usuarios que se pueden asignar a cada función.
Pulse Aceptar.

Nota:

Si el usuario no inicia sesión antes de que caduque la invitación por correo electrónico, puede volver a enviarle la invitación. Haga clic con el botón derecho del ratón en el usuario y seleccione Reenviar invitación.

1.4 Gestión de objetos

Una vez creados los usuarios y configurados los detalles de su cuenta, podrá actualizarlos cuando sea necesario.

1.4.1 Gestión de datos de la cuenta

Puede modificar los detalles de su cuenta, incluidos sus datos de contacto y los datos de su empresa.

Para gestionar los datos de la cuenta:

Haga clic en Detalles en el panel izquierdo.
Pulse Editar detalles.
Modifique la información según sea necesario y haga clic en Aceptar.

1.4.2 Modificación de la información de usuario

Puede modificar los datos del usuario cuando sea necesario.

Para modificar la información de usuario:

Haga clic en Usuarios en el panel izquierdo.
Haga clic con el botón derecho del ratón en el usuario cuyos datos quiera modificar y pulse Editar.
Modifique los datos del usuario según sea necesario y haga clic en Aceptar.

1.4.3 Cambio de contraseña

Cambie su contraseña para garantizar la seguridad de su cuenta.

Nota:

Si no conoce su contraseña actual, abra la página de inicio de sesión de RICOH TotalFlow Cloud y haga clic en Contraseña olvidada. Escriba su dirección de correo electrónico y haga clic en Siguiente. Busque en su correo electrónico un mensaje de RICOH TotalFlow Cloud con instrucciones para restablecer su contraseña.

Para cambiar la contraseña:

Inicie sesión en RICOH TotalFlow Cloud.
En el banner, haga clic en , el icono de Cuenta, y seleccione Configuración del perfil.
En la parte izquierda de la página Perfil y preferencias del software de Ricoh, haga clic en Contraseña.
Introduzca dos veces su contraseña actual y su nueva contraseña.
Pulse Cambiar contraseña.
Pulse Cerrar.

La próxima vez que se conecte, asegúrese de utilizar la nueva contraseña.

1.5 Cómo trabajar con la API de exportación de datos

Con la API de exportación de datos, puede extraer la información recopilada por RICOH Predictive Insight para utilizarla en otros procesos y herramientas de su organización.

La API de exportación de datos permite acceder mediante programación a la información de la impresora, al historial de trabajos, a los datos de estado de la impresora y a los eventos de intervención en la impresora. Puede utilizarlo para alimentar herramientas de generación de informes, completar paneles de control, archivar datos operativos o integrar datos de « RICOH Predictive Insight » con otros sistemas de su entorno.

1.5.1 API de exportación de datos

La API de exportación de datos es una API REST que ofrece cuatro puntos de conexión. Puede utilizar esos puntos de conexión para descargar información sobre sus impresoras y los trabajos que han procesado, así como sobre los estados de funcionamiento de dichas impresoras a lo largo del tiempo y los eventos que han activado mensajes de advertencia o de error en la impresora.

Puede utilizar la API de exportación de datos para importar datos de RICOH Predictive Insight a herramientas de inteligencia empresarial, almacenes de datos, paneles de control y otras aplicaciones de su organización.

Autenticación

Puede crear y gestionar claves API en RICOH Account Administration. Puede crear tantas claves como necesite: una por cada aplicación que descargue datos o una clave para su uso en toda su organización. Configure la fecha de caducidad de acuerdo con sus prácticas de seguridad y renueve las claves según sea necesario. Puede configurar el periodo de solapamiento, de modo que tanto la clave antigua como la nueva funcionen durante varios días. Si es necesario, puede eliminar una clave para desactivarla de inmediato.

La clave API también incluye su identidad de inquilino, por lo que no es necesario incluir ningún parámetro de inquilino o de cuenta en ninguna solicitud. Cualquier persona que disponga de ese valor de clave puede enviar solicitudes en nombre de su inquilino, por lo que debe proteger las claves API del mismo modo que protegería una contraseña.

Puntos finales disponibles

La API incluye los siguientes puntos finales:

/printers

Devuelve la lista de impresoras de su cuenta, incluyendo el nombre de la impresora, el modelo, el fabricante, el número de serie, los motores y el estado actual de la conexión.

/jobs

Proporciona información detallada a nivel de trabajo sobre una o varias impresoras, incluyendo la duración, el número de copias impresas, las páginas, las impresiones, las hojas, la longitud del rollo y el consumo de tinta y de Vaciado por canal de color. Por defecto, la respuesta abarca las últimas 24 horas.

/printer-states

Devuelve el estado de funcionamiento de cada motor de impresión, ya sea como un historial agregado correspondiente a un intervalo de tiempo o únicamente como el estado actual. Puede consultar los estados reales de la impresora, tales como: Printing, Preparing, Maintenance o sleeping, o bien agrupar dichos estados en las siguientes categorías: up, down, idle» o unknown.

Consejo: El punto final /printer-states proporciona información sobre el estado de cada engine de impresión, no de cada impresora. Una impresora con varios motores devuelve una fila por cada motor.

/printer-interventions

Devuelve los eventos que han provocado advertencias o errores en una o varias impresoras, como un atasco de papel o una fuente de papel vacía. Cada evento se registra para un único motor de impresión, indicando la hora de inicio, la hora de finalización, la duración, un código que identifica la condición y el nombre del trabajo que se estaba imprimiendo, si lo hubiera. Por defecto, la respuesta abarca las últimas 24 horas. Puede solicitar las descripciones de los eventos en cualquiera de los idiomas disponibles.

Pruebas de la API

Hay disponible una página de documentación interactiva que le permite revisar cada punto final, consultar los parámetros que admite y probar solicitudes de ejemplo directamente desde su navegador. Para abrir la página, vaya a:

Estados Unidos y Japón: https://rpi-data-export.app-ricohsoftware.com/api/v1/api-docs
Europa: https://rpi-data-export.app-ricohsoftware.eu/api/v1/api-docs

Para enviar solicitudes desde la página de documentación o desde sus propias aplicaciones, primero debe crear una clave API. Puede crear y gestionar claves API en Account Administration.

1.5.2 Creación y gestión de claves API

Una clave API autoriza las solicitudes a la API de exportación de datos. Las claves API se crean y gestionan en Account Administration, y debe introducir la clave al enviar solicitudes desde la página «Explorador de API» o desde sus propias aplicaciones.

Cada solicitud enviada a la API de exportación de datos debe incluir una clave API válida en la cabecera de solicitud x-api-key. La clave autentica la solicitud dirigida a su cuenta (inquilino).

Para crear claves API, debe disponer deAdministradoracceso de tipo aAccount Administration.

Siga los procedimientos que se describen en este apartado para:

Cree una nueva clave API.
Modifique el nombre, la fecha de caducidad o la descripción de una clave existente.
Rote una clave para sustituir su valor secreto sin modificar la identidad de la misma.
Elimine una clave del sistema.

Nota: Cuando se crea o se renueva una clave API, hay un breve intervalo de tiempo antes de que la clave quede registrada y esté lista para su uso. Por lo general, este intervalo es inferior a un minuto.

Para crear una nueva clave API:
1. En el panel izquierdo deAccount Administration, haga clic en Claves de API.
2. Pulse Crear clave de API.
3. Introduzca un nombre y una descripción para esta clave.
4. Para Fecha de caducidad, elija una fecha con una antelación máxima de 367 días.
5. En Licencias , seleccione el plan de uso «RPI Data Export» para las claves API.
6. Pulse Siguiente.
  La clave se ha generado y guardado.
7. Haga clic en Copiar para copiar la clave generada en el portapapeles. Guárdelo en un lugar seguro.
  
  Importante: El valor completo de la clave solo se muestra cuando se crea la clave. No podrá volver a acceder a él. Si pierde el valor, deberá rotar la clave para generar una nueva.
1. Haga clic en « He guardado mi llave » para cerrar el cuadro de diálogo.
Para editar una clave API existente:
1. En el panel izquierdo deAccount Administration, haga clic en Claves de API.
2. Busque la clave que desee modificar. Haga clic con el botón derecho del ratón en la fila correspondiente a la clave y seleccione « Editar clave API ».
3. Actualice el nombre, la fecha de caducidad o la descripción según sea necesario.
  Al editar una clave, el valor de la misma no se modifica. Las aplicaciones que ya utilizan la clave seguirán funcionando sin cambios.
4. Pulse Aceptar.
Para rotar una clave API:
1. En el panel izquierdo deAccount Administration, haga clic en Claves de API.
2. Localice la clave que desea rotar. Haga clic con el botón derecho del ratón en la fila correspondiente a la clave y seleccione « Girar clave API ».
3. Establezca el valor de « Periodo de solapamiento en días » en el número de días durante los que desea que tanto la clave actual como la versión rotada estén activas al mismo tiempo.
4. Establezca un nuevo valor de « Fecha de caducidad » para la clave.
5. Pulse Aceptar.
6. Haga clic en Copiar para copiar la clave generada en el portapapeles. Guárdelo en un lugar seguro.
  
  Importante: El valor completo de la clave solo se muestra cuando se crea la clave. No podrá volver a acceder a él. Si pierde el valor, deberá rotar la clave para generar una nueva.
7. Actualice cualquier aplicación, script o sesión de documentación interactiva guardada que utilice la clave antes de que finalice el periodo de solapamiento.
Para eliminar una clave del sistema:
1. En el panel izquierdo deAccount Administration, haga clic en Claves de API.
2. Localice la clave que desea rotar. Haga clic con el botón derecho del ratón en la fila correspondiente a la clave y seleccione « Suprimir inmediatamente ».
3. En el cuadro de diálogo, seleccione Sí, suprimir la clave.
  Este paso es obligatorio, ya que la eliminación es definitiva. Una vez que haya eliminado la clave, no podrá recuperarla.
4. Pulse Aceptar.

Puede utilizar la clave API nueva o actualizada en la página de documentación interactiva para probar la API de exportación de datos, así como en cualquier aplicación que envíe solicitudes a la API.

1.5.3 Prueba de la API de exportación de datos

Siga este procedimiento para obtener una breve introducción a la API, utilizando la página de documentación interactiva como guía.

Antes de comenzar con esta tarea, cree una clave API a través de RICOH Account Administration.

Este procedimiento le guiará a lo largo de:

Autenticación de la página de documentación interactiva
Obtener la lista de identificadores de las impresoras de su cuenta
Obtener el estado de una o varias impresoras
Solicitar información sobre los trabajos relacionados con una o varias de esas impresoras

Para utilizar la API de exportación de datos:

Acceda aquí a la documentación interactiva de la API de exportación de datos:
- Estados Unidos y Japón: https://rpi-data-export.app-ricohsoftware.com/api/v1/api-docs
- Europa: https://rpi-data-export.app-ricohsoftware.eu/api/v1/api-docs
Autentíquese mediante una clave API:
1. Haga clic en Autorizar, situado en la parte derecha de la página.
2. En el cuadro de diálogo Autorizaciones disponibles, introduzca su clave API en el campo Valor.
1. Haga clic en Autorizar para autenticarse.
2. Haga clic en Cerrar.
Ya puede probar las funciones de la API disponibles. Utilice esta interfaz para familiarizarse con la sintaxis antes de integrar la API en sus aplicaciones.
Obtenga la lista de identificadores de las impresoras definidas en su cuenta.
Para obtener información sobre el estado de los trabajos y de las impresoras, debe incluir los valores de identificación de las impresoras en sus solicitudes a la API. Los identificadores de impresora no cambian. Si los recupera ahora y guarda los valores, podrá utilizar los ID en otras llamadas a la API.
1. Abra la sección Impresoras y, a continuación, abra el punto final GET /printers.
  Como puede ver, este punto final no requiere ningún parámetro.
2. Haga clic en Probarlo y, a continuación, en Ejecutar.
3. Revise el cuerpo de la respuesta. Podrá ver una lista con información detallada sobre las impresoras supervisadas por RICOH Predictive Insight. La respuesta tiene un aspecto similar a este:
```
[
  {
    "printerName": "VC80_2",
    "printerId": "0bc6b7b3-8df9-4293-cdd4-5ae3162c4d4c",
    "engines": 2,
    "manufacturer": "Ricoh",
    "model": "RICOH Pro VC80000",
    "printerMode": "duplex",
    "printerType": "continuous_feed",
    "serialNumber": "Printer 1: 10-11111 and Printer 2: 10-11112",
    "connectionStatus": "not_connected"
  },
  {
    "printerName": "IP 5000",
    "printerId": "0f8726da-8q37-9c3l-8710-065d7c265122",
    "engines": 1,
    "manufacturer": "InfoPrint",
    "model": "InfoPrint 5000 GP v3.17.129",
    "printerMode": "simplex",
    "printerType": "continuous_feed",
    "serialNumber": "10-1111111",
    "connectionStatus": "connected"
  }
]
```
  Anote los valores de los parámetros printerId de cada una de sus impresoras.
Solicite el historial de estado de una o varias impresoras de su sistema.
1. Abra el punto final GET /printer-states.
2. Haga clic en Probar.
3. Junto a printerId, haga clic en Añadir elemento de cadena.
4. Sustituya el texto del campo por uno de los valores de ID de impresora que haya obtenido en el paso 3.
  Para recuperar el historial de estado de otras impresoras, haga clic de nuevo en Añadir elemento de cadena y añada otro valor de ID de impresora.
5. En cuanto a la zona horaria, seleccione la zona horaria que desea utilizar para los datos.
6. Especifique las horas de inicio y fin del intervalo de tiempo sobre el que se va a elaborar el informe. Deje estos campos en blanco para recuperar los datos de las últimas 24 horas.
7. Deje los tres últimos valores con los valores predeterminados, para que pueda ver la lista completa de la información que puede devolver la API.
8. Pulse Ejecutar.
9. Revise el cuerpo de la respuesta. Aparecerá una lista con los datos del estado de cada motor de impresora, con una entrada por cada cambio de estado de la impresora.
10. Modifique los valores de los parámetros currentState, stateCategoryOnly y stateCategory y vuelva a hacer clic en Ejecutar para comprobar cómo cambia la respuesta.
  - Dejar estos parámetros con los valores predeterminados (sin configurar) tiene el mismo efecto que establecerlos en falso.
  - Puede utilizarlos por separado o combinándolos entre sí.
Solicite información sobre los trabajos relacionados con una o varias de esas impresoras:
1. Acceda a la sección Trabajos de la página.
2. Abra el punto final GET /jobs.
3. Haga clic en Probar.
4. Junto a printerId, haga clic en Añadir elemento de cadena.
5. Sustituya el texto del campo por uno de los valores de ID de impresora que haya obtenido en el paso 3.
  Para obtener información de trabajos de otras impresoras, haga clic de nuevo en Añadir elemento de cadena y añada otro valor de ID de impresora.
6. En cuanto a la zona horaria, seleccione la zona horaria que desea utilizar para los datos.
7. Especifique las horas de inicio y fin del intervalo de tiempo sobre el que se va a elaborar el informe. Deje estos campos en blanco para recuperar los datos de las últimas 24 horas.
8. En el campo jobState, deje el valor en blanco para ver todas las respuestas que puede devolver la API.
9. Pulse Ejecutar.
10. Revise la respuesta para ver la información de trabajos que se ha devuelto.
11. Modifique el valor de jobState y vuelva a hacer clic en Ejecutar para comprobar cómo cambia la respuesta.

1.5.4 Manejo de fechas y horas en la API de exportación de datos

La API de exportación de datos utiliza un modelo único y coherente para gestionar las fechas y las horas: cada solicitud incluye un huso horario de la IANA, cada valor de fecha y hora se interpreta en dicho huso horario, y cada valor de fecha y hora de la respuesta se formatea en ese mismo huso horario. Utilice este tema para comprender cómo funciona el modelo y para evitar errores habituales.

El modelo de fecha y hora

Hay tres reglas que describen cómo gestiona la API las fechas y las horas:

Todas las solicitudes dirigidas a /jobs, /printer-states y /printer-interventions deben incluir un parámetro timezone que contenga un identificador de zona horaria válido de la IANA, por ejemplo, America/Denver o Europe/Bucharest.
Cualquier valor de startDateTime o endDateTime que se facilite en la solicitud se interpreta como hora local en la zona horaria indicada. Los valores no incluyen el desplazamiento horario con respecto al UTC.
Todos los valores de fecha y hora de la respuesta se formatean como hora local en la misma zona horaria, siguiendo el formato YYYY-MM-DDTHH:MM:SS.sss.

El parámetro timezone determina el significado de la solicitud y el formato de la respuesta. Dos solicitudes de los mismos datos subyacentes, enviadas con zonas horarias diferentes, generan respuestas con cadenas de fecha y hora distintas, aunque describan los mismos acontecimientos.

Formato de fecha y hora

La API utiliza un único formato para todos los valores de fecha y hora, tanto en las solicitudes como en las respuestas:

YYYY-MM-DDTHH:MM:SS.sss

Por ejemplo, 2026-03-15T14:30:00.000 corresponde a las 14:30:00 horas del 15 de marzo de 2026, según la zona horaria indicada en la solicitud.

Importante: El formato no incluye un desplazamiento horario respecto al UTC (como -06:00) ni el sufijo Z. No añada uno. Tanto las solicitudes como las respuestas utilizan únicamente la hora local, y la zona horaria se indica por separado como parámetro de la solicitud.

En las solicitudes, la parte correspondiente a los milisegundos (.sss) es opcional. En las respuestas, siempre está presente.

Intervalo de tiempo predeterminado

Puede omitir startDateTime, endDateTime o ambos. Los dos valores predeterminados se aplican de forma independiente:

Si omite startDateTime, la API utiliza las 24 horas anteriores a la hora actual como inicio del intervalo.
Si omite endDateTime, la API utiliza la hora actual como fecha de finalización del intervalo.

Los valores predeterminados se combinan tal y como cabría esperar:

Si omite ambos valores, la API devuelve los datos de las últimas 24 horas.
Si introduce startDateTime como «hace una hora» y omite endDateTime, la API devuelve los datos correspondientes a la hora anterior.
Si se especifica endDateTime y se omite startDateTime, la API devuelve los datos correspondientes al intervalo que comienza 24 horas antes de la solicitud y finaliza en el momento indicado por endDateTime.

Los valores por defecto se calculan en la zona horaria indicada en la solicitud.

Conservación de datos: los últimos siete días

La API de exportación de datos proporciona datos operativos en tiempo real. Los registros de trabajos, el historial de estado de la impresora y los eventos de intervención solo están disponibles para los últimos siete días. Una solicitud de datos con más de siete días de antigüedad devuelve un error.

Planifique su integración de tal forma que las extracciones programadas se ejecuten con la frecuencia suficiente para recopilar todos los datos antes de que caduquen:

Para los extractos nocturnos, prevea un margen de al menos uno o dos días. Si una ejecución programada falla, dispone de tiempo para investigar el problema y volver a ejecutarla antes de que los datos dejen de estar disponibles.
En el caso de las actualizaciones retrospectivas o las extracciones puntuales, no solicite datos con más de siete días de antigüedad.

Reglas aplicables al intervalo solicitado

startDateTime debe ser anterior a endDateTime. Una solicitud que incumpla esta regla generará el error ERR_INVALID_DATE_RANGE.
Ambos valores deben seguir el formato descrito en Formato de fecha y hora. Una solicitud con un valor mal formado da lugar a un error con el código ERR_INVALID_DATE_FORMAT.
El intervalo de tiempo entre startDateTime y endDateTime no debe superar el intervalo máximo permitido. Una solicitud que supere el límite máximo se rechazará con el error ERR_DATE_RANGE_EXCEEDED.

Indicar la zona horaria

El parámetro timezoneadmite identificadores de zonas horarias de la IANA, como America/Denver, America/New_York, Europe/Bucharest, Asia/Tokyo o UTC. En la página de documentación interactiva se muestra una lista de todos los valores que admite la API.

Un identificador no válido o no reconocido da lugar a un error ERR_INVALID_TIMEZONE. Las abreviaturas de tres letras, como MST o EST, no son identificadores de la IANA y no se aceptan; utilice en su lugar el identificador correspondiente basado en la región (por ejemplo, America/Denver o America/New_York).

Proporcionar el idioma

El parámetro timezone no es el único que controla el formato que la API da a una respuesta. El punto final /printer-interventions endpoint also accepts an optional language que determina el idioma del campo description en la respuesta.

Los valores admitidos son en (inglés), de (alemán), ja (japonés), it (italiano), fr (francés) y es (español). Si se introduce un valor que no figura en esta lista, se producirá un error con el código ERR_INVALID_LANGUAGE.

Hay dos aspectos de este parámetro que conviene tener en cuenta a la hora de planificar:

Si omite el parámetro, o si no hay ninguna descripción disponible en el idioma que ha solicitado, la descripción se mostrará en inglés. La solicitud se procesa correctamente en ambos casos, por lo que su integración no puede dar por sentado que el idioma de una descripción coincida con el idioma solicitado.
Este parámetro solo afecta al campo description. El campo interventionCode que lo acompaña es independiente del idioma; por lo tanto, utilice dicho campo cuando necesite agrupar, comparar o almacenar eventos de forma coherente, independientemente del idioma solicitado.

El horario de verano y las horas ambiguas

Dado que las solicitudes y las respuestas se expresan en hora local, los cambios de horario de verano dan lugar a dos situaciones que conviene tener en cuenta:

Se han omitido las horas locales en el cambio horario de primavera: Cuando se adelantan los relojes, no existe una hora de la hora local. Por ejemplo, en la zona horaria America/Denver, el día del cambio de hora de primavera, 02:30:00 no constituyen una hora local válida. Evite utilizar horas del intervalo omitido como startDateTime o endDateTime.
Horarios locales repetidos durante la transición al otoño: Cuando se atrasan los relojes, una hora de la hora local se repite dos veces. Un valor como 01:30:00 el día del cambio horario de otoño resulta ambiguo. Elija horas que no coincidan con las horas repetidas para evitar dudas sobre qué instancia está solicitando.

Si su integración se ejecuta de forma autónoma y pudiera enviar una solicitud cuya hora de inicio o de finalización coincida con una transición, programe la solicitud para que se ejecute unas horas antes o después de la transición, o utilice horas que se encuentren claramente fuera de ella.

Recomendaciones para el almacenamiento y la comparación de las marcas de tiempo de respuesta

Las marcas de tiempo de las respuestas corresponden a la hora local sin desplazamiento horario. Para evitar ambigüedades en los sistemas posteriores, considere uno de los siguientes enfoques:

Guarde la marca de tiempo de la respuesta junto con la zona horaria que haya indicado en la solicitud. Ambos elementos, considerados en su conjunto, definen un instante único en el tiempo.
En su integración, convierta cada marca de tiempo de respuesta a UTC antes de almacenarla, utilizando la zona horaria que haya indicado en la solicitud. El almacenamiento de valores UTC simplifica las comparaciones entre datos extraídos en diferentes zonas horarias.
Envíe siempre las solicitudes utilizando la misma zona horaria, por ejemplo, UTC, para que todas las marcas de tiempo almacenadas sean directamente comparables.

Ejemplos

Los siguientes ejemplos ilustran cómo se combinan la zona horaria, la hora de inicio y la hora de finalización.

Ventana predeterminada en la hora de la montaña: Una solicitud enviada a las 9:00 de la mañana del 15 de marzo de 2026, en la zona horaria America/Denver, sin que se haya especificado ninguna hora de inicio ni de fin, devuelve datos desde 2026-03-14T09:00:00 hasta 2026-03-15T09:00:00, ambas fechas interpretadas en la zona horaria de la Montaña.
Intervalo de tiempo concreto en la hora de Europa del Este: Una solicitud que especifique timezone=Europe/Bucharest, startDateTime=2026-03-15T08:00:00, y endDateTime=2026-03-15T16:00:00 devuelve datos correspondientes a la jornada laboral de ocho horas en la hora local de Bucarest. Las marcas de tiempo de las respuestas también se muestran en hora local de Bucarest.
La misma ventana vista en dos zonas horarias: Para recuperar dos veces los mismos datos subyacentes, formateados para dos públicos distintos, envíe dos solicitudes con valores timezonediferentes y ajuste startDateTime y endDateTime de modo que correspondan a los mismos instantes en cada zona horaria. Las cargas útiles de las respuestas describen los mismos eventos, pero utilizan cadenas de marca de tiempo diferentes.

1.5.5 Campos de respuesta de la API de exportación de datos

Cada punto final de la API de exportación de datos devuelve una matriz JSON de objetos. Utilice las tablas de este apartado para interpretar los campos de cada respuesta.

Convenciones utilizadas en esta referencia

Todas las duraciones se expresan en milisegundos.
Todos los valores de fecha y hora se formatean según la zona horaria especificada por el parámetro de solicitud timezone, utilizando el formato YYYY-MM-DDTHH:MM:SS.sss.
Los campos identificadores (printerId, jobId) se mantienen constantes entre solicitudes y las aplicaciones integradas pueden almacenarlos en caché. printerId nunca cambia, por lo que los valores pueden almacenarse y reutilizarse entre sesiones.

Campos de respuesta de la solicitud GET /printers

El punto final /printers devuelve un objeto por cada impresora identificada en la cuenta y de la que se realiza un seguimiento mediante un recopilador de datos.

Field	Tipo	Descripción
`printerName`	cadena	El nombre de visualización asignado a la impresora en RICOH Predictive Insight.
`printerId`	cadena (UUID)	El identificador único de la impresora. Utilice este valor como parámetro `printerId` cuando llame a las rutas `/jobs`, `/printer-states` o `/printer-interventions`.
`engines`	entero	El número de motores de impresión de la impresora. Las impresoras de alimentación continua pueden tener uno o varios motores; las impresoras de hojas sueltas suelen contar con un solo motor. Cada motor aparece como una fila independiente en las respuestas de `/printer-states` y `/printer-interventions`.
`manufacturer`	cadena	El fabricante de la impresora, por ejemplo, Ricoh o InfoPrint.
`modelo`	cadena	El modelo de impresora tal y como lo indica el dispositivo; por ejemplo, RICOH Pro VC80000.
`printerMode`	cadena	Si la impresora está funcionando en modo `simplex` o `duplex`. Este campo puede ser ausente en aquellos tipos de impresoras en los que el valor no sea aplicable, como, por ejemplo, los dispositivos de hojas sueltas.
`printerType`	cadena	Si la impresora admite papel `continuous_feed` o `cut_sheet`.
`serialNumber`	cadena	El número de serie indicado por la impresora. En el caso de las impresoras con varios motores, este campo puede incluir los números de serie de cada motor en una sola cadena de caracteres; por ejemplo, Impresora 1: 10-11111 e Impresora 2: 10-11112.
`connectionStatus`	cadena	Indica si RICOH Predictive Insight puede conectarse actualmente a la impresora. Los valores posibles son `connected` y `not_connected`.

Campos de la respuesta de la solicitud GET /jobs

El punto final /jobs devuelve un objeto por cada trabajo procesado por las impresoras solicitadas dentro del intervalo de tiempo indicado.

Field	Tipo	Descripción
`printerId`	cadena (UUID)	El identificador de la impresora que ha procesado el trabajo. Es coincidente con un `printerId` de la respuesta de `/printers`.
`jobId`	cadena	El identificador único del trabajo.
`jobName`	cadena	El nombre del trabajo tal y como se ha enviado a la impresora; normalmente, el nombre del archivo de origen.
`jobPrintingSide`	cadena	El lado o los lados en los que se imprime este trabajo, por ejemplo, `simplex` o `duplex`.
`jobAction`	cadena	El estado del trabajo en el momento en que se tramitó la solicitud. Valores posibles: `printing`: el trabajo se estaba imprimiendo cuando se envió la solicitud. `printed`: el trabajo se ha impreso correctamente. `aborted`: el trabajo se detuvo antes de que terminara la impresión. `completed`: el trabajo ha alcanzado su estado final. Este valor es un superconjunto que incluye tanto los trabajos `iprinted` como los `aborted`. Utilícelo cuando desee recuperar todos los trabajos que ya no estén activos, independientemente de su resultado.
`jobStartTime`	cadena (fecha y hora)	La fecha y la hora locales en las que se inició la impresión del trabajo, según la zona horaria indicada en la solicitud.
`jobEndTime`	cadena (fecha y hora)	La fecha y la hora locales en las que finalizó el trabajo, según la zona horaria indicada en la solicitud.
`jobDuration`	entero	El tiempo de impresión transcurrido para el trabajo, en milisegundos.
`printedCopies`	entero	El número de copias generadas por el trabajo.
`printedPages`	entero	El número total de páginas lógicas impresas para el trabajo, incluidas todas las copias.
`printedImpressions`	entero	El número total de ejemplares impresos. Una impresión corresponde a una cara de una hoja, por lo que un trabajo a doble cara produce dos impresiones por hoja.
`printedSheets`	entero	El número total de hojas físicas utilizadas para el trabajo.
`printedRollFeet`	Número	En el caso de las impresoras de alimentación continua, la longitud del soporte consumido por el trabajo, en pies.
`printedRollMeters`	Número	En el caso de las impresoras de alimentación continua, la longitud del soporte consumido por el trabajo, en metros.
`inkC, inkM, inkY, inkK`	Número	La cantidad de tinta cian, magenta, amarilla y negra consumida por el trabajo, expresada por canal de color en centímetros cúbicos (cc).
`flushingC, flushingM, flushingY, flushingK`	Número	La cantidad de tinta cian, magenta, amarilla y negra consumida durante las operaciones de vaciado del cabezal de impresión relacionadas con el trabajo, expresada por canal de color en centímetros cúbicos (cc). Los valores de vaciado se registran por separado de `lnkC/M/Y/K`, de modo que se pueda distinguir el uso productivo de la tinta del uso destinado al mantenimiento.

Campos de respuesta de la solicitud GET /printer-states

El punto final /printer-states devuelve un objeto por motor de impresora y por intervalo de estado. Los campos que aparecen dependen del modo de solicitud:

Historial agregado (por defecto): se muestran todos los campos.
Solo estado actual (currentState=true): se omiten printerStateDuration, historyStartTime e historyEndTime.
Solo categoría de estado (stateCategoryOnly=true): se omite «printerState.

Field	Tipo	Descripción
`printerId`	cadena (UUID)	El identificador de la impresora a la que se refiere esta fila. Es coincidente con un `printerId` de la respuesta de `/printers`.
`dispositivo`	cadena	El motor de la impresora al que se refiere esta fila; por ejemplo, `engine_1`, `engine_2` o `engine_3`. Una impresora con varios motores devuelve una fila por cada motor para cada intervalo de estado.
`stateCategory`	cadena	La categoría de nivel superior a la que se agrupa el estado del motor. Los valores posibles son `up`, `down`, `idle` y `unknown`. Utilice este campo para los paneles de control y los informes que requieran categorías uniformes en todos los modelos de impresora.
`printerState`	cadena	El estado sin procesar que indica el motor de la impresora, como Printing», Preparing», Maintenance, o Sleeping. Los valores en bruto varían según el modelo de impresora. Se omite cuando `stateCategoryOnly=true`. Nota: Consulte Estados de la impresora y categorías de estados para obtener una lista completa de los estados y sus correspondencias.
`printerStateDuration`	entero	El tiempo que el motor permaneció en este estado, expresado en milisegundos. Se omite cuando `currentState = true`.
`historyStartTime`	cadena (fecha y hora)	La fecha y la hora locales en las que el motor entró en este estado, según la zona horaria indicada en la solicitud. Se omite cuando `currentState = true`.
`historyEndTime`	cadena (fecha y hora)	La fecha y la hora locales en las que el motor abandonó este estado, según el huso horario indicado en la solicitud. En el caso del intervalo más reciente de una respuesta agregada, este valor puede coincidir con el final del intervalo de tiempo solicitado. Se omite cuando `currentState = true`.

Campos de respuesta de la solicitud GET /printer-interventions

El punto final /printer-interventions devuelve un objeto por cada evento de intervención, para cada motor de cada impresora solicitada, dentro del intervalo de tiempo solicitado.

Field	Tipo	Descripción
`printerId`	cadena (UUID)	El identificador de la impresora a la que se refiere esta fila. Es coincidente con un `printerId` de la respuesta de `/printers`.
`interventionStartDate`	cadena (fecha y hora)	La fecha y la hora locales en las que comenzó el evento, en la zona horaria indicada en la solicitud.
`interventionEndDate`	cadena (fecha y hora)	La fecha y la hora locales en las que se resolvió el incidente, según la zona horaria indicada en la solicitud.
`duración`	entero	La duración del evento, en milisegundos.
`description`	cadena	Una breve descripción de la condición que ha provocado la advertencia o el error; por ejemplo, Media emptyl o Paper jaml. Este campo depende del idioma: se muestra en el idioma solicitado mediante el parámetro `language`, o en inglés si se omite dicho parámetro o si la descripción no está disponible en el idioma solicitado.
`dispositivo`	cadena	El motor de la impresora al que se refiere esta fila; por ejemplo, `engine_1`, `engine_2` o `engine_3`. Una impresora con varios motores devuelve una fila por cada motor para cada evento.
`jobName`	cadena	El nombre del trabajo que se estaba imprimiendo cuando se produjo el incidente. El valor es una cadena vacía cuando el evento no está relacionado con ningún trabajo.
`interventionCode`	cadena	Un código que identifica la condición. A diferencia de `description`, este valor es independiente del idioma, por lo que debe utilizarlo cuando necesite agrupar o comparar eventos en distintos idiomas. El formato del código depende de la impresora: las impresoras de hojas sueltas muestran una cadena descriptiva, como `coverOpen`, mientras que las impresoras de alimentación continua muestran un valor, como`CA00` o `40000006`.

1.5.5.1 Estados de la impresora y categorías de estados

El punto final /printer-states proporciona información tanto sobre el estado bruto de la impresora como sobre una categoría de estado de alto nivel. Utilice las tablas de este apartado para comprender qué estados en bruto se incluyen en cada categoría.

Acerca de los estados y las categorías de las impresoras

Para cada motor de impresión, la API de exportación de datos proporciona dos valores relacionados:

printerState: El estado operativo sin procesar que indica el motor de la impresora, como printing, sleeping» o maintenance. El conjunto de estados sin procesar varía según el modelo de impresora.
stateCategory: Un grupo de alto nivel que clasifica el estado bruto como up, down, idle» o unknown. Las categorías son comunes a todos los modelos de impresora, por lo que constituyen la mejor opción para paneles de control e informes que agrupan datos procedentes de varias impresoras.

Las asignaciones de categorías las define RICOH Predictive Insight y se aplican de manera uniforme a todas las impresoras que envían información a través de la API de exportación de datos.

Estados del norte

Se considera que un motor está up cuando está generando potencia de forma activa o preparándose activamente para generarla. Utilice esta categoría para medir el tiempo de funcionamiento productivo.

Estado bruto de la impresora	Descripción
`feeding`	La máquina está alimentando el soporte de impresión para preparar la impresión.
`initializing`	El motor se está inicializando como parte del proceso de inicio de una operación de impresión.
`preparing`	La impresora se está preparando para imprimir; por ejemplo, cargando los datos del trabajo o calentando los componentes para un trabajo inminente.
`printing`	El motor está en funcionamiento.
`processing`	El motor está procesando los datos de los trabajos.
`receiving`	El motor está recibiendo un trabajo del servidor de impresión.

Estados del sur

Se considera que un motor está down cuando no puede imprimir y se requiere o se está llevando a cabo la intervención de un operador o del servicio técnico, así como tareas de mantenimiento o recuperación. Utilice esta categoría para cuantificar los tiempos de inactividad imprevistos y programados.

Estado bruto de la impresora	Descripción
`adjusting`	El motor está realizando una operación de ajuste que impide la impresión.
`calibrating`	El motor se está calibrando, por ejemplo, en cuanto al color o al registro.
`cleaning`	El motor está realizando una operación de limpieza.
`disconnected`	El motor ha perdido la conexión con RICOH Predictive Insight.
`error`	El motor ha detectado una condición que impide la impresión.
`maintenance`	El motor está realizando una operación de mantenimiento.
`not available`	Se puede acceder al motor, pero en estos momentos no se pueden realizar trabajos en él.
`pre/post busy`	Un dispositivo de preprocesamiento o posprocesamiento conectado a la impresora está ocupado y está bloqueando la impresión.
`pre/post eof`	Un dispositivo de preprocesamiento o posprocesamiento ha alcanzado una condición de «fin de hoja» que está impidiendo la impresión.
`pre/post paused`	Un dispositivo de preprocesamiento o posprocesamiento se ha detenido y está bloqueando la impresión.
`pre/post threading`	Un dispositivo de subproceso o posprocesamiento está introduciendo material y está impidiendo la impresión.
`rebooting`	El motor se está reiniciando.
`recirculation`	El motor está recirculando la tinta.
`restart`	El motor se encuentra en una condición para volver a arrancar.
`restarting`	El motor se está volviendo a poner en marcha.

Estados de inactividad

Se considera que un motor está idle cuando está operativo y es capaz de imprimir, pero en ese momento no está generando ninguna salida. Utilice esta categoría para evaluar la capacidad disponible.

Estado bruto de la impresora	Descripción
`checking`	El motor está realizando una comprobación rutinaria que no impide continuar con el trabajo.
`idle`	El motor está en funcionamiento y a la espera de que se le asigne una tarea.
`not ready`	El motor funciona, pero actualmente no se encuentra en condiciones de imprimir.
`pre/post not ready`	Un dispositivo de pretratamiento o postratamiento no está listo, pero el motor en sí está operativo.
`ready`	El motor está listo para recibir e imprimir un trabajo.
`shutdown`	Se ha apagado el motor.
`shutting down`	El motor se está apagando.
`sleeping`	El motor se encuentra en un estado de reposo de bajo consumo.
`start-up`	El motor se encuentra en fase de puesta en marcha.
`started`	El motor ha completado su secuencia de arranque.
`starting`	El motor se está poniendo en marcha.
`stopping`	El motor se está deteniendo, pero aún no se ha apagado.
`warming`	El motor se está calentando.

Desconocido

Se indica la categoría unknown cuando RICOH Predictive Insight no puede determinar una categoría para el estado sin procesar, por ejemplo, porque no se reconoce el valor de dicho estado. Si su aplicación detecta categorías unknown con frecuencia, póngase en contacto con su representante de para confirmar que su impresora está comunicando los valores de estado esperados.

1.5.5.2 Cómo gestionar los límites de respuesta de la API de exportación de datos

La API de exportación de datos no paginará las respuestas. Si una solicitud devolviera más datos de los que permite la API en una sola respuesta, la solicitud fallaría y se mostraría un error, en lugar de devolver un resultado parcial. Planifique sus integraciones para mantenerse dentro de los límites, ya sea reduciendo el intervalo de fechas, disminuyendo el número de impresoras por solicitud o ambas cosas.

Cuáles son los límites

Se aplican dos tipos de límites a las solicitudes que incluyen un intervalo de fechas:

Intervalo de fechas máximo: Si el intervalo de tiempo entre startDateTime y endDateTime supera los siete días, la API devuelve una respuesta 400 con el código de error ERR_DATE_RANGE_EXCEEDED. Reduzca la duración del intervalo de tiempo solicitado y vuelva a enviar la solicitud.
Tamaño máximo de la respuesta: El tamaño máximo admitido de un archivo de respuesta es de 6 MB, lo que debería ser suficiente para almacenar los datos de casi 10 000 trabajos. Si los datos coincidentes con una solicitud superan el tamaño máximo de la respuesta, la API devuelve una respuesta 413 con el código de error ERR_RESPONSE_LIMIT_EXCEEDED. El cuerpo de la respuesta incluye un valor maxJobs que indica el límite vigente. Para solucionar el problema, reduzca el intervalo de fechas, solicite menos impresoras o haga ambas cosas, y vuelva a enviar la solicitud.

Las solicitudes de planificación deben ajustarse a los límites establecidos

Para diseñar una integración que se mantenga de forma fiable dentro de los límites de respuesta, tenga en cuenta los siguientes factores:

Volumen de trabajos por impresora. Una impresora de alto rendimiento con alimentación continua puede producir muchos más trabajos por hora que una impresora de hojas sueltas de bajo volumen. Si combina ambos tipos en su parque de impresoras, serán las impresoras de gran volumen las que determinen lo reducidas que deben ser sus franjas horarias.
Número de impresoras por solicitud. Cada solicitud puede incluir varios valores de printerId. Agrupar varias impresoras en una sola solicitud resulta práctico, pero cada impresora adicional aumenta el tamaño de la respuesta y la probabilidad de superar el límite.
Hora del día. Si su empresa funciona por turnos, los trabajos y los cambios de estado se concentran en determinadas horas. Un intervalo de 24 horas puede arrojar volúmenes muy diferentes en función de cuándo comiencen y terminen esas 24 horas.
Tolerancia para los reintentos. Si una solicitud falla con el error ERR_RESPONSE_LIMIT_EXCEEDED, su integración debe dividir la solicitud y volver a intentarla. Diseñar desde el principio para ventanas más pequeñas suele ser menos complejo que implementar la división dinámica.

Patrones recomendados

Los siguientes patrones funcionan bien en los casos más habituales de integración:

Extracto nocturno para la elaboración de informes: Ejecute un trabajo programado una vez al día que solicite los datos de las últimas 24 horas, una impresora cada vez. Este patrón es sencillo de implementar, permite volver a intentarlo fácilmente en caso de fallo y garantiza que cada respuesta sea breve. Combine las respuestas de cada impresora en su proceso posterior.
Extracto por hora para paneles de control en tiempo casi real: Ejecute un trabajo programado una vez por hora que solicite los datos de la hora anterior de todas las impresoras en una sola consulta. Los intervalos por hora permiten mantener un tamaño reducido de las respuestas, incluso en el caso de impresoras de gran volumen. Si su flota es numerosa, solicite las impresoras por lotes, en lugar de todas a la vez.
Relleno de datos históricos: Para introducir datos históricos en un almacén de datos, recorra el intervalo de tiempo en ventanas de tamaño fijo (por ejemplo, seis horas por solicitud) y sus impresoras en pequeños grupos. Procese una ventana cada vez y guarde los resultados antes de ir a la siguiente ventana. Si una ventana falla con el error ERR_RESPONSE_LIMIT_EXCEEDED, divida dicha ventana en dos partes y vuelva a intentarlo con cada una de ellas.
Estado actual de la impresora para su supervisión: Para supervisar el estado actual de cada impresora de su parque sin consultar el historial, utilice la llamada /printer-states con el parámetro currentState=true. La respuesta incluye una fila por motor y no se ve afectada por el intervalo de fechas, por lo que una sola solicitud puede abarcar toda la flota.

Cómo gestionar los errores de límite de respuesta en su integración

Cuando reciba una respuesta 413 con el código ERR_RESPONSE_LIMIT_EXCEEDED, lleve a cabo una o varias de las siguientes acciones antes de volver a intentar la solicitud:

Reduzca el intervalo de tiempo. Dividir la ventana por la mitad es una estrategia fiable; si la solicitud dividida a la mitad sigue fallando, vuelva a dividirla.
Reduzca el número de valores de printerId en la solicitud. Si una impresora se encarga de la mayor parte del volumen, solicite esa impresora por separado.
Si la solicitud se refiere a una instantánea actual en lugar de a un historial, utilice currentState=true en /printer-states para evitar por completo el volumen generado por los intervalos de fechas.

No vuelva a intentar la misma solicitud sin modificar los parámetros. La API no devuelve resultados parciales, por lo que un nuevo intento sin modificaciones volverá a fallar.

1.5.6 Ejemplos de solicitudes y respuestas de la API de exportación de datos

Utilice los ejemplos de este tema como punto de partida para su propia integración. Cada ejemplo muestra una URL de solicitud representativa junto con el cuerpo de la respuesta que devuelve la API.

Acerca de estos ejemplos

En los ejemplos se utilizan claves API e identificadores de impresora provisionales. Sustituya los valores por los de su propio entorno al adaptarlos.
En los ejemplos se utiliza el nombre de host de Estados Unidos y Japón. Si su cuenta está alojada en Europa, utilice en su lugar rpi-data-export.app-ricohsoftware.eu.
Los valores de fecha y hora se formatean como horas locales en la zona horaria indicada en la solicitud, siguiendo el formato YYYY-MM-DDTHH:MM:SS.sss.
Todas las duraciones se expresan en milisegundos. Todos los valores relativos a la tinta y al vaciado se expresan en centímetros cúbicos (cc).
Los ejemplos tienen carácter ilustrativo. Los valores numéricos, como el consumo de tinta, el número de páginas y la duración, representan datos operativos plausibles, no mediciones procedentes de una impresora concreta.

GET /printers

Recupera las impresoras disponibles para la clave API facilitada. El punto final no admite parámetros.

Solicitud:

GET https://rpi-data-export.app-ricohsoftware.com/api/v1/printers
x-api-key: YOUR_API_KEY

Respuesta (200 OK):

[
  {
    "printerName": "VC60000_Line1",
    "printerId": "f7932e31-6545-4bff-8971-f84ef5f5b3dc",
    "engines": 2,
    "manufacturer": "Ricoh",
    "model": "RICOH Pro VC60000",
    "printerMode": "duplex",
    "printerType": "continuous_feed",
    "serialNumber": "Printer 1: 10-11111 and Printer 2: 10-22222",
    "connectionStatus": "connected"
  },
  {
    "printerName": "VC80_2",
    "printerId": "0bc6b7b3-8df9-4293-cdd4-5ae3162c4d4c",
    "engines": 2,
    "manufacturer": "Ricoh",
    "model": "RICOH Pro VC80000",
    "printerMode": "duplex",
    "printerType": "continuous_feed",
    "serialNumber": "Printer 1: 10-33333 and Printer 2: 10-33334",
    "connectionStatus": "not_connected"
  },
  {
    "printerName": "IP 5000",
    "printerId": "0f8726da-8a37-4c3b-8710-065d7c265122",
    "engines": 1,
    "manufacturer": "InfoPrint",
    "model": "InfoPrint 5000 GP v3.17.129",
    "printerMode": "simplex",
    "printerType": "continuous_feed",
    "serialNumber": "10-1111111",
    "connectionStatus": "connected"
  }
]

GET /jobs

Recupera los trabajos procesados por una o varias impresoras dentro de un intervalo de tiempo. En este ejemplo se solicita información sobre una sola impresora durante un intervalo de ocho horas en la zona horaria America/Denver, limitándose a los trabajos que se hayan impreso correctamente.

Solicitud:

GET https://rpi-data-export.app-ricohsoftware.com/api/v1/jobs
    ?printerId=f7932e31-6545-4bff-8971-f84ef5f5b3dc
    &timezone=America/Denver
    &startDateTime=2026-03-15T08:00:00
    &endDateTime=2026-03-15T16:00:00
    &jobState=printed
x-api-key: YOUR_API_KEY

Respuesta (200 OK):

[
  {
    "printerId": "f7932e31-6545-4bff-8971-f84ef5f5b3dc",
    "jobId": "5ae3162c4d4c-1771233448485-Cust_MH_Arena.pdf-13925",
    "jobName": "Cust_MH_Arena.pdf",
    "jobPrintingSide": "duplex",
    "jobAction": "printed",
    "jobStartTime": "2026-03-15T08:14:22.000",
    "jobEndTime": "2026-03-15T08:47:51.000",
    "jobDuration": 2009000,
    "printedCopies": 1,
    "printedPages": 4800,
    "printedImpressions": 4800,
    "printedSheets": 2400,
    "printedRollFeet": 1640.5,
    "printedRollMeters": 500.02,
    "inkC": 184.6,
    "inkM": 172.3,
    "inkY": 198.1,
    "inkK": 245.7,
    "flushingC": 2.4,
    "flushingM": 2.4,
    "flushingY": 2.4,
    "flushingK": 2.4
  },
  {
    "printerId": "f7932e31-6545-4bff-8971-f84ef5f5b3dc",
    "jobId": "5ae3162c4d4c-1771237012003-DM_Spring_Promo.pdf-13926",
    "jobName": "DM_Spring_Promo.pdf",
    "jobPrintingSide": "duplex",
    "jobAction": "printed",
    "jobStartTime": "2026-03-15T09:22:10.000",
    "jobEndTime": "2026-03-15T11:05:44.000",
    "jobDuration": 6214000,
    "printedCopies": 25000,
    "printedPages": 50000,
    "printedImpressions": 50000,
    "printedSheets": 25000,
    "printedRollFeet": 17082.0,
    "printedRollMeters": 5206.9,
    "inkC": 1923.4,
    "inkM": 1810.7,
    "inkY": 2055.2,
    "inkK": 2540.8,
    "flushingC": 12.6,
    "flushingM": 12.6,
    "flushingY": 12.6,
    "flushingK": 12.6
  }
]

Un array vacío ([]) es una respuesta válida y significa que no hay coincidencias con los trabajos solicitados.

GET /printer-states (historial agregado)

El modo de respuesta predeterminado devuelve una fila por intervalo de estado por motor, con los campos de duración total e historial. En el ejemplo se solicita un intervalo de cuatro horas para una impresora.

Solicitud:

GET https://rpi-data-export.app-ricohsoftware.com/api/v1/printer-states
    ?printerId=f7932e31-6545-4bff-8971-f84ef5f5b3dc
    &timezone=America/Denver
    &startDateTime=2026-03-15T08:00:00
    &endDateTime=2026-03-15T12:00:00
x-api-key: YOUR_API_KEY

Respuesta (200 OK):

[
  {
    "printerId": "f7932e31-6545-4bff-8971-f84ef5f5b3dc",
    "engine": "engine_1",
    "stateCategory": "idle",
    "printerState": "ready",
    "printerStateDuration": 854000,
    "historyStartTime": "2026-03-15T08:00:00.000",
    "historyEndTime": "2026-03-15T08:14:14.000"
  },
  {
    "printerId": "f7932e31-6545-4bff-8971-f84ef5f5b3dc",
    "engine": "engine_1",
    "stateCategory": "up",
    "printerState": "printing",
    "printerStateDuration": 2017000,
    "historyStartTime": "2026-03-15T08:14:14.000",
    "historyEndTime": "2026-03-15T08:47:51.000"
  },
  {
    "printerId": "f7932e31-6545-4bff-8971-f84ef5f5b3dc",
    "engine": "engine_1",
    "stateCategory": "down",
    "printerState": "maintenance",
    "printerStateDuration": 1980000,
    "historyStartTime": "2026-03-15T08:47:51.000",
    "historyEndTime": "2026-03-15T09:20:51.000"
  },
  {
    "printerId": "f7932e31-6545-4bff-8971-f84ef5f5b3dc",
    "engine": "engine_2",
    "stateCategory": "idle",
    "printerState": "sleeping",
    "printerStateDuration": 14400000,
    "historyStartTime": "2026-03-15T08:00:00.000",
    "historyEndTime": "2026-03-15T12:00:00.000"
  }
]

GET /printer-states (solo estado actual)

Cuando se establece `currentState=true`, la respuesta incluye una fila por motor con el estado actual. Se omiten los campos de duración e historial.

Solicitud:

GET https://rpi-data-export.app-ricohsoftware.com/api/v1/printer-states
    ?printerId=f7932e31-6545-4bff-8971-f84ef5f5b3dc
    &timezone=America/Denver
    &currentState=true
x-api-key: YOUR_API_KEY

Respuesta (200 OK):

[
  {
    "printerId": "f7932e31-6545-4bff-8971-f84ef5f5b3dc",
    "engine": "engine_1",
    "stateCategory": "up",
    "printerState": "printing"
  },
  {
    "printerId": "f7932e31-6545-4bff-8971-f84ef5f5b3dc",
    "engine": "engine_2",
    "stateCategory": "idle",
    "printerState": "ready"
  }
]

GET /printer-states (solo categoría de estado)

Cuando se establece stateCategoryOnly=true, la respuesta omite el campo printerState sin procesar y solo indica la categoría de nivel superior. Se conservan los campos de duración e historial.

Solicitud:

GET https://rpi-data-export.app-ricohsoftware.com/api/v1/printer-states
    ?printerId=f7932e31-6545-4bff-8971-f84ef5f5b3dc
    &timezone=America/Denver
    &startDateTime=2026-03-15T08:00:00
    &endDateTime=2026-03-15T12:00:00
    &stateCategoryOnly=true
x-api-key: YOUR_API_KEY

Respuesta (200 OK):

[
  {
    "printerId": "f7932e31-6545-4bff-8971-f84ef5f5b3dc",
    "engine": "engine_1",
    "stateCategory": "idle",
    "printerStateDuration": 854000,
    "historyStartTime": "2026-03-15T08:00:00.000",
    "historyEndTime": "2026-03-15T08:14:14.000"
  },
  {
    "printerId": "f7932e31-6545-4bff-8971-f84ef5f5b3dc",
    "engine": "engine_1",
    "stateCategory": "up",
    "printerStateDuration": 2017000,
    "historyStartTime": "2026-03-15T08:14:14.000",
    "historyEndTime": "2026-03-15T08:47:51.000"
  }
]

GET /printer-interventions

Recupera los eventos de intervención que se produjeron en una o varias impresoras dentro de un intervalo de tiempo. En el ejemplo se solicita un intervalo de cuatro horas para una impresora y se piden descripciones de los eventos en inglés. Dado que la impresora de este ejemplo es un modelo de alimentación continua, los valores de interventionCode utilizan el formato de alimentación continua.

Solicitud:

GET https://rpi-data-export.app-ricohsoftware.com/api/v1/printer-interventions
    ?printerId=f7932e31-6545-4bff-8971-f84ef5f5b3dc
    &timezone=America/Denver
    &startDateTime=2026-03-15T08:00:00
    &endDateTime=2026-03-15T12:00:00
    &language=en
x-api-key: YOUR_API_KEY

Respuesta (200 OK):

[
  {
    "printerId": "f7932e31-6545-4bff-8971-f84ef5f5b3dc",
    "interventionStartDate": "2026-03-15T08:47:51.000",
    "interventionEndDate": "2026-03-15T09:20:51.000",
    "duration": 1980000,
    "description": "Media empty",
    "engine": "engine_1",
    "jobName": "",
    "interventionCode": "CA00"
  },
  {
    "printerId": "f7932e31-6545-4bff-8971-f84ef5f5b3dc",
    "interventionStartDate": "2026-03-15T09:05:33.000",
    "interventionEndDate": "2026-03-15T09:41:12.000",
    "duration": 2139000,
    "description": "Media empty",
    "engine": "engine_2",
    "jobName": "",
    "interventionCode": "CA00"
  },
  {
    "printerId": "f7932e31-6545-4bff-8971-f84ef5f5b3dc",
    "interventionStartDate": "2026-03-15T10:12:04.000",
    "interventionEndDate": "2026-03-15T10:19:47.000",
    "duration": 463000,
    "description": "Paper jam",
    "engine": "engine_1",
    "jobName": "DM_Spring_Promo.pdf",
    "interventionCode": "40000006"
  }
]

Las dos primeras entradas tienen el campo jobName vacío, lo que significa que en el suceso no intervino ningún trabajo. La tercera entrada se produjo mientras se estaba imprimiendo un trabajo, por lo que se indica el nombre de dicho trabajo.

Ejemplos de respuestas de error

Todas las respuestas de error siguen la misma estructura: un objeto JSON que contiene un code, un message y un statusCode numérico. Algunos códigos de error incluyen campos adicionales, según la nota.

400 Solicitud incorrecta: zona horaria no válida:

{
  "code": "ERR_INVALID_TIMEZONE",
  "message": "The supplied timezone is not a valid IANA timezone identifier.",
  "statusCode": 400
}

400 Solicitud incorrecta: falta un parámetro obligatorio:

{
  "code": "ERR_MISSING_PRINTER_ID",
  "message": "At least one printerId value is required.",
  "statusCode": 400
}

400 Solicitud incorrecta: el intervalo de fechas supera el máximo permitido:

{
  "code": "ERR_DATE_RANGE_EXCEEDED",
  "message": "The requested date range exceeds the maximum allowed range.",
  "statusCode": 400
}

400 Solicitud incorrecta — idioma no válido:

{
  "code": "ERR_INVALID_LANGUAGE",
  "message": "The supplied language is not a supported language code.",
  "statusCode": 400
}

401 No autorizado — clave API no válida:

{
  "code": "ERR_INVALID_APIKEY",
  "message": "Failed to validate API key.",
  "statusCode": 401
}

403 Prohibido: la solicitud incluye una impresora a la que la clave API no tiene acceso:

{
  "code": "ERR_UNAUTHORIZED_PRINTERS",
  "message": "Unauthorized printers.",
  "statusCode": 403
}

413 Carga útil demasiado grande: la respuesta superaría el límite de tamaño:

{
  "code": "ERR_RESPONSE_LIMIT_EXCEEDED",
  "message": "The response would exceed the maximum allowed size. Narrow the date range or request fewer printers.",
  "statusCode": 413,
  "maxJobs": 8000
}

Error 500 del servidor interno:

{
  "code": "ERR_INTERNAL_SERVER_ERROR",
  "message": "An internal server error occurred.",
  "statusCode": 500
}

1.5.7 Solución de problemas de la API de exportación de datos

Utilice este tema para interpretar las respuestas de error más habituales de la API de exportación de datos e identificar la causa más probable y la solución para cada una de ellas. Cada respuesta de error incluye un code, un message y un statusCode numérico; el valor code identifica la condición concreta.

Errores de autenticación y autorización

Código de error	Causa probable	Qué probar
`ERR_INVALID_APIKEY` (401)	Falta la cabecera `«x-api-key»`, está mal formada, ha caducado o se ha eliminado. También se produce brevemente (normalmente menos de un minuto) inmediatamente después de que se cree o se rote una clave, antes de que se registre la nueva clave.	Compruebe que la solicitud incluya la cabecera `x-api-key` con el valor completo de la clave API. En Account Administration, compruebe que la clave sigue existiendo y que no ha caducado. Si la clave se acaba de crear o se acaba de rotar, espere un minuto y vuelva a intentarlo.
`ERR_UNAUTHORIZED_PRINTERS` (403)	La solicitud incluye uno o varios valores de `printerId` a los que la clave API no tiene acceso.	Llame a `/printers` con la misma clave API para ver exactamente qué impresoras están disponibles y, a continuación, vuelva a enviar la solicitud indicando únicamente los identificadores de esas impresoras.
`ERR_TENANT_NOT_FOUND` (404)	La clave API se reconoce, pero no está asociada a ninguna cuenta activa. Esto puede ocurrir si se ha eliminado una cuenta o si está mal configurada.	Póngase en contacto con su representante de cuenta de Ricoh para confirmar que su tenant está activo y que la clave API está asociada a él.

Errores de validación de parámetros (400 Solicitud incorrecta)

Cada error de validación de parámetros devuelve un código de estado 400. El valor code identifica el problema concreto.

Código de error	Causa probable	Qué probar
`ERR_MISSING_PRINTER_ID`	La solicitud no incluía ningún valor de `printerId`. Se requiere al menos uno para `/jobs`, `/printer-states` y `/printer-interventions`.	Añada al menos un parámetro de consulta `printerId`. Repita el parámetro para incluir varias impresoras.
`ERR_INVALID_PRINTER_ID_FORMAT`	El valor `printerId` no es un UUID válido.	Compruebe el valor comparándolo con la respuesta obtenida en `/printers`. Entre los errores más comunes se encuentran los espacios en blanco de más, los caracteres que faltan o pegar el nombre de la impresora en lugar del identificador de la misma.
`ERR_INVALID_TIMEZONE`	Falta el valor de `timezone` o no es un identificador válido de zona horaria de la IANA.	Utilice un identificador basado en la región, como `America/Denver` o `Europe/Bucharest`. No se aceptan abreviaturas de tres letras, como `MST` o `EST`. En la página de documentación interactiva se muestra una lista de todos los valores admitidos.
`ERR_INVALID_DATE_FORMAT`	El valor de `startDateTime»` o `endDateTime` no coincide con el formato esperado.	Utilice el formato `YYYY-MM-DDTHH:MM:SS`, opcionalmente con el sufijo `.sss` para indicar los milisegundos. No incluya un desplazamiento respecto al UTC ni el sufijo `Z`; la zona horaria se indica por separado en el parámetro `timezone`.
`ERR_INVALID_DATE_RANGE`	`startDateTime` es igual o posterior a `endDateTime`.	Compruebe que `startDateTime` sea anterior a `endDateTime` en la zona horaria indicada.
`ERR_DATE_RANGE_EXCEEDED`	El intervalo de tiempo entre `startDateTime` y `endDateTime` supera el rango máximo permitido.	Reduzca la duración del intervalo de tiempo solicitado. Consulte Cómo gestionar los límites de respuesta de la API de exportación de datos para obtener orientación sobre la división en fragmentos.
`ERR_INVALID_JOB_STATE`	El valor de `jobState` no se encuentra entre los valores admitidos.	Utilice una de las siguientes opciones: `printing`, `printed`, `aborted` o `completed`. Tenga en cuenta que el término `completed` incluye tanto los trabajos `printed` como `aborted`.
`ERR_INVALID_STATE_CATEGORY`	El valor de `stateCategory` no es uno de los valores admitidos.	Utilice una de las opciones: `up`», `down` o `idle`.
`ERR_INVALID_LANGUAGE`	El valor `language` proporcionado a `/printer-interventions` no es uno de los valores aceptados.	Seleccione una de las siguientes opciones: `en`, `de`, `ja`, `it`, `fr` o `es`. Este error significa que el propio código ha sido rechazado; un código que se acepta pero que carece de traducción para una descripción concreta no da lugar a un error, ya que la API devuelve dicha descripción en inglés en su lugar.
`ERR_INVALID_BOOLEAN_PARAM`	El parámetro `currentState` o `stateCategoryOnly` tiene un valor distinto de `true` o `false`.	Utilice las cadenas literales en minúsculas `true` o `false`.
`ERR_UNKNOWN_PARAMETERS`	La solicitud incluye uno o varios parámetros que el punto final no acepta.	Compare la solicitud con la lista de parámetros para el punto final en la documentación interactiva. Entre las causas más habituales se encuentran los errores tipográficos, los parámetros destinados a un punto final distinto o los parámetros de seguimiento adicionales añadidos por un cliente HTTP.
`ERR_DUPLICATE_PARAMETERS`	Se ha proporcionado el mismo parámetro más de una vez y el punto final no admite duplicados de dicho parámetro.	Compruebe la lista de parámetros. El parámetro `printerId` puede repetirse (una vez por impresora); los demás parámetros deben aparecer como máximo una vez.
`ERR_EMPTY_PARAMETERS`	Se ha introducido un parámetro obligatorio, pero carece de valor.	Compruebe que todos los parámetros obligatorios tengan un valor distinto de vacío.
`ERR_INVALID_TENANT_ID`	El identificador de inquilino asociado a la clave API no es válido.	Póngase en contacto con su representante comercial de Ricoh.

Errores relacionados con el tamaño de la respuesta y el método

Código de error	Causa probable	Qué probar
`ERR_RESPONSE_LIMIT_EXCEEDED` (413)	Los datos coincidentes con la solicitud superarían el tamaño máximo de la respuesta. El cuerpo de la respuesta incluye un campo `maxJobs` que indica el límite vigente.	Reduzca el intervalo de fechas, solicite menos impresoras o haga ambas cosas, y vuelva a enviar la solicitud. Consulte Cómo gestionar los límites de respuesta de la API de exportación de datos para conocer los patrones de agrupación recomendados.
`ERR_UNSUPPORTED_METHOD` (405)	La solicitud utilizó un método HTTP distinto de `GET`.	La API de exportación de datos solo admite el método `GET`. Actualice su cliente para que utilice `GET`.

Errores del servidor (500: Error interno del servidor)

Las 500 respuestas indican que se ha producido una condición inesperada en el servidor. Los reintentos son seguros porque todos los puntos finales de la API de exportación de datos son de tipo GET y no producen efectos secundarios. Espere unos segundos antes de volver a intentarlo y utilice el retroceso exponencial si el error persiste.

Código de error	Causa probable	Qué probar
`ERR_INTERNAL_SERVER_ERROR`	Se ha producido una condición inesperada en el servidor.	Espere unos segundos y vuelva a intentarlo. Si el error persiste durante más de unos minutos, póngase en contacto con su representante comercial de Ricoh
`ERR_TENANT_CHECK_FAILED`	El servidor no ha podido verificar el inquilino asociado a la clave API.	Espere unos segundos y vuelva a intentarlo. Si el error persiste, póngase en contacto con su representante comercial de Ricoh.
`ERR_PRINTERS_FETCH_FAILED`	El servidor no ha podido recuperar la lista de impresoras del inquilino.	Espere unos segundos y vuelva a intentarlo. Si el error persiste, póngase en contacto con su representante comercial de Ricoh.
`ERR_PRINTER_STATES_FETCH_FAILED`	El servidor no ha podido obtener los datos sobre el estado de la impresora correspondientes a la solicitud.	Espere unos segundos y vuelva a intentarlo. Si el error persiste, póngase en contacto con su representante comercial de Ricoh.

Otros síntomas

La respuesta está vacía ([]) pero usted espera datos: Un array vacío significa que no hay coincidencias con la solicitud. Compruebe el intervalo de tiempo (la API solo proporciona datos de los últimos siete días), la zona horaria, los valores printerId y cualquier filtro, como jobState o stateCategory.
Los valores de fecha y hora de la respuesta no coinciden con lo que esperaba: Las marcas de tiempo de las respuestas corresponden a la hora local en la zona horaria indicada en la solicitud. Al enviar la misma solicitud con un valor timezone diferente, se obtienen cadenas de marca de tiempo distintas, aunque describan los mismos eventos. Consulte Manejo de fechas y horas en la API de exportación de datos.
Falta una impresora en la respuesta de /printers: La API solo devuelve las impresoras que están supervisadas por un recopilador de datos. Si falta una impresora, compruebe que esté registrada en un recopilador de datos y que tenga actualmente una conexión.
La respuesta sobre el estado de una impresora incluye categorías unknown: Una categoría unknown indica que no se ha podido clasificar el estado sin procesar de la impresora. Consulte Estados de la impresora y categorías de estados para ver la correspondencia completa entre estados y categorías.

1.6 RICOH Cloud Connector

RICOH Cloud Connector es una aplicación del sistema local que proporciona una conexión segura con RICOH TotalFlow Cloud. Ayuda a registrar productos y, si es necesario, gestiona la comunicación con las aplicaciones de RICOH TotalFlow Cloud.

Nota:

Si utiliza la Suscripción a RICOH InfoPrint Manager , RICOH Cloud Connector se instala automáticamente con el producto. Al desinstalar RICOH InfoPrint Manager, RICOH Cloud Connector se desinstala automáticamente.
No es necesario instalar RICOH Cloud Connector para utilizar RICOH Predictive Insight.

Puede instalar RICOH Cloud Connector en los siguientes sistemas operativos:

En Windows:
- Microsoft Windows 10 Pro/Enterprise
- Microsoft Windows 11 Pro
- Microsoft Windows Server 2019 Standard
- Microsoft Windows Server 2022 Standard
En Linux:
- Red Hat Enterprise Linux 8
- Red Hat Enterprise Linux 9
- Fedora Linux 38
- CentOS Stream 8
- Ubuntu 22.04 LTS
- openSUSE Leap 15.4

Nota:

Estas son las últimas versiones probadas con RICOH Cloud Connector, pero también puede utilizar versiones posteriores de estos sistemas operativos.
Estos sistemas operativos y sus actualizaciones son compatibles mientras el fabricante siga prestando asistencia a sus clientes en virtud de acuerdos estándar, sin incluir la asistencia ampliada.

La instalación de RICOH Cloud Connector precisa al menos 1,1 GB de espacio libre.

1.6.1 Descarga de RICOH Cloud Connector

Puede descargar la última versión de RICOH Cloud Connector desde Suscripciones o desde la pestaña Conectores en RICOH Account Administration. Descargue el paquete en el servidor donde vaya a instalar la aplicación.

Antes de descargar Cloud Connector, asegúrese de que se cumplan estas condiciones:

La página de configuración de Cloud Connector se abre en un navegador web. Asegúrese de que el sistema tenga instalada la última versión de uno de estos navegadores:
- Mozilla Firefox
- Google Chrome
- Microsoft Edge
Tiene permiso de escritura en la ubicación de instalación predeterminada:
- %Datos de programa%\RICOH\Cloud Connector\ para Windows, o bien
- /opt/RICOH/RCC/ para Linux.
Si elige una ruta de instalación diferente, asegúrese de que exista y de que tiene permisos de escritura sobre ella. Si el directorio existe, debe estar vacío.

Para descargar RICOH Cloud Connector:

Inicie sesión en el servidor en el que desea instalar Cloud Connector como administrador.
Inicie sesión en RICOH TotalFlow Cloud como usuario con acceso a RICOH Account Administration.
En RICOH Account Administration, haga clic en Suscripciones en el panel izquierdo.
Verá la pestaña Suscripciones y los enlaces para descargar el paquete RICOH Cloud Connector.
Haga clic en Descargar para Windows o Descargar para Linux, según su sistema operativo.
Descargue el paquete de instalación en una ubicación en la que tenga permisos de escritura y ejecución. En Linux, descargue un archivo llamado ricoh-cloud-connector-linux.gz, que contiene el archivo ejecutable.
El nombre del archivo descargado es:
- En Windows: ricoh-cloud-connector-win.exe
- En Linux: ricoh-cloud-connector-linux.gz

1.6.2 Instalación o actualización

Después de descargar la versión actual de RICOH Cloud Connector, instálela en el servidor que ha identificado.

Nota:

Si ha descargado los archivos de instalación en otro equipo, cópielos en el sistema en el que desea instalar el programa.
Asegúrese de que dispone de espacio suficiente en el disco. La instalación de RICOH Cloud Connector precisa al menos 1,1 GB de espacio libre.

Para instalar o actualizar RICOH Cloud Connector:

Inicie sesión en el ordenador donde descargó el ejecutable de instalación de RICOH Cloud Connector como administrador.
En un sistema Linux, debe iniciar sesión con una cuenta de usuario que tenga permisos de lectura y escritura en los siguientes directorios:
- /var
- /etc
- /usr
- /opt
Además, necesita permiso de ejecución para el archivo ejecutable de RICOH Cloud Connector que ha descargado.
Si realiza la instalación en Linux, busque y haga doble clic en ricoh-cloud-connector-linux.gz para descomprimir los archivos de instalación.

Importante: Entre los archivos descomprimidos, debería ver el archivo ejecutable del instalador, denominado ricoh-cloud-connector-linux. Asegúrese de que el archivo puede ejecutarse como un ejecutable. Siga el procedimiento correspondiente a su versión de Linux para hacer que sea ejecutable.
Busque y haga doble clic en el ejecutable de instalación de RICOH Cloud Connector.
El nombre del archivo ejecutable es:
- En Windows: ricoh-cloud-connector-win.exe
- En Linux: ricoh-cloud-connector-linux
Si instala RICOH Cloud Connector por primera vez, la página Instalación de RICOH Cloud Connector se abre en el navegador predeterminado.

Si está actualizando RICOH Cloud Connector, la página Actualización de RICOH Cloud Connector se abre en el navegador predeterminado.

Nota: Si no se abre la página Instalación de RICOH Cloud Connector, es posible que su antivirus o su navegador estén bloqueando el instalador.
Compruebe la barra de direcciones de su navegador para ver si ha bloqueado la apertura de una página. Si la página estaba bloqueada, conceda permiso para mostrar la página. Si la página sigue sin aparecer, consulte el tema Resolución de problemas que aparece a continuación.
Si realiza la instalación por primera vez:
1. Revise los términos legales y seleccione Acepto los términos del acuerdo de licencia..
2. Verifique la ubicación de la instalación y que tiene permisos de escritura y ejecución para ella, y luego haga clic en INSTALAR.
Si está actualizando RICOH Cloud Connector:

Nota: Se importan los datos de configuración anteriores, incluida la aceptación de la licencia.
1. Revise la información sobre su versión actual de RICOH Cloud Connector y la versión de actualización.
2. Pulse ACTUALIZAR.

La instalación se inicia y puede ver su progreso.

Una vez finalizada la instalación, se abre automáticamente la página Configuración de RICOH Cloud Connector.

El servicio RICOH Cloud Connector se inicia automáticamente después de cada instalación, actualización o reinicio del sistema.

1.6.3 Configuración

Después de instalar RICOH Cloud Connector, debe configurarlo para que se comunique con RICOH TotalFlow Cloud.

Cuando finalice la instalación de RICOH Cloud Connector, se abrirá la página Configuración de RICOH Cloud Connector en el navegador predeterminado.

Para configurar RICOH Cloud Connector:

La propiedad Nombre del sistema se rellena automáticamente con el nombre del sistema establecido en el sistema operativo. Puede actualizarla con algo que sea más reconocible o fácil de recordar.
Si su empresa utiliza servidores proxy, pida a su departamento informático la dirección IP o el nombre de host y el número de puerto correctos que debe utilizar. Seleccione la opción Voy a utilizar un servidor proxy. y escriba los valores correctos en los campos Configuración del proxy.
Pulse Probar el proxy. Si la configuración del proxy no está validada, consúltela a su departamento informático, introduzca los valores correctos e inténtelo de nuevo.
Pulse Generar código.

Si no ha iniciado sesión en Account Administration, se abrirá el cuadro de diálogo de inicio de sesión. Inicie sesión en Account Administration.

Cuando haya iniciado sesión, verá la ventana Generar un código único y un código único de un solo uso válido durante 20 minutos.
Copie el código, vuelva a RICOH Cloud Connector y pegue el código en el campo Código de un solo uso.
Pulse Enviar.
Si su autorización es válida, recibirá un mensaje de confirmación. Pulse Cerrar.
Verá el diálogo Configuración de la licencia.
Contiene todos los datos introducidos durante la configuración. Puede editar el Nombre del sistema y la Configuración del proxy, si es necesario.
Cierre la pestaña o ventana del navegador para salir de la configuración de RICOH Cloud Connector.

1.6.3.1 Nombre del sistema

Muestra el nombre del dispositivo en el que está configurando RICOH Cloud Connector.

Por defecto, este valor es el nombre de este sistema asignado en el sistema operativo. Puede cambiarlo por un nombre más reconocible. RICOH Account Administration muestra este nombre en la pestaña Conectores, en la tabla de conectores registrados.

1.6.3.2 Configuración del proxy

Algunas empresas utilizan servidores proxy para proporcionar una capa adicional de protección de la red.

Si su empresa utiliza servidores proxy, pida a su departamento informático la dirección IP o el nombre de host y el número de puerto correctos que debe utilizar.

1.6.3.3 Código de un solo uso

El código de un solo uso generado por RICOH Account Administration que debe utilizar para registrar RICOH Cloud Connector, de modo que la información pueda transmitirse desde su red a las aplicaciones de RICOH TotalFlow Cloud.

Para iniciar sesión en RICOH Account Administration, necesita un ID de usuario de RICOH TotalFlow Cloud.

1.6.4 Desinstalación de RICOH Cloud Connector

Esta sección describe cómo desinstalar RICOH Cloud Connector utilizando las herramientas del sistema Windows.

Nota:

Para desinstalar RICOH Cloud Connector en Linux, siga las instrucciones de su distribuidor de Linux.

Para desinstalar RICOH Cloud Connector en Windows:

Inicie sesión en el ordenador donde está instalado RICOH Cloud Connector como administrador.
Haga clic en el botón de búsqueda de Windows y busque la página de Aplicaciones y características.
Busque y haga clic en el nombre de la aplicación RICOH Cloud Connector.
Pulse Desinstalar.
Haga clic de nuevo en Desinstalar para confirmar que entiende que la aplicación y su información relacionada serán desinstaladas.
Verá la página Desinstalación de RICOH Cloud Connector:
Revise la información y seleccione Entiendo y quiero desinstalar RICOH Cloud Connector. Dependiendo de la configuración, su máquina podría reiniciarse después del proceso de desinstalación..
- Si desinstala RICOH Cloud Connector, todos los programas que utilizaban el Cloud Connector desinstalado para sus suscripciones dejan de funcionar.
Pulse DESINSTALAR.
Inicie sesión en RICOH Account Administration y asegúrese de que el Cloud Connector desinstalado ya no aparezca en la tabla Conectores.
Puede eliminarlo manualmente si no se ha eliminado automáticamente.

1.6.5 Detección de errores

1.6.5.1 Problemas comunes

1.6.5.1.1 No se ha podido instalar RICOH Cloud Connector

Cuando instale RICOH Cloud Connector y no aparezca la página de instalación, intente estas acciones.

Posibles razones por las que no se abre la página de instalación:

No ha iniciado sesión como administrador.
Inicie sesión como usuario con derechos de administrador y vuelva a intentarlo.
En Linux, el archivo de instalación no está definido como archivo ejecutable.
Siga las instrucciones de su versión de Linux para hacer que el archivo sea ejecutable.
Un bloqueador de anuncios impide que Instalación de RICOH Cloud Connector se abra en una nueva ventana del navegador.
Busque la configuración del bloqueador de ventanas emergentes en su navegador y permita que se abra la página.
Su software antivirus está bloqueando la ejecución del instalador.
Conceda permiso para que el programa se ejecute dentro de su programa antivirus.
Ha alcanzado el número máximo de conectores de nube que su suscripción admite.
Inicie sesión en RICOH Account Administration y elimine los conectores de nube desconectados de la tabla Conectores. O bien, póngase en contacto con su representante de ventas de Ricoh para actualizar su suscripción.

Si nada de lo anterior es cierto, utilice el procedimiento de línea de comandos para instalar RICOH Cloud Connector:

Inicie sesión en el ordenador donde descargó los archivos de instalación como usuario con derechos de administrador.
Abra un símbolo del sistema con la opción Ejecutar como administrador y localice el archivo ejecutable RICOH Cloud Connector.
Importante: Asegúrese de tener permiso para ejecutar el archivo. Si utiliza Linux, asegúrese de que el archivo sea ejecutable. Si no lo es, siga el procedimiento correspondiente a su versión de Linux para hacer que sea ejecutable.
Escriba el siguiente comando de instalación:
rccInstallerFileName --install
Pulse Intro.

1.6.5.1.2 Edge no se inicia al instalar RICOH Cloud Connector

Si Microsoft Edge es su navegador predeterminado y utiliza la cuenta de administrador integrada, el navegador no se abre automáticamente al instalar RICOH Cloud Connector.

En tal caso, puede iniciar sesión con las credenciales de una cuenta de usuario distinta o cambiar su navegador predeterminado por otro, como Chrome o Firefox. A continuación, inicie de nuevo el instalador de RICOH Cloud Connector.

1.6.5.1.3 Error de Cloud Connector: la firma aún no está actualizada

Este error puede producirse si la hora del servidor no está sincronizada con su hora local actual.

Asegúrese de que la hora de su servidor esté sincronizada con la hora actual con una precisión de hasta 5 minutos.

Si utiliza Windows, le recomendamos que ajuste automáticamente la hora actual:

Inicie sesión en Windows como administrador.
Haga clic en el icono de Windows en la barra de tareas.
Vaya a Configuración ⇒ Hora e idioma ⇒ Fecha y hora.
Active la opción Establecer la hora automáticamente.
Desplácese hasta Configuración adicional y haga clic en Sincronizar ahora.

1.6.5.2 Descarga de registros de RICOH Cloud Connector

Si tiene problemas mientras utiliza RICOH Cloud Connector, puede cargar fácilmente los registros de la aplicación, que pueden ayudar a solucionar el problema.

Para descargar los registros:

Abra una ventana del navegador web.
Introduzca la URL de la página Configuración de RICOH Cloud Connector en la barra de direcciones:

http://server_address:port_number/license,

donde server_address es la dirección IP o el nombre de host del equipo en el que está instalado RICOH Cloud Connector y port_number es el puerto de la aplicación.

Si está en el ordenador donde está instalado RICOH Cloud Connector y está utilizando el puerto predeterminado, vaya a http://localhost:15180/license.
Haga clic en , el icono Ayuda, en el banner and seleccione Descargar los registros.
Guarde el paquete de registros en su sistema.
El procedimiento de guardado del archivo dependerá de los ajustes del navegador web.
Los registros se guardan en formato ZIP y el paquete resultante se denomina RCC_logs_yyyy-mm-ddThh_mm_ss.zip, donde yyyy-mm-dd y hh_mm_ss representan la fecha y la hora en que se recopilaron los registros.

1 RICOH Account Administration

1.1 Descripción general de RICOH Account Administration

1.1.1 Novedades

1.1.2 Objetos del sistema

1.1.2.1 Claves de API

Related information:

1.1.2.2 Conectores

Related information:

1.1.2.3 Usuarios

Related information:

1.1.3 Interfaz de usuario

1.1.3.1 Mensaje de cabecera

1.1.3.2 Página principal

1.1.3.2.1 Pestaña Claves de API

Related information:

1.1.3.2.2 Pestaña Conectores

1.1.3.2.3 Pestaña Detalles

1.1.3.2.4 Pestaña Suscripciones

1.1.3.2.5 Pestaña Usuarios

1.1.4 RICOH Cloud Connector

Related information:

1.1.5 Accesibilidad

Funciones de accesibilidad

Navegación con el teclado

1.1.6 Marcas registradas

1.2 Introducción a RICOH TotalFlow™ Cloud

1.2.1 Iniciar sesión por primera vez en RICOH TotalFlow Cloud

Related information:

1.2.2 Introducción a RICOH TotalFlow Cloud para administradores

Related information:

1.2.2.1 Visualización de las suscripciones

1.2.2.2 Adición de usuarios

Related information:

1.2.3 Introducción a RICOH TotalFlow Cloud para usuarios

Related information:

1.2.4 Gestión de la configuración de las cookies

1.3 Configuración

1.3.1 Adición de usuarios

Related information:

1.4 Gestión de objetos

1.4.1 Gestión de datos de la cuenta

1.4.2 Modificación de la información de usuario

1.4.3 Cambio de contraseña

1.5 Cómo trabajar con la API de exportación de datos

Related information:

1.5.1 API de exportación de datos

Autenticación

Puntos finales disponibles

Pruebas de la API

1.5.2 Creación y gestión de claves API

Related information:

1.5.3 Prueba de la API de exportación de datos

1.5.4 Manejo de fechas y horas en la API de exportación de datos

El modelo de fecha y hora

Formato de fecha y hora

Intervalo de tiempo predeterminado

Conservación de datos: los últimos siete días

Reglas aplicables al intervalo solicitado

Indicar la zona horaria

Proporcionar el idioma

El horario de verano y las horas ambiguas

Recomendaciones para el almacenamiento y la comparación de las marcas de tiempo de respuesta

Ejemplos

Related information:

1.5.5 Campos de respuesta de la API de exportación de datos

Convenciones utilizadas en esta referencia

Campos de respuesta de la solicitud GET /printers

Campos de la respuesta de la solicitud GET /jobs

Campos de respuesta de la solicitud GET /printer-states

Campos de respuesta de la solicitud GET /printer-interventions

1.5.5.1 Estados de la impresora y categorías de estados

Acerca de los estados y las categorías de las impresoras

Estados del norte

Estados del sur

Estados de inactividad

Desconocido

1.5.5.2 Cómo gestionar los límites de respuesta de la API de exportación de datos

Cuáles son los límites

Las solicitudes de planificación deben ajustarse a los límites establecidos